SDK JavaScript - Configuration avancée

Lisez notre guide de démarrage rapide pour apprendre à charger et initialiser le SDK Facebook pour JavaScript. Même si ce guide de démarrage rapide utilise, pour les options disponibles, des valeurs par défaut courantes pour initialiser le SDK, vous pouvez en personnaliser certaines.

Modification de la langue

Dans l’extrait de configuration de base, la version en_US du SDK est initialisée. Cela signifie que tous les boutons et plugins générés par Facebook et utilisés sur votre site seront en anglais américain. (Toutefois, les boîtes de dialogue générées par Facebook comme la boîte de dialogue Login seront dans la langue que la personne a choisi dans Facebook, même si celle-ci diffère de celle que vous avez sélectionnée.) Pour modifier cette langue, changez la valeur de src dans l’extrait. Consultez la page réservée à la localisation pour voir les différentes langues qu’il est possible d’utiliser. Par exemple, si votre site est en espagnol et que vous chargez le SDK avec le code ci-dessous, tous les plugins sociaux s’afficheront en espagnol.

<script async defer crossorigin="anonymous" src="https://connect.facebook.net/es_LA/sdk.js"></script> 

Vérification du statut de connexion

Si vous définissez status sur true dans l’appel FB.init(), le SDK tentera d’obtenir des informations sur l’utilisateur ou l’utilisatrice actuel·elle, immédiatement après l’initialisation. En procédant ainsi, il est possible de passer moins de temps à vérifier l’état d’une personne connectée si vous utilisez Facebook Login. Par contre, cela se révèle inutile pour les Pages qui ne contiennent que des plugins sociaux.

Vous pouvez utiliser FB.getLoginStatus pour obtenir l’état de connexion d’une personne. Apprenez-en davantage sur l’utilisation de Facebook Login avec le SDK JavaScript.

Désactivation de l’analyse XFBML

En définissant xfbml sur true, le SDK analysera l’attribut DOM de votre Page pour rechercher et initialiser tous les plugins sociaux qui ont été ajoutés avec XFBML. Si vous n’utilisez pas de plugins sociaux sur la Page, définissez xfbml sur false pour en améliorer les temps de chargement. Pour en savoir plus à ce sujet, attardez-vous sur les plugins sociaux.

Déclenchement du code au chargement du SDK

La fonction affectée à window.fbAsyncInit s’exécute dès que le chargement du SDK se termine. Tout code que vous voulez exécuter après le chargement du SDK doit être placé dans cette fonction et après l’appel de FB.init. Le code JavaScript utilisé ici importe peu. Cependant, toutes les fonctions du SDK doivent être appelées après FB.init.

Débogage

Pour améliorer les performances, le SDK JavaScript est chargé dans un format réduit. Vous pouvez également charger une version débuguée du SDK JavaScript qui intègre plus de consignation et une vérification plus poussée des arguments, le tout dans un format non réduit. Pour cela, modifiez la valeur src dans votre code de chargement et utilisez la valeur suivante :

src="https://connect.facebook.net/en_US/sdk/debug.js"

Nous recommandons de ne pas utiliser la version de débogage dans votre environnement de production. En effet, sa charge utile est plus importante, ce qui pourrait nuire aux performances de votre Page.

Autres options d’initialisation

Le document de référence pour la fonction FB.init fournit une liste complète des options d’initialisation disponibles.