Modules

⌘K
  2. Accueil
  4. Docs
  6. Modules
  8. Polylang — multilingue Apidae

Polylang — multilingue Apidae

WP-Apidae Polylang rend votre site multilingue : à chaque import, il crée les traductions de vos fiches Apidae dans Polylang, avec leurs catégories, classements et labels.

Ce module s’adresse aux sites multilingues construits avec Polylang : offices de tourisme en zone frontalière, stations de ski, territoires à forte clientèle étrangère. Si votre site utilise WPML, c’est le module WP-Apidae WPML qu’il vous faut.

Fiche produit : Polylang sur wp-apidae.io

À quoi sert ce module ?

Apidae fournit les contenus dans plusieurs langues, et WP-Apidae en importe six : français, anglais, allemand, espagnol, italien et néerlandais. Il ne crée pas seul plusieurs versions d’une même fiche. Le module fait ce travail :

  • à chaque import, une traduction de la fiche est créée ou mise à jour dans chaque langue importée ;
  • les catégories (communes, thèmes, équipements…) sont traduites ;
  • les classements et labels sont traduits, avec leur étoile et leur date ;
  • sur une page traduite, les listings, filtres, cartes et fiches liées montrent les fiches de la langue de la page ;
  • les noms que vous saisissez dans les réglages des modules, par exemple les saisons de WP-Apidae Saisons, se traduisent dans Traductions des chaînes.

Pré-requis

  • WP-Apidae 6.0 ou plus récent, installé et activé, en version 6.8 de préférence
  • PHP 8.2 ou supérieur (prérequis du cœur WP-Apidae)
  • Polylang ou Polylang Pro, avec au moins une langue et une langue par défaut
  • Licence WP-Apidae Polylang

Polylang et WPML ne peuvent pas être actifs ensemble sur un site WP-Apidae. Le module ne fonctionne plus avec WP-Apidae 5 depuis sa version 1.6.0 : un site encore en version 5 garde la version 1.5.5 le temps de sa migration.

Mise à jour vers WP-Apidae 6.8

Mettez le module à jour en 1.7.0 en même temps que WP-Apidae 6.8, ou avant. WP-Apidae 6.8 passe par ce module pour travailler avec Polylang. Si le module reste en 1.6, vos pages s’affichent comme avant, mais les fiches importées ne sont plus indexées. Elles n’apparaissent ni dans les listings ni dans les filtres, et un avis le signale. Une fois le module en 1.7.0, ces fiches sont indexées automatiquement dans l’heure. Si vous avez lancé une réindexation de sélection entre-temps, relancez-la.

Installation

  1. Installez et configurez Polylang : ajoutez vos langues et choisissez la langue par défaut.
  2. Dans WP-Apidae → Réglages, onglet Connexion Apidae, cochez les Langues à importer. Le français est toujours importé.
  3. Achetez le module sur wp-apidae.io, téléversez-le et activez-le depuis Extensions → Ajouter.
  4. Activez la licence dans WP-Apidae → Extensions. La licence WP-Apidae principale doit être activée avant.
  5. Dans WP-Apidae → Polylang, onglet Traduire, activez tous les types de publication et toutes les taxonomies, puis enregistrez.

Important : les fiches importées avant l’activation du module ne sont pas traduites d’elles-mêmes. Lancez Re-traduire les fiches, dans l’onglet Admin du module, ou attendez le prochain import.

Paramétrage

L’écran WP-Apidae → Polylang a deux onglets.

Traduire

Cet onglet indique à Polylang quels contenus WP-Apidae sont traduisibles. Il présente une case par type de fiche, dans Types de publication personnalisés, et une case par taxonomie, dans Taxonomies personnalisées. Chaque liste a une case Tout sélectionner. Activez tout : un type ou une taxonomie laissé décoché n’est pas traduit. Cliquez ensuite sur Enregistrer les modifications.

Admin

  • Re-traduire les fiches (bouton Lancer) : crée ou met à jour les traductions de toutes les fiches. Utile après l’activation du module ou l’ajout d’une langue.
  • Supprimer les fiches traduites (bouton Supprimer) : supprime toutes les fiches qui ne sont pas dans la langue par défaut, avec leurs images. Les fiches principales restent.

Fonctionnement

À chaque import

  1. La fiche importée reçoit la langue par défaut de Polylang.
  2. Ses catégories, classements et labels sont traduits.
  3. Le module crée ou met à jour une traduction dans chaque langue cochée dans Langues à importer, et la relie à la fiche principale dans Polylang.

Quand WP-Apidae supprime une fiche, parce qu’elle a quitté vos sélections ou Apidae, il supprime aussi toutes ses traductions, même dans une langue que vous n’importez plus. Si une traduction ne peut pas être supprimée, la fiche principale est gardée.

Fiche principale et traductions

  • Fiche principale : dans la langue par défaut, elle porte l’identifiant Apidae (apidae_id).
  • Traductions : elles ne portent pas cet identifiant. Elles sont reliées à la fiche principale par Polylang.

Commandes WP-CLI

Les commandes du module commencent par wp wpdae-polylang :

  • translate_post <id> : traduit une fiche principale, par son identifiant WordPress.
  • translate_all_posts : traduit toutes les fiches, par lots de 10 (--batch-size=<n> pour changer). Elle reprend aussi les noms de catégories restés en français.
  • sync_distinction_terms : recopie les informations des classements et labels sur leurs traductions. --dry-run montre ce qui changerait sans rien écrire.
  • delete_translated_posts : supprime toutes les fiches traduites. Elle ne demande pas de confirmation.

Impact performance

Chaque langue importée ajoute une copie de chaque fiche : avec trois langues en plus du français, le site porte quatre fois plus de fiches. L’index de recherche, lui, ne grossit pas : il ne contient que les fiches de la langue par défaut, et WP-Apidae affiche ensuite celles de la langue de la page.

Voir aussi

Étiquettes