زر تسجيل الدخول

زر تسجيل الدخول هو طريقة بسيطة لبدء تشغيل عملية تسجيل دخول فيسبوك على موقعك على الويب أو تطبيق الويب الخاص بك.

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

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

علمًا بأن زر تسجيل الدخول مُصمم فقط للعمل مع مجموعة SDK للغة JavaScript - إذا كنت تنشئ تطبيق هواتف محمولة أو لا يمكنك استخدام مجموعة SDK للغة JavaScript، فيجب اتباع دليل دفق تسجيل الدخول لهذا النوع من التطبيقات بدلاً من ذلك.

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

أداة تكوين المكون الإضافي

زر متابعة باسم {Name}

يتضمن الزر متابعة باسم {Name} النص "متابعة باسم {persons' name}" ويتضمن اختياريًا صورة الملف الشخصي للمستخدم على فيسبوك في حالة تسجيل دخوله إلى فيسبوك بالمتصفح نفسه. ولاستخدام الزر متابعة باسم {Name}، يجب أولاً تحميل مجموعة SDK للغة JavaScript. للحصول على إرشادات حول إعداد مجموعة SDK للغة JavaScript، راجع البدء السريع لمجموعة SDK للغة JavaScript. وقم بتمكين متابعة باسم {Name} عن طريق إضافة data-use-continue-as="true" إلى الإعدادات الخاصة بالزر الذي تستخدمه.

لا يمكن تخصيص ارتفاع الزر متابعة باسم {Name}.

إذا قمت بتحديد حجم أكبر من الحد الأقصى للمعلمات، فيتم تعيين الزر افتراضيًا إلى الحد الأقصى للعرض.

أفضل الممارسات الخاصة بالزر متابعة باسم {Name}

يمكن أن يكون الزر متابعة باسم {Name} طريقة رائعة لزيادة عدد النقرات ونسبة التفاعل. ويتيح هذا الزر للمستخدم عرض صور الملف الشخصي الخاصة به واسمه على الزر تسجيل الدخول ويمكن أن يساعد في جعل تطبيقك أكثر تخصيصًا.

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

حتى إن لم يكن الزر متابعة باسم {Name} مناسبًا لتطبيقك، لا يزال بإمكانك تجربة أزرار جديدة في مجموعة SDK للغة JavaScript التي تحمل النص "متابعة بحساب فيسبوك".

حالات الاستخدام المقترحة

نقدم خدماتنا لقاعدة عريضة من المستخدمين حول العالم ومناطق مختلفة تتفاوت فيها توقعات المستخدمين. احترم هذه التوقعات عند استخدام هذا الزر.

اختيار مناسب في الحالات التالية

• تطبيقات التواصل الاجتماعي:
  عندما يستخدم الأشخاص تطبيقات التواصل الاجتماعي، فإنهم يتوقعون أن يتواصلوا مع الآخرين. ورأينا أداءً جيدًا للزر متابعة باسم {Name} في مثل هذه الحالات.

• اشتراك الأشخاص في السوق المستهدف في استخدام الهواتف:
  عندما يستخدم العديد من الأشخاص الهاتف نفسه، يمكن أن يوفر الزر متابعة باسم {Name} ميزة إضافية للتأكد مرة أخرى من أنهم يستخدمون الحساب الصحيح.

اختيار غير مناسب في الحالات التالية

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

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

أفضل ممارسات الزر تسجيل الدخول

يرجى اتباع أفضل الممارسات العامة المتعلقة باستخدام تسجيل دخول فيسبوك. ومن المهم بشكل خاص اتباع الممارستين التاليتين من أفضل الممارسات عند استخدام الزر متابعة باسم {Name}:

• توفير طريقة لتسجيل الخروج (تتطلب السياسية ذلك)
• الاختبار والقياس - تحديد تأثير الزر في إدراك المستخدمين والتحويل

مجموعة أخرى من أفضل الممارسات المتاحة:

• توضيح ما يؤدي إليه تسجيل الدخول
• وضع عنصر نائب/أداة انتقاء أثناء تحميل زر تسجيل الدخول وإزالتها بعد تحميله. مثال على هذا الرمز البرمجي:

<script>
var finished_rendering = function() {
  console.log("finished rendering plugins");
  var spinner = document.getElementById("spinner");
  spinner.removeAttribute("style");
  spinner.removeChild(spinner.childNodes[0]);
}
FB.Event.subscribe('xfbml.render', finished_rendering);
</script>
<div id="spinner"
    style="
        background: #4267b2;
        border-radius: 5px;
        color: white;
        height: 40px;
        text-align: center;
        width: 250px;">
    Loading
    <div
    class="fb-login-button"
    data-max-rows="1"
    data-size="large"
    data-button-type="continue_with"
    data-use-continue-as="true"
    ></div>
</div>

الإعدادات

بالإضافة إلى الإعدادات الموضحة أعلاه، يمكنك أيضًا تغيير ما يلي:

الترحيل

سيتم ترحيل الأزرار القديمة إلى الأزرار الجديدة. يعرض الجدول التالي مخطط ذلك.

تحتوي الأزرار متابعة باسم {Name} على معلمة تُسمى button_type لا تتطلبها الأزرار القديمة. وهذه هي الطريقة التي تحدد بها الزر متابعة بحساب فيسبوك أو تسجيل الدخول بحساب فيسبوك. وإذا لم تحدد نوع الزر، فيتم عرض الزر على أنه زر جديد صغير الحجم. ويعتبر هذا الزر متوسط الحجم مقارنة بالأزرار القديمة. بالنسبة لحالة الزر x-large، سيتم تقليصه قليلاً. وإذا حددت المعلمة button_type، فستظهر الأزرار على النحو المحدد.

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

 <div
    class="fb-login-button"
    data-max-rows="1"
    data-size="<medium, large>"
    data-button-type="continue_with"
    data-width="<100% or px>"
    data-scope="<comma separated list of permissions, e.g. public_profile, email>"
></div>
}

الترجمة:

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

الأسئلة المتكررة

كيف يمكنني استخدام ذلك لتسجيل دخول المستخدمين؟

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

ولا يوجد إعداد إضافي ضروري هنا، ومع ذلك يمكنك استخدام الإعداد onlogin في الزر لتشغيل وظيفة JavaScript التي ستعمل عند تسجيل الدخول.

هل يمكنني استخدام الزر تسجيل الدخول برمز برمجي للتسجيل من جانب الخادم؟

يمكنك ذلك، إلا أنك ستظل في حاجة إلى استخدام مجموعة SDK للغة JavaScript جزئيًا. وبمجرد انتهاء عملية تسجيل الدخول التي بدأت عند النقر على الزر، ستتمكّن مجموعة SDK من الوصول إلى كائن authResponse باستخدام FB.getLoginStatus(). كما يمكنك استخدام هذه الوظيفة لإدخال كائن الاستجابة إلى الرمز البرمجي الوارد من جانب الخادم لإكمال أية عملية تسجيل موجودة.

هل يمكنني استخدام زر تسجيل الدخول لإعادة طلب إذن رفضه شخص؟

لا يدعم الزر تسجيل الدخول عمليات إعادة الطلب لأن طلب الأذونات المرفوضة لا يناسب الإجراء الموجود على الزر. وإذا أردت إعادة طلب إذن، فقم بإعداد زر مخصص واستخدم FB.login() كما هو موضح في مستندات تسجيل دخول فيسبوك للويب.

الزر غير معروض.

يتم تحويل الإشارات <div> إلى أزرار معروضة باستخدام التكنولوجيا التي نطلق عليها XFBML والتي تعتمد على لغة JavaScript في مجموعة SDK لتحليل الصفحة وتنفيذ عمليات الاستبدال. وإذا كنت تقوم بتعديل محتوى صفحة ديناميكيًا لإضافة div بعد تشغيل الأسلوب init لمجموعة SDK (مثل في مربع الحوار الذي تم إنشاؤه ديناميكيًا)، فستحتاج إلى استدعاء FB.XFBML.parse() مرة أخرى حتى يتم تنفيذ التحويل.