JavaScript-SDK – Erweitertes Setup

In unserem Leitfaden zur Kurzanleitung erfährst du, wie du das Facebook-SDK für JavaScript lädst und initialisierst. Bei der Kurzanleitung werden häufig verwendete Standardwerte für die verfügbaren Optionen beim Initialisieren des SDK eingesetzt. Einige dieser Optionen kannst du anpassen.

Ändern der Sprache

Im Codeausschnitt des einfachen Setups wird die en_US-Version des SDK initialisiert. Das bedeutet, dass alle von Facebook generierten Buttons und Plugins, die auf deiner Webseite verwendet werden, auf Englisch sind. (Von Facebook generierte Popup-Dialoge, wie der Login-Dialog, erscheinen aber in der Sprache, in der die Person Facebook verwendet, selbst wenn diese Sprache von der ausgewählten Sprache abweicht.) Du kannst diese Sprache über den src-Wert im Codeausschnitt ändern. Im Abschnitt zur Lokalisierung findest du die verschiedenen verfügbaren Sprachen. Wenn deine Webseite z. B. auf Spanisch ist und du das SDK mit dem folgenden Code lädst, werden alle sozialen Plugins auf Spanisch angezeigt.

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

Prüfung des Login-Status

Wenn du status im FB.init()-Aufruf auf true setzt, versucht das SDK, sofort nach der Initialisierung Informationen zu dem*der aktuellen Nutzer*in abzurufen. Damit kannst du die Prüfung des Status eines*einer angemeldeten Nutzer*in beschleunigen, wenn du Facebook Login verwendest. Für Seiten, die nur soziale Plugins enthalten, eignet sich das aber nicht.

Du kannst den Login-Status einer Person mit FB.getLoginStatus abrufen. Hier findest du weitere Informationen zur Verwendung von Facebook Login mit dem JavaScript-SDK.

Deaktivieren von XFBML Parsing

Wenn xfbml auf true gesetzt ist, parst das SDK das DOM deiner Seite, um alle mit XFBML hinzugefügten sozialen Plugins zu finden und zu initialisieren. Wenn du keine sozialen Plugins auf der Seite verwendest, kannst du das Laden von Seiten beschleunigen, indem du xfbml auf false setzt. Weitere Informationen dazu findest du unter Soziale Plugins.

Auslösen von Code beim Laden des SDK

Die Funktion, die window.fbAsyncInit zugewiesen wurde, wird ausgeführt, sobald das SDK vollständig geladen wurde. Jeder Code, den du nach Laden des SDK ausführen möchtest, sollte in dieser Funktion nach dem Aufruf von FB.init abgelegt werden. Hier kannst du jede Art von JavaScript verwenden. Alle SDK-Funktionen müssen aber nach FB.init aufgerufen werden.

Debugging

Für eine verbesserte Performance wird das JavaScript-SDK minimiert geladen. Du kannst auch eine Debug-Version des JavaScript-SDK laden, die eine erweiterte Protokollierung und strengere Argumentprüfung umfasst und nicht minimalisiert ist. Dazu änderst du den src-Wert in deinem Ladecode in:

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

Die Debug-Version sollte nicht in deiner Produktionsumgebung verwendet werden, da ihre Payload größer ist und sich negativ auf die Leistung deiner Seite auswirkt.

Weitere Initialisierungsoptionen

Im Referenzdokument für die FB.init-Funktion findest du eine vollständige Liste der verfügbaren Initialisierungsoptionen.