A MDR Web Hosting disponibiliza o instalador do MiniSearch, um script CGI desenvolvido em Perl, sem nenhum custo adicional para seus clientes. O MiniSearch é um software gratuito, desenvolvido sob uma licença chamada GPL que significa GNU Public License, que em síntese permite que você utilize os programas desenvolvidos sob esta licença como desejar. Para maiores informações sobre o MiniSearch, consulte o site de seu autor em http://www.dansteinman.com/minisearch/.

O funcionamento é bem simples e semelhante a um site de buscas convencional. Mas alguns recursos interessantes estão presentes, como busca booleana (buscas que usem os operadores lógicos "E" e "OU"). O administrador dispõe de uma interface de adiministração que permite criar facilmente o índice de palavras a serem pesquisadas, especificar diretórios onde a busca não será efetuada dentre outras coisas.
Note que o suporte técnico da MDR Web Hosting não cobre suporte técnico referente à personalização do sistema de busca e/ou quaisquer outras modificações no código, limitando-se apenas a auxiliar na reinstalação do aplicativo. Porém, dada a natureza da licença do programa, o usuário é livre para modificá-lo de modo que atenda suas necessidades.

Instalação do MiniSearch

Para instalar o MiniSearch, basta seguir os seguintes passos:

1. Entre no Painel de Controle (http://painel.seudominio.com.br)
2. Clique no ícone Mecanismo de Busca.
3. Na opção Nome de arquivo de pesquisa, pode-se definir o nome da página de busca. O padrão é pesquisa.htm. Caso queira sobrescrever um arquivo pré-existente, basta marcar a opção "Sobreescrever arquivo com mesmo nome?".
4. Marque as opções apropriadas quanto à instalação ou reinstalação e se deverá remover as antigas configurações em caso de uma eventual reinstalação.
5. Clique em prosseguir.

A página a seguir exibe um relatório da instalação e configuração do programa. Basta clicar nos links resultantes para visualizar o sistema de busca completamente funcional.

Nota: É importante lembrar que você deverá entrar na Administração do MiniSearch antes, para criar um índice de arquivos que serão procurados. Sem isso, o resultado de busca não irá retornar resultado.

Administração do MiniSearch

Acesse http://seudominio.com.br/cgi-local/searchindex.pl

A interface de administração do MiniSearch permite que você defina todas as opções pertinentes ao sistema de busca. Porém, a primeira opção a ser alterada deverá ser, conforme recomendado pelo próprio script, a senha de acesso. Note que a alteração de senha é imprescindível, pois a senha padrão é a mesma para todos os clientes da MDR Web Hosting.
Os ítens a seguir listam os recursos disponíveis acompanhados de maiores detalhes a respeito:

Informação do Índice Atual: É uma tabela informativa sobre a quantidade de arquivos indexados e a quantidade de palavras indexadas. O sistema irá procurar pelas palavras que constam na lista de palavras dentro dos arquivos listados. É importante ressaltar que a indexação e busca só serão realizados em arquivos HTML, HTM e SHTML

(Re) Indexar o Site: Ao clicar neste botão, as listas de arquivos e de palavras serão criadas (ou recriadas). A página que aparece em seguida exibe um relatório detalhado e estatístico deste comando. Note que o tempo que leva para criar o índice de palavras pode variar de acordo com a quantidade de arquivos a serem pesquisados.

Exclusão de arquivos: Pode-se excluir os índice de palavras e arquivo de configuração através desta opção. É recomendável no caso de uma reconfiguração completa das opções na interface de administração, pois a reindexação recria e sobrescreve o índice de palavras automaticamente.

Configuração: É a tabela mais significativa na interface de administração.

Nova senha do Admin: É onde deve-se alterar a senha padrão criada pelo script. Após a alteração da senha, deve-se clicar no botão "Salvar Configuração". O script irá encerrar e solicitar a senha novamente para permitir acesso à interface.

Procura Recursiva: Permite a pesquisa de arquivos recursivamente, englobando diretórios e subdiretórios. O padrão (e opção recomendável) é SIM. Se você deseja que a busca não seja feita em todos os diretórios, escolha NÃO ou escolha SIM mas tenha certeza de não incluir a raiz "/" nos diretórios a serem indexados.

Diretórios de Busca: Permite especificar os diretórios onde a busca será efetuada. Pode-se selecionar a opção "Todos os diretórios" ou "Apenas os diretórios selecionados". No último caso, basta selecionar o diretório desejado na caixa de lista e clicar no botão "Adicionar" até acrescentar todos os diretórios que desejar. A opção padrão é "Todos os diretórios".
Caso queira excluir determinados diretórios da busca, é mais interessante utilizar a próxima opção.

Diretórios Excluídos da Busca: Permite especificar os diretórios onde a busca NÃO será efetuada. É importante, pois determinados diretórios não devem ser incluídos na busca - como por exemplo, diretórios onde estão arquivos de script. Alguns diretórios já vêm marcados como excluídos por padrão, como o diretório cgi-local (exclusivo para scripts) e alguns outros para extensões do Microsoft FrontPage. A inclusão de diretórios para exclusão funciona do mesmo modo que na opção anterior.

Não deixe que arquivos renomeados (antigos) permaneçam nos diretórios que entrarão na busca, como aqueles old_arquivo.html

Modelos: Especifica o caminho onde estão localizados os arquivos-gabarito. Personalizando estes arquivos (ou especificando outros) pode-se mudar a aparência da interface de busca. Para fazer tal alteração, basta modificar os arquivos-gabarito que estão em /cgi-bin/searchdata/templates/ usando um editor de páginas HTML qualquer.

Importante - Note que o suporte técnico da MDR Web Hosting não cobre suporte técnico referente à personalização do sistema de busca e/ou quaisquer outras modificações no código, limitando-se apenas a auxiliar na reinstalação do aplicativo. Porém, dada a natureza da licença do programa, o usuário é livre para modificá-lo de modo que atenda suas necessidades.

Quaisquer alterações feitas na seção Configurações só fazem efeito após
clicar no botão "Salvar Configuração".

Isto é tudo. Para ver o script funcionando, basta acessar a página de busca criada durante a instalação (Se você não alterou a página padrão durante a instalação, basta acessar http://www.seudomínio.com.br/pesquisa.htm).

Pesquisa

Para efetuar pesquisas, acesse a página de pesquisa criada durante a instalação, normalmente chamada pesquisa.htm.
O funcionamento é idêntico ao dos grandes sites de busca como o Yahoo, o Altavista e o Excite por exemplo. A diferença é que a pesquisa só será efetuada em arquivos residentes no seu domínio.

As opções disponíveis são:

Pesquisar por: Palavra ou palavras a serem pesquisadas. O resultado da pesquisa vai variar de acordo com a opção escolhida no item a seguir.

Método: Especifica o método de busca. Pode ser Todas as palavras (Operador lógico "E") ou Qualquer palavra (Operador lógico "OU"). Por exemplo: Se o usuário digitar "lazer esporte" (sem aspas), ao escolher Todas as palavras irá receber uma listagem com todas as páginas que contenham ocorrência das duas palavras. Ao escolher Qualquer palavra, irá receber uma lista possivelmente maior, cujas páginas contêm qualquer uma das duas palavras.

Onde procurar: Permite especficar os caminhos onde a busca será efetuada. O padrão é a opção - Tudo - .

Número de Resultados: Permite definir quantos resultados devem ser apresentados por página. Pode variar entre 10 resultados por página, 20 resultados por página ou Ilimitado, apresentando uma única página com todos os resultados da busca.

Após selecionar todas as opções, basta clicar em Procurar. Após a exibição dos resultados, basta clicar no link relacionado à página que deseja visualizar.

A aparência da página de busca pode ser modificada através da modificação dos modelos. Consulte a documentação referente à administração do MiniSearch para maiores detalhes.

Importante - Note que o suporte técnico da MDR Web Hosting não cobre suporte técnico referente à personalização do sistema de busca e/ou quaisquer outras modificações no código, limitando-se apenas a auxiliar na reinstalação do aplicativo. Porém, dada a natureza da licença do programa, o usuário é livre para modificá-lo de modo que atenda suas necessidades.