Distinctions Apidae : quatre vérifications pour les intégrateurs avant l’été 2027

Depuis novembre 2025, Apidae range les classements, les labels, les chaînes et les guides de chaque type de fiche dans un tableau unique, celui des distinctions. Apidae avait annoncé une année de rétrocompatibilité pour les anciens champs, qui s’achève le 24 novembre 2026. Ils ne disparaissent pas ce jour-là : le calendrier d’Apidae place leur suppression à l’été 2027, ce qui laisse aux prestataires le temps de s’adapter (Apidae).

Pour l’office de tourisme, l’article de la version 6.5 a dit l’essentiel : un site à jour et migré continue d’afficher ses classements et ses labels.

Celui-ci s’adresse à qui maintient le site : l’agence, le freelance, le développeur d’un thème sur mesure. Le délai est confortable, mais inutile d’attendre le dernier mois. Voici quatre vérifications, dans l’ordre.

Les versions

Le cœur doit être au moins en 6.5, la version qui lit les distinctions à la place des anciens champs. Pour les modules, il faut au minimum Elementor 2.1.0, Blocs avancés 1.4.0, Polylang 1.5.5 et Divi 2.0.1. Un module resté en arrière peut lire encore l’ancien champ : il n’aura plus rien à afficher quand Apidae aura supprimé l’ancien champ et que la fiche sera mise à jour.

La version actuelle du cœur, la 6.6.1, demande PHP 8.2. Il faut donc vérifier la version de PHP du serveur avant de mettre à jour.

La migration

Une fiche importée avant la 6.5 n’a pas forcément ses distinctions enregistrées sur le site. L’étape de migration les crée à partir du JSON Apidae déjà stocké avec chaque fiche, sans appel à Apidae. Elle s’appuie sur les distinctions que ce JSON contient : une fiche très ancienne qui n’en porte aucune doit être réimportée. Elle se lance depuis l’assistant de migration, dans l’administration, ou en ligne de commande :

wp wpdae migrate_distinctions --dry-run
wp wpdae migrate_distinctions
wp wpdae verify_migration --sample=0 --format=json > etat-distinctions.json

La simulation compte ce qui serait ajouté, sans rien écrire. La commande ne fait qu’ajouter : elle ne retire aucun terme et ne touche pas aux anciennes taxonomies. On peut la relancer, elle ne pose que ce qui manque.

La dernière commande, la vérification, est la plus utile. Elle dit si ce que les gabarits affichent vient encore des anciens champs du JSON, ou déjà de la taxonomie des distinctions. Ce qui vient des anciens champs disparaîtra à la première mise à jour de la fiche qui suivra leur suppression ; ce qui vient de la taxonomie restera. Par défaut, la commande examine 200 fiches réparties sur tout le site, et un échantillon peut manquer un champ rare. Les deux options de la dernière ligne les prennent toutes et sortent le résultat dans un fichier, pour en garder une trace.

Le thème sur mesure

Les gabarits du cœur et des modules sont déjà adaptés. En revanche, un thème qui lit directement le JSON Apidae ne trouvera plus les anciens champs dès que la fiche aura été mise à jour après leur suppression.

Pour savoir lesquels disparaissent, pas besoin de liste : Apidae l’indique dans le JSON de chaque fiche. Un champ voué à disparaître porte une déclaration « critereDeprecie », avec une date de désactivation et son remplaçant :

"classementPrefectoral": {
  "elementReferenceType": "HebergementLocatifClassementPrefectoral",
  "id": 2633,
  "libelleFr": "Non Classé",
  "critereDeprecie": {
    "dateDesactivation": "2026-11-24",
    "critereSubstitutionId": 7674,
    "champSubstitution": "distinctions[].qualification"
  }
}

Le champ concerné est le parent de cette déclaration. La date indiquée, le 24 novembre 2026, n’est pas celle de la suppression : pour celle-ci, c’est le calendrier d’Apidae qui fait foi. Ici, c’est le classement préfectoral d’un hébergement locatif, relevé le 1er octobre sur une fiche réelle. Il suffit de noter ces chemins sur quelques fiches de chaque type, puis de les chercher dans le code du thème.

Deux remarques, tirées de 828 fiches examinées. Les champs texte comme le numéro ou la date de classement ne portent pas cette déclaration : rien n’annonce leur retrait. Et les critères dépréciés les plus fréquents appartiennent à presentation.typologiesPromoSitra, un champ qu’Apidae conserve pour ses autres critères et que beaucoup de thèmes n’affichent pas.

Pour adapter le thème, WP-Apidae fournit trois fonctions. La plus directe rend les distinctions qui correspondent à un ancien champ :

$distinctions = wpdae_get_distinctions_par_champ_herite(
    get_the_ID(),
    'informationsHebergementLocatif.classementPrefectoral'
);

foreach ( $distinctions as $distinction ) {
    echo esc_html( $distinction['libelle'] );
}

Chaque entrée porte le libellé, l’organisme, le numéro, la date et la provenance du libellé (« taxonomie » ou « json »). Le numéro et la date ne sont pas toujours renseignés : pour un classement, wpdae_get_classement() les donne. Tant que la fiche n’est pas migrée, la fonction relit l’ancien champ au même chemin, ce qui évite une page vide en attendant. Les libellés, eux, suivent ceux des distinctions, qui ont parfois changé. Les deux autres fonctions sont wpdae_get_distinctions_par_categorie(), qui travaille par catégorie de distinction, et wpdae_get_classement(), dont la signature ne change pas.

Un cas particulier : si le thème a sa propre copie du gabarit wp-apidae/blocks/informations-restauration.php, il faut la mettre à jour à partir de la nouvelle version pour afficher les guides et les chaînes.

Les filtres

Les filtres de listing n’ont pas à être reconfigurés : depuis la 6.5, l’import reconstruit les anciennes catégories de classement à partir des distinctions, dès qu’Apidae ne publie plus l’ancien champ. Il y a deux exceptions.

• Un ancien critère qu’Apidae n’a repris dans aucune distinction ne peut pas être reconstruit, comme le confort « Prise de télévision ».
• « Classé et contrôlé par la SMF » disparaît au profit de « Musée de France » : un filtre réglé sur l’ancien libellé ne trouvera plus rien.

C’est le moment de passer en revue les filtres qui portent sur ce genre de critères.

Pour aller plus loin : simuler la suppression

Tant que l’ancien champ existe, le site retombe dessus quand il ne trouve pas la distinction. C’est voulu, mais cela masque un oubli de migration : une page peut sembler identique aujourd’hui et perdre son classement le jour où le champ sera supprimé. Sur un site de recette, le moyen le plus sûr est de retirer du JSON les champs dépréciés et de comparer le rendu, sur quelques fiches de chaque type. C’est ainsi que nous avons recetté la 6.5.

D’ici l’été 2027

Quand Apidae supprimera les anciens champs, les fiches les perdront une à une, au fil de leurs mises à jour. Un site dont la vérification complète ne trouve plus rien qui vienne des anciens champs, et dont le thème et les filtres ont été revus, est prêt. Dans les jours qui suivront la suppression, ouvrir quelques fiches de chaque type qui portent un classement ou un label, vérifier qu’elles l’affichent toujours, et relancer la vérification. Si quelque chose manque, reprendre les deux premières vérifications. Pour toute question, le support peut regarder avec vous.

Sources

• WP-Apidae 6.5 : la migration des distinctions est terminée
• WP-Apidae 6.3 : la nouvelle taxonomie des distinctions est en place
• Apidae, documentation développeurs, « Réorganisation des distinctions »
• Apidae, « Restructuration de la donnée (2024-2027) », calendrier d’exécution