Pular para o conteúdo Pular para a barra lateral

Home » Documentação do WPML » Projetos relacionados » WPML ElasticPress – resultados de pesquisa multilíngue

WPML ElasticPress – exibir resultados de pesquisa multilíngue

O WPML ElasticPress permite que você exiba resultados relevantes e específicos para cada idioma em pesquisas feitas com o Elasticsearch.

Principais recursos

Gera índices para cada idioma, garantindo que os resultados de pesquisa e posts relacionados correspondam ao idioma dos visitantes do seu site

Estende as capacidades de pesquisa do ElasticPress para todos os idiomas do seu site com WPML

Integra-se perfeitamente com o painel de sincronização do ElasticPress para permitir a sincronização específica por idioma

Sincroniza e analisa o conteúdo em cada idioma para indexação e pesquisa precisas

Nesta página:

Plugins e configuração necessários

Comece instalando e ativando o seguinte:

Se você é novo no WPML, confira nosso Guia de Introdução.

Introdução ao Elasticsearch e ao ElasticPress

O Elasticsearch oferece uma maneira rápida e precisa de gerenciar seu conteúdo pesquisável. A ferramenta de código aberto indexa e categoriza seu conteúdo, permitindo que você analise uma ampla variedade de tipos de conteúdo, incluindo documentos de texto e dados numéricos e geoespaciais.

O ElasticPress integra seu site WordPress com o Elasticsearch para aprimorar as funcionalidades padrão de pesquisa, consulta e relevância de conteúdo do WordPress.

Se você tem um site com muitas informações, como uma loja WooCommerce ou um site de comunidade, você pode usar o ElasticPress para:

  • Criar uma pesquisa com resultados quase instantâneos, eliminando a sobrecarga no banco de dados do WordPress
  • Lidar com consultas complexas, incluindo pesquisas de texto completo e difusas
  • Adicionar pesos ao conteúdo para que o foco dos resultados da pesquisa seja nos dados de sua escolha
  • Analisar grandes volumes de dados para entender o comportamento e as tendências dos clientes em seu site

Depois de instalar o plugin ElasticPress e conectar-se a um servidor Elasticsearch, o plugin começa a indexar os dados do seu site. Isso significa que ele organiza todo o conteúdo do seu site (posts, páginas, produtos, etc.) em um formato que o Elasticsearch pode processar rapidamente.

O ElasticPress agrupa suas funcionalidades em recursos que você pode acessar acessando ElasticPress → Recursos.

O ElasticPress permite que você habilite uma série de recursos

Sincronização de conteúdo com o ElasticPress

O ElasticPress sincroniza automaticamente o conteúdo quando você o cria, atualiza ou exclui, garantindo que seu índice de pesquisa esteja sempre atualizado.

Em ElasticPress → Sync, você pode acessar adicionalmente as Configurações de Sincronização, que apresentam dois modos de indexação. Estes permitem que você indexe o conteúdo atual do seu site WordPress para o Elasticsearch ou exclua os dados existentes no seu índice Elasticsearch e crie um novo índice do zero com o conteúdo atual do seu site WordPress.

Como o WPML ElasticPress funciona

O WPML ElasticPress permite a funcionalidade de pesquisa multilíngue em seu site WordPress com WPML e ElasticPress. Ele analisa o conteúdo em seu idioma original, garantindo uma indexação precisa, e exibe conteúdo relevante aos usuários em seu idioma escolhido.

O WPML ElasticPress alcança isso gerando índices únicos e específicos para cada idioma:

  1. Documentos Relevantes: Cada índice inclui traduções para o idioma específico para todos os tipos de post definidos como traduzíveis. Para tipos de post configurados para exibir traduções, se disponíveis, ou recorrer ao idioma padrão, o índice inclui traduções para esse idioma mais posts no idioma padrão. Para posts não traduzíveis, cada índice de idioma inclui uma cópia de todos os itens.
  2. Análise de documentos específicos do idioma: Todos os documentos em um índice de idioma passam por análise e sincronização usando ferramentas, stopwords e stemming para esse idioma. Isso inclui cópias de posts no idioma padrão.
  3. Pool de Resultados de Pesquisa: Cada índice de idioma fornece um pool de resultados potenciais para solicitações de pesquisa no front-end, listas de posts relacionados e assim por diante.

Recursos suportados do ElasticPress

Atualmente, o WPML ElasticPress suporta os seguintes recursos do ElasticPress:

  • Pesquisa de Posts para pesquisas no front-end
  • Posts Relacionados, usando o widget fornecido pelo ElasticPress
  • Termos, Comentários e Usuários para pesquisas no backend
  • Recurso de Documentos para pesquisar em arquivos de texto anexados a posts e páginas

Começando com o WPML ElasticPress

Como o WPML ElasticPress gera índices para cada idioma, recomendamos que você reindexe seus posts após instalar o WPML ElasticPress e/ou após atualizar da versão 1.0 para 2.0 do WPML ElasticPress.
Por favor, note que se o seu site for grande, este processo pode levar algumas horas

Você pode fazer isso através do painel de administração do WordPress ou usando o seguinte comando:

wp wpml_elasticpress sync --setup --post-type=post

Sincronizando e indexando conteúdo com o WPML ElasticPress

O WPML ElasticPress integra-se diretamente com o painel de Sincronização em ElasticPress → Sync. Em vez de executar um único processo de sincronização, o plugin aciona várias sincronizações, uma para cada idioma em seu site multilíngue.

O WPML ElasticPress integra-se diretamente com a Sincronização do ElasticPress

Sempre que você cria, modifica ou exclui um post, o WPML ElasticPress mantém automaticamente o conteúdo relevante sincronizado. Ele atualiza os índices relevantes com base no idioma do conteúdo modificado ou na configuração de tradução para o tipo de post.

Indexação com WP-CLI

Se você tem um grande site multilíngue com muito conteúdo para indexar, pode preferir a indexação por linha de comando. O WPML ElasticPress inclui seu próprio comando CLI, wp wpml_elasticpress, que expande o comando wp elasticpress existente. Ele adiciona uma opção --post-lang para que você especifique os idiomas a serem sincronizados. Você pode listar vários idiomas separados por vírgulas. Por exemplo, wp wpml_elasticpress sync –post-lang=en,es sincronizará apenas o conteúdo em inglês e espanhol.

Os comandos úteis incluem:

  • wp wpml_elasticpress sync –setup: Exclui todos os índices existentes e reindexar todo o conteúdo.
  • wp wpml_elasticpress sync --per-page=200: Sincroniza todo o conteúdo em lotes de 200 itens por vez, em vez dos 350 itens padrão por lote definidos pelo ElasticPress.
  • wp wpml_elasticpress sync –post-type=post –post-lang=en,pt-pt: Indexa apenas posts em idiomas específicos. Nesse caso, inglês e português. Explicaremos a seguir como usar esse comando em detalhes.

Indexando apenas posts de idiomas específicos

O plugin de integração WPML ElasticPress também permite que você indexe apenas posts em idiomas específicos. Para fazer isso:

  1. Use o comando wp wpml_elasticpress sync --setup --post-type=post --post-lang=en para indexar posts em um determinado idioma (neste caso, inglês) e remover todos os índices existentes.
  2. Se você verificar o front-end do seu site agora, verá apenas posts em inglês nos resultados de pesquisa no site em inglês. Se você mudar de idioma, os resultados da pesquisa deverão ficar vazios.

Se você quiser indexar outros idiomas, repita a etapa 2. Certifique-se de pular o argumento –setup, caso contrário, você removerá os posts que já foram indexados).

Por exemplo, você poderia usar isso: wp wpml_elasticpress sync --post-type=post --post-lang=fr

Problemas conhecidos

Não há problemas de compatibilidade não resolvidos entre este plugin e o WPML. Pesquisar todos os problemas conhecidos.

Obtendo ajuda de nosso suporte

Caso precise de ajuda para usar o ElasticPress em seu site multilíngue, visite o fórum de suporte do WPML.

Atualizado
outubro 23, 2025