Souhaitez-vous afficher vos événements Facebook sur votre site WordPress ?
Dans ce guide, nous allons vous expliquer la procédure en trois étapes. Vous allez vous inscrire en tant que développeur Facebook, créer votre propre application Facebook et obtenir le jeton d'accès qui relie vos événements au plugin. Il vous suffit de disposer d'un accès administrateur à la page Facebook dont vous souhaitez afficher les événements.
Conditions requises: les flux d'événements nécessitent la licence « Elite » de Custom Facebook Feed Pro et la version 4.9.0 ou supérieure du plugin.
Avant de commencer, assurez-vous que l'extension « Custom Facebook Feed Pro » est bien installée et activée sur votre site WordPress.
Facebook restreint l'accès aux données relatives aux événements. C'est pourquoi les fils d'actualité consacrés aux événements fonctionnent un peu différemment des autres types de fils d'actualité. Ils s'affichent via une application Facebook que vous créez depuis votre propre compte Facebook.
Cela ne prend que quelques minutes. Vous n'aurez à le faire qu'une seule fois.
Obtenir le jeton d'accès à la page
Au cours de cette étape, vous allez générer un jeton d'accès utilisateur temporaire et le transmettre au plugin. Lors de la connexion, Custom Facebook Feed Pro l'échange contre un jeton d'accès à la page qui n'expire pas.
Le plugin vous demandera l'ID et la clé secrète de votre application. Copions-les dès maintenant.
Dans la barre latérale de gauche, accédez à « Paramètres de l'application » » « Général ».
En haut de la page, vous trouverez les champs « App ID » et « App secret ». Pour afficher la clé secrète, cliquez sur « Afficher ». Laissez cette page ouverte ou copiez ces deux valeurs dans un endroit sûr en vue de l'étape de connexion qui suivra.

Remarque : Considérez votre clé secrète d'application et votre jeton d'accès comme des mots de passe. Ne les communiquez jamais publiquement ni à quiconque en dehors de votre équipe, y compris à notre équipe d'assistance. Si vous avez besoin d'aide concernant votre source d'événements, générez un lien de connexion en un clic situé au bas de la page du plugin Aide page et envoyez-la-nous accompagnée du Informations sur le système tiré de cette même page.
Une fois ces deux valeurs en votre possession, vous êtes prêt à générer votre jeton d'accès.
Nous allons maintenant générer le jeton d'accès utilisateur qui relie votre application à votre compte Facebook.
Dans le menu supérieur de Facebook for Developers, accédez à Outils » Graph API Explorer, ou ouvrez directement le Graph API Explorer. Dans le panneau de droite, votre nouvelle application doit être sélectionnée sous « Meta App ».

Ensuite, ouvrez le menu déroulant « Ajouter une autorisation » et sélectionnez les 5 autorisations suivantes : business_management, pages_manage_engagement, pages_read_engagement, pages_read_user_content et pages_show_list. Les autorisations que vous avez ajoutées précédemment définissaient ce que votre application est autorisée à utiliser. Le fait de les sélectionner ici les applique à ce jeton spécifique. C’est pourquoi les 5 doivent être sélectionnées à nouveau, même si 2 d’entre elles étaient déjà incluses dans le cas d’utilisation.
Avant de continuer, vérifiez bien que les 5 éléments figurent bien dans la liste des autorisations. Une fois les autorisations configurées, cliquez sur « Générer un jeton d'accès ».

Une fenêtre de connexion Facebook s'affiche alors, vous demandant si vous souhaitez continuer avec le compte sur lequel vous êtes connecté. Si c'est le bon compte, cliquez sur « Continuer ».

Facebook vous demande ensuite à quelles Pages et à quelles entreprises l'application peut accéder. L'option par défaut, « Autoriser l'accès à toutes les Pages actuelles et futures », est la plus simple. Toute Page que vous créerez par la suite sera automatiquement prise en compte, sans que vous ayez à répéter cette configuration. Vous retrouverez ce même choix pour les entreprises sur l'écran suivant.
Si vous préférez limiter l'accès à l'application, l 'option « Opt in to current Pages » fonctionne tout aussi bien. Avec cette option, sélectionnez la Page dont vous souhaitez afficher les événements. Le plugin n'affiche que les Pages auxquelles votre jeton a accès. Vous devrez répéter cette configuration pour ajouter une Page que vous créerez ultérieurement.
Une fois que vous avez effectué votre choix sur chaque écran, cliquez sur « Continuer ».

Sur l'écran final, vérifiez le récapitulatif des droits d'accès, puis cliquez sur « Enregistrer ».

La fenêtre contextuelle se ferme. Votre nouveau jeton d'accès utilisateur s'affiche dans le champ « Jeton d'accès ». Cliquez ensuite sur l'icône de copie située à côté pour copier le jeton.

Remarque : Ce jeton est temporaire et n'est valable qu'environ une heure ; veillez donc à le coller dans le plugin sans attendre. Une fois que vous l'aurez saisi, Custom Facebook Feed Pro le remplacera par un jeton de page qui n'expire pas.
Une fois que vous disposez de votre identifiant d'application, de votre clé secrète d'application et de votre jeton, retournez sur votre site WordPress. Dans votre tableau de bord WordPress, accédez à « Flux Facebook » > « Paramètres ».

Dans la section « Gérer les sources », cliquez sur la flèche située à droite du bouton « Ajouter une source » et sélectionnez « Source d'événements » dans le menu déroulant.

Cela ouvre le formulaire « Connecter une source d'événements ».

Dans le formulaire, collez votre identifiant d'application (App ID), votre clé secrète d'application (App Secret) et votre jeton d'accès utilisateur (User Access Token). Cliquez ensuite sur « Se connecter ».

Le plugin récupère les pages Facebook que vous gérez et les répertorie. Dans la liste, sélectionnez la page dont vous souhaitez afficher les événements. Cliquez ensuite sur « Ajouter ».
Remarque : vous devez être administrateur de la page Facebook dont vous souhaitez afficher les événements, sinon aucun événement ne s'affichera.

C'est tout ce dont le plugin a besoin. Votre page apparaît désormais dans la section « Gérer les sources » en tant que source d'événements.
Custom Facebook Feed Pro se charge ensuite du jeton : il convertit votre jeton temporaire en un jeton d'accès à la Page qui n'expire pas. Votre ID d'application et votre clé secrète ne sont pas stockés sur votre site.

Dès que votre page apparaît dans cette liste, la connexion est établie. La source est indiquée comme « non utilisée » car aucun flux ne s'y connecte encore. C'est précisément ce que nous allons configurer ensuite.
Votre source d'événements est prête à l'emploi. Créons votre premier flux d'événements.
Depuis votre tableau de bord WordPress, rendez-vous dans « Flux Facebook » → « Tous les flux », puis cliquez sur « Ajouter un nouveau flux ». Sélectionnez ensuite le type de flux « Événements ».

Et voilà ! Votre source « Événements Facebook » est connectée, et vous n'aurez rien à renouveler par la suite. Découvrez ensuite notre guide sur Afficher les événements Facebook sur votre site web pour découvrir le guide complet sur la création et la personnalisation de votre fil d'événements.
Collez votre jeton d'accès de l'étape 11 dans le champ ci-dessous et cliquez sur Extend my token.
Nous vous félicitons ! Vous avez généré avec succès votre jeton d'accès aux événements. Vous obtenez une erreur ou vous êtes bloqué ? Consultez notre section de dépannage ci-dessous ou contactez le service d'assistance.
Si vous recevez le message d'erreur suivant :
(#10) Pour utiliser la fonction "Page Public Content Access", votre utilisation de ce point de terminaison doit être examinée et approuvée par Facebook. Pour soumettre cette fonctionnalité "Page Public Content Access" à un examen, veuillez consulter notre documentation sur les fonctionnalités à examiner : https://developers.facebook.com/docs/apps/review.
Vérifiez ensuite les trois points suivants :
- Que vous êtes un administrateur de la page Facebook dont vous essayez d'afficher les publications.
- Que l'application est en mode "Développement" et non "Live"
- Vous avez sélectionné la bonne application et la bonne page Facebook aux étapes 2.2-2.3 et 3.8.
Questions fréquemment posées
Vous trouverez ci-dessous les réponses à certaines des questions les plus fréquentes concernant la connexion de vos événements Facebook.
Mon jeton d'accès a-t-il une date d'expiration ?
Non. Le jeton que vous générez dans l'Explorateur de l'API Graph est temporaire. Lorsque vous cliquez sur « Se connecter », le plugin le remplace par un jeton d'accès à la page qui n'expire pas. Vous n'aurez pas besoin de le renouveler manuellement.
Dois-je publier mon application Facebook ou la soumettre à l'App Review ?
Non. Votre application peut rester en mode Développement. Étant donné qu'elle se contente de lire les événements d'une page que vous gérez, elle fonctionne sans passer par la vérification de l'application ni par la publication.
De quelles autorisations mon application a-t-elle besoin ?
Votre application nécessite au total 5 autorisations : business_management, pages_manage_engagement, pages_read_engagement, pages_read_user_content et pages_show_list. La première et la dernière sont incluses automatiquement lorsque vous configurez le cas d'utilisation « Gérer tout sur votre page ». Le jeton que vous générez dans l'Explorateur de l'API Graph doit inclure ces 5 autorisations.
Que signifie « Aucune page Facebook n'a été trouvée pour ce jeton » ?
Cela signifie que le jeton reçu par le plugin n'a pas encore accès à vos Pages. Générez un nouveau jeton dans l'Explorateur de l'API Graph en sélectionnant les 5 autorisations, en particulier « business_management ». Lorsque la fenêtre contextuelle vous le demande, acceptez l'accès à vos Pages et à vos entreprises. Si vous avez récemment mis à jour le plugin, actualisez la page « Paramètres » en effectuant une actualisation complète avant de réessayer.
J'ai configuré mon flux d'événements avec une URL iCal. Dois-je modifier quelque chose ?
Non. Les flux d'événements existants qui utilisent une URL iCal continuent de fonctionner tels quels. La connexion « Source d'événements » décrite dans ce guide permet de configurer les nouvelles connexions d'événements.
Les informations relatives à mon application Facebook sont-elles stockées sur mon site web ?
Seul le jeton d'accès de la page connectée est stocké, sous forme chiffrée. Votre identifiant d'application (App ID) et votre clé secrète d'application (App Secret) ne sont utilisés qu'une seule fois lors de la connexion pour récupérer vos pages et ne sont pas enregistrés par le plugin.