e107 Readme

e107 requer um webserver que tenha PHP 4.3 (ou mais recente) e MySQL 3.22 (ou mais recente), contate seu administrador web caso não tenha certeza se estão instalados.
Se você hospeda seu próprio site, você pode fazer download do PHP e do MySQL e instalá-los, ambos são gratuitos.
Você precisará do nome do usuário e senha do banco de dados MySQL, e um banco de dados para armazenar o conteúdo. Não se preocupe se você só tem direito a um banco de dados no seu servidor, o e107 pode compartilhar seu banco de dados com outras aplicações.
Uma instalação completa do e107 requer aproximadamente 9MB de espaço em disco no seu servidor, mas isso pode ser reduzido dramaticamente para a maioria dos usuários, basta remover os plugins e temas que não queiram usar, basta remover os folders/pastas.

Instalando

Depois de fazer download e descompactar o pacote, você precisa enviar os arquivos para o server usando um programa de FTP. O e107 rodará na raiz ou dentro de uma pasta no seu webserver ...
- Abra seu programa de FTP e conecte ao seu webserver
- Vá até a pasta do seu webserver onde as páginas web são armazenadas, geralmente estão em 'public_html', 'www' ou 'html'
- Copie todos os arquivos do pacote descompactado para seu webserver - isto demora um pouco, hora de tomar um cafezinho!
Se você tem as permissões corretas de seu server, você pode fazer o upload de uma forma alternativa (e muito mais rápida), enviando os arquivos por este método:
- Pegue o e107 no formato tar.gz do site e107brasil.net ou no e107.org (inglês)
- Usando seu programa de FTP, envie o arquivo tar.gz para seu webserver sem descompactá-lo
- Agora abra um prompt (ou vá no gerenciador de arquivos, no cpanel), e navegue até o folder onde está o arquivo tar.gz
- digite tar xvzf file.tar.gz para descompactar o arquivo ou peça para descompactar pelo link do gerenciador de arquivos do cpanel

Agora você precisa configurar as permissões para alguns arquivos do e107 para acessá-los corretamente. Configure as permissões para 0777 (o server poderá ler e escrever), se uma série de checkboxes aparecerem, selecione todos. Aqui está a lista dos arquivos que você precisa fazer CHMOD 777:
- e107_config.php
- e107_files/public/
- e107_files/cache/
- e107_files/public/avatars/
- e107_plugins/
- e107_themes/

Agora abra seu navegador web e acesse o arquivo install.php, por exemplo:
http://www.seusiteaqui.com.br/install.php ou http://www.seusiteaqui.com.br/e107/install.php

Se todos os arquivos foram enviados com sucesso, você verá a primeira página de instalação do script. Escolha o idioma que você quer usar durante a instalação e clique no botão continuar
O e107 fará uma série de testes para ver se todos os requerimentos foram atendidos e se as permissões dos arquivos está correta. Se você receber mensagem de aviso sobre o MySQL não se preocupe muito, algumas versões do MySQL não retornam a versão corretamente, ou não retornam nada. Clique no botão para continuar, se todos os critérios foram atendidos, caso contrário, ajuste os problemas e tente novamente.
Digite os dados do banco de dados MySQL. O nome do server (geralmente é 'localhost'), usuário e senha. Se você não sabe o usuário e senha entre em contato com seu administrador web (caso não tenha criado o banco de dados no cpanel). Agora digite o nome do banco de dados que o e107 vai usar. Se você tem as permissões corretas, você poderá criar o banco de dados direto da instalação do e107
Se tudo correu bem, o e107 fará a conexão ao banco de dados MySQL, se alguma mensagem de erro aparecer, volte à página anterior e corrija os dados
O e107 agora irá criar as tabelas do banco de dados e preenchê-las com dados, etc
Se tudo correu bem, o último botão irá levá-lo ao seu site. Então, tudo pronto! Não foi tão difícil assim, não é?

Você precisa configurar as permissões do arquivo config para 0644 ...

Usando seu programa de FTP, selecione o arquivo e107_config.php
Configure suas permissões para 0644 (usando o método explicado acima)

Agora delete o arquivo install.php e a pasta e107_install de seu servidor, se você não fizer isso, seu site corre risco de segurança.

Atualizando

Favor clicar aqui para instruções de upgrade de seu site versão 0.6175 para 0.7...

Usando o phpMyAdmin para fazer backup de seu banco de dados

Primeiro, navegue em sua página do phpMyAdmin e faça login (geralmente no cpanel tem o link)
Pela caixa de dropdown na esquerda (ou um link texto) clique no banco de dados de seu site em e107
Na página principal, clique em 'Exportar/Export'
Na caixa da direita, certifique-se se estão marcados 'Add drop table', 'Add AUTO_INCREMENT value' e 'Enclose table and field names with backquotes' (procurar o mesmo em português)
Certifique-se que no principal o 'Structure' e 'Data' estejam marcados também
Marque 'Save as file'
Se você quer fazer um backup compactado, marque também 'zipped' ou 'gzipped'
Clique 'Go'

Para restaurar um backup, clique em 'SQL' no topo. Procure seu backup, talvez você precise esvaziar algumas tabelas antes de restaurar.

Segurança

Segurança tem sido um conceito primário desde as primeiras versões do e107, e por esta razão há algumas medidas fáceis de tomar para fazer seu site ficar mais seguro ainda...

Renomeie seu diretório e107_admin: isto irá fazer com que fique menos óbvio para outros usuários de e107 saberem onde estão seus arquivos de administração.

O procedimento de mudar o nome de um diretório mudou. As definições foram mudadas para o arquivo e107_config.php.

Se você está fazendo UPGRADE/Atualização de uma versão muito antiga do e107 (ex. menor que a v.615), você precisa abrir o arquivo class2.php e encontrar as seguintes linhas:

// Se você quiser mudar o nome de algum diretório, mude o valor aqui e renomeie o respectivo folder no seu servidor...
$ADMIN_DIRECTORY = "e107_admin/";
$FILES_DIRECTORY = "e107_files/";
$IMAGES_DIRECTORY = "e107_images/";
$THEMES_DIRECTORY = "e107_themes/";
$PLUGINS_DIRECTORY = "e107_plugins/";
$HANDLERS_DIRECTORY = "e107_handlers/";
$LANGUAGES_DIRECTORY = "e107_languages/";
$HELP_DIRECTORY = "e107_docs/help/";
$DOWNLOADS_DIRECTORY = "e107_files/downloads/";

Recorte estas linhas do arquivo class2.php e cole no arquivo e107_config.php. Agora você pode mudar o nome dos folders.

Se é uma NOVA INSTALAÇÃO os nomes dos folders já estão em e107_config.php. Eles foram mantidos no arquivo class2.php para compatibilidade. Serão removidos no futuro.

Este procedimento depende de você completar os passos acima e ter certeza de que os caminhos dos arquivos estão localizados no arquivo e107_config.php.
Para renomear seu diretório e107_admin (ou qualquer outro diretório), primeiro renomeie o folder pelo programa de FTP. Então, abra o arquivo e107_config.php na pasta de sua instalação do e107 em um editor de textos, encontre a linha a seguir próxima ao topo do arquivo...
$ADMIN_DIRECTORY = "e107_admin/";
... e mude o e107_admin/ para o nome que você quiser renomear no seu server
Você pode mudar o nome de todos os seus diretórios do e107 usando este método
Há algumas configurações de segurança que você pode mudar na sua área de admin. Vá na página de preferências e você verá uma área de Segurança

Problemas Comuns

Se por alguma razão você receber uma mensagem de erro crítico referente à configurações do core, você pode facilmente resetá-lo para o padrão usando a ferramenta resetcore. Você pode encontrar esta ferramenta na pasta e107_files, use seu navegador web para navegar até: http://www.seusite.com.br/e107_files/resetcore/resetcore.php e siga as instruções. Isto não irá afetar o conteúdo de seu site, isto irá apenas resetar as configurações do core, então seu tema, etc irá voltar ao padrão. Você pode fazer um backup de seu core a qualquer hora e restaurá-lo com esta ferramenta, para fazer backup de seu core, vá na área de admin e clique em Banco de Dados e depois em Backup Core
Se depois de instalar o e107 você receber uma página em branco, verifique o arquivo error_reporting no seu arquivo php.ini. Isto geralmente é causado por um erro no seu site e não é reportado porque está configurado para um nível baixo de aviso ou desligado completamente. Se você não tem acesso ao arquivo php.ini entre em contato com o seu administrador web
Se você vê uma mensagem como "Undefined Variable" ou nota erros no seu site, o nível do arquivo error_reporting está configurado para muito alto. Certifique-se de configurá-lo para "E_ERROR | E_WARNING | E_PARSE" no seu arquivo php.ini, novamente se você não tem acesso, entre em contato com o seu servidor web e peça para que eles mudem

Suporte

Todos esses lugares são amigáveis. Por favor, não hesite em entrar em contato quando tiver dúvidas.

(inglês) e107 fóruns http://e107.org/forum.php
e107 faq http://e107faq.bkwon.net
Canal IRC chat
#e107 em irc.freenode.net

Suporte a plugins: e107coders
http://e107coders.org/

Suporte a temas: e107styles | e107themes
http://e107styles.org/ | http://e107themes.org/
Suporte em português: e107brasil
http://www.e107brasil.net

Desenvolvimento

O e107 foi testado e desenvolvido no Apache 1 e 2, IIS, e PHP 4.3+ (Incluindo 5.0).
Ele é desenvolvido por um time de desenvolvedores chamado "e107 dev team" (Jalist, McFly, Cameron, Streaky, SweetAs, Asperon, Que, Lolo, Chavo, Lisa, MrPete).

Se você fizer mudanças no core que você achar que pode ser útil a outros usuários, favor comunicar nos fóruns no site oficial (em inglês) do e107.org :)

Obrigado!

Agradecimentos especiais primeiro ao jalist por começar tudo isso e tocar a coisa por tanto tempo.

Obrigado principalmente ao Terrence, Damon, que, nalenb, Dawn, HeX0R, JuhaH, bkwon, Knight, Aldrin pelo suporte.
Obrigado também a todos aqueles que enviam traduções, fixes etc
Obrigado a CraHan, NeXTer, Kuhndog, wols, [steev], rootrider, Claymore, demigod, maaneeack, Schmots, dreamer, galois e todos os outros de [#ls.g] pela amizade.
Obrigado a Jérôme C. Meijers e Craig Bramscher
A e107.net pelo host doado
Obrigado a todos vocês que dedicaram seu tempo para criar plugins/themes/hacks, fizeram perguntas e deram respostas nos fóruns e no canal IRC, etc. Nós temos uma comunidade maravilhosa aqui e isto é porque temos pessoas como você.
E obrigado por usar o e107, espero que você goste e que ele seja útil gerenciando seu site. Se ele não for, experimente outros! Visite: OpenSourceCMS para uma lista completa de sistemas de gerenciamento de sites.
Diversos scripts foram integrados ao e107 para fazer sua vida mais fácil, então temos que agradecer a...
- MagpieRSS (http://magpierss.sourceforge.net) MagpieRSS disponibiliza um XML-based (expat) distribuidor RSS em PHP.
- PCLZip (http://www.phpconcept.net/pclzip/) a biblioteca PclZip oferece compressão e extração de arquivos Zip (WinZip, PKZIP).
- PCLTar (http://www.phpconcept.net/pcltar/) PclTar oferece a capacidade de arquivar uma lista de arquivos ou diretórios com ou sem compressão. Os arquivos criados por PclTar são lidos pela maioria das aplicações gzip/tar e por aplicações Windows como o WinZip.
- TinyMCE (http://tinymce.moxiecode.com) TinyMCE é uma plataforma independente baseada em Javascript, é um controle-editor HTML WYSIWYG desenvolvido sob licença LGPL por Moxiecode Systems AB. Ele tem a capacidade de converter campos HTML TEXTAREA ou outros elementos HTML.
- Nuvolo Icons (http://www.icon-king.com) Ícones usados no e107
- PHPMailer (http://phpmailer.sourceforge.net) Classe de envio de email completo para PHP
- Brainjar DHTML Menu (http://www.brainjar.com/dhtml/menubar/) Sistema de menus usado por muitos temas
- DHTML / JavaScript Calendar (http://www.dynarch.com/projects/) Calendário Popup
- FPDF (http://www.fpdf.org) Suporte a PDF
- UFPDF (http://www.acko.net/node/56) Suporte a UTF-8 PDF
Todos esses scripts são desenvolvidos sob licença GPL e têm informações de copyright que devem ser deixadas intactas. Se você quiser usar esses scripts com seus códigos, você precisa aceitar a licença GPL.

Aviso

Este software é livre e vem sem garantias como especificado na licença GNU GPL (inclusive este pacote). Qualquer problema encontrado não é de responsabilidade do autor.