Les Modèles WP-Apidae v6 définissent le rendu visuel de vos fiches touristiques — aussi bien les pages de détail (fiche single) que les cartes utilisées dans les listings. Chaque type de fiche (hébergement, restauration, activité…) peut avoir son propre modèle, construit avec les blocs Gutenberg dédiés.
En remplacement du système de templates PHP v5, les Modèles v6 sont des documents Gutenberg : visuels, configurables sans code, et versionnés comme les autres contenus WordPress.
Accéder aux Modèles
Dans l’administration WordPress, ouvrez WP-Apidae → Modèles. La page liste tous les modèles existants avec, pour chacun :
- Nom du modèle — libellé libre
- Type de modèle — Fiche (rendu single d’une fiche) ou Carte (rendu d’une card dans un listing)
- Type de fiche — type d’objet touristique Apidae auquel ce modèle s’applique (Restaurations, Hébergements locatifs, Activités…)
Trois actions sont disponibles en haut de la page :
- Nouveau modèle — créer un nouveau modèle (Fiche ou Carte)
- Importer — importer un modèle sauvegardé (JSON)
- Tout exporter — exporter l’ensemble de vos modèles pour reproduction sur un autre site
Créer un nouveau modèle
- Cliquez sur Nouveau modèle.
- Dans l’éditeur Gutenberg qui s’ouvre, renseignez le panneau latéral droit (onglet Modèle) :
Paramètres du modèle (panneau latéral)
- Titre du modèle — libellé interne (ne s’affiche pas en front)
- CPT associé — le type d’objet touristique (Activités, Hébergements locatifs, Restaurations, etc.). Le modèle s’appliquera aux fiches de ce type.
- Taxonomies associées — optionnel. Si renseigné, le modèle ne s’applique qu’aux fiches qui ont les termes sélectionnés (par exemple : ne pas utiliser le même rendu pour les restaurants gastronomiques que pour les bistrots).
Construire le modèle avec les blocs
Les blocs de templating sont regroupés dans la catégorie WP Apidae template de l’inserteur Gutenberg. Ils récupèrent automatiquement les données de la fiche en cours de rendu.
Les 21 blocs disponibles :
- Accueil, Adresse, Animaux, Clientèle, Descriptif, Descriptif thématisé, Environnement, Gallerie d’images, Handicap, Informations, Moyens de communication, Multimédia et documents, Ouvertures, Prestations, Réservation, Tarifs, Tourisme d’affaire — pour les sections standard d’une fiche
- Contenu dynamique — pour insérer des données spécifiques via des callbacks personnalisés
- Image dynamique — image qui varie selon la fiche
- Fiches liées — affiche les fiches associées à la fiche courante
- Carte fiche Apidae — carte Leaflet centrée sur la fiche
Combinez-les avec les blocs WordPress standards (colonnes, groupes, séparateurs, paragraphes…) pour structurer la mise en page. L’éditeur affiche un aperçu avec des données réelles de la fiche associée.
Types de modèles : Fiche vs Carte
Modèle de type Fiche
Définit le rendu de la page single d’une fiche — la page qu’on voit quand on accède à /{type}/{slug-de-la-fiche}/. Doit être riche : titre, galerie, description, informations pratiques, ouvertures, tarifs, adresse, carte, etc.
Modèle de type Carte
Définit le rendu d’une card dans un bloc Listing. Plus compact : image, titre, extrait, indicateurs de classement, bouton « Voir la fiche ».
Dans un bloc Listing, le type de modèle Carte à utiliser peut être sélectionné individuellement par type de fiche — ce qui permet d’avoir des cards différentes pour les hébergements et pour les événements, même dans un listing mixte.
Taxonomies associées : cas d’usage
Associer un modèle à des taxonomies permet une segmentation fine :
- Un modèle Fiche Restauration gastronomique avec un focus sur les distinctions (Michelin, Gault&Millau) et les réservations
- Un modèle Fiche Restauration locale plus compact, sans les éléments de classement
- Les deux modèles partagent le même CPT Restaurations mais sont discriminés par la taxonomie distinctions ou types
Le moteur de templating WP-Apidae choisit automatiquement le modèle le plus spécifique qui correspond à la fiche à rendre.
Surcharger un bloc templating
Chaque bloc de la catégorie WP Apidae template peut être surchargé côté thème par le pattern classique de surcharge Gutenberg (fichier render.php dans {theme}/wp-apidae/blocks/{nom-du-bloc}/). Pour des données non prises en charge par les blocs natifs, utilisez les callbacks dynamiques documentés dans la section Doc technique.
Sauvegarder et réutiliser un modèle
La Bibliothèque de design accessible en haut de l’éditeur (bouton Bibliothèque de design) permet de sauvegarder un modèle pour le réutiliser comme point de départ sur d’autres fiches ou d’autres types.
L’export JSON (Tout exporter) est utile pour dupliquer un jeu de modèles d’un site à un autre — par exemple d’un environnement de pré-production vers la production.
Aller plus loin
- Afficher vos sélections avec le bloc Listing
- Documentation technique — callbacks dynamiques et override de blocs
- Module Extended Blocks — 6 blocs de templating complémentaires