Afficher les fiches Apidae sur WordPress : widget, API ou extension

Votre office de tourisme saisit ses hébergements, ses restaurants et ses manifestations dans Apidae, et le site tourne sous WordPress. Pour faire apparaître ces fiches sur le site, trois voies existent. Ce guide compare ce que chacune vous demande au quotidien : compétences, temps, maintenance, langues, cartes et agenda.

Le point de départ commun : un projet Apidae

Pour interroger l’API vous-même comme pour passer par une extension, il vous faut :

• un abonnement Apidae en cours de validité ;
• un projet, créé dans l’espace Apidae, qui décrit ce que votre site diffuse ;
• son identifiant et sa clé API, dans l’onglet Informations générales du projet ;
• une ou plusieurs sélections : les objets que le projet diffuse, définis par des critères dans Apidae.

L’article API Apidae : projet, clé, sélections et consentement détaille chacune de ces notions.

Les trois voies

• Le widget. Un code fourni par un tiers affiche une liste dans un cadre de votre page. Wapidae, le widget gratuit d’Apidae, est publié sur le répertoire des extensions WordPress.
• Le développement sur l’API. Votre équipe, ou un prestataire, écrit le code qui interroge l’API Apidae, reçoit les fiches en JSON et les range dans WordPress.
• L’extension. Une extension spécialisée fait ce travail d’import et fournit les blocs d’affichage. WP-Apidae en est une ; d’autres éditeurs en proposent.

Compétences et mise en place

Avec un widget, la pose est rapide et ne demande pas de développeur. La contrepartie : les fiches restent chez le tiers qui fournit le widget. Elles n’ont pas d’adresse sur votre site et gardent sa mise en forme.

Avec l’API, il faut savoir écrire des requêtes HTTP et lire des réponses JSON volumineuses. L’affichage n’est qu’une partie du chantier. Il faut aussi :

• stocker les fiches et copier les photos ;
• gérer les langues et recalculer les dates d’ouverture ;
• supprimer ce qui disparaît d’Apidae ;
• ne rien effacer le jour où l’API répond mal ;
• importer de grosses sélections sans dépasser le délai d’exécution du serveur.

Vous pouvez tout faire, puisque vous écrivez tout ; le budget suit ce périmètre.

Avec WP-Apidae, la mise en route se fait dans l’administration de WordPress, sans code. Vous collez l’identifiant et la clé API, l’extension affiche toutes les sélections du projet, et un clic sur Importer les rapatrie. L’import tourne en arrière-plan : une grosse sélection ne bloque ni l’administration ni le site. Les photos et les documents sont copiés dans la médiathèque, et chaque fiche devient un contenu WordPress. L’extension gère quatorze types d’objets touristiques.

Pour l’affichage, un bouton installe un modèle de fiche et un modèle de carte par type. Vous les retouchez dans l’éditeur de blocs, comme une page. Si votre site est construit avec Elementor ou Divi, un module dédié ouvre ces modèles dans votre constructeur. Le guide Commencer avec WP-Apidae décrit chaque réglage.

Maintenance et mises à jour

Les données. Une fiche corrigée dans Apidae doit arriver sur le site. Un code maison doit prévoir cette resynchronisation. WP-Apidae la planifie toutes les 2 heures par défaut, et vous pouvez l’espacer jusqu’à 24 heures. Le temps réel existe en option, désactivé par défaut : une fois l’adresse du webhook déclarée dans la configuration technique du projet Apidae, Apidae prévient le site dès qu’une fiche change.

Le format d’Apidae. Apidae fait évoluer ses données : les classements et les labels rejoignent un tableau unique, les distinctions. Un connecteur maison doit suivre ce changement, site par site. WP-Apidae lit les distinctions depuis sa version 6.5.

Les pannes silencieuses. Une synchronisation qui s’arrête ne se voit pas toujours depuis le site. Nous l’avons constaté sur l’un de nos propres sites : 31 sélections sur 32 ne se mettaient plus à jour depuis onze mois, sans alerte. La version 6.3.8 a corrigé cette famille de pannes, et l’administration affiche pour chaque sélection sa dernière mise à jour. Avec un développement sur mesure, cette surveillance est à construire.

Le support. La licence WP-Apidae donne accès aux mises à jour et au support pendant un an. Un rapport de diagnostic décrit l’installation sans mot de passe, sans clé d’API ni contenu de fiche, ce qui évite souvent de demander un accès au site.

Un site en plusieurs langues

Apidae peut porter une fiche dans plusieurs langues, à condition que l’office les ait saisies.

• Widget : vous dépendez de ce que son éditeur a prévu. Vérifiez-le avant de vous engager.
• API : les langues font partie du code à écrire, en lien avec l’extension multilingue du site.
• WP-Apidae : l’extension importe six langues (français, anglais, allemand, espagnol, italien, néerlandais). Sans module, le site affiche sa propre langue. Avec le module Polylang, chaque fiche reçoit une traduction par langue importée, liée à la fiche d’origine. Un texte que l’office n’a pas traduit dans Apidae reste dans sa langue d’origine.

Cartes, filtres et agenda

Avec l’API, Apidae fournit des points d’accès pour l’agenda des événements. La carte, les filtres et la liste des événements à venir restent à concevoir et à coder.

Avec WP-Apidae, ces éléments sont des blocs à poser dans une page :

• le bloc Listing affiche une sélection en grille, en liste ou en agenda, avec pagination ou bouton « voir plus » ;
• les filtres portent sur toute taxonomie, les dates, le titre ou la capacité, et mettent à jour la liste et la carte placées sur la même page ;
• la carte propose sept fonds, dont le plan et la photo aérienne de l’IGN ;
• le bloc Prochains événements ne montre que les fêtes, manifestations et activités à venir.

Deux modules vont plus loin. La Carte globale affiche l’ensemble des fiches importées sur une seule carte. Events Calendar verse les fêtes et manifestations dans l’agenda de The Events Calendar, si votre site l’utilise déjà.

Quelle voie pour quel projet

Le widget : afficher une liste sans développement

Il convient si vous voulez une liste de fiches rapidement, sans budget de développement, et si vous acceptez que les fiches restent hors de votre site. Pour mesurer ce que ce choix change dans les moteurs de recherche, lisez Widget ou vraies pages : ce que Google et l’IA voient.

L’API : un besoin que rien d’existant ne couvre

Elle convient à une équipe qui garde des développeurs après la mise en ligne, et dont le besoin sort de ce qu’une extension sait faire. Le coût se mesure alors en jours de développement, puis en maintenance chaque année.

L’extension : des pages de fiche sur votre site, maintenues par l’éditeur

Elle convient à un office qui veut publier ses fiches comme des pages de son site, avec listes, cartes et filtres, sans porter la maintenance du connecteur. Elle convient aussi aux agences web qui intègrent Apidae pour plusieurs clients : les modèles de fiche s’exportent d’un site et s’importent sur un autre. La page Agences web et Apidae détaille les licences et le support pour ce cas.

Le cœur de WP-Apidae coûte 99 € HT par an et par site, et chaque module 49 € HT par an. Une licence achetée peut être remboursée dans les 14 jours. Si vous préférez déléguer la mise en place, l’installation par nos soins commence à 99 € HT.

Voir avant de choisir

Le site de démonstration publie de vraies fiches Apidae, en accès libre. La page Plugin WordPress Apidae présente l’extension étape par étape, de la connexion du projet aux blocs d’affichage.

Demander une démo · Voir les tarifs