‏المشاركة‏

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

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

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

فيما يلي مثال على مربع الحوار مشاركة الذي يشارك رابطًا في يوميات المستخدم.

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

إذا كنت مسؤول ويب لصفحة تمت مشاركتها على فيسبوك، فقم بتضمين إشارات تعريف open graph لتخصيص القصة التي تمت إعادة مشاركتها على فيسبوك. من المهم ترميز موقعك على الويب باستخدام إشارات Open Graph للتحكم في طريقة ظهور المحتوى الذي توفره على فيسبوك. لمزيد من المعلومات، راجع دليل المشاركة لمسؤولي الويب.

المشاركة باستخدام إعادة التوجيه عن طريق عنوان URL

لمشاركة رابط باستخدام إعادة التوجيه عن طريق عنوان 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

المشاركة باستخدام مجموعة Facebook SDK للغة JavaScript

يتوفر مربع الحوار مشاركة في مجموعة Facebook SDK للغة JavaScript باستخدام وظيفة FB.ui التي تتضمن معلمة الأسلوب share. استخدم جزء الرمز البرمجي التالي لفتح مربع الحوار مشاركة.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});
جرّب ذلك بنفسك!

المعلمات

فيما يلي معلمات مربع الحوار مشاركة.

المعلمةالوصفهل مطلوب؟

app_id

المعرف الفريد للتطبيق.

نعم. يتم توفيره تلقائيًا عند استخدام مجموعة SDK.

display

طريقة عرض مربع الحوار مشاركة.

  • إعادة التوجيه عن طريق عنوان URL - تكون القيمة display هي page. مربع الحوار مشاركة هو صفحة كاملة تظهر في Facebook.com.

  • مجموعة Facebook SDK للغة JavaScript - تكون قيمة العرض هي إحدى القيم التالية:

    • قيمة iframe مشروطة للأشخاص الذي قاموا بتسجيل الدخول إلى تطبيقك
    • async عند الاستخدام داخل لعبة على Facebook.com
    • نافذة popup لأي شخص آخر

    يمكنك أيضًا فرض النوع popup عند استخدام مجموعة Facebook SDK للغة JavaScript إذا لزم الأمر.

  • تطبيقات ويب الهواتف المحمولة - تكون القيمة display دائمًا touch.

  • مجموعة Facebook SDK لنظام iOS أو نظام Android - تحدد مجموعة SDK display تلقائيًا وتختار نوع عرض مناسب للجهاز.

نعم. يتم توفيره تلقائيًا عند استخدام مجموعة SDK.

hashtag

هاشتاج يمكن إضافته إلى المحتوى الذي تتم مشاركته. ويمكن للأشخاص إزالة الهاشتاج في مربع الحوار مشاركة. يجب أن يتضمن الهاشتاج رمز التجزئة، على سبيل المثال #facebook. القيمة الافتراضية هي null.

لا

href

الرابط المطلوب مشاركته. القيمة الافتراضية هي عنوان URL الحالي.

مطلوب عند استخدام مجموعة SDK.

redirect_uri

الميزات التي تم إيقاف استخدامها

The URL to redirect to after a person clicks a button on the Share dialog.Yes. Provided automatically when you use the SDK.
mobile_iframe

الميزات التي تم إيقاف استخدامها

true to open the share dialog in an iframe on top of your website. This option is only available for mobile, not desktopfalse

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

لا تحدث الاستجابة إلا إذا قام المستخدم بتسجيل الدخول إلى تطبيقك باستخدام تسجيل دخول فيسبوك.

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

error_message

رسالة خطأ.

راجع أيضًا