Modules

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

WPML — multilingue Apidae

WP-Apidae WPML traduit vos fiches Apidae avec WPML. Les fiches sont importées dans la langue principale du site, puis traduites dans chaque langue importée, avec les textes qu’Apidae fournit pour cette langue.

Ce module s’adresse aux sites multilingues construits avec WPML. Si votre site utilise Polylang, c’est le module WP-Apidae Polylang qu’il vous faut.

Fiche produit : WPML sur wp-apidae.io

À quoi sert ce module ?

WP-Apidae sait importer une fiche dans plusieurs langues, mais il ne crée pas seul les versions traduites que WPML attend. Le module fait ce lien :

  • à chaque import, une traduction de la fiche est créée ou mise à jour dans chaque langue choisie ;
  • les catégories, classements et labels sont traduits avec elle ;
  • sur une page traduite, les listings, filtres, cartes et fiches liées montrent les fiches de la langue de la page ;
  • quand une fiche quitte vos sélections, ses traductions sont supprimées avec elle ;
  • les noms que vous saisissez dans les réglages des modules, par exemple les saisons de WP-Apidae Saisons, se traduisent dans String Translation.

Pré-requis

  • WP-Apidae 6.8 ou plus récent, installé et activé
  • WordPress 6.1 et PHP 8.2, ou plus récents
  • WPML 5.1 ou plus récent, installé, activé et configuré (langues et langue par défaut)
  • String Translation, l’extension de WPML, si vous voulez traduire les noms saisis dans les réglages des modules
  • Licence WP-Apidae WPML

WPML et Polylang ne peuvent pas être actifs ensemble sur un site WP-Apidae. Si un prérequis manque, un avis l’indique dans l’administration et le module ne fait rien.

Installation

  1. Installez et configurez WPML : 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. Ouvrez WP-Apidae → WPML : vérifiez le diagnostic et choisissez les langues à traduire.

À l’activation, le module rattache vos fiches déjà importées à la langue par défaut de WPML, pour qu’elles restent affichées. Si WPML n’est pas encore configuré, le module le fait à la fin de l’assistant de WPML. Un avis vous prévient si cette étape n’a pas pu se faire.

Fiches déjà importées : leurs traductions ne sont pas créées à l’activation. Créez-les avec Mettre en file toutes les fiches, dans l’onglet Traduire (voir plus bas), ou attendez le prochain import.

Paramétrage

L’écran WP-Apidae → WPML a trois onglets : Diagnostic, Réglages et Traduire.

Diagnostic

Un tableau associe chaque langue importée par WP-Apidae à une langue WPML, avec son état et le nombre de fiches traduites. Les états possibles :

  • langue par défaut (originaux) : les fiches importées sont dans cette langue ;
  • traduite : le module crée les traductions ;
  • exclue par les réglages : vous l’avez décochée ;
  • aucune langue WPML ne correspond : non traduite : ajoutez cette langue dans WPML.

Sous le tableau, le diagnostic indique les fiches et les termes encore sans langue WPML, puis les traductions en attente, en cours ou en échec.

Pour associer une langue, le module cherche dans WPML la même langue, puis le même code de langue. Sinon, il prend la seule langue de la même famille : l’anglais importé (en_GB) va vers l’anglais américain s’il est le seul anglais du site. S’il hésite entre deux langues, il n’en choisit aucune.

Réglages

  • Langues à traduire : une case par langue importée qui a une langue WPML. Toutes sont cochées par défaut, y compris une langue ajoutée plus tard. Une langue décochée n’est plus traduite ni mise à jour, mais ses traductions existantes restent en place.
  • Traduction automatique : activée par défaut. Chaque fiche est traduite après son import. Si vous la désactivez, lancez la traduction depuis l’onglet Traduire ou en ligne de commande.
  • Adresse des pages traduites : Tirée du titre traduit (/en/titre-anglais/, par défaut) ou Identique à l’adresse française (/en/titre-francais/). Le choix s’applique à chaque traduction créée ou mise à jour.

Cliquez sur Enregistrer les modifications.

Traduire

  • Traduire cette fiche : saisissez l’identifiant WordPress d’une fiche pour la traduire tout de suite.
  • Mettre en file toutes les fiches : traduit toutes vos fiches en arrière-plan, par lots de 200. Suivez l’avancement dans l’onglet Diagnostic.
  • Supprimer les traductions : supprime les traductions créées par le module, après confirmation. Les fiches principales et les traductions que vous avez faites dans WPML ne sont jamais supprimées. Les fichiers d’images restent : ils sont partagés avec la fiche principale.

Fonctionnement

À chaque import

  1. WP-Apidae importe la fiche dans la langue par défaut de WPML.
  2. Le module programme sa traduction, si la traduction automatique est activée.
  3. La traduction reçoit le titre et l’extrait qu’Apidae fournit dans cette langue. Ses catégories, classements et labels sont traduits.
  4. Au réimport suivant, le module réécrit la traduction. WPML ne la marque donc plus « à mettre à jour ».

Les communes et les critères internes sont partagés par toutes les langues. Une fiche qui n’a pas de traduction dans une langue n’apparaît pas sur les pages de cette langue.

Fiche principale et traductions

Seule la fiche principale porte l’identifiant Apidae (apidae_id). Ses traductions n’en ont pas : elles sont reliées à elle par WPML. Quand WP-Apidae supprime une fiche, il supprime aussi toutes ses traductions.

Commandes WP-CLI

  • wp apidae-wpml diagnostic : langues, couverture, file d’attente et réglages.
  • wp apidae-wpml traduire <id> : traduit une ou plusieurs fiches par leur identifiant WordPress. --apidae=<id> désigne la fiche par son identifiant Apidae, --toutes met toutes les fiches en file et --maintenant traduit sans passer par la file.
  • wp apidae-wpml supprimer : supprime les traductions créées par le module. --simulation compte sans rien supprimer.
  • wp wpdae-wpml initialiser : rattache à la langue par défaut les fiches et les termes qui n’ont pas de langue.

Impact performance

Chaque langue traduite ajoute une copie de chaque fiche : avec trois langues traduites, le site compte quatre fois plus de fiches. Les traductions se font en tâche de fond, dans Outils → Actions planifiées, une tâche par fiche. Le premier passage sur un gros catalogue peut donc prendre du temps. Les fichiers d’images ne sont pas dupliqués : les traductions utilisent ceux de la fiche principale.

Voir aussi