A pesquisa interna ajuda os visitantes a encontrar conteúdos do site, mas colocar um campo de pesquisa não garante que toda a informação seja pesquisável. O resultado depende dos campos, tipos de conteúdo e configurações em uso no WordPress.
Neste artigo
O que encontra a pesquisa do WordPress?
Por omissão, a pesquisa do WordPress consulta o título, o excerto e o conteúdo, como documenta post_search_columns. Campos personalizados, referências de produto como SKU e texto dentro de ficheiros não ficam automaticamente abrangidos por colocar um campo de pesquisa.

O tema, as extensões e os filtros podem alterar esse comportamento. Os tipos de conteúdo também podem ser excluídos da pesquisa; confirme a configuração efetiva antes de tirar conclusões.
Como tornar um PDF encontrável sem trocar de motor?
Um PDF carregado na Biblioteca Multimédia não torna o seu texto pesquisável pelo formulário nativo. O WordPress procura nos campos de título, excerto e conteúdo; o texto que está dentro do ficheiro não passa automaticamente para esses campos. Se o visitante precisa apenas de encontrar um documento público, comece por uma página HTML que lhe dê contexto.
Por exemplo, para disponibilizar um manual público, publique uma página com o nome do equipamento, os modelos abrangidos e a versão do manual. Inclua uma ligação que diga que documento abre, em vez de um «Clique aqui» isolado. Na pesquisa interna, teste o nome usado pelo público e uma referência incluída na página: ambos devem levar à página certa, de onde se pode abrir o manual correto.
Se o requisito for encontrar palavras dentro de muitos PDFs, teste a extração de texto antes de escolher a solução. Abra documentos de amostra e veja se consegue selecionar e copiar um termo. Uma digitalização composta só por imagens pode precisar de reconhecimento ótico de caracteres (OCR). Faça o ensaio com documentos públicos e confirme se a ferramenta processa os ficheiros no próprio site ou os envia para fora. Teste ainda se, ao substituir o ficheiro, o texto da versão anterior deixa de gerar resultados.
Como colocar o campo de pesquisa no WordPress?
Para inserir o campo numa página, abra Páginas, edite a página e use o botão + para procurar o bloco Pesquisa. Configure um rótulo visível, por exemplo «Pesquisar no site», e escolha a apresentação do botão. O texto de exemplo dentro do campo não substitui o rótulo. A documentação do bloco Pesquisa explica as opções de apresentação.

Para um campo partilhado no cabeçalho, num tema de blocos use Apresentação → Editor e abra o cabeçalho utilizado pelos modelos relevantes. Confirme onde essa parte é reutilizada antes de guardar: a alteração pode afetar várias páginas. Num tema clássico, a localização depende das áreas de widgets e das opções do tema; não é necessário trocar de tema só para adicionar pesquisa.
Porque é que uma página publicada não aparece na pesquisa do WordPress?
Se a pesquisa interna não devolve uma página publicada, confirme primeiro se o termo consta de um campo pesquisado, se o tipo de conteúdo está incluído e se a página é pública. Um resultado vazio também pode indicar um problema de apresentação, pelo que não convém assumir a causa.
Compare o formulário visível com um pedido de pesquisa normal, por exemplo https://oseudominio.pt/?s=termo, substituindo domínio e termo por valores autorizados. Se o pedido normal encontra a página mas o formulário não, investigue o destino, filtros e apresentação desse formulário. Se ambos falham, registe o campo e o tipo de conteúdo antes de pedir análise técnica. Não use nomes de clientes, emails ou números de encomenda como termos de ensaio.
Se a lista surge, mas faltam títulos, excertos ou paginação, o problema pode estar no modelo dos resultados. Em temas de blocos, consulte Apresentação → Editor → Modelos e procure Pesquisa, quando disponível. O editor de modelos controla a apresentação de todas as páginas que usam esse modelo; reveja o âmbito da gravação. Alterar a aparência do campo não repara, por si só, a consulta ou o modelo de resultados.

Ficha de teste da pesquisa interna
| Campo | Registo a preencher |
|---|---|
| Termo de teste, sem dados pessoais | ________________ |
| Página esperada e campo onde consta o termo | ________________ |
| Tipo de conteúdo e estado público | ________________ |
| Resultado observado | ________________ |
| Ambiente e decisão após o teste | ________________ |
Por exemplo, numa empresa hipotética, uma página publicada contém uma referência apenas num campo personalizado. Se esse campo não estiver abrangido, a referência pode não devolver a página. Registe o caso e o resultado observado antes de alterar a configuração.
Porque aparecem sempre os mesmos resultados ou uma zona vazia?
Se o modelo de pesquisa usa o bloco Ciclo de consulta (Query Loop), confirme com o responsável pelo site se está a seguir a consulta do modelo. A opção Predefinida / Default herda o contexto; uma consulta Personalizada / Custom pode apresentar uma seleção própria em vez da pesquisa do visitante. Não mude para Custom apenas para fazer aparecer filtros. A documentação do Ciclo de consulta distingue essas configurações. Compare dois termos públicos que devam devolver páginas diferentes antes de aceitar o resultado.
Para uma pesquisa sem correspondências, esse bloco permite uma área Sem resultados / No Results, mostrada quando a consulta não encontra conteúdos. Em vez de deixar uma zona vazia, escreva uma mensagem clara e ofereça nova pesquisa ou uma ligação útil para a navegação. Por exemplo: «Não encontrámos conteúdos para esta pesquisa. Experimente outra expressão ou consulte os serviços.» É um exemplo de texto, não uma mensagem que já esteja instalada no seu site. Teste também um termo sem correspondência e confirme que o formulário continua utilizável por teclado.
Se os resultados aparecem mas não abrem o conteúdo, selecione o bloco Título dentro do Modelo de artigo do Ciclo de consulta e ative a opção de tornar o título uma ligação. Faça o mesmo na imagem destacada se quiser usá-la como ligação. Estas opções não estão ativas em todos os esquemas, como explica a documentação do Ciclo de consulta.
Porque é que a página certa aparece demasiado abaixo?
A pesquisa interna pode encontrar a página certa e ainda assim colocá-la atrás de resultados pouco úteis. No núcleo do WordPress, uma correspondência no título pode ter prioridade sobre uma correspondência apenas no excerto ou no corpo, conforme os termos da consulta. É o que mostra a lógica de ordenação de WP_Query. O tema ou uma extensão podem usar outra ordem.
Imagine que «trocas e devoluções» devolve primeiro uma notícia antiga, mas a política atual aparece ao pesquisar «condições de devolução». Compare os títulos e os excertos tal como aparecem nos resultados. Se o nome da página atual for vago, dê-lhe um título que identifique o assunto para quem o procura. Se os nomes já forem claros, peça ao responsável técnico para verificar se a consulta está a ordenar por data em vez de relevância. Não duplique páginas para tentar ganhar posições.
Registe a posição do resultado esperado, e não apenas se apareceu. Um resultado na segunda página passa num teste de presença, mas pode falhar o objetivo de ser encontrado sem navegar mais.
O que fazer quando a pesquisa interna mostra dados antigos?
Comece por abrir o endereço do conteúdo e compará-lo com o que aparece na pesquisa interna. Use uma palavra pública que só exista na versão nova e outra que tenha sido retirada. Se a página e os resultados mostram a versão antiga, confirme primeiro se consultou o endereço certo e se a alteração foi publicada. Se a página já está atualizada, a investigação passa para o motor de pesquisa e para a apresentação dos resultados.
Quando existe um índice separado, veja se a atualização ainda está pendente antes de o reconstruir. A página de estado do índice da extensão WooCommerce Product Search, por exemplo, permite verificar a evolução da indexação; enquanto houver entradas por processar, podem faltar produtos que correspondem à consulta. Confirme o estado no motor que usa e repita os termos quando o processamento ficar concluído.
Se o motor já devolve o destino certo, mas a página mostra um excerto antigo ou as sugestões apresentam um nome desatualizado, isole a etapa que diverge. Compare sugestões e resultados depois de enviar a consulta, numa sessão anónima. Peça ao responsável técnico para verificar se existe uma cópia em cache desse componente antes de limpar a cache de todo o site. Reteste também a segunda página: atualizar a primeira não demonstra que as restantes ficaram corretas.
Em que difere a pesquisa interna da pesquisa no Google?
Não. Encontrar uma página no Google e encontrá-la no formulário do site são verificações distintas. Um resultado no Google não prova que esse tipo de conteúdo está incluído na consulta interna do WordPress. Da mesma forma, um resultado interno não confirma indexação externa. Não altere permissões nem remova proteções para tentar resolver uma falha de pesquisa.
Se a dúvida é sobre visibilidade externa, siga o guia verificar se o site está indexado no Google. Se a dúvida é sobre navegação dentro do site, mantenha o diagnóstico no formulário, campos abrangidos e modelo de resultados. Esta separação evita instalar uma extensão de pesquisa para um problema que pertence a outro sistema.
A pesquisa interna deve misturar produtos e páginas de apoio?
Num site com WooCommerce, alguém que escreve o nome de um produto na loja espera encontrar o catálogo; no cabeçalho geral, pode estar à procura de instruções, entregas ou assistência. Se tiver dois campos, use rótulos que expliquem o âmbito, por exemplo «Pesquisar produtos» e «Pesquisar em todo o site». Teste cada formulário no destino real, não apenas no editor.
Se os clientes compram por referência, experimente separadamente um SKU de produto simples e um SKU de variação. Registe se cada termo devolve o produto certo e se o visitante consegue identificar a opção correspondente ao abrir o resultado. Um acerto no produto principal não prova que todas as variações sejam pesquisáveis. O campo da extensão WooCommerce Product Search, por exemplo, permite configurar a correspondência por SKU. Essa documentação descreve a extensão específica, não uma garantia para o formulário do seu site.
Se houver sugestões enquanto se escreve, confirme o que acontece ao carregar em Enter sem escolher uma sugestão. A escolha de um resultado e o envio da consulta são percursos diferentes: o cliente deve poder concluir a pesquisa por teclado sem depender da lista de sugestões.
Quando vale a pena instalar uma extensão de pesquisa interna?
Comece por verificar se a solução existente cobre o requisito. A opção exclude_from_search influencia a inclusão de um tipo de conteúdo nos resultados, segundo register_post_type. Não é um controlo de autorização: um conteúdo excluído da pesquisa pode continuar acessível pelo endereço direto. Não altere código às cegas para corrigir uma ausência.

Critérios para decidir
Escreva o requisito de forma verificável: «a referência de teste presente no campo X deve devolver a página Y a um visitante anónimo». Se precisar de sinónimos, tolerância a erros, filtros ou pesquisa em documentos, confirme explicitamente o suporte de cada capacidade e os respetivos limites. Se a solução mantiver um índice próprio, pergunte como o atualiza e como remove conteúdos que deixaram de ser públicos. Inclua custos, manutenção, destino dos dados pesquisados e procedimento de desativação na decisão.
O conteúdo devia estar abrangido?
Confirme a configuração do tipo de conteúdo e eventuais alterações do tema ou de extensões antes de acrescentar outra solução.
É preciso pesquisar campos adicionais?
Avalie se uma extensão suporta os campos e tipos de conteúdo necessários e se é compatível com o site.
Se o requisito obrigar a desenvolvimento, use os critérios do guia plugin WordPress personalizado ou extensão existente para definir responsabilidade, manutenção e saída. Não escolha pela quantidade de funcionalidades anunciadas: peça uma demonstração dos seus casos de pesquisa num ambiente isolado.
Como comparar a configuração atual com uma alternativa?
Antes de instalar uma extensão para a pesquisa interna, escolha um conjunto pequeno de consultas representativas e escreva o que deve acontecer em cada uma. A equipa de atendimento pode indicar palavras que os clientes usam, sem copiar conversas, contactos ou referências de encomenda. Use a ficha acima para repetir os mesmos casos no mesmo catálogo ou conjunto de páginas, primeiro com a configuração atual e depois com a alternativa em testes.
Num ensaio hipotético, «horário» deve devolver a página de contactos logo na primeira página; «trocas» deve levar à política em vigor, não a uma campanha antiga; uma referência fictícia deve encontrar o produto correspondente pelo SKU; e uma palavra inventada deve mostrar a mensagem de ausência de resultados. Anote em que posição apareceu cada resultado esperado e se o respetivo link abriu o destino certo.
Compare os casos individualmente. Se a alternativa resolver a pesquisa por referências mas esconder as páginas de apoio, pode fazer sentido aplicá-la apenas ao catálogo. Se a única falha remanescente for um termo pouco claro no título de uma página pública, corrija esse conteúdo e repita o caso antes de assumir mais uma dependência técnica.
Como testar a pesquisa interna sem expor conteúdo privado?
Para decidir como testar a pesquisa interna sem expor conteúdo privado, use termos de teste sem dados pessoais e compare o que cada sessão pode encontrar e abrir. Retirar uma página dos resultados não substitui o controlo de acesso.

Distinga conteúdo privado de conteúdo protegido por palavra-passe: neste último, o título pode continuar visível, mesmo quando o texto exige uma palavra-passe. A documentação de visibilidade do WordPress explica a diferença. Num ambiente de testes, use um título e um excerto fictícios para verificar o que aparece nos resultados; não inclua informação confidencial nesses campos.
Verificação antes de publicar alterações
- Confirmar o rótulo visível, o uso por teclado e a apresentação no telemóvel.
- Verificar o destino e a apresentação dos resultados com e sem correspondências; se houver várias páginas, avançar e recuar sem perder o termo pesquisado.
- Comparar uma pesquisa anónima com outra feita por uma conta autorizada.
- Confirmar que o acesso a conteúdos privados está protegido, mesmo conhecendo o endereço.
- Testar alterações técnicas num ambiente de testes e preparar uma reversão que preserve encomendas recentes.
Antes de mudanças técnicas, faça uma cópia de segurança e teste num ambiente separado do site público, conhecido como staging. Planeie uma reversão dirigida que preserve encomendas recentes; WordPress — cópias de segurança explica o que incluir na preparação.
Considere a alteração validada apenas quando os casos registados devolvem os conteúdos esperados, os resultados negativos são compreensíveis e os acessos continuam protegidos. Guarde a data, o responsável e as exceções aceites; repetir os mesmos casos após uma mudança de tema ou extensão permite detetar regressões sem inventar métricas de sucesso.