WP-Apidae 6.3 : la nouvelle taxonomie des distinctions est en place

La phase 2 de notre plan de transition, annoncée pour mi-2026, est livrée avec quatre mois d’avance. Voici ce qui change avec la v6.3, et pourquoi vos sites continuent de tourner sans intervention.

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_distinctions hié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_write

Pratique 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
            → indexation

Les 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