ke_search Premium para TYPO3

Busca enterprise sem servidor Solr é possível com ke_search Premium no TYPO3

A busca interna de um site é a funcionalidade mais usada e menos mantida. Visitantes esperam autocomplete, tolerância a erros de digitação e a capacidade de pesquisar não apenas páginas, mas também PDFs e documentos Office. ke_search Premium entrega exatamente isso para TYPO3, sem que um servidor Solr ou Elasticsearch externo precise ser operado. Todos os dados ficam no banco de dados TYPO3, o índice é atualizado pelo Scheduler, e a administração permanece no backend TYPO3.

Para sites de médio porte com 500 a 5.000 páginas e alguns downloads de arquivo, ke_search Premium é a solução de busca mais econômica no ecossistema TYPO3. Somente a partir de mais de 10.000 documentos indexados ou com requisitos de tempo de resposta sub-segundo o Solr se torna a melhor escolha.

Cenários típicos de uso vão de sites corporativos a portais de conhecimento

O cenário padrão é o site corporativo com catálogo de produtos, revista, FAQ e área de downloads. Visitantes buscam por nomes de produto, termos técnicos ou documentos e esperam resultados de todas as áreas em uma única lista de resultados. ke_search indexa conteúdos de página, artigos de notícias, downloads (PDF, DOCX, XLSX) e registros customizados como produtos ou perfis de funcionários. A função autocomplete da versão Premium mostra sugestões já durante a digitação e reduz a taxa de abandono de busca em estimados 15 a 25%.

Segundo cenário: portais de conhecimento e coleções de documentos. Universidades, associações e instituições públicas frequentemente disponibilizam centenas de PDFs para download. Sem indexação de arquivos, a busca TYPO3 pesquisa apenas os textos das páginas, não o conteúdo dos PDFs. Já na versão gratuita, o ke_search extrai o texto de PDF, DOCX e outros formatos e o torna pesquisável.

Terceiro cenário: indexadores customizados para sistemas de terceiros. Empresas com PIM, DAM ou catálogo de produtos externo podem integrar fontes de dados arbitrárias no índice de busca via a API de indexador customizado.

Arquitetura técnica usa o banco de dados TYPO3 como índice de busca

ke_search armazena o índice em uma tabela dedicada (tx_kesearch_index) no banco de dados TYPO3. Cada entrada de índice contém título, conteúdo, tags, tipo e informações de ordenação. A indexação roda via tarefas Scheduler em intervalos configuráveis (típico: noturno). Indexação de arquivos e indexadores próprios já vêm na versão gratuita; a versão Premium acrescenta, entre outros, autocomplete, sinônimos, sugestões “Você quis dizer?” e ranking personalizado.

A indexação de arquivos usa pdftotext e pdfinfo para PDFs e catdoc, catppt e xls2csv para formatos Office mais antigos; DOCX, PPTX e XLSX o ke_search lê sem ferramenta adicional. Essas ferramentas devem estar instaladas no servidor, o que em ambientes de hosting compartilhado pode ser um problema. Em servidores dedicados e containers Docker, a instalação é trivial.

A consulta de busca no frontend usa a busca de texto completo do MySQL ou MariaDB (MATCH … AGAINST) sobre um índice FULLTEXT que o próprio ke_search cria na tabela tx_kesearch_index. Um índice adicional nas colunas relevantes não é necessário.

Autocomplete é realizado via endpoint AJAX e sugere termos que outros visitantes já usaram e que trouxeram resultados. Os resultados são entregues como JSON e exibidos no frontend via JavaScript como dropdown.

Problemas frequentes envolvem tempo de indexação, instalação de pdftotext ausente e ordenação por relevância

Problema um: tempos longos de indexação em grandes volumes de dados. Um site com 3.000 páginas e 500 PDFs pode levar 30 a 60 minutos para uma reindexação completa. A solução: ativar indexação incremental que reindexia apenas conteúdos alterados.

Problema dois: instalação de pdftotext ausente. Sem essa ferramenta, os PDFs não chegam ao índice, e o ke_search registra isso apenas no log. Editores carregam PDFs que nunca chegam ao índice de busca. A solução: após a instalação, iniciar uma execução de indexação de teste e verificar se conteúdos PDF aparecem no índice.

Problema três: ordenação por relevância. A ordenação padrão é baseada em um algoritmo de scoring simples que pondera resultados em títulos mais que resultados no body. Para requisitos complexos (boosting por atualidade, por tipo de página ou por campos customizados), a versão Premium oferece ranking personalizado e boost keywords; o peso do título na versão básica é definido na configuração da extensão.

As versões atuais suportam TYPO3 v13 e v14, para v12 existe a série 6.x

ke_search é mantida por uma equipe dedicada de desenvolvedores e está disponível de forma compatível prontamente a cada release LTS TYPO3. As versões 7.x atuais do ke_search e do ke_search Premium suportam TYPO3 v13 e v14; para TYPO3 v12 existem as versões 6.x. A Gosign utiliza ke_search Premium em projetos TYPO3 que precisam de busca interna mas não justificam a operação de um servidor Solr.