المكون الإضافي للتعليقات

يتيح المكون الإضافي للتعليقات للأشخاص إمكانية التعليق على محتوى ما بموقعك باستخدام حساباتهم على فيسبوك. ويمكن للأشخاص مشاركة نشاط تعليقاتهم مع أصدقائهم (وأصدقاء أصدقائهم) على فيسبوك أيضًا. ويحتوي المكون الإضافي للتعليقات أيضًا على أدوات إشراف مضمنة وترتيب للتعليقات من حيث الملاءمة الاجتماعية.

أداة تكوين المكون الإضافي للتعليقاتالإشرافالإعداداتضبط اللغةالأسئلة المتكررة

الخطوات التفصيلية

1. اختيار عنوان URL أو صفحة

اختر عنوان URL لموقع الويب الذي تريد استخدامه مع المكون الإضافي للتعليقات.

2. أداة تكوين الرموز

انسخ عنوان URL والصقه في أداة تكوين الرموز أدناه. يمكنك ضبط إعدادات مثل widthللمكون الإضافي للتعليقات أو عدد المنشورات التي تريد عرضها افتراضيًا (num_posts). انقر على الزر الحصول على الرمز لإنشاء رمز المكون الإضافي للتعليقات.

3. نسخ جزء الرمز ولصقه

انسخ جزء الرمز والصقه في علامات HTML بموقعك أو صفحتك على الويب حيث تريد تنفيذ التعليقات.

أداة إنشاء رموز المكون الإضافي للتعليقات

عنوان URL المطلوب التعليق عليه
العرض
عدد المنشورات

الإعدادات

لا تستخدم أداة تكوين الرموز الموضحة أعلاه إلا مجموعة فرعية من كل الإعدادات الممكنة للمكون الإضافي للتعليقات. ويمكنك أيضًا تغيير الإعدادات التالية:

الإعداد سمة HTML5 الوصف القيمة الافتراضية

colorscheme

data-colorscheme

نظام الألوان المستخدم بواسطة المكون الإضافي للتعليقات. والقيم التي يمكن استخدامها هي"light" أو "dark".

"light"

href

data-href

عنوان URL المطلق الذي سترتبط به التعليقات المنشورة في المكون الإضافي بشكل دائم. ستحتوي كل الأحداث التي تتم مشاركتها على فيسبوك بشأن تعليقات منشورة باستخدام المكون الإضافي على رابط لعنوان URL هذا.

عنوان URL الحالي.

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 (قيمة افتراضية)

وتعرف أيضًا باسم "Top" (الأفضل). يستخدم المكون الإضافي للتعليقات إشارات اجتماعية لإظهار التعليقات الأكثر جودة أولاً. يتم ترتيب التعليقات بحيث تظهر أولاً التعليقات الأكثر ملاءمة من الأصدقاء وأصدقاء الأصدقاء وكذلك أكثر التعليقات حصولاً على تسجيلات الإعجاب أو سلاسل المناقشات النشطة. ويتم إخفاء التعليقات التي أشار المستخدمون إلى أنها غير مهمة أو احتيالية من العرض.

ملاحظة: لن تقبل سلاسل التعليقات الأقدم الفرز اجتماعيًا - ويندرج تحت ذلك السلاسل المقترنة بكائن 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";

اللغات المدعومة موضحة في ملف لغات فيسبوك بتنسيق XML.

وقد يتطلب الأمر ضبط عرض المكون الإضافي للتواصل الاجتماعي حتى يتوافق مع اللغات المختلفة. تعرف على المزيد عن التطويع المحلي والترجمة.

الإشراف على التعليقات

يحتوي المكون الإضافي للتعليقات على أداة إشراف قوية. تساعد هذه الأداة على توفير السهولة والسرعة لفريق إدارة المجتمع في الإشراف على العديد من التعليقات دفعة واحدة.

الإعداد

لاستخدام أداة الإشراف على التعليقات، يجب تنفيذ تعليمات إعداد الإشراف.

تعليمات إعداد الإشراف

يرجى العلم أنه لا يمكنك استخدام واجهة Graph API للرد على التعليقات التي تتم باستخدام المكون الإضافي للتعليقات.


لوحة التحكم

هناك طريقتان للوصول إلى أداة الإشراف:

1. طريقة عرض الإشراف حسب التطبيق: انتقل إلى developers.facebook.com/tools/comments. حيث تظهر لك قائمة بكل تطبيقاتك على فيسبوك، وهو ما يتيح لك الإشراف على كل التعليقات المرتبطة بكل تطبيق. إذا لم تكن تستخدم تطبيق فيسبوك مع المكون الإضافي للتعليقات، فلن تتمكن من استخدام طريقة العرض هذه.

2. طريقة عرض الإشراف حسب الصفحة: انقر على رابط أداة الإشراف الموجود بجوار مربع التعليقات (راجع لقطة الشاشة أدناه). ولا تعرض طريقة العرض هذه إلا التعليقات المنشورة على صفحة الويب هذه (عنوان URL).

طريقة عرض الإشراف

توضح لقطات الشاشة التالية طريقتي عرض الإشراف. إذا كنت تستخدم طريقة عرض الإشراف حسب التطبيق، يمكنك استخدام القائمة للتبديل بين التطبيقات.

في جدول الإشراف، يمكنك إخفاء التعليقات أو الموافقة عليها تبعًا لحالتها. لتغيير حالة تعليقات متعددة، استخدم مربعات الاختيار الموجودة في العمود الأيمن.

1. طريقة عرض الإشراف حسب الصفحة

في طريقة عرض الإشراف هذه، يتم عرض كل التعليقات لعنوان url محدد.

2. طريقة عرض الإشراف حسب التطبيق

في طريقة عرض الإشراف هذه، يتم عرض كل التعليقات لتطبيقك.

3. قائمة المميزة بعلامة

يتم هنا عرض التعليقات التي يميزها المستخدم أو فيسبوك بعلامة لوجود خطب ما بها. ويمكن جعل التعليقات بهذا القائمة عامة أو مخفية تبعًا لإعدادات التطبيقات وكيفية الإبلاغ عن هذه التعليقات.

4. قائمتي

لتقسيم العمل على نحو أفضل بين المطورين، يمكنك استخدام هذه الميزة لتعيين التعليقات لنفسك من أجل الإشراف عليها. وتظل التعليقات المعينة هنا متاحة للمشرفين أو المسؤولين الآخرين، لكن التعليقات الموجودة في قائمتك لن تظهر في قوائم الآخرين.

الإعدادات

يمكنك تحديد إعدادات مخصصة لكل تطبيق. استخدم الزر الإعدادات (أعلى يسار الأداة) لفتح مربع حوار الإعدادات.


المشرفون

يمكنك ترقية أشخاص آخرين للقيام بمهام الإشراف على تعليقاتك. ابدأ كتابة اسم صديقك في مربع الإدخال، وستظهر لك قائمة كتابة مسبقة لمساعدتك على تحديد الشخص الذي تريد تعيينه كمشرف.


فرز التعليقات حسب

يمكنك أيضًا التحكم في طريقة فرز التعليقات. تعرف على المزيد في فرز التعليقات.


الإشراف

يمكنك تغيير القيمة الافتراضية لعرض التعليقات الجديدة. على سبيل المثال، قد ترغب في الموافقة على كل التعليقات الجديدة. وإذا لم تتم الموافقة على تعليق ما، فسيكون مرئيًا فقط للشخص الذي وضع التعليق إلى أن يوافق المشرف عليه.

توجد ثلاثة أوضاع مختلفة للإشراف:

عامة

تظهر كل التعليقات للعامة، وتظهر أيضًا في علامة تبويب "المراجعة".

مغلقة

يتم إخفاء كل التعليقات.

المستخدمون المحظورون

في علامة تبويب "المستخدمون المحظورون" يمكن للمشرفين البحث عن المستخدمين المحظورين. إذا تم نشر تعليق جديد من مستخدم محظور، فسيتم تلقائيًا تقييد ظهور التعليق ووضعه في علامة تبويب "المراجعة".


مع طرح الإصدار 4.28.0 من مجموعة Facebook SDK، تم إيقاف استخدام انعكاس التعليقات. وسيظل مدعومًا حتى 5 فبراير 2018.

انعكاس التعليقات

تتيح ميزة انعكاس التعليقات للأشخاص المشاركة في محادثة واحدة، سواءً كان مصدر التعليقات هو صفحتك على الويب أو صفحتك على فيسبوك. عندما تشارك رابطًا إلى موقع الويب الخاص بك في صفحتك على فيسبوك، تظهر التعليقات من صفحة الويب هذه كتعليقات على منشور صفحتك على فيسبوك، والعكس بالعكس. يساعد ذلك على خلق حوار أكثر ثراءً بصفحتك على فيسبوك وبموقعك على الويب لأن التعليقات سوف تظهر بالصفحة والموقع معًا.

يمكنك تشغيل انعكاس التعليقات في أداة الإشراف بالانتقال إلى علامة التبويب الإعدادات. ولتشغيل انعكاس التعليقات، يجب أن تكون مسؤول صفحة فيسبوك التي تريد تمكين الانعكاس بها.

إذا كنت تريد السماح للأشخاص بتضمين صور في التعليقات عند تمكين انعكاس التعليقات، يجب تشغيل السماح لزوار الصفحة بنشر منشورات في صفحتك. حتى يتم انعكاس التعليقات بشكل صحيح، يجب أن تكون صفحة فيسبوك متاحة للعامة.

يسري مفعول انعكاس التعليقات على صفحات الويب الجديدة التي تم إنشاؤها بعد تمكين الإعداد. بعد تشغيل انعكاس التعليقات لصفحة ويب بعينها، لا توجد طريقة لتعطيل هذه الميزة (يمكنك فقط إيقاف تشغيل انعكاس التعليقات لصفحات الويب الجديدة من الآن فصاعدًا)، لذا في حالة تمكين ميزة الإغلاق التلقائي ومشاركتها بصفحتك على فيسبوك، سيظل بالإمكان وضع التعليقات الجديدة من منشور صفحة ، وليس من صفحتك على الويب.

هل سيعلم الأشخاص أننا نقوم بتشغيل انعكاس التعليقات؟ عندما يبدأ الشخص كتابة تعليق بموقعك على الويب، يرى رسالة تخبره بأن التعليق سيظهر أيضًا على صفحة فيسبوك. وتظهر الرسالة ذاتها عندما يبدأ الشخص بكتابة تعليق على مقال منشور بصفحتك على فيسبوك.


كيف يعمل الإشراف؟ كل التعليقات، سواء التي يتم وضعها على منشور صفحة فيسبوك أو على المقال الأصلي بموقع الويب، تظهر في الأداة الرئيسية للإشراف على التعليقات في فيسبوك، وبالتالي يمكن الإشراف على كل التعليقات التي تظهر بصفحة المقال. إذا أخفيت تعليقًا في أداة الإشراف، فسيختفي تلقائيًا من صفحة فيسبوك أيضًا.

إعدادات عنوان URL

إغلاق سلسلة

يمكنك إغلاق سلسلة تعليقات بأي عنوان URL تستخدم فيه المكون الإضافي للتعليقات. ويعني القيام بذلك أن الأشخاص لن يتمكنوا من إضافة تعليقات جديدة إلى المناقشة القائمة على صفحة الويب هذه. يمكنك إغلاق السلاسل من قائمة إعدادات عنوان URL.

تجاوز الإغلاق التلقائي

في حالة تمكين الإغلاق التلقائي، يمكنك تجاوز السلاسل المغلقة، وهو ما يؤدي إلى فتحها مجددًا أمام وضع التعليقات. للقيام بذلك، انتقل إلى إعدادات عنوان URL وقم بتشغيل تجاوز الإغلاق التلقائي. بعد ذلك، قم بتعيين حالة الإغلاق المطلوبة لعنوان URL الذي تقوم بالإشراف عليه.

إعداد الإشراف

لاستخدام أداة الإشراف، يجب ربط حساب فيسبوك أو تطبيق فيسبوك لتنفيذ المكون الإضافي للتعليقات.

الإعداد باستخدام تطبيق فيسبوك (المفضل)

إذا كان موقعك يحتوي على العديد من مربعات التعليق، فإننا نوصي بتحديد معرف تطبيق فيسبوك ككيان للإدارة، ويعني ذلك أن كل مسؤولي التطبيق يمكنهم الإشراف على التعليقات. يتيح ذلك للمشرف الدخول على فيسبوك إلى المكان الذي يمكن فيه الإشراف بسهولة على جميع التعليقات من كل المكونات الاجتماعية التي تدار بمعرف تطبيقك.

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

بالإضافة إلى الأشخاص الذين تضيفهم باستخدام الإعداد المشرفون، سيتمكن كل مسؤولي تطبيقك من الإشراف أيضًا على التعليقات، ولكن سيتمكن المشرفون فقط من تلقي إشعارات للتعليقات الجديدة إذا قمت بتمكين الإشعارات.

عند تنفيذ مربعات تعليق متعددة بموقعك وربطها بتطبيق ما عن طريق تحديد معرف تطبيق، سوف تنطبق إعدادات الإشراف التي تختارها على كل مربعات التعليقات.

على سبيل المثال، سيؤثر تغيير إعداد الإشراف إلى ظهور مقيد في كل مربعات التعليقات التي لها معرف التطبيق نفسه. إذا كنت بحاجة لتطبيق إعدادات إشراف مختلفة في الأماكن المختلفة بموقعك، ينبغي عليك استخدام اثنين أو أكثر من معرفات التطبيقات. يمكنك بعدها تنفيذ إعدادات إشراف مختلفة لكل مجموعة من مربعات التعليقات.

يمكنك تحديد fb:app_id أو fb:admins، وليس القيمتين معًا.

تعيين حساب فيسبوك كمسؤول

لتعيين حساب فيسبوك كمسؤول لتنفيذ المكون الإضافي للتعليقات، ما عليك إلا تضمين عنصر التعريف التالي في القسم <head> بكل صفحة ويب تستخدم فيها المكون الإضافي للتعليقات:

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

لإضافة عدة مشرفين، أضف أكثر من عنصر واحد، وكل منهم بمعرف فيسبوك منفصل:

<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 معين عبر استخدام Graph API. على سبيل المثال، يمكن الوصول إلى عدد التعليقات بموقع 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، انقر على "Set Up" (إعداد).
  4. اختر "Application" (التطبيق) في القائمة المنسدلة
  5. انقر على الزر "Subscribe to this topic" (الاشتراك في هذا الموضوع)
  6. في مربع الحوار أدخل عنوان URL الخاص بالبرنامج النصي الذي سيتلقى الإشعارات، على سبيل المثال https://example.org/mywebhook.php
  7. أدخل رمز الوصول - أي سلسلة نصية تختارها. سيتم إرساله إلى برنامجك النصي للتحقق
  8. آخر خطوة في عملية الإعداد هي النقر على الزر "Verify and Save" (تأكيد وحفظ)

ولكن قبل ذلك، يرجى الاطلاع على وثائق 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، ستظهر لك "plugin_comment" و"plugin_comment_reply" في قسم Webhooks من لوحة معلومات التطبيق.

انقر على "Test" (اختبار) لإعادة التحقق من عملية التنفيذ من خلال نموذج استجابة، ثم "Subscribe" (اشتراك) لبدء النشر.

يتوفر المزيد من التفاصيل عن الاستجابة في وثائق Webhooks المرجعية.