Boîte de dialogue Fil d’actualité

Vous pouvez ajouter la boîte de dialogue Fil d’actualité à votre application pour permettre aux utilisateurs de publier des actualités individuelles avec des commentaires dans leur journal.

Le partage d’actualités via la boîte de dialogue Fil d’actualité ne nécessite pas d’autorisations étendues.

Intégration

Cette boîte de dialogue peut être utilisée avec les SDK Facebook pour JavaScript, iOS et Android, en réalisant une redirection complète vers une URL. Voici quelques exemples d’extrait de code pouvant être utilisés pour déclencher cette boîte de dialogue.

JavaScript

Pour déclencher une boîte de dialogue Fil d’actualité, appelez la fonction FB.ui et utilisez la valeur feed pour le paramètre method.

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

iOS

Lisez notre guide sur la boîte de dialogue Partager pour iOS qui vous permet également de publier des actualités Open Graph.

Android

Découvrez notre boîte de dialogue Partager pour Android qui vous permet également de publier des actualités Open Graph.

Redirection d’URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Remarque

Si une personne a réglé le paramètre « Qui peut publier dans votre journal ? » sur « Moi uniquement », et qu’une autre personne tente de publier du contenu sur le journal de la première à l’aide de la boîte de dialogue Fil d’actualité, une erreur « Publication impossible » s’affiche.

Paramètres

Remarque : si votre application partage des liens vers les boutiques iTunes ou Google Play, ou vers un profil ou une page Facebook, nous ne publions pas les images ni les descriptions que vous indiquez dans le partage avec les paramètres ci-dessous. Au lieu de cela, nous publions certaines informations de l’application que nous récupérons directement sur l’App Store ou la page Facebook avec le robot d’indexation. Cela peut ne pas inclure d’images. Pour prévisualiser un partage de lien sur iTunes ou Google Play, saisissez votre URL dans le Programme de débug du partage.

Paramètre	Description
`app_id`	L’identifiant unique de votre application. 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 le SDK Facebook pour iOS ou Android pour invoquer la boîte de dialogue, ceci est automatiquement spécifié et un type d’affichage approprié est sélectionné pour 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 application 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 l’utilisation des types `popup` ou `page` lorsque vous utilisez le SDK Facebook pour JavaScript, si nécessaire. Par défaut, le type d’affichage pour les applications web mobiles est toujours `touch`.
`from`	L’ID de la personne qui publie le message. S’il n’est pas spécifié, l’ID de la personne actuelle est renseigné par défaut. S’il est spécifié, l’ID doit être celui de la personne ou d’une page qu’elle gère.
`to`	L’ID du profil sur lequel sera publiée cette actualité. S’il n’est pas spécifié, la valeur `from` est renseignée par défaut. L’ID doit être celui d’un ami qui utilise aussi votre application.
`link`	Le lien associé à cette publication.
`source`	L’URL d’un fichier multimédia (SWF ou MP3) joint à cette publication. Dans le cas d’un fichier SWF, vous devez aussi spécifier le paramètre `picture` afin de fournir une miniature pour la vidéo.
`ref`	Cet argument est une liste d’éléments séparés par des virgules composée d’au moins 5 éléments différents, chacun contenant entre 1 et 15 caractères parmi les suivants : '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'. Chaque catégorie est utilisée dans Facebook Insights pour vous aider à mesurer la performance des différents types de publication.

Paramètres obsolètes

Paramètre	Description
`post_id`	L’ID de l’actualité publiée si la personne choisit de publier dans son journal.
`properties`	Un objet JSON de paires clé/valeur qui s’affiche dans la pièce jointe au stream sous la description, chaque propriété étant sur sa propre ligne. Les clés doivent être des chaînes, et les valeurs peuvent être des chaînes ou des objets JSON avec les clés `text` et `href`.
`actions`	Un tableau JSON contenant un seul objet pour décrire le lien d’action qui s’affiche en regard des liens « Commenter » et « J’aime » sous les publications. Cet objet doit avoir les clés `name` et `link`.
`picture`	L’URL d’une image jointe à cette publication. L’image doit mesurer au moins 200 x 200 pixels. Pour en savoir plus sur les dimensions, consultez notre documentation sur les recommandations en matière de partage.
`name`	Le nom de la pièce jointe du lien.
`caption`	La légende du lien (apparaît sous le nom du lien). Si elle n’est pas spécifiée, ce champ est automatiquement renseigné avec l’URL du lien.
`description`	La description du lien (apparaît sous la légende du lien). Si elle n’est pas indiquée, ce champ est automatiquement rempli avec les informations récupérées dans le lien, en général le titre de la Page.
`thumbnail`	Le fichier image local importé, au format `.jpg`, `.jpeg`, `.gif` ou `.png`.