Плагин комментариев

Этот плагин позволяет людям комментировать материалы на вашем сайте с использованием аккаунта Facebook. Люди также могут делиться своими комментариями с друзьями (и друзьями друзей) в Facebook. Плагин комментариев включает встроенные средства модерации и социальный рейтинг.

Конфигуратор плагина комментариевМодерацияНастройкиНастройка языкаЧаВо

Пошаговые инструкции

1. Выберите URL или страницу.

Выберите URL сайта, где вы хотите использовать плагин комментариев.

2. Помощник конфигурирования.

Скопируйте URL и вставьте его в помощник конфигурирования ниже. При необходимости настройте параметры плагина — ширину width и количество публикаций, отображаемое по умолчанию (num_posts). Чтобы сгенерировать код, нажмите Получить код.

3. Скопируйте и вставьте сниппет

Вставьте сниппет в HTML-код сайта или веб-страницы, где вы хотите разместить плагин комментариев.

Генератор кода плагина комментариев

URL-адрес для комментариев
Ширина
Количество публикаций

Настройки

В представленном выше конфигураторе доступны не все возможные настройки плагина комментариев. Вы можете задать следующие настройки:

Настройка Атрибут HTML5 Описание Значение по умолчанию

colorscheme

data-colorscheme

Цветовая схема плагина. Параметр может иметь значение "light" или "dark".

"light"

href

data-href

Абсолютный URL комментария, размещенного в плагине. Новости на Facebook о комментариях, опубликованных в плагине, будут связаны с этим URL.

Текущий URL

mobile

data-mobile

Значение типа данных Boolean, которое указывает, показывать оптимизированную для мобильных устройств версию или нет.

Автоматическое обнаружение

num_posts

data-numposts

Количество комментариев, отображаемых по умолчанию. Минимальное значение — 1.

10

order_by

data-order-by

Порядок отображения комментариев. Параметр может иметь значение "social", "reverse_time" или "time". Подробнее о сортировке комментариев см. в разделе ЧаВо.

"social"

width

data-width

Ширина плагина комментариев на веб-странице. Может быть указана в пикселях или в процентном отношении (например, 100%). Мобильная версия плагина комментариев игнорирует параметр ширины. Используется плавающая ширина со значением 100%. Минимальная ширина плагина комментариев — 320 пикселей.

550

Сортировка комментариев

Люди могут сортировать комментарии по времени или социальному рейтингу с помощью меню, расположенного справа вверху плагина комментариев.

Вы можете определить порядок по умолчанию, задав для атрибута data-order-by одно из трех значений.

social (по умолчанию)

Такой вид сортировки также называется «Лучшие». Плагин использует социальные сигналы, чтобы показывать комментарии высокого качества. Сначала выводятся комментарии, опубликованные друзьями и друзьями друзей, а также понравившиеся или активные цепочки обсуждения. Комментарии, помеченные как спам, недоступны для просмотра.

Примечание. Старые комментарии, в том числе связанные с объектами Open Graph, созданными до выпуска плагина комментариев, невозможно упорядочить по социальному рейтингу.

time

Комментарии отображаются в том порядке, в каком они были опубликованы. Вверху — старые, внизу — новые.

reverse_time

Комментарии отображаются в противоположном порядке: вверху — новые, внизу — старые.

Настройка языка

Чтобы настроить язык плагина комментариев, загрузите локализованную версию Facebook SDK для JavaScript. При загрузке SDK задайте значение js.src в соответствии со своей локалью. Например, для французского языка вместо en_US нужно подставить fr_FR:

js.src = "//connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.4";

Список поддерживаемых локалей см. в файле Facebook Locales XML.

Возможно, вам понадобится изменить ширину социального плагина, чтобы разместить локализованный текст. Подробнее о локализации и переводе см. здесь.

Модерация комментариев

В плагине комментариев есть инструмент для модерации. Он позволяет команде управления сообществом быстро и легко модерировать несколько комментариев одновременно.

Настройка

Чтобы использовать инструмент для модерации комментариев, необходимо выполнить инструкции по настройке модерации.

Инструкции по настройке модерации

Обратите внимание, что с помощью API Graph нельзя отвечать на комментарии, оставленные через плагин комментариев.


Панель управления

Есть 2 способа открыть инструмент для модерации.

1. Интерфейс модерации на основе приложений: Откройте страницу developers.facebook.com/tools/comments. Вы увидите список всех своих приложений Facebook. Для каждого из них вы можете модерировать комментарии. Если вы не используете приложение Facebook для плагина комментариев, вы не сможете использовать этот интерфейс.

2. Интерфейс модерации на основе страницы: Нажмите ссылку Инструмент для модерации рядом с полем комментариев (см. снимок экрана ниже). В этом интерфейсе перечислены только те комментарии, которые опубликованы на определенной веб-странице (URL).

Интерфейс модерации

Ниже представлены снимки экрана, на которых показаны оба интерфейса. В интерфейсе модерации на основе приложений вы можете переключаться между приложениями с помощью меню.

В таблице модерации можно либо одобрить, либо скрыть комментарии в зависимости от их статуса. Чтобы изменить статус сразу нескольких комментариев, отметьте их в левом столбце.

1. Интерфейс модерации на основе страницы:

В этом режиме отображаются все комментарии на определенной веб-странице.

2. Интерфейс модерации на основе приложений:

В этом режиме отображаются все комментарии в определенном приложении.

3. Цепочка жалоб

Здесь отображаются комментарии, на которые пожаловались пользователи. Эти комментарии могут быть видимы или скрыты в зависимости от настроек приложения и особенностей жалобы.

4. Моя очередь

Эту функцию можно использовать, чтобы самому выполнить модерацию определенных комментариев. Так удобнее распределять обязанности между разработчиками. Комментарии, которые здесь показаны, будут доступны другим модераторам или администраторам, однако в их собственных очередях они отображаться не будут.

Настройки

Для каждого приложения можно задать свои настройки. Нажмите кнопку Настройки (справа вверху в инструменте), чтобы открыть диалоговое окно настроек.


Модераторы

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


Сортировка комментариев

Вы можете управлять сортировкой комментариев. Подробнее об этом читайте в разделе Сортировка комментариев.


Модерация

Вы можете изменить видимость по умолчанию для новых комментариев. Например, можно одобрять все новые комментарии. Если комментарий не одобрен, он будет виден только его автору.

Есть три режима модерации:

Доступно всем

Все комментарии будут общедоступными. Их также можно будет увидеть во вкладке «На рассмотрении».

Закрыто

Все комментарии будут скрыты.

Заблокированные пользователи

Пользователи, чьи комментарии были заблокированы, показаны во вкладке «Заблокированные пользователи». Если автором нового комментария является заблокированный пользователь, для такого комментария будет установлено ограничение на просмотр, а сам комментарий будет показан во вкладке «На рассмотрении».


Начиная с Facebook SDK версии 4.28.0, дублирование комментариев упраздняется. Оно будет поддерживаться до 5 февраля 2018 г.

Дублирование комментариев

Функция «Дублирование комментариев» позволяет людям участвовать в одном обсуждении независимо от того, откуда приходят комментарии: с вашей веб-страницы или Страницы Facebook. Когда вы публикуете ссылку с вашего сайта на вашу Страницу на Facebook, комментарии, размещенные на вашей веб-странице, появятся и в вашей публикации Facebook (и наоборот). Это позволяет сделать обсуждение более обстоятельным, так как на обоих ресурсах увеличивается количество комментариев.

Включить функцию «Дублирование комментариев» можно в инструменте модерации во вкладке Настройки. Для этого вам нужно быть администратором Страницы Facebook, на которой вы хотите дублировать комментарии.

Если вы хотите, чтобы люди могли включать фото в комментарии с помощью функции «Дублирование комментариев», также включите опцию Разрешить посетителям Страницы делать публикации для своей Страницы. Чтобы комментарии дублировались правильно, ваша страница Facebook должна быть доступна всем.

Функция начнет работать на новых страницах, созданных после ее включения. После того как вы включили функцию «Дублирование комментариев» на своей странице, вы не сможете отключить дублирование комментариев (это можно будет сделать только для новых страниц). Поэтому если у вас на странице настроено автоматическое закрытие комментариев, то люди смогут по-прежнему добавлять комментарии на Странице Facebook, но не с вашей веб-страницы.

Будет ли людям известно, что мы дублируем комментарии? Начав вводить комментарий на вашем сайте, человек увидит предупреждение о том, что его сообщение будет также опубликовано на вашей Странице Facebook. Такое же сообщение будет показано, когда человек начнет писать комментарий к статье на вашей Странице Facebook.


Как работает модерация? Все комментарии, добавленные на Странице Facebook или на вашем сайте, отображаются в главном инструменте модерации комментариев Facebook. Поэтому комментарии на вашей веб-странице также могут проходить модерацию. Комментарии, скрытые в инструменте модерации, перестают отображаться и на Странице Facebook.

Настройки URL

Закрытие цепочек

Вы можете закрывать цепочки комментариев на любых веб-страницах, где используется плагин комментариев Facebook. В результате возможность комментировать на соответствующей странице будет отключена. Закрыть цепочку комментариев можно в меню «Настройки».

Отмена автоматического закрытия

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

Настройка модерации

Чтобы использовать инструмент для модерации, нужно подключить аккаунт Facebook или приложение Facebook к плагину комментариев.

Настройка с помощью приложения Facebook (предпочтительный метод)

Если на вашем сайте много полей для комментариев, мы рекомендуем указывать ID приложения Facebook как управляющий объект (модерировать комментарии смогут все администраторы приложения). На Facebook появится интерфейс модератора. С его помощью вы сможете модерировать комментарии со всех плагинов, администрируемых ID вашего приложения.

<meta property="fb:app_id" content="{YOUR_APP_ID}" />

Помимо людей, которых вы добавляете с помощью настройки Модераторы, все администраторы вашего приложения также смогут модерировать комментарии, однако только модераторы будут получать уведомления о новых комментариях, если вы включили уведомления.

Предположим, вы размещаете на сайте несколько полей для комментариев и связываете их вместе с помощью ID приложения. В этом случае настройки модерации, которые вы задаете, будут применяться ко всем полям для комментариев.

Например, если вы установите ограничение на просмотр, эта настройка будет применена ко всем полям комментариев, которые связаны с одним и тем же ID приложения. Если вы хотите применять разные настройки модерации в разных частях вашего сайта, используйте два или больше ID приложения. Так вы сможете применять разные параметры к каждой группе полей комментариев.

Можно выбрать fb:app_id, fb:admins, но не оба параметра одновременно.

Установка аккаунта Facebook в качестве администратора

Чтобы назначить аккаунт Facebook администратором плагина комментариев, включите следующий метаэлемент в раздел <head> каждой веб-страницы, в которой вы используете плагин.

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID}"/>

Чтобы добавить несколько модераторов, добавьте больше одного элемента, каждый с ID Facebook.

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_1}"/>
<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_2}"/>

Счетчик комментариев

Значение fb:comments-count позволяет отобразить количество комментариев для определенного URL в элементе <span> веб-страницы. Затем с помощью CSS вы можете применить к этому элементу <span> стиль, соответствующий остальному наполнению сайта. Примечание: эта функция пока недоступна в HTML5.

Например, код счетчика комментариев для сайта example.com будет выглядеть так:

<span class="fb-comments-count" data-href="http://example.com/"></span>
awesome comments 

Будет получен следующий результат:

69391 awesome comments

Количество комментариев для определенного URL можно просмотреть с помощью API Graph. Например, информация о количестве комментариев на example.com доступна через свойство comment_count в поле share узла URL:

https://graph.facebook.com/v2.4/?fields=share{comment_count}&amp;id=<YOUR_URL>

Webhooks

Вы можете настроить webhooks так, чтобы скрипт на вашем сервере уведомлял о публикации нового комментария. С чего начать?

  1. Откройте Панель приложений.
  2. В меню навигации слева нажмите «+ Добавить продукт».
  3. В разделе «Webhooks» нажмите «Настроить».
  4. В раскрывающемся меню выберите «Приложение».
  5. Нажмите кнопку «Подписаться на эту тему».
  6. В диалоговом окне введите URL скрипта, который будет получать уведомления, например https://example.org/mywebhook.php.
  7. Введите маркер: любую строку. Она будет отправлена в ваш скрипт для проверки.
  8. Чтобы завершить настройку, нажмите кнопку «Подтвердить и сохранить».

Но до этого ознакомьтесь с документаций по Webhooks, чтобы узнать, как интегрировать скрипт.

Вот пример того, как mywebhook.php может выглядеть в PHP.

Начните с подтверждения:

<?php
if ($_GET['hub_verify_token'] === 'make-up-a-token') {
  echo $_GET['hub_challenge'];
}

make-up-a-token — это та же строка, которую вы ввели в шаге 7.

Затем просто регистрируйте все комментарии по мере их публикации:

file_put_contents(
  'log.txt',
  "\n" . file_get_contents('php://input'),
  FILE_APPEND
);
?>

Имейте в виду: в PHP $_POST не будет работать; вам понадобится file_get_contents('php://input').

После того как вы проверите свой Webhook, вы увидите «plugin_comment» и «plugin_comment_reply» в разделе Webhooks панели приложений.

Нажмите «Тестировать», чтобы проверить интеграцию с помощью образца отклика, а затем нажмите «Подписаться».

Подробнее об отклике см. в справочной документации по Webhooks.