مربع الحوار مشاركة

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

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

لتنفيذ مربع الحوار مشاركة في تطبيقات الهواتف المحمولة الأصلية، يرجى قراءة الدلائل التي نوفرها لنظامي iOS وAndroid.

التكامل

يتوفر مربع الحوار مشاركة في مجموعة Facebook SDK للغة JavaScript. ويمكنك استخدام جزء الرمز التالي لبدء تشغيل مربع الحوار مشاركة. ويمكنك أيضًا استخدام إعادة توجيه إلى عنوان URL. للحصول على التفاصيل، راجع قسم موضوعات متقدمة.

مجموعة SDK فيسبوك لـ JavaScript

تشغيل مربع الحوار مشاركة باستخدام وظيفة FB.ui بمعلمة الطريقة share من أجل مشاركة رابط.

لمشاركة رابط:

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

جرب ذلك بنفسك!

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

لاحظ أن response.error_message ستظهر فقط إذا كان هناك شخص من مستخدمي تطبيقك قام بمصادقة تطبيقك باستخدام تسجيل دخول فيسبوك.

المعلمات

المعلمات العامة

ستوفر JS SDK هذه المعلمات تلقائيًا.

المعلمة الوصف

المعلمة	الوصف
`app_id`	المعرف الفريد لتطبيقك. ويجب إدخال هذه المعلمة.
`redirect_uri`	عنوان URL الوجهة الذي يتم توجيه الشخص إليه بعد النقر على زر في مربع الحوار. يجب إدخال هذه المعلمة عند استخدام إعادة توجيه عنوان URL.
`display`	تحدد طريقة عرض مربع الحوار. إذا قمت باستخدام تنفيذ مربع حوار إعادة توجيه عنوان URL، فستكون طريقة العرض المستخدمة عبارة عن عرض صفحة كاملة على النحو المعروض في Facebook.com. ويطلق على نوع العرض هذا اسم `page`. إذا كنت تستخدم مجموعات SDK لنظام iOS أو Android في استدعاء مربع الحوار، يتم تحديده تلقائيًا واختيار نوع العرض المناسب للجهاز. إذا كنت تستخدم Facebook SDK للغة JavaScript، يتم تعيين الإعداد الافتراضي على نوع `iframe` شرطي للأشخاص المسجل دخولهم إلى تطبيقك أو `async` عند استخدام لعبة على Facebook.com، ونافذة `popup` لأي شخص آخر. يمكنك أيضًا فرض النوع `popup` عند استخدام مجموعة Facebook SDK للغة JavaScript، إذا لزم الأمر. وعادةً ما تكون القيمة الافتراضية لتطبيقات الويب للهواتف المحمولة هي نوع العرض `touch`.

app_id

المعرف الفريد لتطبيقك. ويجب إدخال هذه المعلمة.

redirect_uri

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

display

تحدد طريقة عرض مربع الحوار.

إذا قمت باستخدام تنفيذ مربع حوار إعادة توجيه عنوان URL، فستكون طريقة العرض المستخدمة عبارة عن عرض صفحة كاملة على النحو المعروض في Facebook.com. ويطلق على نوع العرض هذا اسم page.
إذا كنت تستخدم مجموعات SDK لنظام iOS أو Android في استدعاء مربع الحوار، يتم تحديده تلقائيًا واختيار نوع العرض المناسب للجهاز.
إذا كنت تستخدم Facebook SDK للغة JavaScript، يتم تعيين الإعداد الافتراضي على نوع iframe شرطي للأشخاص المسجل دخولهم إلى تطبيقك أو async عند استخدام لعبة على Facebook.com، ونافذة popup لأي شخص آخر. يمكنك أيضًا فرض النوع popup عند استخدام مجموعة Facebook SDK للغة JavaScript، إذا لزم الأمر.
وعادةً ما تكون القيمة الافتراضية لتطبيقات الويب للهواتف المحمولة هي نوع العرض touch.

معلمات `share`

المعلمة	الوصف	القيمة الافتراضية
`href`	الرابط المرفق بهذا المنشور. يجب إدخالها عند استخدام الطريقة `share`. قم بتضمين علامات open graph وصفية في الصفحة في عنوان URL هذا لتخصيص الحدث الذي تتم مشاركته.	عنوان URL الحالي
`hashtag`	علامة هاشتاج من تحديد المطور مقرر إضافتها إلى المحتوى الذي تتم مشاركته. ستظل لدى الأشخاص الفرصة لإزالة علامة الهاشتاج هذه من مربع الحوار. يجب أن تشتمل علامة الهاشتاج على رمز المربع، مثل `#facebook`.	`null`
`quote`	اقتباس تتم مشاركته مع الرابط، ويتم تمييزه بواسطة المستخدم أو يتم تحديده سلفًا بواسطة المطور، كاقتباس بارز بأحد المقالات.	`null`
`mobile_iframe`	إذا تم تعيين القيمة إلى `true`، فسيفتح زر المشاركة مربع حوار المشاركة في إطار iframe أعلى موقعك على الويب (لمزيد من المعلومات، راجع مربع حوار مشاركة ويب الهاتف المحمول. هذا الخيار يتوفر فقط للهواتف المحمولة، وليس لأجهزة الكمبيوتر.	`false`

بيانات الاستجابة

المعلمة	الوصف
`post_id`	تتوفر فقط في حالة تسجيل دخول المستخدم إلى تطبيقك باستخدام فيسبوك وقيامه بمنح `publish_actions`. في حالة وجودها، تصبح هي معرف حدث Open Graph المنشور.
`error_message`	تتوفر فقط في حالة تسجيل دخول المستخدم إلى تطبيقك باستخدام تسجيل دخول فيسبوك.

موضوعات متقدمة

يمكنك أيضًا الاستفادة من الميزات المتقدمة التالية.

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

نموذج الرمز البرمجي

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

FB.ui({
  method: 'share',
  mobile_iframe: true,
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

جرب ذلك بنفسك!

إعادة توجيه عنوان URL

لمشاركة رابط:

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

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

إجراءات Open Graph

ابدأ تشغيل مربع الحوار مشاركة باستخدام وظيفة FB.ui مع معلمة الطريقة share_open_graph لمشاركة حدث Open Graph.

لمشاركة حدث Open Graph باستخدام مربع الحوار:

FB.ui({
  method: 'share_open_graph',
  action_type: 'og.likes',
  action_properties: JSON.stringify({
    object:'https://developers.facebook.com/docs/',
  })
}, function(response){});

لاحظ أن إعادة توجيه عنوان URL تعمل بنفس طريقة مشاركات الروابط القياسية.

معلمات `share_open_graph`

استخدم المعلمات نفسها لمشاركة رابط قياسي، لكن مع إضافة ما يلي:

المعلمة الوصف

المعلمة	الوصف
`action_type`	سلسلة تحدد نوع إجراء Open Graph المطلوب نشره، على سبيل المثال `og.likes` لنوع الإعجاب المضمن. ويدعم مربع الحوار كذلك الأنواع المخصصة المعتمدة. يجب إدخالها عند استخدام الطريقة `share_open_graph`.
`action_properties`	كائن JSON لأزواج مفتاح/قيمة تحدد المعلمات التي توافق `action_type` الجاري استخدامه. وأزواج المفتاح/القيمة الصالحة هي نفسها المعلمات التي يمكن استخدامها عند نشر إجراءات Open Graph باستخدام واجهة API. يجب إدخالها عند استخدام الطريقة `share_open_graph`.

action_type

سلسلة تحدد نوع إجراء Open Graph المطلوب نشره، على سبيل المثال og.likes لنوع الإعجاب المضمن. ويدعم مربع الحوار كذلك الأنواع المخصصة المعتمدة. يجب إدخالها عند استخدام الطريقة share_open_graph.

action_properties

كائن JSON لأزواج مفتاح/قيمة تحدد المعلمات التي توافق action_type الجاري استخدامه. وأزواج المفتاح/القيمة الصالحة هي نفسها المعلمات التي يمكن استخدامها عند نشر إجراءات Open Graph باستخدام واجهة API. يجب إدخالها عند استخدام الطريقة share_open_graph.

لا يدعم مربع الحوار share_open_graph القيمة mobile_iframe: true.