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

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

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

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

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

2. Конфигуратор кода

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

3. Копирование и вставка фрагмента кода

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

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

Настройки

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

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

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

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

reverse_time (используется по умолчанию)

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

time

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

Изменение языка

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

src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1"

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

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

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

Настройка

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

Панель

Существует два способа открыть инструмент для модерации:

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

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

Представление модерации

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

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

1. Представление модерации по страницам

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

2. Представление модерации по приложениям

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

3. Очередь помеченных

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

Настройки

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

Модераторы

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

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

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

Модерация

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

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

Общедоступные

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

Закрытые

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

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

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

Настройки URL

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

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

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

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

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

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

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

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

<meta property="fb:app_id" content="&#123;YOUR_APP_ID&#125;" />

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

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

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

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

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

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID&#125;"/>

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

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_1&#125;"/>
<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_2&#125;"/>

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

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

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

<span class="fb-comments-count" data-href="https://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

Вы можете настроить уведомления webhook так, чтобы скрипт на вашем сервере уведомлял о публикации нового комментария. Для этого выполните следующие действия:

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
);
?>

После подтверждения webhook в разделе Webhooks Панели приложений появятся поля plugin_comment и plugin_comment_reply.

Нажмите "Проверить", чтобы проверить реализацию с помощью примера ответа, а затем нажмите "Подписаться", чтобы начать использовать уведомления webhook.

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