كيفية إعداد تسجيل الدخول بدون كلمة مرور (تسجيل الدخول عبر OTP)

توفر ميزة تسجيل الدخول بدون كلمة مرور (Passwordless Login) لعملائك وصولاً سهلاً وخالياً من العقبات دون عناء وتوتر تذكر كلمات المرور التقليدية والمعقدة. يعزز هذا الخيار سرعة تحويلات العملاء العائدين ويؤمن عمليات تسجيل الدخول من خلال رموز استخدام لمرة واحدة آمنة أو قوالب تفاعلية فريدة عبر واتساب.

1. الإعدادات العامة (الطريقة الافتراضية وأمان الجلسات)

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

طريقة تسجيل الدخول الافتراضية (login_method)

اختر التبويب الافتراضي الذي يراه المستخدمون أولاً عند فتح النموذج:

• تسجيل الدخول بالهاتف (phone_login): تحقق مباشر عبر واتساب أو رسائل SMS. موصى به للجماهير التي تستخدم الهواتف المحمولة أولاً.
• تسجيل الدخول بالبريد الإلكتروني (email_login): تسجيل آمن عبر رابط البريد السحري أو التحقق الكلاسيكي بكلمة المرور.
• الاحتياطي والتحول التلقائي: إذا كانت الطريقة الافتراضية المحددة غير متاحة بسبب عدم تكوين البوابات أو فصلها (على سبيل المثال، تم تحديد تسجيل الهاتف ولكن بوابات واتساب وفايربيس غير متصلة)، يعرض النظام التبويب البديل تلقائياً دون أخطاء.

الأمان والجلسة (Security & Session)

• نوع عمر الجلسة (session_lifetime_type): التحكم في مدة جلسة دخول المستخدم. حدد عمر الجلسة (اتباع إعداد ووردبريس) لتوريث ملفات تعريف الارتباط الافتراضية لووردبريس البالغة 14 يوماً، أو اختر مدة مخصصة بالـ دقائق أو الساعات أو الأيام.
• قيمة عمر الجلسة (session_lifetime_value): حدد العدد الدقيق للوحدات الزمنية المخصصة لانتهاء صلاحية الجلسة. يظهر هذا الحقل ويتاح للتعديل فقط عند ضبط نوع عمر الجلسة على دقائق أو ساعات أو أيام. يؤدي تعيين القيمة على 0 إلى الاعتماد على المدة الافتراضية للووردبريس.

2. إعدادات تسجيل الدخول بالبريد الإلكتروني (الرابط السحري مقابل كلمة المرور الكلاسيكية)

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

طريقة البريد الإلكتروني الأساسية (primary_email_method)

حدد أي التدفقات له الأسبقية عندما يدخل المستخدم عنوان بريده الإلكتروني:

• رابط تسجيل الدخول السحري للبريد (otp): يرسل رابطاً آمناً بنقرة واحدة لتسجيل الدخول مباشرة إلى صندوق الوارد الخاص به.
• كلمة المرور الكلاسيكية (password): التحقق القياسي الكلاسيكي لاسم المستخدم وكلمة المرور.

تمكين البريد وكلمة المرور (enable_email_password)

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

تسجيل الدخول برابط البريد السحري / رمز OTP للبريد (enable_email)

قم بتفعيل هذا المفتاح لتنشيط تسليم الروابط السحرية لتسجيل الدخول بدون كلمة مرور:

• الاعتماد على بوابة SMTP: تتطلب هذه الميزة أن يكون اتصال مرسل البريد (SMTP) مكوناً ونشطاً تحت إعدادات المرسلين (/wp-admin/admin.php?page=wawp-senders#tab-email). إذا كان معطلاً، تظهر شارة تحذير ويتم إلغاء تنشيط المفتاح.
• الموضوع (otp_subject_email): أدخل عنوان موضوع مخصصاً لرسالة البريد الصادرة (مثال: تسجيل الدخول إلى {{shop_name}}). يدعم إدراج وسوم التخصيص المتغيرة مثل:
  • {{magic_link}} — لتوليد رابط تسجيل الدخول الآمن.
  • {{user_name}} — لعرض اسم حساب المستخدم.
  • {{shop_name}} — لعرض اسم متجرك وموقعك.
• قالب نص الرسالة (otp_email_template_id): اختر أحد قوالب بريد HTML الخاصة بك من القائمة المنسدلة. يمكنك إدارة القوالب وتصميمها في صفحة قوالب البريد الإلكتروني. انقر فوق زر إدارة القوالب (أيقونة الترس) بجانب القائمة المنسدلة للذهاب مباشرة إلى صفحة /wp-admin/admin.php?page=wawp&wawp_section=email_templates. العلامات النيابية المتاحة للاستخدام في القالب تشمل:
  • {{magic_link}}
  • {{user_first_last_name}}
  • {{shop_name}}
  • {{site_link}}

3. إعدادات تسجيل الدخول بالهاتف (واتساب مقابل رسائل فايربيس SMS)

قم بتكوين قنوات الهاتف المحمول عالية الموثوقية لتوجيه رموز التحقق أو الموافقات التفاعلية بنقرة واحدة.

طريقة الهاتف الأساسية (primary_phone_method)

حدد بوابة تسليم الرسائل الافتراضية لأرقام الهواتف:

• مصادقة واتساب ويب (whatsapp): استخدم جلسات أرقام واتساب المتصلة لإرسال نصوص رموز OTP القياسية أو رسائل القوائم التفاعلية للموافقة بنقرة واحدة.
• مصادقة رسائل فايربيس SMS (firebase): استخدم واجهة برمجة تطبيقات Google Firebase لإرسال رموز SMS لجميع دول العالم.

أ. مصادقة واتساب ويب (enable_whatsapp)

قم بتفعيل هذه البوابة لتوجيه عمليات تسجيل الدخول عبر اتصالات واتساب الخاصة بك. يتطلب هذا وجود رقم واتساب متصل واحد على الأقل وبحالة نشط في إعدادات المرسلين (/wp-admin/admin.php?page=wawp-senders). إذا لم تكن هناك أي جلسات متصلة، سيتم إلغاء تنشيط المفتاح وعرض تحذير.

قناة التحقق المفضلة (whatsapp_auth_type)

اختر تدفق وسيناريو التحقق:

1. رمز OTP القياسي (otp): يرسل رمز مرور نصياً مكوناً من 6 أرقام يقوم المستخدم بإدخاله يدوياً في موقعك.
   • فرض اللغة (whatsapp_otp_lang_type):
     • تلقائي (لغة الموقع) (site): يرث لغة موقع ووردبريس النشطة حالياً.
     • سياق المستخدم (ديناميكي) (user): يرث لغة تصفح الزائر الفردي وجهازه.
     • مفروضة (تحديد يدوي) (custom): يثبت لغة قالب الرسالة على لغة محددة ثابتة.
   • تحديد اللغة (whatsapp_otp_custom_lang): يظهر فقط عند ضبط فرض اللغة على خيار "مفروضة". اختر من بين اللغات المتاحة: العربية، الإنجليزية، الإسبانية، الفرنسية، البرتغالية، الإندونيسية، الروسية، التركية، أو الألمانية.
   • تمكين التذييل المخصص (whatsapp_otp_footer_enabled): قم بتفعيله لإضافة نص تذييل مخصص في أسفل رسالة الـ OTP.
   • محتوى التذييل (whatsapp_otp_footer): أدخل النص المخصص مع دعم الرموز التعبيرية والإيموجي (مثل: دعم محرك Wawp).
   • قالب رسالة الـ OTP (otp_message_whatsapp): تعديل النص الخام للرسالة الموجهة. تأكد من الاحتفاظ بـ العلامة النيابية {{otp}} لعرض الرمز. مثال: "رمز التحقق الخاص بك هو {{otp}}".

2. القائمة التفاعلية (التحقق بنقرة واحدة) (list): يرسل بطاقة رسالة تفاعلية مباشرة إلى حساب واتساب للعميل. ينقر المستخدم ببساطة على زر تأكيد تسجيل الدخول (Approve Login) أو زر رفض وإلغاء (Reject & Report) دون الحاجة لكتابة أو نسخ أي أكواد.
   • عنوان القائمة (whatsapp_list_title): تعيين عنوان بارز لبطاقة رسالة واتساب (الافتراضي: تحقق أمني آمن).
   • الوصف الرئيسي (whatsapp_list_desc): تعيين العنوان الفرعي للبطاقة (الافتراضي: يرجى التحقق من هويتك للمتابعة).
   • العنصر 1 (إجراء الموافقة والنجاح): تخصيص تفاصيل زر الموافقة والتأكيد.
     • عنوان الإجراء (whatsapp_list_item1): مثال: موافقة وتأكيد الدخول.
     • وصف الإجراء (whatsapp_list_item1_desc): مثال: هذه محاولة تسجيل الدخول الخاصة بي.
   • العنصر 2 (إجراء الرفض والإلغاء): تخصيص تفاصيل زر الرفض والتقرير.
     • عنوان الإجراء (whatsapp_list_item2): مثال: رفض وإلغاء المحاولة.
     • وصف الإجراء (whatsapp_list_item2_desc): مثال: أنا لا أعرف هذا الطلب.
   • زر التحديد الاختياري (whatsapp_list_button): تسمية قائمة خيارات المنسدلة للرسالة (الافتراضي: اختر إجراءً).
   • التذييل السفلي للبطاقة (whatsapp_list_footer): النص السفلي للرسالة التفاعلية (الافتراضي: مصادقة آمنة عبر Wawp).

ب. مصادقة رسائل فايربيس SMS (enable_firebase_sms)

قم بتفعيل هذه البوابة لتوجيه رموز التحقق كرسائل SMS للهواتف.

• متطلبات تكوين فايربيس: يتطلب هذا التفعيل أن يكون مفتاح واجهة برمجة التطبيقات لفايربيس (Firebase API Key) وإعدادات التكوين نشطة تحت إعدادات المرسلين -> فايربيس (/wp-admin/admin.php?page=wawp-senders#tab-firebase). في حال غيابها، تظهر شارة تحذير بالخطأ.
• الإدارة الخارجية لرسائل الـ SMS: تتم معالجة وإدارة قوالب رسائل فايربيس خارجياً. لتعديل قوالب الرسائل أو مراقبة التكاليف، قم بزيارة لوحة تحكم غوغل فايربيس (Google Firebase Console). لتكوين بيانات اعتماد فايربيس لأول مرة، اتبع دليل تكوين رسائل فايربيس SMS.

4. قواعد إعادة التوجيه بعد تسجيل الدخول (Post-Login Redirection Rules)

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

انقر فوق إضافة قاعدة جديدة (Add New Rule) لإنشاء توجيه يعتمد على رتبة المستخدم:

• رتبة المستخدم المستهدفة (role): حدد جميع الأدوار (all) أو اختر رتبة ودوراً معيناً (مثل: مدير الموقع Administrator، أو عميل ووكومرس Customer، أو مشترك Subscriber، أو كاتب Editor، أو مدير المتجر Shop Manager).
• رابط الصفحة لتوجه إليها (redirect_url): أدخل رابط الوجهة المحددة أو المسار المحلي (على سبيل المثال، كتابة /wp-admin لمدراء الموقع، أو كتابة /my-account لعملاء المتجر).
• الحالة الفارغة: في حال لم يتم تحديد أي قواعد مخصصة لإعادة التوجيه، سيتم توجيه المستخدمين تلقائياً إلى صفحة الووردبريس الافتراضية القياسية.

5. إعدادات المظهر والجماليات (السمات، الهوية التجارية، وأكواد CSS المخصصة)

قم بتخصيص واجهة نموذج تسجيل الدخول ليتوافق تماماً وبدقة مع نظام التصميم البصري لموقع الويب الخاص بك.

تمكين التصميم الاحترافي والجميل (enable_premium_design)

قم بتشغيل هذا المفتاح لإلغاء التنسيق البصري الافتراضي وتطبيق خيارات هويتك التجارية المخصصة.

شعار وعناوين النموذج

• شعار النموذج (logo): قم برفع صورة شعار أفقية بصيغة PNG/SVG بخلفية شفافة لتظهر في أعلى النموذج بدلاً من الاسم النصي الافتراضي للموقع.
• عنوان النموذج الرئيسي (title): إضافة نص العنوان الترحيبي للنموذج (الافتراضي: مرحباً بك مجدداً).
• وصف النموذج (description): إضافة النص التوضيحي للنموذج باستخدام محرر نصوص منسق يدعم التنسيقات المتقدمة، وإدراج القوائم، والرموز التعبيرية (الافتراضي: اختر طريقة لتسجيل الدخول للمتابعة).

قوالب السمات الجاهزة للألوان (color_theme)

اختر من بين ست لوحات ألوان مصممة مسبقاً:

1. الافتراضي (أخضر واتساب): المظهر الكلاسيكي الجميل لواتساب (#22c55e).
2. شعار Wawp الرسمي (التركواز): ألوان تركوازية نظيفة (#004444) مع اللون الكحلي الداكن (#141b38).
3. المحيط العصري (أزرق/تركواز): تباين عالٍ بين الأزرق (#2563eb) والسماوي (#0891b2).
4. الليلي والداكن (بنفسجي/داكن): درجات البنفسجي العصري (#7c3aed) والنيلي الجذاب (#4f46e5).
5. الغروب الدافئ (برتقالي/أحمر): طاقة برتقالية نابضة (#ea580c) مع درجات الأحمر المشرق (#dc2626).
6. البسيط والأنيق (أسود/رمادي): مونوكروم هادئ ونظيف يجمع الأسود (#171717) بالرمادي الفاتح (#d4d4d4).

مخصص الألوان التفصيلي

قم بتعديل وتجاوز ألوان الخلفيات وألوان النصوص الفردية لكل من:

• زر واتساب: whatsapp_button_color / whatsapp_button_text_color
• زر فايربيس: firebase_button_color / firebase_button_text_color
• زر البريد الإلكتروني: email_otp_button_color / email_otp_button_text_color
• زر الدخول بكلمة المرور: password_login_button_color / password_login_button_text_color
• زر إجراء التحقق وتأكيد الرمز: verify_button_color / verify_button_text_color
• زر إعادة إرسال الرمز: resend_button_color / resend_button_text_color
• زر عرض كلمة المرور: show_password_button_color / show_password_button_text_color
• رابط الرجوع للخلف: back_button_color / back_button_text_color

التصميم المخصص بالـ CSS (custom_css)

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

6. الأكواد المختصرة وعمليات الدمج (Shortcodes & Integrations)

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

• المحتوى الملحق بالنموذج (custom_shortcode): الصق أي أكواد مختصرة خارجية تريد إدراجها (مثل أداة Google reCAPTCHA للتحقق من البشر أو شارات تسجيل الدخول الاجتماعي) لتظهر وتعرض مباشرة أسفل نموذج تسجيل الدخول.

• الكود المختصر الرئيسي لتسجيل الدخول: انسخ والصق الكود المختصر القياسي التالي في أي صفحة أو مقال تريده: [wawp_otp_login]
• كود دمج المطورين بـ PHP:

حدود الإرسال والأمن وحماية الخادم (Rate Limiting & Security)

تتضمن إضافة Wawp حمايات برمجية مدمجة في الخلفية لتأمين نقاط الاتصال ونماذج تسجيل الدخول الخاصة بك ضد السبام والهجمات المؤتمتة للبوتات:

• حدود معدل الإرسال المستندة إلى الـ IP: يفرض خادم Wawp الخلفي في ملف class-wawp-otp-login.php حداً أقصى للاستدعاء يبلغ 3 طلبات رموز OTP كحد أقصى لكل 60 ثانية لكل عنوان IP فردي للزائر. ستتلقى أي طلبات تتجاوز هذا الحد رسالة خطأ صريحة توضح حدوث استدعاءات متكررة Too many requests.
• أداة Google reCAPTCHA: إذا تم تمكين حماية Google reCAPTCHA للتحقق أمنياً على مستوى الموقع العام، يقوم نموذج تسجيل الدخول بالواجهة الأمامية بالتحقق من صحة رمز المستخدم عبر واجهة reCAPTCHA أولاً قبل الموافقة وتفويض إرسال أي رسالة رمز تحقق OTP لهاتفه.
• فحص وجود حساب مستخدم: إذا قام الزائر بكتابة رقم هاتف أو حساب واتساب لا يتطابق ولا يرتبط بأي مستخدم مسجل فعلياً في قاعدة بيانات ووردبريس، يقوم النظام بصد ومنع إرسال رمز الـ OTP ويوجهه تلقائياً لصفحة التسجيل وإنشاء حساب (في حال تم تكوينها) مع تمرير وإدراج رقم هاتفه مكتوباً تلقائياً في معلمات رابط التوجيه (?pre_phone=...).