Event API Addon

Le Event API Addon est un utilitaire puissant conçu pour Modern Events Calendar Cela vous permet d'afficher vos événements de manière fluide sur des applications et plateformes web externes. En générant des scripts ou des fichiers JSON, vous pouvez synchroniser les données d'événements sur plusieurs domaines sans ressaisie manuelle.

Configuration initiale et exigences

Installation

Avant de commencer, assurez-vous de remplir les conditions suivantes :

Activation: Accédez au menu des plugins WordPress et assurez-vous que les deux MEC et la Event API Addon sont actifs.

MEC Lite ou Pro : Contrairement à certains addons, le Event API fonctionne avec les deux versions de Modern Events Calendar.

Le Event API

Vous pouvez générer une API soit pour un groupe spécifique d'événements (via des codes courts), soit pour une page d'événement individuelle.

Event API pour les codes courts

Pour afficher une vue de calendrier spécifique sur un autre site web :

1. Accédez à MEC > Codes courts.
2. Localisez le code court souhaité et cliquez Créer une API.

Event API pour les événements uniques

Pour afficher les détails d'un événement sur un autre site web :

1. Accédez à MEC > Tous les événements.
2. Trouvez l'événement de votre choix et cliquez Créer une API.

Gestion du hub API

Une fois que vous aurez cliqué sur « Créer une API », vous serez redirigé vers l’interface de gestion. Cette page est divisée en deux sections principales :

Gestion de domaine (côté gauche)

• Autorisation de domaine : Saisissez le ou les domaines spécifiques sur lesquels vous souhaitez que l'événement soit affiché. Vous pouvez également configurer l'API pour qu'elle fonctionne sur Tous les domaines.
• Suppression de l'accès : Pour révoquer l'accès, sélectionnez le(s) domaine(s) et cliquez sur Icône de la corbeilleCela désactive immédiatement l'API pour ces emplacements spécifiques.
• Finaliser: Cliquez toujours sur Bouton Générer une fois vos paramètres de domaine configurés.

Extraction de données (côté droit)

La partie droite contient les outils nécessaires à la création de votre site web de destination :

• Champ de script : Contient un script que vous pouvez copier dans votre presse-papiers. Utilisez-le pour intégrer le contenu directement dans le code HTML d'un autre site.
• Champ JSON : Fournit des données d'événements au format JSON, idéal pour les développeurs qui souhaitent intégrer des données brutes dans une application web personnalisée.

Vous pouvez voir des exemples de l'API utilisée ci-dessous :

---

Astuce Pro: Assurez-vous que votre fournisseur d'hébergement dispose de iframes activée sur votre site web, car le script nécessite cette fonctionnalité pour afficher correctement le contenu.

Paramètres globaux et personnalisation

Vous pouvez trouver les options de configuration globale en naviguant vers Paramètres MEC > Paramètres > Event API.

• Intégration de la source : Vous pouvez choisir d'inclure le site web source. En-tête et pied de page dans le résultat du site web de destination.
• Limites de l'événement : Contrôlez le nombre d'événements affichés dans le résultat du shortcode afin de maintenir une mise en page cohérente.

Cas d'utilisation (Quand ce module complémentaire est utile)

• Syndication multiplateforme : Idéal pour les organisations qui gèrent un calendrier d'événements principal mais qui ont besoin d'afficher des calendriers spécifiques sur des sites web partenaires ou des sous-domaines.
• Intégration d'applications mobiles : Idéal pour les développeurs utilisant Format JSON pour intégrer des données d'événements en temps réel dans une application mobile native.
• Gestion centralisée: Utile pour les agences gérant plusieurs sites clients qui souhaitent mettre à jour un événement une seule fois dans une plateforme centrale et que la modification soit instantanément visible partout.

Situations dans lesquelles ce module complémentaire peut ne pas être idéal

• Restrictions de l'hôte : Si votre fournisseur d'hébergement bloque strictement iframesLa méthode de script standard ne fonctionnera pas.
• Sites nécessitant une optimisation poussée : Si le site de destination utilise des plugins d'optimisation de vitesse agressifs, ceux-ci peuvent bloquer les liens vers les scripts externes nécessaires au chargement de l'API.
• Conformité stricte au RGPD : Les plugins de consentement aux cookies tiers présents sur le site source peuvent parfois être répercutés sur le site de destination, ce qui peut nécessiter des modifications techniques supplémentaires pour être résolu.

Dépannage pour les débutants

• Les événements ne se chargent pas ? Si vous utilisez des plugins d'optimisation (comme WP Rocket ou Autoptimize), vous devez exclure les « liens externes » dans ces plugins afin que le script API ne soit pas ignoré.
• Script non fonctionnel ? Vérifiez que vous avez bien cliqué sur Bouton Générer après avoir ajouté vos domaines ; sinon, l’API reste inactive.
• Problèmes de mise en forme ? Si l'affichage semble « défectueux » sur le nouveau site, essayez de basculer le En-tête et pied de page options dans le Event API paramètres pour voir lequel correspond le mieux au CSS de la destination.

QFP