La version 6 de WP-Apidae est une refonte majeure de l’architecture de rendu. Ce guide vous accompagne pour migrer un site existant de la v5 vers la v6 en toute sérénité.
Audience : gestionnaires de sites équipés de WP-Apidae v5, ainsi que développeurs et intégrateurs qui accompagnent ces migrations.
Ce qui change en version 6
La v6 fait passer le plugin d’un modèle hook-driven (plus de 50 actions PHP pour rendre une fiche) à un modèle block-driven (templates Gutenberg configurables). L’import, l’indexation et la recherche facettée restent identiques — seul le rendu évolue.
Rendu des fiches (single)
- v5 : enchaînement de 50+ hooks
apidae_*dans des fichiers PHP (single-entity.php,content-single-entity.php…) - v6 : templates Gutenberg définis dans un fichier
templates.json+ blocs individuels personnalisables depuis l’éditeur.
Rendu des listings (archives)
- v5 : shortcodes, widget Elementor dédié, bloc
Entities_List. Cards en couches configurables (media / content / body / footer). - v6 : blocs Gutenberg natifs avec filtres, pagination, cartographie et templates de cards tous modulaires.
Templates de thème (overrides)
- v5 : les thèmes surchargent des fichiers PHP dans
{theme}/wp-apidae/(pattern WooCommerce). - v6 : les thèmes surchargent des blocs Gutenberg ou ajoutent des dynamic content callbacks. Plus de fichiers PHP d’override.
Elementor
Le widget WPDAE_Elementor_Archive intégré à la v5 est supprimé en v6. Si votre site utilisait ce widget, installez le module WP-Apidae Elementor qui reprend les widgets legacy, ou migrez vos templates vers les blocs Gutenberg v6.
Ce qui ne change pas
Tous les éléments suivants sont inchangés entre v5 et v6 :
- L’import depuis l’API Apidae (Action Scheduler)
- La table d’index facetté
- Les types de posts (
ad_activite,ad_hotellerie, etc.) - Les taxonomies (
at_selectionids,at_communes, etc.) - Le moteur de recherche
- La post meta
apidaeJson - Les rich snippets Schema.org
- Les commandes WP-CLI
- Les fonctions
apidae_get_the_*()(conservées pour rétro-compatibilité) - Les shortcodes
[selection_id],[entities_category],[entities]
Autrement dit, les fiches déjà importées restent en place et les URL publiques ne sont pas cassées par la migration. Le travail porte uniquement sur le rendu.
Préparer la migration
- Vérifiez votre environnement : la v6 exige PHP 8.1 et WordPress 6.1 minimum. Faites monter votre hébergement au niveau si nécessaire.
- Mettez votre site en sauvegarde complète (fichiers + base de données).
- Dupliquez sur une préproduction si possible — la migration se teste mieux sans pression.
- Recensez les personnalisations actuelles (voir section suivante).
Recenser vos personnalisations v5
Avant de migrer, faites l’inventaire de ce qui est personnalisé côté thème :
- Templates overrides : fichiers dans
{votre-theme}/wp-apidae/(notammentsingle-entity.php,content-single-entity.php,global/wrapper-start.php, les sous-dossierssingle/). - Hooks custom : fonctions attachées à des actions
apidae_*(souvent dansfunctions.phpouinc/hook-wp-apidae.php). - Shortcodes
[selection_id],[entities_category],[entities]insérés dans vos pages et articles. - Widget Elementor
WPDAE_Elementor_Archivedans vos templates. - Cards custom définies via
elabo_cards_template_custom()— elles restent compatibles en v6.
Étapes de migration
- Sur la préproduction, téléversez le plugin v6 et activez-le (remplace la v5). Les réglages existants sont conservés.
- Passez en revue les Options de réglages — de nouveaux onglets sont apparus (Mise à jour en temps réel, Aspects…).
- Vérifiez l’affichage des fiches single et des listings. Si un thème personnalisé est en place, certains éléments peuvent ne plus s’afficher comme avant (normal : les overrides v5 ne s’appliquent plus).
- Migrez les overrides thème :
single-entity.php→ créer un template JSONcontent-single-entity.php→ plus nécessaire (blocs natifs)single/*.php→ override du bloc Gutenberg correspondant dans{theme}/wp-apidae/blocks/
- Migrez les hooks vers des callbacks dynamiques ou des overrides de blocs. Le filtre
wp-apidae/blocks-views/dynamic-content/custom-callbackest le nouveau point d’extension. - Si vous utilisiez le widget Elementor
WPDAE_Elementor_Archive: installez WP-Apidae Elementor ou migrez vers les blocs Gutenberg. - Testez : rendu des fiches single, rendu des listings, filtres facettés, carte, breadcrumbs, rich snippets.
- Déployez en production après validation complète sur préproduction.
Correspondance v5 → v6
Fichiers d’override
| Fichier v5 | Remplacement v6 |
|---|---|
single-entity.php | Template JSON dans templates.json |
content-single-entity.php | Plus nécessaire (blocs natifs) |
global/wrapper-start.php | Plus nécessaire |
single/*.php | Override du bloc correspondant dans wp-apidae/blocks/ |
single/informations/*.php | Override du bloc informations |
Hooks
| Hook v5 | Équivalent v6 |
|---|---|
apidae_template_single_title | Bloc titre dans le template |
apidae_template_single_gallery | Bloc gallery |
apidae_single_summary | Blocs adresse + contact dans le layout |
apidae_single_content | Blocs de contenu dans le template |
apidae_loop_entity_title | Card template layers |
apidae_before_loop_entity_title | Card template avec custom_block |
Les hooks de structure (apidae_before_main_content, apidae_after_main_content) ne sont plus nécessaires.
Checklist de migration
- Environnement PHP 8.1 et WordPress 6.1 validé
- Sauvegarde complète effectuée
- Préproduction à jour avec le trafic réel
- Inventaire des templates overrides fait
- Inventaire des hooks custom fait
- Inventaire des shortcodes utilisés fait
- Widget Elementor migré (si utilisé)
- Templates JSON créés pour les fiches personnalisées
- Hooks migrés vers callbacks dynamiques ou overrides de blocs
- Rendu des fiches single validé
- Rendu des listings validé
- Filtres facettés validés
- Carte validée
- Breadcrumbs et rich snippets validés
- Fichiers d’override v5 obsolètes supprimés du thème
- Déploiement en production planifié
Besoin d’accompagnement ?
Les migrations complexes (thèmes très personnalisés, nombreux hooks custom) gagnent à être accompagnées. e-labo propose un accompagnement dédié : contactez le support depuis votre espace client sur wp-apidae.io.