Find para TYPO3

A busca integrada do TYPO3 funciona até 500 páginas, depois é necessário Solr

A busca padrão do TYPO3 (EXT:indexed_search) pesquisa o output HTML renderizado e o armazena em uma tabela de banco de dados. Para sites pequenos com 50 a 500 páginas, funciona. A partir de 1.000 páginas, a busca fica lenta (tempos de resposta acima de 2 segundos), a partir de 5.000 páginas, inutilizável. EXT:find é uma extensão de busca baseada em Solr que oferece uma alternativa ao stack EXT:solr estabelecido: configuração mais flexível, query builder próprio e uma abordagem diferente para busca facetada.

A decisão entre EXT:find e EXT:solr não é uma questão de qualidade, mas de arquitetura. EXT:solr tem a comunidade maior e mais funcionalidades out-of-the-box. EXT:find oferece mais flexibilidade na configuração de queries e é adequada para projetos com requisitos de busca incomuns.

Cenários típicos de uso

Portais especializados com busca específica de domínio. Um portal jurídico com 15.000 documentos precisa de busca por parágrafos, números de processo e palavras-chave simultaneamente. EXT:find permite a definição de diferentes tipos de query por campo de busca: busca exata para números de processo, busca fuzzy para texto livre, filtro de faixa para campos de data. Em uma editora especializada com 22.000 documentos, EXT:find entregou resultados de busca em menos de 100 milissegundos, independente da complexidade da filtragem.

Busca e-commerce com atributos de produto. Produtos têm atributos (cor, tamanho, peso, preço) que servem como facetas na busca. Um visitante busca “parafuso M8”, filtra por material “aço inoxidável” e preço “até 5 EUR”. EXT:find mapeia essas facetas diretamente em campos Solr e gera a navegação de filtros automaticamente a partir da configuração Solr.

Busca fulltext multilíngue. Sites internacionais precisam de busca que considere particularidades linguísticas: compostos alemães, declinação polonesa, acentos espanhóis, caracteres portugueses. Solr traz analisadores linguísticos para mais de 30 idiomas. EXT:find configura o analisador adequado por idioma e cria cores Solr específicos por idioma.

Arquitetura técnica

EXT:find comunica com um servidor Apache Solr via HTTP/JSON. A arquitetura consiste em três componentes: o servidor Solr (indexação e busca), o indexador (escreve conteúdos TYPO3 no Solr) e o plugin frontend (entrada de busca, resultados, facetas).

O indexador percorre a estrutura de páginas TYPO3 e envia o conteúdo de cada página como documento JSON ao Solr. Não apenas os conteúdos visíveis são indexados, mas também metadados: título da página, descrição, categorias, palavras-chave e campos customizados. A indexação roda como tarefa Scheduler (recomendado: após cada atualização de conteúdo ou à noite como índice completo).

EXT:find se diferencia de EXT:solr na camada de query. Em vez de uma estrutura fixa de consulta de busca, find oferece um query builder configurável: via TypoScript ou FlexForm pode-se definir quais campos Solr são pesquisados, com qual ponderação (boosting), quais filtros são aplicados automaticamente e como os resultados são ordenados.

A configuração de facetas ocorre via definições de campo Solr. Cada campo que deve servir como faceta precisa estar definido como campo facet na configuração do schema Solr. EXT:find lê as facetas disponíveis da configuração Solr e as renderiza como menu de filtro no frontend. Os filtros funcionam por parâmetros GET, o que permite URLs amigáveis ao SEO para páginas de resultados filtradas.

Problemas frequentes e soluções

Setup e manutenção do servidor Solr. Solr é um servidor baseado em Java que precisa ser operado separadamente. Para agências TYPO3 sem experiência Java, o setup é um obstáculo: configuração JVM, gestão de Solr Core, atualização de schema, monitoramento. Solução: usar Solr gerenciado (p.ex. Websolr, SearchStax) ou operar Solr como container Docker. A imagem Docker oficial do Solr reduz o setup a 3 comandos.

Qualidade da busca é ruim. Visitantes buscam “contato” e encontram 200 resultados, porque a palavra está em cada página no footer. Solução: configurar ponderação de campos. Resultados no título são ponderados 10x mais que resultados no body, resultados em H2 5x mais que texto corrido. EXT:find permite essa ponderação via TypoScript: plugin.tx_find.settings.boostFields.title = 10.

Índice não é atualizado. Editores alteram conteúdo, mas a busca mostra resultados antigos. Causa: a tarefa Scheduler do indexador não está rodando ou falhou. Solução: definir a tarefa Scheduler para intervalos curtos (a cada 15 minutos para índice delta, à noite para índice completo) e configurar um alerta de monitoramento que notifique em caso de erros de índice.

Migração e compatibilidade de versões

EXT:find suporta TYPO3 v10 e v11 com Solr 8 e 9. Para TYPO3 v12 existe uma versão beta no GitHub. A extensão é mantida pela equipe de pesquisa e desenvolvimento da SUB Göttingen e tem uma base de usuários acadêmica.

EXT:solr é a alternativa mais popular com suporte oficial v12 e opções de suporte comercial (dkd Internet Service GmbH). Para a maioria dos projetos TYPO3, EXT:solr é a escolha segura. EXT:find é recomendada para projetos com requisitos especiais de query (busca acadêmica, bancos de dados especializados, cenários multi-índice).

A migração de EXT:indexed_search para Solr (tanto find quanto solr) requer: configurar servidor Solr, configurar schema, indexar conteúdo e adaptar templates frontend. O esforço é de 3 a 5 dias para um site padrão e 1 a 2 semanas para portais complexos. A Gosign orienta sobre o stack de busca adequado e assume setup, configuração e ajuste fino da qualidade de busca.