Dialog „Teilen“

Mit dem Dialog „Teilen“ können Personen individuelle Meldungen in der Chronik veröffentlichen. In dieser Dokumentation wird beschrieben, wie der Dialog „Teilen“ im Web implementiert wird. Wenn du den Dialog „Teilen“ in einer mobilen App implementieren möchtest, findest du unter Teilen unter iOS und Teilen unter Android die entsprechenden Informationen.

Nachfolgend findest du ein Beispiel für den Dialog „Teilen“, der einen Link zur Chronik eines*einer Nutzer*in teilt.

Wenn du der Webmaster für eine Seite bist, die mit Facebook geteilt wird, füge Open Graph-Meta-Tags zur Anpassung der Meldung ein, die wieder mit Facebook geteilt wird. Es ist wichtig, deine Website mit Open Graph-Tags zu versehen, um zu steuern, wie deine Inhalte auf Facebook angezeigt werden. Weitere Informationen findest du im Leitfaden zum Teilen für Webmaster.

Teilen mithilfe von URL-Umleitung

Verwende den folgenden Code, um einen Link mithilfe von URL-Umleitung zu teilen. Zur besseren Lesbarkeit wurden Zeilenumbrüche eingefügt. Entferne die Zeilenumbrüche, wenn du diesen Code verwendest.

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Teilen durch Verwenden des Facebook-SDK für JavaScript

Der Dialog „Teilen“ steht im Facebook-SDK für Javascript zur Verfügung, wenn du die FB.ui-Funktion mit dem Methodenparameter share verwendest. Verwende den folgenden Code-Schnipsel, um den Dialog „Teilen“ zu öffnen.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

Probiere es aus!

Parameter

Dies sind die Parameter für den Dialog „Teilen“.

Parameter	Beschreibung	Erforderlich?
`app_id`	Die eindeutige ID deiner App.	Ja. Wird bei Verwendung des SDK automatisch bereitgestellt.
`display`	Bestimmt, wie der Dialog „Teilen“ dargestellt wird. URL-Umleitung: Der Wert `display` lautet `page`. Der Dialog „Teilen“ ist eine ganze Seite, die auf Facebook.com angezeigt wird. Facebook-SDK für JavaScript: Der Anzeigewert ist einer der folgenden: ein modaler `iframe` für Personen, die bei deiner App angemeldet sind `async` bei Verwendung innerhalb eines Spiels auf Facebook.com ein `popup`-Fenster für alle anderen Falls nötig, kannst du den Typ `popup` erzwingen, wenn du das Facebook-SDK für JavaScript verwendest. Mobile Web-Apps: Der Wert `display` lautet stets `touch`. Facebook-SDK für iOS oder Android: Das SDK gibt automatisch `display` an und wählt einen geeigneten Anzeigetyp für das Gerät.	Ja. Wird bei Verwendung des SDK automatisch bereitgestellt.
`hashtag`	Ein Hashtag, das dem geteilten Inhalt hinzugefügt wird. Nutzer*innen können dieses Hashtag im Dialog „Teilen“ entfernen. Das Hashtag sollte das Hash-Symbol enthalten, z. B. `#facebook`. Der Standardwert ist `null`.	Nein
`href`	Der zu teilende Link. Der Standardwert ist die aktuelle URL.	Erforderlich, wenn du das SDK verwendest.
~~`redirect_uri`~~ Veraltet	~~Die URL, an die eine Person umgeleitet wird, wenn sie auf einen Button im Dialog „Teilen“ klickt.~~	~~Ja. Wird bei Verwendung des SDK automatisch bereitgestellt.~~
~~`mobile_iframe`~~ Veraltet	~~`true` zum Öffnen des Dialogs „Teilen“ in einem iframe über deiner Website. Diese Option ist nur für Mobilgeräte verfügbar, nicht für Desktop.~~	~~`false`~~

Antwortdaten

Eine Antwort erfolgt nur dann, wenn der*die Nutzer*in über Facebook Login bei deiner App angemeldet ist.

Parameter	Beschreibung
`error_message`	Eine Fehlermeldung.

Siehe auch

Best Practices für Sharing