Dialog „Teilen“

Mit dem Dialog „Teilen“ kann eine Person eine individuelle Meldung in ihrer Chronik, den Chroniken ihrer Freunde, in einer Gruppe oder in einer privaten Nachricht im Messenger veröffentlichen. Da hierzu weder Facebook Login noch erweiterte Berechtigungen erforderlich sind, ist dies die einfachste Methode, um das Teilen im Web zu ermöglichen.

Wenn Nutzer einen Browser verwenden, bei dem die Anmeldung nicht mit einem Cookie erfolgt, wird die Dropdown-Liste zum Auswählen der Zielgruppe für deine Freigabe nicht angezeigt. Dies gilt auch, wenn die App den Feed-Dialog anstelle des Dialogs „Teilen“ oder die iframe-Webansicht verwendet.

Informationen dazu, wie der Dialog „Teilen“ in nativen mobilen Apps implementiert wird, findest du in unseren Leitfäden für iOS und Android.

Integration

Der Dialog „Teilen“ ist im Facebook-SDK für JavaScript verfügbar. Du kannst den folgenden Codeausschnitt verwenden, um den Dialog „Teilen“ auszulösen. Du kannst auch eine Weiterleitung an eine URL verwenden. Weitere Informationen findest du unter Weiterführende Themen.

Facebook-SDK für JavaScript

Löse einen Dialog „Teilen“ aus, indem du die FB.ui-Funktion mit dem share-Methodenparameter verwendest, um einen Link zu teilen.

So teilst du einen Link:

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

Füge Open Graph-Meta-Tags auf der Seite unter dieser URL ein, um die Meldung anzupassen, die in Facebook geteilt werden soll.

Beachte, dass response.error_message nur angezeigt wird, wenn eine Person deine App mit Facebook Login authentifiziert hat.

Parameter

Allgemeine Parameter

Diese Parameter werden vom JavaScript-SDK automatisch bereitgestellt.

ParameterBeschreibung

app_id

Die eindeutige ID deiner App. Dieser Parameter ist erforderlich.

redirect_uri

Die URL, an die eine Person umgeleitet wird, wenn sie auf einen Button im Dialog klickt. Bei der URL-Umleitung erforderlich.

display

Legt fest, wie der Dialog dargestellt wird.

  • Wenn du die URL-Umleitung zur Dialogimplementierung verwendest, erfolgt die Anzeige als ganze Seite auf Facebook.com. Dieser Anzeigetyp wird als page bezeichnet.
  • Wenn du eines unserer iOS- oder Android-SDKs zum Aufrufen des Dialogs verwendest, wird dies automatisch angegeben und ein geeigneter Anzeigetyp für das Gerät ausgewählt.
  • Wenn du das Facebook-SDK für JavaScript verwendest, wird standardmäßig ein modaler iframe-Typ für Personen verwendet, die sich bei deiner App anmelden. Bei Verwendung in einem Spiel auf Facebook.com wird async verwendet, für alle anderen Personen ein popup-Fenster. Du kannst bei Bedarf auch den Typ popup erzwingen, wenn du das Facebook-SDK für JavaScript verwendest.
  • Mobile Web-Apps verwenden standardmäßig immer den Anzeigetyp touch.

share-Parameter

ParameterBeschreibungStandard

href

Der Link, der mit diesem Beitrag verknüpft ist. Erforderlich, wenn die Methode share verwendet wird. Füge Open Graph-Meta-Tags auf der Seite unter dieser URL ein, um die Meldung anzupassen, die geteilt werden soll.

Aktuelle URL

hashtag

Ein vom Entwickler angegebenes Hashtag, das dem geteilten Inhalt hinzugefügt wird. Personen können dieses Hashtag im Dialog wieder entfernen. Das Hashtag sollte das Hash-Symbol enthalten, z. B. #facebook.

null

quote

Ein mit dem Link zu teilendes Zitat, das entweder vom Nutzer markiert oder vom Entwickler vordefiniert wurde, wie z. B. ein hervorgehobenes Zitat in einem Artikel.

null

mobile_iframe

Wenn dies auf true gesetzt ist, öffnet der Button „Teilen“ den Dialog „Teilen“ in einem iframe über deiner Webseite (weitere Informationen dazu findest du unter Dialog „Teilen“ für das mobile Web). Diese Option ist nur für Mobilversionen und nicht für Desktop verfügbar.

false


Antwortdaten

Parameter Beschreibung

post_id

Nur verfügbar, wenn der Benutzer über Facebook bei deiner App angemeldet ist und die Berechtigung publish_actions erteilt hat. Sofern vorhanden, ist dies die ID der veröffentlichten Open Graph-Meldung.

error_message

Nur verfügbar, wenn der Benutzer über Facebook Login bei deiner App angemeldet ist.

Weiterführende Themen

Du kannst auch die folgenden erweiterten Funktionen nutzen.

Dialog „Teilen“ für das mobile Web

Der Dialog „Teilen“ für das mobile Web kann auch in einem iFrame über deinem Inhalt angezeigt werden. Wenn eine Person den Teilen-Ablauf abschließt, wird der Dialog verworfen und die Person zurück zum ursprünglichen Inhalt geleitet, damit sie ihn einfach weiter nutzen kann.

Codebeispiel

Um den Dialog „Teilen“ für das mobile Web in einem iframe zu aktivieren, setzt du das Attribut mobile_iframe auf true:

FB.ui({
  method: 'share',
  mobile_iframe: true,
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
Probiere es aus!

URL-Umleitung

So teilst du einen Link:

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

Hinweis: Entferne beim Testen dieses Codes die Zeilenumbrüche. Andernfalls kommt es zu Fehlern.

Open Graph-Handlungen

Löse einen Dialog „Teilen“ aus, indem du die FB.ui-Funktion mit dem share_open_graph-Methodenparameter verwendest, um eine Open Graph-Meldung zu teilen.

So teilst du eine Open Graph-Meldung mit dem Dialog:

FB.ui({
  method: 'share_open_graph',
  action_type: 'og.likes',
  action_properties: JSON.stringify({
    object:'https://developers.facebook.com/docs/',
  })
}, function(response){});

Beachte, dass die URL-Umleitung genauso funktioniert wie für standardmäßige Vorgänge zum Teilen von Links.

share_open_graph-Parameter

Verwende dieselben Parameter wie für das Teilen eines Standardlinks, aber füge Folgendes hinzu:

Parameter Beschreibung

action_type

Ein String, der angibt, welche Open Graph-Handlungsart veröffentlicht wird, beispielsweise og.likes für den vordefinierten Typ „like“. Der Dialog unterstützt auch genehmigte benutzerdefinierte Typen. Erforderlich, wenn die Methode share_open_graph verwendet wird.

action_properties

Ein JSON-Objekt aus Schlüssel/Wert-Paaren zur Angabe von Parametern, die dem verwendeten action_type entsprechen. Gültige Schlüssel/Wert-Paare sind dieselben Parameter wie diejenigen, die beim Veröffentlichen von Open Graph-Handlungen mit der API verwendet werden können. Erforderlich, wenn die Methode share_open_graph verwendet wird.

Der share_open_graph-Dialog unterstützt mobile_iframe: true nicht.