WP-Apidae vous offre la possibilité d’afficher vos sélections dans une page de votre site WordPress grâce au bloc Gutenberg « Listing ».
Avant de pouvoir afficher une sélection de la base Apidae Tourisme, assurez-vous que celle-ci soit bien importée dans votre site. Consulter l’article Comment importer une sélection ?

Utilisation du bloc Gutenberg « Listing »

Créez une nouvelle page sur votre site et saisissez un titre.

Ajoutez un nouveau bloc dans votre page et recherchez « Listing »

Dans le bloc, définissez la sélection que vous souhaitez afficher. Seules les sélections importées dans votre site vous seront proposées.

Dans le panneau latéral de droite vous allez pouvoir définir les options d’affichages :

• Nombre de colonnes : Défini le nombre de colonnes de l’affichage
• Fiches par page : Permet de définir combien de fiches seront affichées.
• Classer par dates : L’activation de cette option classera les fiches par dates d’événements, de la plus proche à la plus lointaine.
• Afficher la pagination

Si ces premières configurations sont bien renseignées, vous devriez avoir un aperçu de votre sélection dans le bloc Gutenberg.

Vous pouvez publier votre page !

Les options avancées

Ordonner les résultats par critères internes

Vous avez la possibilité de mettre en avant vos partenaires, en les affichant en tête des résultats. Si vous avez défini des critères internes sur vos fiches Apidae, vous pouvez renseigner ce critère.

Tapez simplement le nom de votre critère interne, comme par exemple « Partenaire ». Cliquez sur Entrée. Vous devriez voir votre listing se mettre à jour dans l’éditeur.

Attention : Vous ne pouvez pas combiner le classement par date et la mise en avant par critères internes.

Après avoir importé votre sélection Apidae dans votre site, elle apparaitra sur l’écran des sélections importées.

Depuis cet écran vous pourrez forcer la mise à jour, supprimer la sélection ou éditer les réglages de cette sélection.

Réglages de la sélection

Vous pouvez retrouver un ensemble d’informations relatif à votre sélection, mais aussi définir des options globales sur l’affichage de celle-ci.

Les boutons d’action

• Forcer la mise à jour : Relance une synchronisation complète des fiches avec la base Apidae.
• Re-indexer : Permet de ré-indexer les informations des fiches dans votre site. (Ne fait pas appel à l’API Apidae).
• Enregistrer : Enregistrer les modifications faites.
• Supprimer : Supprime l’ensemble de la sélection et les fiches attachées. (Si une fiche appartient à plusieurs sélections, elle sera conservée).

Informations générales

Détails de la sélection

Vous retrouvez dans cette section les éléments suivant :

• Nom de la sélection : Nom de votre sélection.
• Identifiant Apidae : Identifiant de la sélection sur la base Apidae.
• Nombre de fiches : Nombre de fiches dans la sélection.
• Dernière mise à jour : La date et l’heure de la dernière vérification de votre sélection.
• Shortcode* : Le code court que vous pouvez utiliser pour afficher votre sélection sur une page de votre site WordPress.

* Les shortcodes appartiennent à l’ancien système d’affichage et ne sont plus utilisés dans les dernières évolutions de WP-Apidae.

Utilisation de la sélection sur votre site

Retrouvez dans cette section, les pages utilisant le bloc Gutenberg pour afficher cette sélection.

Journal des erreurs

Retrouvez dans l’onglet erreur, le journal des erreurs pendant l’import. Vous pouvez cliquer sur le nom de la fiche pour effectuer des changements/corrections sur votre fiche Apidae.

Une fois WP-Apidae configuré, vous pouvez importer vos sélections.

Rendez-vous sur l’onglet sélections et cliquez sur le bouton « Importer une sélection »

Vous arriverez sur l’écran qui liste les sélections disponibles pour votre projet.

Choisissez la sélection Apidae que vous souhaitez importer dans votre WordPress et cliquez sur l’icone d’import.

Vous pouvez ensuite retourner sur l’écran sélection. Patientez pendant que votre sélection se synchronise.

Avant de commencer l’import de vos sélections Apidae sur votre site WordPress, prenez le temps de paramétrer les réglages de WP-Apidae.

Les réglages sont divisés en 4 onglets :

Connexion Apidae

Informations de connexion

Vous retrouvez dans cette zone l’identifiant ainsi que la clé Api de votre projet Apidae. Ces informations ne peuvent pas être modifiées, elle sont ici à titre informatif.

Fréquence de mise à jour des sélections

Réglez la fréquence à laquelle WP-Apidae va interroger la base Apidae pour vérifier les mises à jours. Par défaut la vérification s’effectue toute les 2 heures.

Langues à importer

Définissez les langues qui seront importées pour vos fiches Apidae. Le Français est importé par défaut et ne peut pas être désactivé.

Attention : L’activation de l’import d’une autre langue ne suffit pas à la gestion d’un site multilingue. L’import d’une autre langue permet d’afficher une fiche Apidae selon la langue principale définie dans les réglages de votre site WordPress.

Gestion des objets Touristique

Vous pouvez gérer les types d’objets touristique qui seront pris en charge par WP-Apidae. Chaque types correspond à un type de post personnalisé dans WordPress (exemple : Activité devient le type de post ad_activite).

Objets touristique à importer

Activer les types d’objets touristique qui seront pris en charge par WP-Apidae.

Slug des objets touristique

Vous pouvez changer les slugs des différents types de post personnalisés.

Attention : Les slugs dans WordPress doivent être unique, sinon vous risquez de rencontrer des disfonctionnements sur certaines partie de votre site. Après avoir changer le slug d’un type de post, pensez à régénérer les permaliens de votre site (Réglages -> Permaliens), juste en cliquant sur enregistrer.

Images

WP-Apidae gère l’import et la synchronisation des images de vos fiches Apidae. En cas d’indisponibilité de la base Apidae, il n’y aura pas de défaut d’affichage de celles-ci.

Tailles des images à importer

Lorsqu’une image est présente sur une fiche, Apidae génère plusieurs tailles de celle-ci.
Dans WP-Apidae, vous pouvez définir quelle taille d’image sera prise en compte pour la génération des différents formats sur votre site.

L’utilisation d’une grande taille d’image permettra un affichage de meilleur qualité, mais occupera plus de place sur votre hébergement.

Taille des images

WP-Apidae génère 3 formats d’images par fiche :

• Miniature : Ce format est utiliser pour l’affichage des sélections. Par défaut le format est de 210px * 140px. L’image est recadrée selon son ratio.
• Image principale : C’est la photo principale visible sur le détail d’une fiche. Par défaut le format est de 600px de large.
• Image secondaire : Ce sont les photos qui composent le diaporama sur le détail d’une fiche. Par défaut le format est de 300px * 200px.L’image est recadrée selon son ratio.

Vous pouvez modifier ces valeurs, pour adapter l’affichage à votre thème. Le changement de valeur s’appliquera au future images importées. Les images déjà présentent seront recalculées automatiquement, sans avoir a utiliser une extension de régénération d’images.

Image par défaut*

Vous pouvez définir une image qui sera utilisée si vos fiches n’ont pas de photos.

Thème

Options générales*

Les options générale de thème vous permettent de :

• Activer/désactiver JQuery : Dans un soucis de compatibilité avec d’autres extensions, vous pouvez décider de désactiver JQuery si celui-ci est déjà chargé par un autre plugin.
• Activer/désactiver les CSS : Vous pouvez complètement désactiver les CSS de WP-Apidae, afin de créer vous même les styles qui conviendront le mieux au thème de votre site.

Couleurs des vignettes et pagination*

Vous pouvez définir des couleurs pour les fond des fiches et de la pagination pour l’affichage de vos sélections Apidae.

* Ces options ne concerne que les utilisateurs qui utilisent l’ancien système de templating (le templating par surcharge).

Pour profiter des dernières mises à jour de l’extension, vous devez valider votre licence.

Pour activer votre licence, vous devez vous rendre sur le tableau de bord de WP-Apidae.

1. Collez votre licence
2. Renseignez l’email de la licence
3. Cliquez sur activer la licence

Et c’est tout !

Si vous rencontrez des difficultés à activer votre licence, n’hésitez pas a contacter le support depuis votre espace client.

Préparer son projet sur Apidae

Avant de pouvoir commencer à utiliser WP-Apidae, nous vous conseillons de vérifier la configuration de votre projet sur Apidae :

• Connectez-vous à votre compte Apidae : https://base.apidae-tourisme.com/
• Sélectionnez le projet que vous souhaitez synchroniser avec votre site WordPress.
• Dans l’onglet Informations générales, copiez l’identifiant et la clé d’API de cotre projet.
• Vérifiez que le dernier calcul des sélections à bien eu lieu récement.

• Dans l’onglet Configuration technique, cliquez sur l’icone de modification.
• Assurez-vous que les éléments suivants soient configurés
  • Technologies utilisées : API
  • Fréquence de génération : Quotidien
  • Temps réel : Coché si vous désirez utiliser le temps réel.
  • Webhook : si vous utilisez le temps réel, vous pouvez renseigner ce champs (https://monsite.fr/wp-json/wp-dae/v1/apidae/update)
• Format : JSON
• Version du format de sortie : V2
• Exporter les dates d’ouverture : Coché

Pré-requis

Nous recommandons l’utilisation de PHP 7.4 ou supérieur et WordPress 5.8 au minimum.

Installation et activation de WP-Apidae

Après l’achat de votre licence WP-Apidae, rendez-vous sur votre compte pour télécharger la dernière version de WP-Apidae.

Ensuite allez dans votre administration WordPress, extensions, ajouter et téléversez l’archive ZIP de l’extension.

Cliquez sur Activer.

Renseignez l’identifiant et la clé API de votre projet Apidae. Vous trouverez ces informations directement sur Apidae, dans l’onglet « Informations générales » de votre projet.