1/ Créer un profil de développement
Cette étape n’est pas indispensable mais recommandée : pour ne pas faire bénéficier tous vos amis personnels de votre nouvelle application, il est recommander de créer un profil Facebook spécialement dédié au développement d’applications. Vous n’oublierez pas bien entendu de lui ajouter une dizaine d’amis, de l’inscrire à quelques groupes, et de remplir intégralement votre profil afin de pouvoir tester correctement vos futurs développements.
2/ S’identifier auprès de Facebook Developer application
Vous devez commencer par vous identifier auprès de Facebook. Pour cela, cliquez sur ce lien
Cliquez sur “Autoriser” pour laisser la Developer application accéder à votre profil.
3/ Remplir les informations de base de l’application
Cliquez sur “Set Up New Application” pour commencer la création de votre nouvelle application et acceptez les conditions d’utilisation (après les avoir soigneusement lues : on ne peut pas faire n’importe quoi et les conditions d’utilisation des applications facebook sont plutôt strictes).
Vous pourrez alors récupérer quelques informations importantes :
- votre API key : elle permet d’identifier votre application auprès de Facebook, et il vous faudra la passer lors des appels à l’API.
- votre code secret : Facebook utilise cette clef secrète pour authentifier les requètes que vous effectuez.
Vous pouvez ensuite indiquer une description, donner un logo, ainsi que modifier le contact de votre application. Vous devriez tout de suite remplir correctement ces informations car elles sont importantes pour avoir un rendu professionnel et faire un bon buzz, et ce sont typiquement les éléments qu’on oublie de modifier une fois qu’on est plongé dans le code.
Vous noterez qu’il est possible d’entrer des URL pour une page d’aide, la politique de conditentialité, et les conditions générales de l’application : ce n’est pas là par hasard, créez ces trois pages et ajoutez les liens afin d’avoir une approche vraiment professionnelle.
Quand tout est modifié, cliquer sur “Edit Settings”.
4/ Mise en place du code de base
Sur un serveur de développement (si vous ne savez pas ce que c’est, vous devriez relire l’article concernant le niveau minimum requis pour pouvoir développer une application Facebook), placez :
- le contenu de l’archive que vous pourrez télécharger à cette adresse contenant la librarie client
- un fichier pour tester que tout fonctionne bien comme par exemple celui que vous pourrez trouver en allant à la developper page en bas (Exemple de code).
Evidemment vous n’oublierez pas de vérifier que c’est bien votre propre clef et votre propre code secret, sinon ça ne fonctionnera pas.
5 / Indiquer les urls à Facebook
De retour sur notre compte Facebook Developper, il s’agit maintenant d’indiquer à Facebook l’url à laquelle il pourra trouver les fichiers que nous venons de mettre en place. Pour cela, il faut cliquer sur “Modifier les paramètres”, puis en haut à gauche sur “Canevas”.
Les informations à rentrer sont :
- Callback url : l’url de votre serveur à laquelle peut être atteinte l’application
- Canvas page URL : là où va être accessible l’application sur Facebook. A priori, il faut indiquer le nom de l’application, ou au moins quelque chose de proche.
Il y a ensuite plein d’options intéressantes, mais nous en reparlerons ultérieurement.
Allez désormais à l’adresse que vous avez indiqué en Canvas. Normalement cela doit fonctionner.
Aïe : ça ne fonctionne pas. Comment ça se fait ?
Si vous avez suivi soigneusement ce guide, cela devrait fonctionner, mais les erreurs les plus fréquentes sont :
- Vous n’avez pas chargé la librairie de scripts, ou vous l’avez mal chargé : comme indiqué dans le readme (que vous n’avez sûrement pas lu), il faut mettre les fichiers contenus dans le dossier php/ de l’archive que vous avez téléchargée à la racine (là où vous avez aussi mis le fichier index).
- Vous avez testé des petits changements de configuration en cours de route : deux solutions - soit vous vous souvenez de ce que vous avez changé, et vous remettez tout en place; soit vous recommencez. Vous avez eu raison de vouloir faire des tests, c’est comme ça qu’on apprend. Mais commencez par réussir à afficher une application avant de vouloir faire trop de tests.