Диалог "Поделиться"

С помощью диалога "Поделиться" люди могут публиковать новости в своей хронике, в хрониках друзей, в группах или отправлять материалы в личных сообщениях в Messenger. Для использования диалога "Поделиться" не требуется вход через Facebook или какие-либо дополнительные разрешения, поэтому это самый простой и удобный способ делиться контентом в Интернете.

В этой документации описано, как реализовать диалог "Поделиться" на веб-странице. Если вам нужно реализовать его в мобильном приложении, см. статьи Публикация контента в iOS и Публикация контента в Android.

Ниже показан пример диалога "Поделиться", в котором предоставлена ссылка на хронику пользователя.

На предыдущем изображении в раскрывающемся списке аудитории выбрано Поделиться в своей хронике. Этот список аудитории не отображается, если пользователь открывает диалог из браузера без файлов cookie входа. То же самое произойдет, если вместо диалога "Поделиться" используется диалог ленты или если приложение использует веб-представление iframe.

Если вы веб-мастер страницы, которой поделились на Facebook, вы можете настроить ее отображение на Facebook с помощью метатегов Open Graph. Для разметки своего сайта следует использовать теги Open Graph, которые отвечают за то, как ваш контент будет отображаться на Facebook. Подробнее см. в руководстве по публикации для веб-мастеров.

Публикация с помощью перенаправления на URL

Чтобы поделиться ссылкой с помощью перенаправления на URL, используйте следующий код. Для удобства чтения добавлены переносы строки. Удалите переносы при использовании этого кода.

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

Публикация с помощью Facebook SDK для JavaScript

Чтобы вызвать диалог "Поделиться" в Facebook SDK для JavaScript, используйте функцию FB.ui с параметром метода share. Чтобы открыть диалог "Поделиться", используйте показанный ниже фрагмент кода.

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

Попробуйте сами!

Параметры

Ниже перечислены параметры диалога "Поделиться".

Параметр	Описание	Обязательный?
`app_id`	Уникальный идентификатор приложения.	Да. Предоставляется автоматически при использовании SDK.
`display`	Определяет, как отображается диалог "Поделиться". Перенаправление на URL — параметр `display` должен иметь значение `page`. Диалог "Поделиться" будет отображаться на сайте Facebook.com в виде полноценной страницы. Facebook SDK для JavaScript — параметр display может иметь одно из следующих значений: модальное окно `iframe` для пользователей, которые вошли в ваше приложение; `async` при запуске внутри игры на Facebook.com; окно `popup` во всех остальных случаях. Если используется Facebook SDK для JavaScript, при необходимости можно принудительно выбрать тип `popup`. Мобильные веб-приложения — параметр `display` всегда должен иметь значение `touch`. Facebook SDK для iOS или Android — SDK автоматически задает `display` и определяет подходящий тип отображения в зависимости от устройства.	Да. Предоставляется автоматически при использовании SDK.
`hashtag`	Хэштег, который нужно добавить в публикуемый контент. Пользователи могут удалить хэштег в диалоге "Поделиться". Хэштег должен включать в себя знак решетки, например `#facebook`. Значение по умолчанию — `null`.	Нет.
`href`	Ссылка, которой нужно поделиться. Значение по умолчанию — текущий URL.	Обязателен, если используется SDK.
~~`redirect_uri`~~ Упразднено	~~URL, на который будет перенаправлен человек, когда нажмет кнопку в диалоге.~~	~~Да. Предоставляется автоматически при использовании SDK.~~
~~`mobile_iframe`~~ Упразднено	~~`true`, чтобы открыть диалог в iframe поверх сайта. Этот параметр доступен только для мобильных платформ~~	~~`false`~~

Данные ответа

Ответ отправляется, только если пользователь авторизован в вашем приложении с использованием входа через Facebook.

Параметр	Описание
`error_message`	Сообщение об ошибке.

Дополнительная информация

Рекомендации по публикации контента