Link em Menu-PullDown

Configuração e Instalação
A configuração é feita nos dois arquivos atuantes do sistema: No arquivo HTML e no arquivo CGI.

  • PÁGINA HTML: nas páginas que possuirem o link pull-down a configuração deve obedecer o esquema abaixo:
  • Textos em vermelho: Devem ser adaptados ao seu website
  • Textos em azul: Devem ser mantidos e nunca alterados
  • Textos em verde: Devem ser adaptados às suas necessidades

    <FORM METHOD=POST ACTION="http://www.wssystem.com.br/cgi-bin/link.cgi">
    <SELECT NAME="destino">
    <OPTION VALUE="http://www.moniqueevan.com.br">Website Monique Evans
    <OPTION VALUE="http://www.motoetecnica.com.br">Website Moto&Técnica
    <OPTION VALUE="http://www.wssystem.com.br/cadastro/index.html">Cadastro de Clientes
    </SELECT>
    </FORM>

    Repare que o exemplo acima nada mais é que um simples menu SELECT, onde, em cada tag OPTION é colocada a URL da página ou website de destino.
    Vale notar que o tag FORM deve apontar para o local em seu servidor onde será instalado o arquivo LINK.CGI.
    Se seu website opera sob Frames, basta incluir no tag FORM o comando TARGET apontando para o frame de destino.

  • LINK.CGI: Só há duas alterações a serem feitas no arquivo LINK.CGI.
    Abra o arquivo em seu editor de textos preferido e, logo na primeira linha do programa, verifique se a instrução aponta para o interpretador Perl de seu servidor.
    O valor que está no programa é aceito pela maioria dos servidores (As mais comuns são #!usr/bin/perl e #!usr/local/bin/perl. Para ter certeza, digite, via telnet, o seguinte comando: whereis perl. O resultado é a correta localização do Perl, que deve ser inserida no inicio do programa).

    Em seguida, localize a área com os textos abaixo:

    ######## Altere o texto entre as aspas para a URL ou IP
    ######## dos sites que podem acessar este programa
    @permitidos=("http://www.e-medica.com.br", "http://209.143.133.50");

    Como está descrito nas primeiras linhas do código, substitua o texto pré-existente pela URL ou IP dos websites que poderão se utilizar do programa.
    Repare que um único script pode atender vários websites.
    Se você não pretende restringir o uso do programa basta deixar o espaço entre aspas vazio - ex.:("").
    Porém, se você pretende ampliar a quantidade de sites, basta incluir a nova URL ou IP entre aspas e separar das demais com uma vírgula - Ex: @permitidos=("site1","site2","site3","site4"). Nota: relacionar os websites que poderão usar o programa é uma medida de segurança que deve sempre ser considerada. Nossa recomendação é que seja usada.

    Instalação

    Faça o up-load dos arquivos para seu servidor. As páginas HTML devem ser instaladas normalmente. Atenção especial deve ser tomada na instalação do programa LINK.CGI.
    Faça o up-load do programa com o modo ASCII habilitado (as opções diponíveis nos programas de FTP são ASCII, Binary e Auto).
    Após o up-load, será necessário alterar a permissão Unix do arquivo LINK.CGI.
    Para isto, você pode se utilizar de um programa de Telnet ou de um programa de FTP com este recurso.

    FTP: Um programa de FTP conhecido, e que permite alterar permissões é o CuteFTP.
    Para tanto, basta acessar o arquivo com este programa e clicar sobre ele com o botão direito do mouse.
    Feito isto, selecione a opção "Change File Attributes".
    Na janela que surgir, digite o número 755 no campo "Manual".
    Pronto. Agora, teste o programa.

    TELNET: Se você prefere alterar a permissão com um programa telnet, nossa sugestão é o programa TELNET.EXE, que se encontra no diretório WINDOWS de seu computador. Conecte-se com seu servidor a acesse a pasta onde se encontra o arquivo LINK.CGI.
    Feito isto, digite "chmod 755 link.cgi".
    Pronto. O sistema está pronto para usar!

    Algumas Dicas:

  • Antes de iniciar a instalação, consulte a área de suporte de seu servidor. Lá você encontrará informações importantes para configurar e instalar seu programa.
  • Esteja atento ao uso de letras maiúsculas ou minúsculas. Os sistemas são sensíveis a estas diferenças, portanto, a palavra "texto" é diferente de "Texto" ou de "TEXTO". Use sempre um único padrão.
  • Nem todo servidor possui acesso via Telnet. Se este for seu caso, providencie o programa CuteFTP para alterar as permissões Unix de seu programa.
  • Alguns servidores só permitem que programas funcionem em pastas específicas como "CGI-BIN". Verifique este detalhe antes de iniciar a instalação.
  • Só faça up-load de programas CGI no modo ASCII. Alguns programas representam o modo ASCII com uma letra (A, L...).
  • As permissões Unix podem ser apresentadas como números (755, 777...) ou combinações das letras r, w e x. Exemplo: 755 = rwx-rx-x, 777 = rwx-rwx-rwx

    SOLUÇÃO DE PROBLEMAS

    Alguns problemas inesperados podem ocorrer quando você testar o funcionamento de seu programa. Abaixo estão os problemas mais comuns
    Lembre-se: antes de solicitar o suporte, verifique as instruções abaixo.

  • 500 Internal Server Error - Ocorreu um erro no servidor. Verifique a permissão do arquivo, que deve ser 755. Atente para o fato de ter feito o up-load no modo ASCII e não haver tocado nas linhas do programa.
    Outro problema possível pode estar na primeira linha do programa, que indica a localização do interpretador Perl. As mais comuns são #!usr/bin/perl e #!usr/local/bin/perl. Para ter certeza, digite, via telnet, o seguinte comando: whereis perl. O resultado é a correta localização do Perl, que deve ser inserida no inicio do programa.

  • 403 Forbidden - A permissão Unix atribuída ao programa não permite que ele execute suas funções. Altere a permissão para 755.

  • 404 Not Found - Este erro está na página HTML e pode estar associado à localização do arquivo LINK.cgi no servidor ou ao endereçamento dos links.
    Verifique se o tag FORM aponta para o local exato onde se encontra o programa LINK.CGI
    Veja também se os links estão todos em ordem. Um modo de evitar confusões é inserir a URL completa em cada tag OPTION.
    por exemplo, ao invés de usar uma URL parcial como
    "<OPTION VALUE=pasta/arquivo.html>",
    use a URL completa
    "<OPTION VALUE=http://www.dominio.com.br/pasta/arquivo.html>"

    O Programa surge como página de texto - Altere a permissão do programa para 755.