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

Этот плагин позволяет людям комментировать материалы на вашем сайте с использованием аккаунта 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

lazy

data-lazy

Если задать значение true, в браузере будет использоваться механизм отложенной загрузки. Для этого требуется атрибут iframe loading="lazy". При отложенной загрузке браузер отображает плагин, только если тот расположен достаточно близко к окну просмотра и велик шанс, что пользователь его увидит. Возможные значения настройки: true, false (значение по умолчанию).

false

mobile

data-mobile

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

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

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 for JavaScript. При загрузке SDK задайте для src свою локаль. Например, для французского языка вместо en_US нужно подставить fr_FR:

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

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

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

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

Настройка

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройки

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


Модераторы

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


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

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


Модерация

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

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

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

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

Закрыто

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

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

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


Настройки URL

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

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

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

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

Вы можете настроить 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
);
?>

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

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

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

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