INSTRUES DE INSTALAO e OPERAO TTL-1.0

###########################################################
#           T E R M O S   D E   L I C E N  A             #
###########################################################
# Autor:         TodaviA Internet - WSSystem Solues     #
# Data:          03 abril de 2000                         #
# Copyright:     (C) 2000 All Rights Reserved.            #
###########################################################
# Este software  de propriedade exclusiva de seu autor.  #
# A licena adquirida refere-se ao uso apenas, e no      #
# autoriza o licenciado a ceder, vender, emprestar, locar #
# ou tornar pblico o uso desta licena.                  #
# Qualquer alterao feita neste software corre por total #
# conta e risco do licenciado, e no caracteriza o feito  #
# como co-autoria.                                        #
# A instalao, execuo e configurao deste software    #
# correm por total conta e risco do licenciado e qualquer #
# dano decorrente destas aes so de sua inteira         #
# responsabilidade.                                       #
#                                                         #
# COPYRIGHT                                               #
# =========                                               #
# O usurio, como prova de respeito ao copyright e        #
# e direitos do autor, manter os crditos existentes     #
# neste programa intactos e exibveis. O desrespeito a    #
# esta norma caracteriza o ato como Crime contra          #
# propriedade intelectual.                                #
###########################################################

##########################################################
# NOME:  TTL-1.0 - Toplinks 1.0     (C)2001 - TodaviA    #
##########################################################
##########################################################
# Descrio do Programa                                  #
#  O programa permite que os usurios se cadastrem e     #
#  exibe quantas vezes cada link foi clicado.            #
#   O sistema conta ainda com sistema de autenticao de #
#	 E-Mail, pois o link s  adicionado se o e-mail       #
#	 informado for verdadeiro e ainda h o sistema de      #
#	 alternncia de links: O ltimo a ser clicado vai para #
#	 o fim da lista e assim sucessivamente.                #
##########################################################
Os passos desta instruo:
	> Configurando o arquivo "toplinks.cgi"
	> Configurando o arquivo "body.css"
  > Instalando
	> Fazendo funcionar
	> FAQ


CONFIGURANDO O ARQUIVO "TOPLINKS.CGI"
===============================================================


1) Abra o arquivo "toplinks.cgi" em seu editor de textos
preferido. Note que o editor de textos deve ser tipo ASCII
como o NOTEPAD do Windows ou similar. Nunca use editores
como o Word ou Wordpad.

2) Logo na primeira linha do arquivo voc encontrar a
seguinte instruo:
#!/usr/bin/perl

Este  o caminho da PERL em seu servidor. Altere esta linha
se necessrio. Para a maioria dos servidores os comandos mais
comuns so: #!/usr/bin/perl   ou   #!/usr/local/bin/perl.
Abaixo explicamos como saber ao certo.


3) Agora, localize no programa a linha:


##########################################################
###                                                    ###
### -------------  rea de Configurao  ------------- ###


As linhas abaixo devem ser configuradas para atender s suas
necessidades e iremos ajud-lo neste passo.



4) Digite entre as aspas sua senha para administrar o TTL-1.0

###-------------------------------------------------------
### --- Senha para Administrao
### --- Escolha uma senha de sua preferncia

$senha="todavia";



5) Digite entre as aspas o nome de sua pgina de links

###-------------------------------------------------------
### --- Nome do sistema de Links
### --- Ser exibido em todas as pginas e nos e-mails

$titulo_top="Toplinks TodaviA TTL-1.0";



6) O layout geral de seu Toplinks est definido no arquivo
body.css que est anexo a seu pacote. Informe entre as aspas
a URL (endereo) completo onde voc ir hospedar este arquivo

###-------------------------------------------------------
### --- URL do Arquivo CSS
### --- Lembre-se: insira uma barra-invertida (\) antes de
### --- qualquer aspa. Ex.: href=\"www.site.com\"

$estilo="http://www.todavia.com.br/body.css";


7) Esta pode ser a parte mais complicada se  sua primeira
instalao. Entre as aspas voc deve informar onde no servidor
est o programa SENDMAIL, que  responsvel pelo envio de mensagens
via e-mail. Logo abaixo ajudamos voc a descobrir onde , se voc
ainda no sabe.
###-------------------------------------------------------
### --- Caminho do programa SENDMAIL
### --- Local onde est o Sendmail em ser host. Os mais comuns
### --- so: /usr/lib/perl   ou   /urs/sbin/perl

$prog_mail="/usr/lib/sendmail";


8) Quando o sistema envia um e-mail, ele precisa ter o campo
remetente. Informe abaixo seu e-mail

###-------------------------------------------------------
### --- Seu E-Mail 
### --- Lembre-se: insira uma barra-invertida (\) antes da
### --- arroba (@). Ex.: joao\@nada.com

$meu_email="info\@todavia.com.br";


9) Informe entre as aspas a URL (endereo) do TTL-1.0 em seu
servidor.

###-------------------------------------------------------
### --- URL deste script
### --- Insira uma barra no fim da URL (/)

$url_cgi="http://www.todavia.com.br/cgi-bin/scripts/toplinks/toplinks.cgi";

10) A hora de deciso... Seu sistema pode apresentar um banner ou imagem no topo
da pgina. Voc decide agora se quer isto ou no. O "0" (zero) significa NO,
e o "1" (um) significa "SIM".

###-------------------------------------------------------
### --- Banners na pgina de links
### --- Sua pgina ter banners?

$banner=0; #  0=No
           #  1=Sim
			   #
			   #  Se a resposta for "Sim", abaixo informe
			   #  a URL completa do banner
			   
			   
11) Se voc decidiu ter uma imagem no topo da pgina, precisa agora informar
onde estar hospedado o aqruivo com a imagem. Informe a URL completa.
			   
$url_banner="http://www.todavia.com.br/banner.jpg";


12) Vrias pessoas iro pegar este programa. Deste modo, sera prudente
mudar o nome do arquivo que ir armazenar os dados dos websites, certo?
Entre as aspas informe o novo nome para o arquivo de armazenamento.
Ah! lembre-se de tambm renomear o arquivo "dados.txt" para o nome que
voc escolher aqui, ok?

###-------------------------------------------------------
### --- Arquivo de armazenamento dos dados
### --- Se voc alterar, lembre-se de alterar tambm o
### --- arquivo anexo com mesmo nome.

$arquivo="dados.txt";



13) Se voc chegou a esta parte anime-se. O pior j passou :)

### ---------- FIM da rea de Configurao  ---------- ###
### S prossiga se souber realmente o que est fazendo ###
##########################################################


******* Quer saber como achar o SENDMAIL ou o Caminho PERL?

Voc tem duas alternativas: Descobre por si mesmo ou manda um
e-mail para quem hospeda seu site perguntando.

Se voc est com pressa e quer saber logo de uma vez ser preciso
abrir um programinha chamado TELNET.EXE que j existe na pasta
C:\Windows de seu computador.

a. Conecte-se  Internet, abra o TELNET.EXE
b. Clique em Conectar e depois em Sistema Remoto
c. na janela "Nome do Host" digite seu dominio ou seu IP.
d. Se tudo estiver certo, o programa ir pedir seu login e senha.
   informe-os e seu acesso estar aberto.
	 
	 Para descobrir Onde est o Sendmail digite:
	whereis sendmail
	 A resposta estar  sua frente. Anote-a e digite em seguida:
	whereis perl
	 O resultado  o caminho onde est o interpretador PERL do servidor.
	 
Nota: Alguns servidores no permitem acesso via TELNET ou os dados de
acesso so diferenciados. Informe-se para saber qual  seu caso.

  

CONFIGURANDO O ARQUIVO "BODY.CSS"
===============================================================

Na verdade, voc s precisar alterar este arquivo se as cores
e formas exibidas no TTL-1.0 no forem de seu agrado.
Se voc preferir deixe-o como est e altere quando seu sistema
j estiver funcionando.
Mais uma coisa. na hora de alter-lo voc precisar se virar
sozinho. Alm do mais, se voc j chegou at aqui com certeza um CSS 
"fichinha" para voc.



INSTALANDO
===============================================================
 1) Conecte-se ao seu servidor via FTP e faa o upload do arquivo
 "toplinks.cgi" para a pastya cgi-bin em ser servidor no modo ASCII.
 
 Explicando:
 
 O modo ASCII  uma das opes de transferncia dos programas de FTP.
 Este modo as vezes  identificado com as letras "A", "I" ou "T"
 
 Pasta "cgi-bin"  a pasta que tem permisso para abrigar programas CGI.
 em alguns servidores ela chama-se "cgi-local" e em outros qualquer pasta
 pode abrigar os programas CGI.
 
 2) Faa o upload do arquivo "dados.txt" para a mesma pasta onde est
 o arquivo "toplinks.txt" no modo ASCII (lembre-se que ele deve ser
 renomeado se voc escolheu outro nome no arquivo "toplinks.cgi")
 
 
 3) Agora voc est prestes a se tornar um "mago" do CGI. Voc vai
 mudar a permisso UNIX de arquivos.
 
 Explicando:
 
 O servidor precisa "saber" que os arquivos so programas e no apenas
 arquivos cheios de letras e numeros. para isto, voc precisar fazer
 esta "coisa" chamada Alterar Permisses Unix.
 
 Siga os passos abaixo (dependendo de seu programa de FTP)
 
 CuteFTP ou WS_FTP
 =================
 Clique sobre o arquivo no servidor com o boto direito do Mouse e selecione:
 a opo "CHMOD". Digite o numero 755 para o arquivo "toplinks.cgi"
 e 777 para o arquivo "dados.txt" (ou o nome que voc deu a ele).
 
 LeechFTP (Ns recomendamos)
 ===========================
 Clique sobre o arquivo no servidor com o boto direito do Mouse e selecione:
 a opo "File Attributes". Digite o numero 755 para o arquivo "toplinks.cgi"
 e 777 para o arquivo "dados.txt" (ou o nome que voc deu a ele).
 
 
 Se voc preferir alterar as permisses via Telnet, leia o FAQ.

4) fa o upload do arquivo "body.css" para o local que voc indicou nas
configuraes do arquivo "toplinks.cgi"


PRONTO!!!!! J podemos testar o TTL-1.0

FAZENDO FUNCIONAR
===============================================================

para acessar a lista basta criar um link em seu site para:

	http://www.seu-dominio.com.br/cgi-bin/toplinks.cgi?lista

para acessar a rea de administrao, acesse assim

	http://www.seu-dominio.com.br/cgi-bin/toplinks.cgi?admin

Informe a senha que voc escolheu.


FAQ
===============================================================

SOLUO DE PROBLEMAS

Alguns problemas inesperados podem ocorrer quando voc testar o funcionamento de seu programa. Abaixo esto os problemas mais comuns
Lembre-se: No oferecemos suporte para este produto.


A)  500 Internal Server Error - Ocorreu um erro no servidor. 
 	1. Verifique a permisso do arquivo, que deve ser 755.
	2. Atente para o fato de ter feito o up-load no modo ASCII
	3. Certifique-se de e no haver tocado nas linhas do programa de modo incorreto
	(respeite as aspas existentes e no use nenhum caracter especial, inclusive as aspas).
	4. Verifique primeira linha do programa, que indica a localizao do interpretador Perl.
	As mais comuns so #!usr/bin/perl e #!usr/local/bin/perl.
	Para ter certeza, digite, via telnet, o seguinte comando:
	whereis perl.
	O resultado  a correta localizao do Perl, que deve ser inserida no inicio do programa.

B)  403 Forbidden - A permisso Unix atribuda ao programa no permite que ele execute suas funes.
    Altere a permisso para 755.

C)  404 Not Found - Este erro est nos links
	 e pode estar associado  localizao do arquivo toplinks.cgi no servidor ou ao
	 endereamento dos links.
	Verifique se o link aponta para o local exato onde se encontra o programa toplinks.cgi.
	Veja tambm se os links esto todos em ordem na configurao do programa.
	Um modo de evitar confuses  inserir a URL completa em cada opo.
	por exemplo, ao invs de usar uma URL parcial como 
	"pasta/arquivo.cgi",
	use a URL completa 
	"http://www.dominio.com.br/pasta/arquivo.cgi"

D)  O Programa surge como pgina de texto 
		Altere a permisso do programa para 755. 
