Démarrage rapide : SDK Facebook pour JavaScript

Le SDK Facebook pour JavaScript fournit un nombre important de fonctionnalités côté client qui :

  • vous permettent d’utiliser le bouton J’aime et d’autres Social Plugins sur votre site ;
  • vous permettent d’utiliser la fonctionnalité Facebook Login pour accélérer le processus d’inscription sur votre site ;
  • facilitent l’appel de l’API Graph de Facebook ;
  • lancent des boîtes de dialogue qui permettent aux gens d’effectuer diverses actions telles que le partage d’actualités ;
  • facilitent la communication lorsque vous développez un jeu ou créez un onglet application sur Facebook.

Le SDK, les Social Plugins et les boîtes de dialogues fonctionnent sur les navigateurs web sur mobile et ordinateur.

Ce guide de démarrage rapide vise à vous expliquer comment configurer le SDK et l’utiliser pour passer quelques appels de base vers l’API Graph. Si vous ne souhaitez pas encore le configurer, vous pouvez utiliser notre console de tests JavaScript pour utiliser l’ensemble des méthodes du SDK et consulter quelques exemples (vous pouvez ignorer les étapes de configuration, mais les autres éléments de ce guide peuvent être testés dans la console).

Configuration de base

Le SDK Facebook pour JavaScript ne comporte aucun fichier autonome devant être téléchargé ou installé. Vous devez simplement inclure un extrait de code JavaScript habituel dans votre protocole HTML qui chargera le SDK sur vos pages de manière asynchrone. Le chargement asynchrone ne bloque pas le chargement d’autres éléments de votre page.

L’extrait de code ci-dessous fournit la version de base du SDK, dont les paramètres sont réglés sur leurs valeurs courantes par défaut. Vous devez l’insérer directement après l’ouverture de la balise <body> sur chaque page sur laquelle vous souhaitez le charger :

<script>
  window.fbAsyncInit = function() {
    FB.init({
      appId            : 'your-app-id',
      autoLogAppEvents : true,
      xfbml            : true,
      version          : 'v2.11'
    });
  };

  (function(d, s, id){
     var js, fjs = d.getElementsByTagName(s)[0];
     if (d.getElementById(id)) {return;}
     js = d.createElement(s); js.id = id;
     js.src = "https://connect.facebook.net/en_US/sdk.js";
     fjs.parentNode.insertBefore(js, fjs);
   }(document, 'script', 'facebook-jssdk'));
</script>
    

Ce code chargera et initialisera le SDK. Vous devez remplacer la valeur dans your-app-id par l’identifiant de votre propre application Facebook. Utilisez l’Espace App pour trouver cet identifiant.