Blog 6 min de lecture
WP-Apidae 6.3 : la nouvelle taxonomie des distinctions est en place
La phase 2 de notre plan de transition est livrée avec quatre mois d'avance : taxonomie hiérarchique at_distinctions, double écriture, support Polylang. Voici ce qui change en v6.3 et pourquoi vos sites continuent de tourner sans intervention.
pierre Do Rosario
Mise à jour du 22 septembre 2026 — la dernière étape annoncée ici pour la v7.0, avec une rupture, est finalement livrée avec la 6.5, sans rupture. WP-Apidae 6.5 : la migration des distinctions est terminée.
Là où on en était
En janvier, nous expliquions ici comment Apidae allait consolider l’ensemble des distinctions (classements hôteliers, labels qualité, guides gastronomiques, chaînes) dans un nœud unique $.distinctions de leur API, avec une bascule définitive prévue fin novembre 2026. Nous annoncions un plan en trois phases pour amener WP-Apidae sur cette nouvelle architecture sans casser les sites existants :
- Phase 1 (v6.2) : lecture du nouveau format avec table de correspondance rétrocompatible. Livrée en février.
- Phase 2 (mi-2026) : nouvelle taxonomie unifiée et double écriture. Livrée dès la v6.3.
- Phase 3 (v7.0.0, fin 2026) : bascule complète, suppression des anciennes taxonomies.
Cet article fait le point sur la 6.3 et sur ce qu’elle ouvre côté thèmes et requêtes.
Le changement structurant : une taxonomie hiérarchique unifiée
Jusqu’à la 6.2, les distinctions d’une fiche Apidae se retrouvaient éparpillées dans plusieurs taxonomies WordPress distinctes : une pour les chaînes hôtelières, une pour les labels, une pour les guides, une pour les classements préfectoraux, etc. C’était fidèle à la façon dont Apidae les exposait historiquement, mais ça rendait toute requête transversale compliquée.
La v6.3 introduit une taxonomie unique, at_distinctions, hiérarchique sur trois niveaux :
at_distinctions
├── Catégorie (ex: "Classement hôtelier")
│ ├── Nom (ex: "Étoiles")
│ │ ├── Qualification (ex: "3 étoiles")
│ │ ├── Qualification (ex: "4 étoiles")
│ │ └── Qualification (ex: "5 étoiles")
│ └── …
├── Catégorie (ex: "Guide gastronomique")
│ ├── Nom (ex: "Guide Michelin")
│ │ ├── Qualification (ex: "Une étoile")
│ │ └── …
└── …L’avantage est immédiat : un seul endroit pour interroger, filtrer et afficher, peu importe qu’il s’agisse d’un classement préfectoral ou d’un guide gastronomique. La hiérarchie permet aussi de requêter à n’importe quel niveau. Lister par exemple « tous les établissements avec un Guide Michelin, peu importe le nombre d’étoiles » devient un tax_query de quelques lignes.
La double écriture : pourquoi vos thèmes actuels continuent de marcher
Le point important : la 6.3 ne casse rien.
À l’import, WP-Apidae alimente désormais les deux systèmes en parallèle :
- Les anciennes taxonomies (chaînes, labels, guides, classements préfectoraux…), celles que votre thème lit aujourd’hui.
- La nouvelle taxonomie
at_distinctionshiérarchique, celle qui sera la seule à la 7.0.
Après mise à jour vers la 6.3 et réimportation, vos templates existants continuent de fonctionner exactement comme avant. Aucune ligne de PHP à modifier. La nouvelle taxonomie est simplement disponible en plus, quand vous serez prêt à migrer.
Côté développeurs, la double écriture est activée par défaut et pilotable via le filtre :
wpdae/distinctions/enable_dual_writePratique pour la désactiver temporairement sur un environnement de dev et tester la 7.0 avant l’heure.
Ce que la 6.3 ouvre côté requêtes et templates
Quelques exemples de ce que la v6.3 rend simple.
Lister tous les classements 3 étoiles
$query = new WP_Query([
'post_type' => 'ad_hotellerie',
'tax_query' => [[
'taxonomy' => 'at_distinctions',
'field' => 'name',
'terms' => '3 étoiles',
]],
]);Tous les établissements d’une catégorie de distinction donnée
$query = new WP_Query([
'post_type' => 'ad_restauration',
'tax_query' => [[
'taxonomy' => 'at_distinctions',
'field' => 'slug',
'terms' => 'guide-gastronomique',
'include_children' => true, // descend toute la hiérarchie
]],
]);Afficher la hiérarchie complète d’une fiche
get_the_terms( $post_id, 'at_distinctions' ) renvoie l’ensemble des termes, parents inclus. Plus besoin d’agréger trois ou quatre taxonomies pour reconstruire la liste des distinctions d’un établissement.
Côté Polylang : la traduction des distinctions
WP-Apidae Polylang gère depuis longtemps la traduction des taxonomies Apidae, mais les distinctions étaient un cas à part : leur nature semi-structurée rendait la chose délicate.
La v6.3 introduit une étape translate_distinctions dans le pipeline d’import multilingue, juste après translate_terms :
Import post → set_default_language → enqueue_duplicate_post
→ translate_terms → translate_distinctions (v6.3+)
→ translate_post → pll_save_post_translations
→ indexationLes termes de at_distinctions sont désormais traduits automatiquement avec le reste de la fiche, à tous les niveaux de la hiérarchie. Aucune configuration supplémentaire si WP-Apidae Polylang est déjà installé.
Pour les développeurs : les nouveaux hooks
La v6.3 expose une API d’extensibilité dédiée aux distinctions :
| Hook | Type | Usage |
|---|---|---|
wpdae/distinctions/get_data | filter | Modifier les données brutes lues depuis l’API Apidae |
wpdae/distinctions/legacy_reference | filter | Ajuster la table de correspondance ancien / nouveau |
wpdae/distinctions/before_process | filter | Intervenir avant le traitement d’une distinction |
wpdae/distinctions/before_create_term | filter | Modifier un terme avant création dans at_distinctions |
wpdae/distinctions/enable_dual_write | filter | Activer ou désactiver la double écriture |
Cas d’usage typiques : forcer une normalisation de libellé propre à votre client, ajouter une distinction métier qui n’existe pas dans Apidae, ou (pour les plus aventureux) basculer un site en mode 7.0 anticipé en désactivant la double écriture.
À noter : enable_dual_write et legacy_reference sont propres à la période de transition et disparaîtront avec la v7.0. Les trois autres (get_data, before_process, before_create_term) sont des points d’extension pérennes du pipeline d’import.
Pour le détail de chaque filtre, voir la documentation technique des hooks d’import.
Calendrier mis à jour
| Phase | Version | Statut |
|---|---|---|
| Phase 1 : lecture nouveau format, rétrocompat | v6.2 | Livrée, janvier-février 2026 |
| Phase 2 : taxonomie unifiée + double écriture | v6.3 | Livrée, février 2026 |
| Phase 3 : bascule complète, suppression de l’ancien | v7.0.0 | Prévue novembre-décembre 2026 |
La deadline imposée par Apidae, fin novembre 2026 pour la suppression des anciens champs côté API, reste notre boussole pour la v7.0. Nous communiquerons en amont sur la procédure de mise à jour, pensée elle aussi pour minimiser le travail sur les thèmes existants.
FAQ
Faut-il réimporter les fiches après la mise à jour vers la 6.3 ?
Oui, pour que la nouvelle taxonomie at_distinctions soit alimentée. Une réimportation complète suffit, aucune autre manipulation n’est nécessaire. Les anciennes taxonomies restent en place et sont rafraîchies au passage.
Mon thème actuel continue-t-il de fonctionner ?
Oui, sans modification. La double écriture garantit que les taxonomies que vos templates lisent aujourd’hui continuent d’être alimentées normalement.
Quand dois-je migrer mes templates vers at_distinctions ?
Pas d’urgence. Vous pouvez attendre la v7.0 (fin 2026) ou anticiper dès maintenant pour tirer parti des requêtes hiérarchiques. Les deux systèmes cohabitent jusqu’à la 7.0.
Et si j’ai des personnalisations qui filtrent sur les anciennes taxonomies (chaînes, labels, guides…) ?
Elles continuent de fonctionner. Au moment du passage à la 7.0, nous publierons un guide de migration avec les correspondances. Et pour les cas tordus, on reste joignables.
Les distinctions sont-elles bien traduites avec WP-Apidae Polylang ?
Oui, depuis la 6.3, via l’étape translate_distinctions du pipeline multilingue. Aucune configuration supplémentaire.
Apidae a affiché « déprécié » sur certaines de mes catégories dans la rubrique « Présentation ». C’est lié ?
Oui, c’est le même chantier vu côté Apidae. Les anciennes catégories de présentation basculent progressivement vers le nœud distinctions. La v6.3 de WP-Apidae sait les lire à leur nouvel emplacement, assurez-vous d’être bien à jour.
En résumé
La 6.3 livre la phase 2 avec quatre mois d’avance, sans rupture pour les sites en production, et avec un bonus côté Polylang. Reste à préparer la 7.0 pour la fin de l’année, en phase avec le calendrier d’Apidae.
L’équipe WP-Apidae
