Passer au contenu Passer à la barre latérale

Home » Documentation WPML » Projets connexes » WPML ElasticPress – résultats de recherche multilingues

WPML ElasticPress – affichage des résultats de recherche multilingues

WPML ElasticPress vous permet d’afficher des résultats pertinents et spécifiques à chaque langue pour les recherches effectuées avec Elasticsearch.

Fonctionnalités principales

Génère des index pour chaque langue, garantissant que les résultats de recherche et les articles associés correspondent à la langue des visiteurs de votre site

Étend les capacités de recherche d’ElasticPress à toutes les langues de votre site propulsé par WPML

S’intègre parfaitement au tableau de bord de synchronisation d’ElasticPress pour permettre une synchronisation spécifique à chaque langue

Synchronise et analyse le contenu dans chaque langue pour une indexation et une recherche précises

Sur cette page :

Plugins requis et configuration

Commencez par installer et activer les éléments suivants :

Si vous débutez avec WPML, consultez notre Guide de démarrage.

Introduction à Elasticsearch et ElasticPress

Elasticsearch offre un moyen rapide et précis de gérer votre contenu recherchable. Cet outil open-source indexe et catégorise votre contenu, vous permettant d’analyser une grande variété de types de contenu, y compris des documents texte, des données numériques et géospatiales.

ElasticPress intègre votre site WordPress à Elasticsearch pour améliorer les fonctionnalités de recherche, de requête et de pertinence du contenu par défaut de WordPress.

Si vous avez un site avec beaucoup d’informations, comme une boutique WooCommerce ou un site communautaire, vous pouvez utiliser ElasticPress pour :

  • Créer une recherche avec des résultats quasi instantanés tout en éliminant la charge sur votre base de données WordPress
  • Traiter des requêtes complexes, y compris des recherches en texte intégral et des recherches floues.
  • Ajouter des pondérations au contenu afin que l’accent des résultats de recherche soit mis sur les données de votre choix
  • Analyser de grands volumes de données pour comprendre le comportement des clients et les tendances sur votre site

Une fois que vous avez installé le plugin ElasticPress et connecté à un serveur Elasticsearch, le plugin commence à indexer les données de votre site web. Cela signifie qu’il organise tout le contenu de votre site web (articles, pages, produits, etc.) dans un format qu’Elasticsearch peut traiter rapidement.

ElasticPress regroupe ses fonctionnalités dans des fonctionnalités auxquelles vous pouvez accéder en allant dans ElasticPress → Fonctionnalités.

ElasticPress vous permet d’activer un certain nombre de fonctionnalités

Synchroniser le Contenu avec ElasticPress

ElasticPress synchronise automatiquement le contenu lorsque vous le créez, le mettez à jour ou le supprimez, garantissant que votre index de recherche est toujours à jour.

Dans ElasticPress → Sync, vous pouvez également accéder aux Paramètres de synchronisation, qui proposent deux modes d’indexation. Ceux-ci vous permettent d’indexer le contenu actuel de votre site WordPress vers Elasticsearch ou de supprimer les données existantes dans votre index Elasticsearch et de créer un nouvel index à partir de zéro avec le contenu actuel de votre site WordPress.

Comment fonctionne WPML ElasticPress

WPML ElasticPress permet une fonctionnalité de recherche multilingue sur votre site WordPress propulsé par WPML et ElasticPress. Il analyse le contenu dans sa langue d’origine, assurant une indexation précise, et affiche le contenu pertinent aux utilisateurs dans la langue de leur choix.

WPML ElasticPress y parvient en générant des index uniques et spécifiques à chaque langue :

  1. Documents pertinents : Chaque index inclut des traductions dans la langue spécifique pour tous les types d’articles définis comme traduisibles. Pour les types d’articles configurés pour afficher des traductions si disponibles ou revenir à la langue par défaut, l’index inclut des traductions dans cette langue plus les articles dans la langue par défaut. Pour les articles non traduisibles, chaque index de langue inclut une copie de tous les éléments.
  2. Analyse des documents en fonction de la langue: Tous les documents d’un index linguistique font l’objet d’une analyse et d’une synchronisation à l’aide d’outils, de mots d’arrêt et de troncatures propres à cette langue. Cela inclut des copies d’articles dans la langue par défaut.
  3. Pool de résultats de recherche : Chaque index de langue fournit un pool de résultats potentiels pour les requêtes de recherche en front-end, les listes d’articles connexes, etc.

Fonctionnalités d’ElasticPress prises en charge

Actuellement, WPML ElasticPress prend en charge les fonctionnalités ElasticPress suivantes :

  • Recherche d’articles pour les recherches en front-end
  • Articles connexes, en utilisant le widget fourni par ElasticPress
  • Termes, Commentaires et Utilisateurs pour les recherches en back-end
  • Fonctionnalité Documents pour rechercher dans les fichiers texte attachés aux articles et aux pages

Démarrer avec WPML ElasticPress

Étant donné que WPML ElasticPress génère des index pour chaque langue, nous vous recommandons de réindexer vos articles après l’installation de WPML ElasticPress et/ou après la mise à jour de la version 1.0 à 2.0 de WPML ElasticPress.
Veuillez noter que si votre site est volumineux, ce processus peut prendre quelques heures

Vous pouvez le faire soit via l’administration WordPress, soit en utilisant la commande suivante :

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

Synchronisation et indexation du contenu avec WPML ElasticPress

WPML ElasticPress s’intègre directement au tableau de bord de synchronisation dans ElasticPress → Sync. Au lieu d’exécuter un seul processus de synchronisation, le plugin déclenche plusieurs synchronisations, une pour chaque langue de votre site multilingue.

WPML ElasticPress s’intègre directement à la synchronisation ElasticPress

Chaque fois que vous créez, modifiez ou supprimez un article, WPML ElasticPress maintient automatiquement le contenu pertinent synchronisé. Il met à jour les index pertinents en fonction de la langue du contenu modifié ou du paramètre de traduction pour le type d’article.

Indexation avec WP-CLI

Si vous avez un grand site web multilingue avec beaucoup de contenu à indexer, vous préférerez peut-être l’indexation en ligne de commande. WPML ElasticPress inclut sa propre commande CLI, wp wpml_elasticpress, qui étend la commande wp elasticpress existante. Il ajoute une option --post-lang pour spécifier les langues à synchroniser. Vous pouvez énumérer plusieurs langues en les séparant par des virgules. Par exemple, wp wpml_elasticpress sync –post-lang=en,es ne synchronisera que le contenu en anglais et en espagnol.

Les commandes utiles sont les suivantes :

  • wp wpml_elasticpress sync –setup: Supprime tous les indices existants et réindexe tout le contenu.
  • wp wpml_elasticpress sync --per-page=200: Synchronise tout le contenu par lots de 200 éléments à la fois, au lieu des 350 éléments par lot par défaut définis par ElasticPress.
  • wp wpml_elasticpress sync –post-type=post –post-lang=en,pt-pt: Indexe uniquement les articles dans des langues spécifiques. Dans le cas présent, il s’agit de l’anglais et du portugais. Nous expliquons ci-dessous comment utiliser cette commande en détail.

Indexation uniquement des articles de langues spécifiques

Le plugin de liaison WPML ElasticPress vous permet également d’indexer uniquement les articles dans des langues spécifiques. Pour ce faire :

  1. Utilisez la commande wp wpml_elasticpress sync --setup --post-type=post --post-lang=en pour indexer les articles dans une langue donnée (dans ce cas, l’anglais) et supprimer tous les index existants.
  2. Si vous vérifiez maintenant le front-end de votre site, vous ne verrez que des articles en anglais dans les résultats de recherche sur le site en anglais. Si vous changez de langue, les résultats de la recherche devraient être vides.

Si vous souhaitez indexer d’autres langues, répétez l’étape 2. Assurez-vous de ne pas utiliser l’argument –setup, sinon vous supprimerez les articles qui ont déjà été indexés).

Par exemple, vous pouvez utiliser ceci : wp wpml_elasticpress sync --post-type=post --post-lang=fr

Problèmes connus

Il n'y a aucun problème de compatibilité irrésolu entre ce module d'extension et WPML. Rechercher tous les problèmes connus.

Obtenir de l’aide de notre service d’assistance

Si vous avez besoin d’aide pour utiliser ElasticPress sur votre site multilingue, visitez le forum de support de WPML.

Mis à jour
octobre 23, 2025