社交插件

评论插件

通过评论插件，用户可以使用他们的 Facebook 帐户评论您网站上的内容。用户也可以选择与他们的 Facebook 好友（以及好友的好友）分享评论活动。评论插件还包括内置审核工具。

欧洲地区社交插件的变更

由于系统会向欧洲地区使用 Facebook 产品的用户显示更新过的 Cookie 同意提示，因此可能会发现社交插件受到一些影响。对于欧洲地区的用户，我们将不再支持“赞”和“评论”社交插件，除非这些用户：1) 已登录到他们的 Facebook 帐户中，并且 2) 已同意接受“应用和网站 Cookie”控件。如果已同时满足这两项要求，则用户将能够看到“赞”或“评论”按钮之类的插件，还能与其互动。如果未满足上列任一要求，则用户将不能看到那些插件。

欧洲地区是指列出的一系列特定国家/地区，其中包括：

  • 欧盟 (EU)：奥地利、比利时、保加利亚、克罗地亚、塞浦路斯共和国、捷克共和国、丹麦、爱沙尼亚、芬兰、法国、德国、希腊、匈牙利、爱尔兰、意大利、拉脱维亚、立陶宛、卢森堡、马耳他、荷兰、波兰、葡萄牙、罗马尼亚、斯洛伐克、斯洛文尼亚、西班牙、瑞典

  • 仅属于欧洲经济区 (EEA)/属于欧洲自由贸易联盟 (EFTA) 或关税同盟的非欧盟 (EU) 成员：[仅属欧洲经济区/属于欧洲自由贸易联盟] 冰岛、列支敦士登和挪威；瑞士：[欧盟关税同盟] 所有海峡群岛、马恩岛、摩纳哥；塞浦路斯英属基地；[欧洲关税同盟] 安道尔、圣马力诺、梵蒂冈。

  • 属于欧洲外延地区 (OMR) 的非欧盟成员：马提尼克岛、马约特岛、瓜德罗普岛、法属圭亚那、留尼汪岛、圣马丁岛、马德拉群岛、亚速尔群岛、加那利群岛。
  • 英国（所有不列颠群岛）

分步说明

1.选择网址或主页

选择您想使用评论插件的网站网址。

2.代码配置器

将网址复制粘贴到下方的代码配置器中。您可以调整设置，例如评论插件的 width，或默认显示的帖子数量 (num_posts)。点击获取代码按钮生成评论插件代码。

3.复制并粘贴代码片段

将代码片段复制并粘贴到想要进行评论的网站或网页的 HTML 中。

评论插件代码生成器

评论的 URL
宽度
帖子个数
获取代码

设置

上面的代码配置器仅使用了评论插件可用的部分设置。您还可更改以下设置：

设置 HTML5 属性 说明 默认值

colorscheme

data-colorscheme

评论插件使用的配色方案。可以是“light”或“dark”。

“light”

href

data-href

与插件中发布的评论永久关联的绝对网址。在 Facebook 上分享且与使用评论插件发布的评论相关的所有动态都将链接到该网址。

当前网址。

lazy

data-lazy

true 表示您可通过设置 loading="lazy" iframe 属性来使用浏览器的延迟加载机制。其效果是，如果插件不在视区附近，则浏览器不会显示插件，且您可能始终无法看到该插件。可以是 true 或 false（默认）的其中一个。

false

mobile

data-mobile

用于指定是否显示移动优化版本的布尔值。

自动检测

num_posts

data-numposts

默认显示的评论数量。最小值是 1。

10

order_by

data-order-by

显示评论时使用的顺序。可以是“reverse_time”或“time”。不同顺序类型的说明请参阅评论排序版块。

“reverse-time”

width

data-width

网页中评论插件的宽度。可以是像素值，也可以是不固定宽度的百分比（如 100%）。评论插件的移动版本忽略了宽度参数，转而使用 100% 不固定宽度。评论插件支持的最小宽度为 320 像素。

550

评论排序

用户可以使用评论插件右上方的菜单按时间对评论进行排序。

您可以使用 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"

您可能需要调整社交插件的宽度，以适应不同的语言。详细了解本地化和翻译。

评论审核

评论插件包含强大的审核工具。该工具能帮助您的社区管理团队更轻松快速地同时审核多条评论。

设置

要使用评论审核工具，您需要完成审核设置说明。

审核设置说明

请注意，您不能使用图谱 API 回复通过评论插件发表的评论。

面板

有两种方法可以导航到审核工具：

1.应用类审核视图：前往 developers.facebook.com/tools/comments。您将获得所有 Facebook 应用的列表，这将便于您审核与各个应用相关的所有评论。如果您未在 Facebook 应用中使用评论插件，就无法使用此视图。

2.网页类审核视图：点击评论框旁的审核工具链接（请看以下截图）。此视图仅显示发布到这个网页（网址）的评论。

审核视图

下方截图显示了两种审核视图。如果您使用的是应用类审核视图，则可以使用菜单切换应用。

在审核表中，您可以根据评论的状态批准或隐藏评论。如要更改多条评论的状态，请使用左边栏中的复选框。

1.网页类审核视图

此审核视图显示特定网址的所有评论。

2.应用类审核视图

此审核视图显示应用程序的所有评论。

3.已标记队列

系统将在此显示用户或 Facebook 标记的评论。此列表中的评论可能会公开或隐藏，具体视应用程序设置和评论被举报的情况而定。

设置

您可以为每个应用指定自定义设置。使用设置按钮（工具右上方）打开设置对话框。

版主

您可以将其他用户提升为评论版主。开始在输入框中输入好友的名称，预输入内容有助于您选择要提升为版主的用户。

评论排序方式

您也可以控制评论的排序方式。详细了解评论排序。

审核

您可以更改新评论的默认可见性。例如，您可能想审批所有新评论。评论如果未获批准，就只对发布评论的人可见，直到获得版主批准为止。

有三种不同的审核模式：

Public（公开）

所有评论都是公开的。它们也会显示在“审核”选项卡中。

Closed（关闭）

所有评论都将隐藏。

Banned Users（被禁言用户）

在“被禁言用户”选项卡中，版主可以搜索禁言用户。如果被禁言用户发布了新评论，该评论将自动应用可见性限制并显示在“审核”选项卡中。

网址设置

关闭评论对话

您可以关闭使用评论插件的任何网址中的评论对话。这意味着用户将无法向对应网页中的讨论发布新评论。您可以在网址设置菜单中关闭评论对话。

覆盖自动关闭

如果已启用自动关闭，则可以覆盖已关闭的评论对话，这会重新开启评论对话，让用户能够发表评论。要实现此操作，请前往网址设置，并开启覆盖自动关闭。然后，对您正在审核的网址设置合适的关闭状态。

审核设置

要使用审核工具，您需要将 Facebook 帐户或 Facebook 应用关联到评论插件实施中。

使用 Facebook 应用设置（首选）

如果您的网站有多个评论框，我们建议您将一个 Facebook 应用编号指定为管理实体，这意味着应用的所有管理员都能审核评论。执行此操作将在 Facebook 上启用版主界面，您可轻松在此处集中审核来自应用编号管理的所有插件的评论。

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

除了您使用版主设置添加的人员外，您应用的所有管理员也可以审核评论。但如果您启用了通知功能，则只有版主才会收到新评论的通知。

当您在网站上实施多个评论框并通过指定一个应用编号将它们关联在一起时，您选择的审核设置将应用于所有评论框。

例如，将审核设置更改为可见性受限会影响同一应用编号下的所有评论框。如果您需要在网站的不同区域应用不同的审核设置，应使用两个或更多应用编号。然后，您便可以对每组评论框应用不同的审核设置。

您可以指定 fb:app_id 或 fb:admins，但不能同时指定两者。

指定 Facebook 帐户为管理员

如要将 Facebook 帐户指定为实施评论插件的管理员，请在使用评论插件的每个网页的 <head> 部分中加入以下元标签元素：

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

如要添加多个版主，请添加多个元素，并为每个元素分别使用一个 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> 元素中展示特定网址上的评论数量。然后，您可以使用 CSS 设定此 <span> 元素的样式，以便与网站的其他部分相匹配。请注意：此功能目前不适用于 HTML5。

例如，要显示 example.com 上的评论数量，应使用以下代码：

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

这将显示：

69391 awesome comments

您可使用图谱 API 访问特定网址上的评论数量。例如，您可通过网址节点下 share 字段中的 comment_count 属性来查看 example.com 上的评论数量：

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

Webhooks

您可以设置 Webhooks，在用户发布新评论时通知服务器中的脚本。要开始使用此功能：

  1. 前往应用面板
  2. 点击左侧导航栏中的“+ 添加产品”
  3. 在“Webhooks”版块，点击“设置”
  4. 选择下拉菜单中的“应用程序”
  5. 点击“订阅此主题”按钮
  6. 在对话框中，输入用于接收通知的脚本网址，例如 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 参考文档。