WP-Apidae et le nouveau tableau des distinctions : une transition en douceur

Apidae fait évoluer sa structure de données

Si vous utilisez WP-Apidae pour intégrer vos fiches touristiques, vous avez peut-être entendu parler de la restructuration des données Apidae 2024-2026. Cette évolution majeure concerne notamment les distinctions : classements hôteliers, labels qualité, guides gastronomiques, chaînes d’hébergement, et bien d’autres critères qui enrichissent vos fiches.

Qu’est-ce qui change exactement ?

Jusqu’à présent, ces informations étaient dispersées dans différents champs de l’API Apidae :

• classement et classementPrefectoral pour l’hôtellerie
• classementsGuides pour la restauration
• labels et labelsQualite pour les certifications
• chaines pour les réseaux d’hébergement
• Et bien d’autres encore…

À partir de fin 2026, tous ces critères seront regroupés dans un nouveau nœud unique : $.distinctions. Cette consolidation apporte une structure plus cohérente et des données enrichies (dates de validité, numéros d’agrément, qualifications détaillées).

Documentation officielle : Tableau des distinctions Apidae

Notre engagement : zéro rupture pour vos sites

Chez WP-Apidae, nous savons que vous avez construit vos sites avec soin. Vos filtres de recherche, vos blocs Gutenberg, vos templates personnalisés : tout doit continuer à fonctionner.

C’est pourquoi nous avons élaboré une stratégie de migration progressive en 3 phases, qui vous permet de bénéficier des évolutions sans rien casser.

Phase 1 : Rétrocompatibilité immédiate (Version 6.2)

Disponible dès maintenant. Cette première phase, déjà intégrée dans WP-Apidae 6.2, assure une transition transparente :

Ce que nous avons fait

1. Lecture du nouveau format : WP-Apidae lit désormais le nœud $.distinctions de l’API Apidae.
2. Table de correspondance : Nous utilisons le fichier de correspondance officiel d’Apidae pour traduire les nouveaux identifiants vers les anciens. Résultat : vos taxonomies existantes (at_hotellerieclassement, at_labeltourismehandicap, etc.) continuent d’être alimentées normalement.
3. Données enrichies stockées : Les nouvelles informations (dates de validité, numéros, qualifications) sont sauvegardées en métadonnées pour une exploitation future.

Ce que cela signifie pour vous

• Aucune action requise : mettez simplement à jour vers la version 6.2.
• Vos filtres fonctionnent : les taxonomies gardent les mêmes slugs.
• Vos blocs Gutenberg s’affichent : aucune modification de templates nécessaire.
• Import transparent : les nouvelles fiches et mises à jour sont traitées automatiquement

Phase 2 : Préparation de la nouvelle architecture (Courant 2026)

Objectif : préparer le terrain pour l’avenir.

Cette phase, prévue dans les prochains mois, posera les fondations de la nouvelle structure :

Ce qui est prévu

• Nouvelle taxonomie unifiée : création de at_distinctions qui regroupera toutes les distinctions.
• Double écriture : pendant cette période, WP-Apidae alimentera à la fois les anciennes ET la nouvelle taxonomie.
• Fonctions helper : de nouvelles fonctions PHP et blocs Gutenberg pour exploiter les données enrichies (afficher la date de validité d’un label, le nombre d’étoiles avec l’année, etc.)

Ce que cela signifie pour vous

• Rétrocompatibilité maintenue : vos sites continuent de fonctionner.
• Nouvelles possibilités : vous pourrez progressivement adopter les nouvelles fonctionnalités.
• Documentation fournie : guides de migration et bonnes pratiques.

Phase 3 : Migration finale (Fin 2026 – 2027)

Objectif : architecture définitive et pérenne.

Cette dernière phase interviendra après la fin du support des anciens champs par Apidae :

Ce qui est prévu

• Basculement complet : les filtres et blocs utiliseront exclusivement la nouvelle taxonomie.
• Nettoyage : suppression des anciennes taxonomies devenues obsolètes.
• Optimisation : allègement du code et meilleures performances.

Ce que cela signifie pour vous

• Migration guidée : un assistant vous accompagnera pour adapter vos éventuelles personnalisations.
• Architecture moderne : profitez pleinement des nouvelles données Apidae.
• Pérennité : votre site sera aligné avec l’évolution d’Apidae.

Calendrier récapitulatif

Pour les développeurs : hooks disponibles

Si vous avez développé des extensions ou personnalisations autour de WP-Apidae, voici les nouveaux hooks disponibles :

// Avant le traitement des distinctions
add_filter( 'wpdae/distinctions/before_process', function( $distinctions, $post_id ) {
    // Modifier ou filtrer les distinctions avant traitement
    return $distinctions;
}, 10, 2 );

// Personnaliser la correspondance legacy
add_filter( 'wpdae/distinctions/legacy_reference', function( $legacy_ref, $distinction_id ) {
    // Ajouter des correspondances personnalisées
    return $legacy_ref;
}, 10, 2 );

// Après le traitement des distinctions
add_action( 'wpdae/distinctions/after_process', function( $processed, $post_id ) {
    // Actions post-traitement
}, 10, 2 );

Questions fréquentes

wp wpdae import_selection <ID_SELECTION> --force

En résumé

La restructuration des distinctions Apidae est un changement important, mais nous avons anticipé pour que cette transition soit la plus fluide possible pour vous.

Avec WP-Apidae 6.2, vous êtes déjà prêts pour l’avenir, tout en conservant la compatibilité avec vos configurations actuelles.