Comment configurer une application de lecteur de flux RSS Facebook pour votre blog

Version 1.0
Auteur : Falko Timme

Ce guide montre comment vous pouvez créer une application de lecteur de flux RSS pour le réseau social Facebook qui affichera le flux RSS de votre blog/site web sur les pages de profil des utilisateurs de Facebook (qui ont installé l’application de lecteur de flux RSS). Chaque élément du flux RSS aura un bouton Partager afin que les gens puissent partager l’histoire avec leurs amis, et l’application aura un lien Inviter afin que les gens puissent inviter jusqu’à dix amis à la fois à installer également cette application de lecteur de flux. J’utiliserai PHP5 pour construire l’application de lecteur de flux RSS. Pour analyser le flux RSS et générer du HTML à partir de celui-ci, j’utiliserai Magpie RSS.

Vous pouvez voir cette application en action en installant le lecteur de flux RSS HowtoForge pour Facebook.

Ce document est fourni sans garantie d’aucune sorte ! Je ne donne aucune garantie que cela fonctionnera pour vous !

1 Remarque préliminaire

Ce guide est basé sur un exemple du monde réel, le lecteur de flux RSS HowtoForge pour Facebook, et j’utiliserai les vraies URL et scripts dans cet exemple (en remplaçant uniquement les données secrètes comme la clé API et le Secret).

Comme je l’ai mentionné précédemment, j’utilise PHP5 pour construire cette application, en utilisant la bibliothèque cliente PHP de Facebook. Théoriquement, vous pouvez également utiliser PHP4, mais la plateforme cliente est optimisée pour PHP5, donc vous devriez utiliser cela si possible.

J’utilise l’hôte fb.howtoforge.com dans cet exemple pour héberger l’application ; c’est un site web compatible PHP5.

Avant de pouvoir commencer à écrire votre propre application Facebook, vous devez vous inscrire sur Facebook (si vous n’avez pas encore de compte) et ajouter l’application développeur Facebook à votre compte, comme décrit sur http://developers.facebook.com/get_started.php :

Ensuite, vous devriez commencer avec ces exemples pour vous habituer à créer des applications Facebook. Cependant, j’utiliserai à nouveau ces exemples dans ce tutoriel (au début) pour m’assurer que tout fonctionne comme prévu avant d’essayer d’écrire mes propres éléments.

2 Configurer une nouvelle application

Avant de commencer à programmer notre application, nous devons informer Facebook à son sujet, et Facebook nous donnera alors une clé API et un Secret dont nous avons besoin pour construire l’application.

Maintenant que vous avez ajouté l’application développeur Facebook à votre compte, allez sur votre page Facebook - vous devriez maintenant voir l’application Développeur dans la navigation à gauche. Cliquez dessus. La page Développeur s’ouvre, où vous cliquez sur le bouton + Configurer une nouvelle application (près du coin supérieur droit) :

Nous sommes maintenant sur la page Nouvelle application. Je veux nommer mon application HowtoForge RSS Feed Reader, donc je remplis cela comme Nom de l’application. Je coche la case en dessous de ce champ pour montrer que j’accepte les conditions de la plateforme Facebook. Ensuite, je remplis une adresse e-mail de support (cela devrait être une adresse où vous ou vos collègues développeurs pouvez être contactés). L’URL de rappel est l’emplacement où l’application sera hébergée. La mienne sera hébergée sous http://fb.howtoforge.com/fb/htf_feed_reader/, donc je remplis cela. L’URL de la page Canvas est l’adresse Facebook que vous souhaitez que votre application ait. Remplissez votre adresse souhaitée (par exemple http://apps.facebook.com/htf_feed_reader), et le formulaire vous dira alors si l’adresse est encore disponible ou non. Ensuite, sélectionnez Utiliser FBML et Site Web (les deux devraient déjà être la sélection par défaut) :

Une note importante concernant l’URL de rappel : Il est absolument important que l’URL se termine par une barre oblique ( /) ; si ce n’est pas le cas, les gens obtiendront plus tard l’erreur célèbre L’URL … n’a pas répondu. chaque fois qu’ils visitent votre application dans leurs comptes, comme ceci :

Ensuite, toujours sur la page Nouvelle application, remplissez les autres options. Répondez à la question Votre application peut-elle être ajoutée sur Facebook ? par Oui. Vous pouvez laisser le champ URL des CGU vide si vous n’avez pas de conditions d’utilisation. Ajoutez des développeurs supplémentaires s’il y en a. Comme URL de Post-Add, utilisez l’URL de la page Canvas ( http://apps.facebook.com/htf_feed_reader dans mon cas). Remplissez une description pour votre application. L’URL de Post-Remove peut également être laissée vide. Dans le champ FBML par défaut, vous pouvez entrer du texte que vous aimeriez voir apparaître sur les profils des utilisateurs si votre application ne fournit pas de contenu pour la page de profil. Ensuite, sélectionnez dans quelle colonne de profil vous souhaitez que votre contenu apparaisse. Comme il y a beaucoup de texte dans les flux RSS, la colonne large est un bon choix dans notre cas :

Plus bas sur la page Nouvelle application, il y a juste un autre champ que nous devons remplir, l’URL de la barre latérale. Encore une fois, c’est la même que l’URL de la page Canvas ( http://apps.facebook.com/htf_feed_reader dans mon cas). Tous les autres champs peuvent être laissés vides. Cliquez ensuite sur Soumettre :

Vous devriez maintenant être sur la page Mes applications où vous pouvez trouver la clé API et le Secret pour votre application. Copiez-les, nous en aurons besoin pour notre application plus tard.

Plus bas sur la page Mes applications, vous verrez un lien vers la bibliothèque cliente PHP (4 et 5) :