Boîte de dialogue Partager

La boîte de dialogue Partager donne à chacun la possibilité de publier une actualité sur son journal, sur le journal d’un de ses amis, dans un groupe ou dans un message privé envoyé sur Messenger. Ni Facebook Login ni des autorisations étendues ne sont nécessaires. C’est donc le moyen le plus simple d’autoriser le partage sur le web.

Si les utilisateurs se trouvent dans un navigateur qui n’utilise pas de cookie pour se connecter, la liste déroulante permettant de sélectionner l’audience de votre partage n’apparaît pas. Il en est de même lorsque l’app utilise la boîte de dialogue Fil au lieu de la boîte de dialogue Partager, ou que l’app utilise une webview iFrame.

Pour implémenter la boîte de dialogue Partager dans des applications mobiles natives, consultez nos guides pour iOS et Android.

Intégration

La boîte de dialogue Partager est disponible dans le SDK Facebook pour JavaScript. Vous pouvez utiliser l’extrait de code suivant pour la déclencher. Vous pouvez également utiliser une redirection vers une URL. Pour en savoir plus, consultez les rubriques avancées.

SDK Facebook pour JavaScript

Déclenchez une boîte de dialogue Partager en utilisant la fonction FB.ui avec le paramètre de méthode share pour partager un lien.

Pour partager un lien :

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
Essayez vous-même !

Incluez des balises méta Open Graph sur la page de cette URL pour personnaliser l’actualité partagée sur Facebook.

Notez que response.error_message apparaît uniquement si quelqu’un utilise votre app en l’ayant authentifiée avec Facebook Login.

Paramètres

Paramètres courants

Le SDK pour JavaScript fournira ces paramètres automatiquement.

ParamètreDescription

app_id

L’identifiant unique de votre app. Obligatoire.

redirect_uri

L’URL vers laquelle une personne est redirigée après avoir cliqué sur un bouton de la boîte de dialogue. Obligatoire en cas de redirection d’URL.

display

Détermine comment la boîte de dialogue s’affiche.

  • Si vous utilisez l’implémentation de la boîte de dialogue pour effectuer une redirection d’URL, celle-ci s’affiche en plein écran sur Facebook.com. Ce type d’affichage est appelé page.
  • Si vous utilisez l’un de nos SDK pour iOS ou Android afin d’appeler la boîte de dialogue, ce paramètre est défini automatiquement et le type d’affichage s’adapte à l’appareil.
  • Si vous utilisez le SDK Facebook pour JavaScript, l’affichage par défaut sera de type iframe modal pour les personnes connectées à votre app ou async lors d’une utilisation dans un jeu sur Facebook.com, et une fenêtre popup pour toutes les autres personnes. Vous pouvez également forcer le type popup lorsque vous utilisez le SDK Facebook pour JavaScript, si cela est nécessaire.
  • Le type touch est toujours l’affichage par défaut pour les apps web mobiles.

Paramètres share

ParamètreDescriptionValeur par défaut

href

Le lien joint à cette publication. Obligatoire lorsque vous utilisez la méthode share. Incluez les balises méta Open Graph dans la page de l’URL pour personnaliser l’actualité partagée.

URL actuelle

hashtag

Un hashtag indiqué par le développeur, qui sera ajouté au contenu partagé. Les gens auront toujours la possibilité de supprimer ce hashtag dans la boîte de dialogue. Le hashtag devra inclure le symbole hash, par exemple #facebook.

null

quote

Une citation à partager avec le lien surligné par l’utilisateur ou prédéfini par le développeur, comme dans une citation isolée d’un article.
Ce paramètres n’est pas disponible pour les URL Facebook.

null

mobile_iframe

Si le bouton Partager est défini sur true, il ouvre la boîte de dialogue Partager dans un iFrame par dessus votre site web. Pour en savoir plus, consultez la section Boîte de dialogue Partager sur le web mobile. Cette option est disponible uniquement pour les appareils mobiles, pas sur les ordinateurs.

false


Données de réponse

Paramètre Description

post_id

Disponible uniquement si l’utilisateur est connecté à votre app en utilisant Facebook et s’il a accordé l’autorisation publish_actions. Lorsque ce paramètre est présent, il s’agit de l’ID de l’actualité Open Graph publiée.

error_message

Disponible uniquement si l’utilisateur est connecté à votre app en utilisant Facebook Login.

Rubriques avancées

Vous pouvez également tirer parti des fonctionnalités avancées suivantes.

Boîte de dialogue Partager sur le web mobile

La boîte de dialogue Partager sur le web mobile peut également s’afficher dans un iFrame par-dessus votre contenu. Si une personne termine le processus de partage, la boîte de dialogue disparaît afin de la laisser continuer à parcourir facilement le contenu qu’elle consultait.

Exemple de code

Pour autoriser la boîte de dialogue Partager sur le web mobile dans un iFrame, réglez l’attribut mobile_iframe sur true :

FB.ui({
  method: 'share',
  mobile_iframe: true,
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
Essayez vous-même !

Redirection d’URL

Pour partager un lien :

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

Remarque : lorsque vous testez ce code, supprimez les sauts de ligne, sinon vous obtiendrez une erreur.

Actions Open Graph

Déclenchez une boîte de dialogue en utilisant la fonction FB.ui avec le paramètre de méthode share_open_graph pour partager une actualité Open Graph.

Pour partager une actualité Open Graph avec la boîte de dialogue :

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

Notez que la redirection d’URL fonctionne de la même manière que pour les partages de liens standard.

Paramètres share_open_graph

Utilisez les mêmes paramètres que pour le partage d’un lien standard, en ajoutant cependant ce qui suit :

Paramètre Description

action_type

Une chaîne qui précise le type d’action Open Graph à publier, par exemple og.likes pour le type J’aime intégré. La boîte de dialogue prend également en charge des types personnalisés approuvés. Obligatoire lorsque vous utilisez la méthode share_open_graph.

action_properties

Un objet JSON de paires clé/valeur qui précise les paramètres correspondant à action_type en cours d’utilisation. Les paires clé/valeur valides sont les mêmes paramètres qui peuvent être utilisés lors de la publication des actions Open Graph avec l’API. Obligatoire lorsque vous utilisez la méthode share_open_graph.

La boîte de dialogue share_open_graph ne prend pas en charge l’attribut mobile_iframe: true.