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

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

التغييرات الطارئة على المكونات الإضافية للتواصل الاجتماعي في المنطقة الأوروبية

قد تبدأ في رؤية بعض التأثير على المكونات الإضافية للتواصل الاجتماعي بسبب مطالبة الموافقة على ملفات تعريف الارتباط المحدَّثة التي سيتم عرضها للأشخاص باستخدام منتجات فيسبوك داخل المنطقة الأوروبية. ولن ندعم بعد الآن المكونات الإضافية للتواصل الاجتماعي "أعجبني" و"تعليق" لدى المستخدمين داخل المنطقة الأوروبية، إلا إذا قاموا 1) بتسجيل الدخول إلى حساب فيسبوك لديهم و2) تم تقديم موافقة إلى عنصر التحكم "ملفات تعريف الارتباط للتطبيق وموقع الويب". وإذا تم استيفاء هذين الشرطين، فسيتمكن المستخدم من رؤية المكونات الإضافية والتفاعل معها، مثل الزر "أعجبني" أو "تعليق". أما إذا لم يتم استيفاء أي من الشروط المذكورة أعلاه، فلن يتمكن المستخدم من رؤية المكونات الإضافية.

المنطقة الأوروبية هي قائمة محدَّدة من البلدان، وتتضمن:

  • الاتحاد الأوروبي (EU): النمسا، بلجيكا، بلغاريا، كرواتيا، جمهورية قبرص، جمهورية التشيك، الدنمارك، إستونيا، فنلندا، فرنسا، ألمانيا، اليونان، المجر، أيرلندا، إيطاليا، لاتفيا، ليتوانيا، لوكسمبورغ، مالطا، هولندا، بولندا، البرتغال، رومانيا، سلوفاكيا، سلوفينيا، إسبانيا، السويد

  • البلدان من خارج الاتحاد الأوروبي، ولكنها تقع في المنطقة الاقتصادية الأوروبية فقط/رابطة التجارة الحرة الأوروبية أو الاتحاد الجمركي: [المنطقة الاقتصادية الأوروبية فقط/رابطة التجارة الحرة الأوروبية] آيسلندا وليختنشتاين والنرويج وسويسرا: [الاتحاد الجمركي للاتحاد الأوروبي] جميع جزر القنال وجزيرة مان وموناكو؛ القواعد ذات السيادة البريطانية في قبرص؛ [الاتحاد الجمركي للاتحاد الأوروبي] أندورا، سان مارينو، مدينة الفاتيكان.

  • البلدان من خارج الاتحاد الأوروبي، ولكنها جزء من مناطق أوروبا الخارجية المتطرفة (OMR): مارتينيك، ومايوت، وغوادلوب، وغويانا الفرنسية، وريونيون، وسانت مارتن، وماديرا، وجزر الأزور، وجزر الكناري.
  • المملكة المتحدة (جميع الجزر البريطانية)

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

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

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

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

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

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

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

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

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

الإعدادات

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

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

colorscheme

data-colorscheme

يمثل نظام الألوان المُستخدم من جانب المكون الإضافي للتعليقات. ويمكن أن يكون "فاتح" أو "داكن".

"فاتح"

href

data-href

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

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

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"

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

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

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

الإعداد

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

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

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


لوحة المعلومات

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

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

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

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

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

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

1. طريقة عرض الإشراف القائمة على الصفحة

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

2. طريقة عرض الإشراف القائمة على التطبيق

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

3. قائمة انتظار التعليقات التي تم الإبلاغ عنها

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

الإعدادات

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


المشرفون

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


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

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


الإشراف

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

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

عام

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

مغلق

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

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

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


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

إغلاق سلسلة منشورات

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

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

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

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

لاستخدام أداة الإشراف، يجب ربط حساب 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 إلى عرض عدد التعليقات الموجودة بعنوان URL محدد في عنصر <span> بصفحة الويب لديك. وعندئذ، يمكنك استخدام CSS لضبط نمط عنصر <span> هذا ليتطابق مع بقية الأنماط في موقعك على الويب. ملاحظة: لا تتوفر هذه الميزة حاليًا في HTML5.

فعلى سبيل المثال، لإظهار عدد التعليقات في example.com، استخدم الرمز البرمجي التالي:

<span class="fb-comments-count" data-href="https://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، انقر على "إعداد"
  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، ستظهر لك "plugin_comment" و"plugin_comment_reply" في قسم أحداث Webhooks ضمن لوحة معلومات التطبيق.

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

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