مجموعة SDK للغة JavaScript - الإعداد المتقدم

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

المتصفحات المدعومة

تدعم مجموعة Facebook SDK للغة Javascript آخر إصدارين من المتصفحات الأكثر انتشارًا: Chrome وFirefox وEdge وSafari (تتضمن نظام التشغيل iOS) وInternet Explorer (الإصدار 11 فقط).

تغيير اللغة

في جزء الرمز البرمجي للإعداد الأساسي، تتم تهيئة الإصدار en_US من مجموعة SDK، الأمر الذي يعني أن كل الأزرار والمكونات الإضافية التي أنشأها فيسبوك والمستخدمة على موقع الويب لديك ستكون باللغة الإنجليزية (الولايات المتحدة). (ومع ذلك، ستكون مربعات الحوار المنبثقة التي أنشأها فيسبوك، مثل مربع الحوار تسجيل الدخول باللغة التي اختارها الشخص في فيسبوك، حتى لو كانت مختلفة عن اللغة التي حددتها.) يمكنك تغيير هذه اللغة عن طريق تغيير القيمة src في جزء الرمز البرمجي. ألقِ نظرة على التطويع المحلي لمعرفة الإعدادات المحلية المختلفة التي يمكن استخدامها. على سبيل المثال، إذا كان موقعك باللغة الإسبانية، فسيؤدي استخدام كود البلد التالي لتحميل مجموعة SDK إلى عرض كل المكونات الإضافية للتواصل الاجتماعي باللغة الإسبانية.

<script async defer crossorigin="anonymous" src="https://connect.facebook.net/es_LA/sdk.js"></script>

التحقق من حالة تسجيل الدخول

إذا قمت بتعيين status على true في استدعاء FB.init()، فستحاول مجموعة SDK الحصول على معلومات حول المستخدم الحالي بعد التهيئة مباشرةً. ويمكن يؤدي ذلك إلى تقليل الوقت المستغرق لفحص حالة المستخدم الذي سجّل الدخول إذا كنت تستخدم تسجيل دخول فيسبوك، ولكن لا يُعد مفيدًا للصفحات التي تتضمن مكونات إضافية للتواصل الاجتماعي فقط.

يمكنك استخدام FB.getLoginStatus لمعرفة حالة تسجيل دخول الشخص. اقرأ لمعرفة المزيد حول استخدام تسجيل دخول فيسبوك مع مجموعة SDK للغة JavaScript.

تعطيل تحليل XFBML

من خلال تعيين xfbml على true، ستقوم مجموعة SDK بتحليل نموذج DOM في صفحتك للعثور على أي مكونات إضافية للتواصل الاجتماعي تمت إضافتها باستخدام XFBML وتهيئتها. وإذا لم تكن تستخدم مكونات إضافية للتواصل الاجتماعي على الصفحة، فسيؤدي تعيين xfbml على false إلى وقت تحميل الصفحة. يمكنك معرفة المزيد حول هذا الأمر بالاطلاع على المكونات الإضافية للتواصل الاجتماعي.

تشغيل الرمز عند تحميل مجموعة SDK

يتم تشغيل الوظيفة المعينة إلى window.fbAsyncInit بمجرد اكتمال تحميل مجموعة SDK. ويجب وضع أي رمز تريد تشغيله بعد تحميل مجموعة SDK ضمن هذه الوظيفة وبعد استدعاء FB.init. كما يمكن استخدام أي نوع من لغة JavaScript هنا، ولكن يجب استدعاء وظائف مجموعة SDK بعد FB.init.

تصحيح الأخطاء

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

src="https://connect.facebook.net/en_US/sdk/debug.js"