==============================================
Lista de Emails HPonline - Verso 3.0
==============================================
Criada em 15 de maio de 2003
Por Alexandre Pina - alexandre@hpobr.com
Home Page Online - www.hpobr.com
==============================================
Dedicado com amor as minhas filhas e esposa
Alessandra, Brbara, Victria e Mnica
==============================================	
Sugiro no modificar as variveis e nem o nome dos arquivos,
esse script foi testado diversas vezes, sem ter problemas.

Este programa  gratuito (Freeware), podendo ser distribudo livremente,
contando que sejam mantidos os direitos autorais.

============================
Notas da ltima verso (3.0)
============================
Incluso do download do arquivo de backup das tabelas e outras 
melhorias no instalador.

===========
 N D I C E
===========
1 - Requerimentos para o uso
2 - Apresentao da lista
3 - Caractersticas e Funes
4 - Instalao e Upgrade
5 - Incluindo a lista no site
6 - Relao de arquivos do Script
7 - Direitos Autorais

============================
1) R E Q U E R I M E N T O S
============================

Iniciei o arquivo de instrues com os Requerimentos porque tenho visto
muitas pessoas tentarem instalar esta lista em Servidores que no tem ou
no permitem suporte ao PHP ou no utilizam o Banco de Dados MySql.

Necessita de Servidor com suporte a PHP e MySql em ambiente Linux (LAMP)
E naturalmente que voc tenha permisso para usar ambos
No PHP necessita de (Sessions on: Enabled) e do (CURL: Enabled)

Configuraes para o Servidor e Softwares Recomendados:
Servidor: Apache - Sistema Operacional: Linux
PHP: Verso 4.3.2 - Banco de Dados: MySql Verso 4.0.13
Antes de instalar, consulte o administrador do seu Servidor de Hospedagem

 necessrio que voc tenha um pouco de experincia em:
a) Protocolo FTP, para o envio dos arquivos para o servidor;
b) PHP, para a ediao do arquivo de configurao (config.php).

==========================
2) A P R E S E N T A   O
==========================

A lista de emails tem a finalidade de inscrever usurios
para que eles possam receber as suas notcias via email.
 muito til, pois assim voc mantm contato com todas as
pessoas que visitam o seu site. A lista que desenvolvi tem
as opes de incluso e excluso de usurios pelo site onde
ela estiver, alm de uma poderosa rea de Administrao que
lhe permite todo tipo de operao com os dados cadastrados.

==================================================
3) C A R A C T E R  S T I C A S  E  F U N   E S
==================================================

3a) Na lista:
=============
Incluso --> Verifica campos vazios, email vlido e se o usurio 
j consta no cadastro. Tem opo de fazer a confirmao do cadastro
do novo usurio por um email de confirmao com um link que o ativa.
Envia email de confirmao e avisa o Webmaster da nova inscrio. 

Excluso --> Verifica campos vazios e se o usurio consta no 
cadastro. Envia email confirmando a excluso e avisa o Webmaster.

Ambos contam com um pequeno arquivo de ajuda
As mensagens contam com link para remoo automtica para o caso de 
um inscrio indevida ou no autorizada.

3b) Na Administrao
====================
- Login usando Sessions, para garantir a segurana da lista, sendo 
acessada apenas pelo administrador que tem o login e senha; 
- No Login, existe a opo de recuperao da Senha por email, sendo que 
ela s  enviada para o email do administrador, esta funo  opcional;
- Informa seu ltimo acesso na Administrao;
- Na entrada lhe informa se existe uma nova verso da lista;
- Informa o nmero de usurios cadastrados, ativos e inativos;
- Conta com um sistema de avisos online, gerados direto do site do
desenvolvedor da Lista;
- Informa sobre os softwares que seu Servidor usa e suas verses;
- Consulta usurios por ordem decrescente de cadastro;
- Busca por usurios, com sistema de semelhana, ou seja, se voc
procurar por 'alex', ir aparecer tanto 'alex' como 'alexandre';
- Edio de usurios, podendo mudar nome, email, e tambm sua situao
no cadastro, ativo ou inativo;
- Incluso de usurio, feita na administrao, o usurio entra ativo;
- Excluso de usurio, deleta o cadastro definitivamente;
- Envio de Mensagens em Text e Html, com um recurso que mantm a conexo
com o banco de dados ativo, caso perca a conexo, o programa tenta
reconectar e se no for possvel, lhe avisa sobre o erro e lhe informa o
ltimo email enviado, tambm  possvel enviar anexos junto as mensagens;
- Na Administrao Geral,  possvel alterao de Senha do administrador, 
realizar a manuteno das tabelas, e no caso do Admin Master, este poder 
incluir, excluir ou editar os demais administradores.
Obs: Para isso  necessrio que apenas o Admin Master tenha acesso ao Banco 
de Dados.
- Consulta Alteraes feitas, pelo log  possvel consultar tudo dentro da
lista, pois o programa grava todas as aes feitas, incluir, excluir, editar,
inscrio de novo usurio, excluso de usurio, confirmaes de cadastro, 
envio de mensagens, entrada do administrador no sistema...
- Arquivo de ajuda, apenas um pequeno help;
- Histrico das verses, informa todas as mudanas j feitas na Lista;
- Backup automtico no momento que entra na Administrao;
- Backup via painel da Administrao;
- Restaurao de Backup via painel da Administrao;
- Instalador automtico protegido por Senha;
- Download do arquivo de backup das tabelas;
- Logout, sada do administrador do sistema.

========================================
4) I N S T A L A   O  &  U P G R A D E
========================================

Procedimento para Instalao ou Atualizao:
============================================
1- No arquivo config.php, digitar as informaes necessrias, como o 
acesso ao banco de dados, seus dados e do site, neste arquivo h uma 
breve explicao para cada item;
2- No arquivo modelos.php esto os templates (exemplos) dos emails que
so enviados tanto para o Administrador como para os usurios, voc 
poder modific-los a sua vontade, sugiro cuidado nas mudanas;
3- No arquivo listahpo.php incluir o path para o config.php, 
caso ele seja includo em outra pgina fora do diretrio da lista, no 
item seguinte h exemplos de como fazer a incluso;
4- Enviar todos os arquivos para o servidor lembrando que os arquivos 
'.php' e '.htm' devem ser enviados em ASCII, e as imagens em BINARY. 
No mude os nomes dos arquivos e diretrio;
5- Dar permisso 0777 (chmod) para a pasta backup;
6- Executar o arquivo (instalar.php), lembrando que agora este arquivo 
 protegido por senha, para que apenas o Admin da Lista possa us-lo.
A senha e o login padro so: Login: hpobr e Senha: hpobr
Sugiro modificar essas informaes para as que voc desejar, editando o 
arquivo (instalar.php) nas linhas 2 e 3
  
================================================
5) I N C L U I N D O  A  L I S T A  N O  S I T E
================================================
Em pginas PHP:
===============
Basta usar a funo include onde deseja que o formulrio da 
lista aparea. Toda ela roda dentro do $PHP_SELF.
Exemplo:
Se voc deseja incluir a lista na sua pgina principal.php,
basta utilizar
<?
include ("/home/seusite/www/listahpo/listahpo.php");
?>
Obs: no esquea de incluir o path para o config.php no arquivo 
listahpo.php

Em pginas HTML:
================
Sugerimos incluir por um <iframe>
Exemplo:
<iframe src="http://www.seusite.com/listahpo/listahpo.php"></iframe>
Este recurso permite retirar bordas, scrooling, ajustar tamanho...

===================================================
6) Relao dos arquivos que formam a Lista HPonline
===================================================
/arquivos/excluir.gif
/arquivos/excluir.htm
/arquivos/fundo_cab.gif
/arquivos/fundo_menu.gif
/arquivos/fundo_rod.gif
/arquivos/incluir.gif
/arquivos/incluir.htm
/arquivos/index.php
/arquivos/logohpobr.gif
/arquivos/print.gif
/arquivos/setadir.gif
/arquivos/setaesq.gif
/backup/index.php
admin.php
ajuda.php
backauto.php
buscar.php
config.php
confirmar.php
consultar.php
editar.php
excluir.php
funcoes.php
historico.php
imprimir.php
incluir.php
index.php
instalar.php
leiame.txt
listahpo.php
log.php
login.php
mensagem.php
modelos.php
remover.php
senha.php
sessao.php
 
=================================
F I M  D A S  I N S T R U   E S
=================================

===================================
7) D i r e i t o s  A u t o r a i s
===================================

O script usado para fazer a paginao foi
desenvolvido por: Olavo Alexandrino
e-mail: oalexandrino@hotmail.com
Verso: 1.00 - Verso Original: Diego Mascarenhas

O script usado para a pgina de enviar mensagens com anexo
foi baseado na verso escrita por Nelson R. Moura
nelson@sitecom.com.br, que segundo ele se baseou na verso
1.0 do script do Alexander Benatti.

O script de backup foi baseado em uma resposta dada no frum
do PhpBrasil, por Clever Anjos.

Aos demais scripts que usei como referncia para a 
criao deste programa, eu lamento, mas no anotei
os autores, porque s passei a inserir os Direitos
Autorais na Verso 2.5 desta Lista. Apenas poderia
citar os sites do PhpBrasil e do ScriptBrasil, onde
usei alguns exemplos descritos em tutoriais e artigos.

Sites onde encontrei artigos e tutoriais:
HostSul - www.hostsul.com.br
PHPBrasil - www.phpbrasil.com
ScriptBrasil - www.scriptbrasil.com

===================================
===================================
===================================

Pronto, agora pode usar...

Espero que ajude voc,
Atenciosamente,
Alexandre Pina

