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 Premium 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 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. ke_search Premium 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). A versão Premium estende o indexador base com indexação de arquivos, autocomplete e indexador customizado.

A indexação de arquivos usa Apache Tika ou pdftotext para extração de texto de PDFs e catdoc para documentos Office. 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 funciona via busca LIKE no banco de dados com índice fulltext opcional. Para volumes menores de dados, a performance é suficiente; para índices maiores (5.000+ entradas), recomenda-se um índice fulltext MySQL nas colunas relevantes para manter o tempo de busca abaixo de 200ms.

Autocomplete é realizado via endpoint AJAX que a cada tecla pressionada executa uma busca PREFIX no índice. 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 Tika 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 Tika ou pdftotext ausente. Sem essas ferramentas, a indexação de arquivos falha silenciosamente, sem mensagem de erro. 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), o scoring deve ser adaptado via TypoScript.

TYPO3 v12 é completamente suportado, compatibilidade v13 está em desenvolvimento

ke_search é mantida por uma equipe dedicada de desenvolvedores e está disponível de forma compatível prontamente a cada release LTS TYPO3. A versão Premium atual suporta TYPO3 v11 e v12. Para v13, a compatibilidade está em desenvolvimento. 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.