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

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

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

Если вы веб-мастер страницы, которой поделились на 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`	Сообщение об ошибке.

См. также

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