社交附加程式

回應附加程式

回應附加程式讓用戶可使用自己的 Facebook 帳戶來回應網站內容。用戶也可以選擇在 Facebook 與朋友（或朋友的朋友）分享他們的回應活動。回應附加程式也包含內置的審核工具。

對歐洲地區社交附加程式所作的變更

由於系統會向歐洲地區使用各項 Facebook 產品的用戶顯示更新的 Cookie 同意提示，您可能會看見社交程式受到一些影響。我們將停止支援歐洲地區用戶的「讚好」和「回應」社交程式，除非用戶 1) 已登入其 Facebook 帳戶，以及 2) 已同意「應用程式及網站 Cookie」控制。達成上述兩項要求，用戶便可看見「讚好」或「回應」按鈕等附加程式並與之互動。如果兩者中一項未能達到，用戶便無法看見附加程式。

歐洲地區由一系列特定國家／地區組成，當中包括：

  • 歐盟 (EU)：奧地利、比利時、保加利亞、克羅地亞、塞浦路斯、捷克、丹麥、愛沙尼亞、芬蘭、法國、德國、希臘、匈牙利、愛爾蘭、意大利、拉脫維亞、立陶宛、盧森堡、馬爾他、荷蘭、波蘭、葡萄牙、羅馬尼亞、斯洛伐克、斯洛文尼亞、西班牙、瑞典

  • 僅屬於歐洲經濟區／屬於歐洲自由貿易聯盟或關稅同盟的非歐盟成員：[僅屬於歐洲經濟區/屬於歐洲自由貿易聯盟] 冰島、列支敦士登及挪威；瑞士：[歐盟關稅同盟] 所有海峽群島、曼島、摩納哥；塞浦路斯英屬基地區；[歐洲關稅同盟] 安道爾、聖馬利諾、梵蒂岡城。

  • 屬於歐洲外延地區 (OMR) 的非歐盟成員：馬提尼克島、馬約特、瓜德羅普島、法屬圭亞那、留尼汪島、聖馬丁、馬德拉、亞速爾、加那利群島。
  • 英國（所有不列顛群島）

逐步指示

1.選擇網址或專頁

選擇要使用回應附加程式的網站網址。

2.代碼配置工具

複製網址並貼在下方的代碼配置工具中。您可以調整設定，例如回應附加程式的 width 或預設顯示的帖子數量（num_posts）。點擊取得代碼按鈕，以產生您的回應附加程式代碼。

3.複製並貼上程式碼片段

複製程式碼片段並貼在您要執行回應的網站或網頁的 HTML 中。

回應附加程式代碼產生器

回應的網址
闊度
帖子數量
取得代碼

設定

上方的代碼配置工具只使用回應附加程式的部分設定。您還可以變更以下設定：

設定 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%。回應附加程式支援的最小寬度為 320px。

550

回應排序

用戶可使用回應附加程式右上角的選單，按照時間來將回應排序。

您可使用 data-order-by 屬性和以下值的任何一個來定義預設順序：

reverse_time（預設）

回應會以發佈先後的相反順序顯示，最上方是最新的回應，最下方則是最舊的回應。

time

回應會以發佈的先後順序顯示，最上方是最舊的回應，最下方則是最新的回應。

變更語言

您可透過載入 Facebook JavaScript SDK 的本地化版本，變更回應附加程式的語言。載入 SDK 時，您可更改 src 的值，以使用您的本地語言。舉例來說，您可以將 en_US 替換為您的語言設定，例如 fr_FR 為法文（法國）：

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

視乎所選語言，您或需要調整社交附加程式的寬度。進一步瞭解本地化和翻譯。

回應審核

回應附加程式包含了強大的審核工具。這個工具可讓您的社群管理團隊輕鬆快速地同時審核多則回應。

設定

若要使用回應審核工具，您需要完成審核設定指示。

審核設定指示

請注意，您無法使用 Graph API 回覆由回應附加程式作出的回應。

管理中心

有 2 種導覽至審核工具的方式：

1.以應用程式為基礎的審核檢視模式：前往 developers.facebook.com/tools/comments。您會看到您所有 Facebook 應用程式的清單，以便審核與每個應用程式相關的所有回應。如果您未於任何 Facebook 應用程式中使用回應附加程式，就無法使用這個檢視模式。

2.以專頁為基礎的審核檢視模式：點擊回應框旁的審核工具連結（請見下方螢幕截圖）。這個檢視模式僅會顯示發佈至此網頁（網址）的回應。

審核檢視模式

下方的螢幕截圖顯示了這兩種審核檢視模式。如果使用的是以應用程式為基礎的審核檢視模式，您可以使用選單在應用程式之間切換。

視乎回應的狀態而定，您可在審核表格中批准或隱藏回應。如要變更多則回應的狀態，請使用左欄的選框。

1.以專頁為基礎的審核檢視模式

在此審核檢視模式中，系統會顯示某個特定網址的所有回應。

2.以應用程式為基礎的審核檢視模式

在此審核檢視模式中，系統會顯示您應用程式的所有回應。

3.已標示的序列

由用戶或 Facebook 標示的回應會在此顯示。視乎應用程式的設定及舉報回應的方式而定，系統可能會公開或隱藏此清單中的回應。

設定

您可為各個應用程式定義自訂設定。使用設定按鈕（工具的右上角）開啟設定對話框。

版主

您可將其他用戶提拔為回應的版主。在輸入框中開始輸入朋友的名稱，系統便會顯示輸入提示對話框，以協助您選擇要成為版主的用戶。

回應排序方式

您也可以控制回應的排序方式。進一步瞭解回應排序。

審核

您可以為新的回應變更預設能見度。例如，您可能會想批准所有新的回應。如果回應尚未批准，則在版主批准回應之前，只有回應人才能看到相關回應。

審核模式分為三種：

公開

所有回應都會公開。所有回應也都會顯示在「審查」標籤中。

不公開

所有回應都會隱藏起來。

已封鎖用戶

版主可在「已封鎖用戶」標籤中搜尋已封鎖用戶。如果新回應來自已封鎖用戶，相關回應便會自動限制能見度並顯示在「審查」標籤中。

網址設定

關閉回應串

在任何使用回應附加程式的網址中，您都可以關閉回應串。執行這項操作，即表示用戶無法針對該網頁的討論加入新的回應。您可以在網址「設定」選單中關閉回應串。

覆寫自動關閉功能

如果啟用自動關閉功能，您便可以覆寫已關閉的回應串，以便重新啟用回應功能。您可以前往網址「設定」啟用覆寫自動關閉功能，然後為您負責審核的網址設定合適的關閉狀態。

審核設定

若要使用審核工具，您必須將 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

您可透過 Graph API 存取特定網址上的回應次數。舉例來說，您可透過網址節點上 comment_count 欄位的 share 屬性取得 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 參考資料文件以進一步瞭解可用回應的詳情。