

#llbra#llbra#llbra#llbra#llbra#llbra#llbra#
#					  #
#       LLBRA LOGIN - VERSAO 3.0          #
#     ----------------------------        #
#                                         #
#      SCRIPT POR:  Lucas (llbra)         #
#                                         #
#   COLABORACOES:  Guilherme Saldanha     #
#       (ver modificacoes.txt)		  #
#					  #
#					  #
#llbra#llbra#llbra#llbra#llbra#llbra#llbra#

/*
LLBRA LOGIN - llbra@bol.com.br - llbra.tk
*/

- OBRIGADO POR USAR MEU SCRIPT, ESPERO QUE LHE SEJA UTIL! 


##### USANDO O SCRIPT ###############################
_____________________________________________________

1) Instalando - Configuracoes


	- Setar $patch no 'painel.php', e setar $url_site no 'protect.php' para que ele
	possa proteger todos os diretorios abaixo ao diretorio do script	

	- Enviar os arquivos (para a MESMA PASTA do dos arquivos que voc quer 
	proteger ou para uma ou mais pastas acimas)

	- Criar a pasta 'usuarios' (raramente e necessiario o chmod, mas se for preciso
	de o chmod 666 na pasta 'usuarios' - nao se preocupe, nao afeta a seguranca)

	- Entrar/excutar no install.php, pelo navegador, e criar o usuario master e setar os
	dados do site e do script (podem ser mais tarde, modificados


  INFORMACOES:

  * O script e todo instalavel. Execute 'install.php' via web 
    (http://www.site.com.br/install.php). So nao se esqueca de setar $url_site no doc
    'protect.php' , $patch do 'painel.php' so precisa ser setada se o script estiver numa
    pasta abaixo ao do index, onde o 'painel.php' sera incluido

  * DICA: deixe o script na pasta raiz, assim toda a homepage podera ser protegida e assim
    reduz-se a possibilidade de falhas
	
  PRONTO:

  * Depois de seguido os passos e lido as informacoes, o script esta pronto para usar. 
    LEIA este arquivo INTEIRO, para que nao haja duvidas sobre o funcionamento do script, 
    e se mesmo assim restarem duvidas, va para (3) deste LEIA-ME

_____________________________________________________


2) Funcoes


2.1) Protegendo

	- Insira a linha no TOPO (linha 1, se possivel) da pagina a ser protegida:

	<? include "protect.php"; ?>

2.2) Painel	

	- Use o arquivo 'painel.php' para por o form, os links de logar,
	deslogar e painel (pagina do usuario onde e possivel editar dados, deletar conta,
	etc.)
	- Insira a linha abaixo, para por um link (menu) do script no seu site
	
	<? include "painel.php"; ?>

	ou

	<? include "DIRETORIO_DO_SCRIPT/painel.php"; ?>
	// nao e recomendado ter o index em pastas superiores ao do script


  2.2.1) Colocar links do script no index do site

	- Para colocar os links de 'logar', 'deslogar', 'meu perfil', de um include 
	no arquivo 'painel.php' e mude $patch, para o diretorio, a partir do seu 
	index, que o script fica

2.3) Admin

	- Admin.php onde pode-se ver todos os usuarios/admins, dados deles, deletar ou 
	adicionar admin de 3 tipos

	  * Tipo 1 : Adiciona/modifica status de admin, deleta usuarios/admins, ve 
		     usuarios/admins
	  * Tipo 2 : Deleta usuarios/admins (menos do tipo 1), ve usuarios/admins
	  * Tipo 3 : Ve usuarios/admins

	- So eles tem acesso ao 'admin.php'
	- Ficam destacados na listagem do 'admin.php'
	- Podem ser deletados por admins tipo 1

2.4) Variaveis do usurio

	- Nome completo do usurio -> $nomeC = $_COOKIE['llbra_nomeC'];
	- Nome (login) -> $nome = $_COOKIE['llbra_nome'];
	- Email -> $email = $_COOKIE['llbra_email'];
	- Status de login -> $logado = $_COOKIE['llbra'];

2.5) CSS

	- Para editar o visual use o documento 'style.css'

2.6) Centro do usuario (painel de usuario - nao confundir com painel.php)

	- O usuario pode editar seus dados
	- O usuario pode se deletar
	- O usuario pode se deslogar

2.7) Exemplos

  2.7.1) Mostrar status de 'conectado'

	- Necessita que os cookies sejam gravados no diretorio onde a mensagem for ser
	exibida, caso contrario $_COOKIE['llbra'] tera valor nulo. Entao, para isso deixe
	os arquivos do login na pasta raiz, ou na pasta onde for mostrar o status

	<?
	$patch = "llbra3/";
	include $patch."site.php";
	$logado = $_COOKIE['llbra'];
	if ($logado == "ok"){
	echo "Logado no $nome_site";
	}
	?>

  2.7.2.) Nomeando admins

	- Para nomear alguem admin, va, com o admin(tipo 1) do sistema no admin.php, atraves
	do painel do usuario e clique sobre um usuario e escolha uma das opcoes e de 'ok'
	- Aquele usuario vira instantaneamente um admin do tipo escolhido. Nao existem
	limites de numero de admins de qualquer tipo. Pode haver mais de um do tipo 1.

  2.7.3) Removendo/modificando status de admin

	- Para modificar, d um status de admin, que nao seja o que ele possui, e ele
	perdera o seu status de admin e ganhar o novo status
	- Para remover selecione zerar 'status', que ele voltara a ser um usuario comum
  
  2.7.4) Reconfigurando dados da pagina/script

	- Logue com o admin, va em 'administrar' e la, va em 'modificar dados do script'.

  2.7.5) Testando status/identidade de usuarios

	- Para ver se o usuario logado o admin master do sistema
	
	$fake = htmlspecialchars(trim($_REQUEST['nome_admin']));
	include "config.inc.php";
	// se $nome_admin tiver valor dirente de 0, o usuario e o admin master


	- Para ver se o usuario esta logado
	
	$logado = $_COOKIE['llbra'];
	// se logado for diferente de 'ok' e porque o usuario nao esta logado


	- Para testar/pegar dados do usuario

	ver 2.4

  2.7.6) Testando status pelo 'testar.php'

	- De um include no 'testar.php', que ele exibir o status do usuario (recomendado)

	ou

	- Faca um link para 'testar.php'

  2.7.7) Usando o painel ('painel.php') no seu index

	- Ao painel foram acrescentadas funcoes praticas, para que o usuario possa se logar
	de maneira mais facil e para que o webmaster possa por o formulario de login no
	index. Entao, aonde achar apropriado, no seu site, de um include do 'painel.php'

        <? include 'painel.php' ?>

	Ele ocupa mais ou menos 100 de largura e 40 de altura... bem pequeno, porem pratico

_____________________________________________________


3) Duvidas, erros, comentarios, criticas

	- Mande me um email
	ou
	- Entre em contato pelo meu site -> llbra.tk
	ou
	- Deixe uma msg no site PHPBrasil.com


4) Colaboracoes/ajudas

	- Se voce que fazer alguma modificacao no script, me avise.

	- Se voce dejesa ajudar com o script, ou qualquer outro tipo de ajuda, como 
	hospedagem, traducao do script (apesar de ser fluente em ingles, estou sem tempo de
	traduzir) entre em contato comigo, pelo meu site (llbra.tk), ou pelo meu email
	(llbra@bol.com.br ou llbra1@bol.com.br)
	- Todo tipo de ajuda e bem vinda, nao so a mim, mas a todos desenvolvedores 
	brasileiros
	
obs.: Nao estou pedindo dinheiro ou doacoes, apenas ajuda para desevolvimento do 
script e de projetos.

_____________________________________________________

/*
LLBRA LOGIN - llbra@bol.com.br - llbra.tk
*/