كيفية إعداد كود الدولة المتقدم (Advanced Country Code)

يعمل محرك كود الدولة المتقدم (Advanced Country Code) تلقائياً على إعادة تنسيق وتطبيع أرقام الهواتف التي يدخلها المستخدمون أثناء التسجيل وإتمام الطلب (Checkout). ويضمن توحيد أرقام الهواتف وتنسيقها بالشكل الدولي الصحيح E.164 المطلوب بواسطة واجهة برمجيات ميتا واتساب (Meta WhatsApp API) وبوابات رسائل SMS الخارجية، مما يقضي على فشل تسليم الرسائل الناتج عن البادئات السيئة، أو الأصفار الزائدة، أو رموز الاتصال الفارغة.

الخلفية التقنية: لماذا يهم تنسيق الهاتف؟

تتطلب معظم شبكات البنية التحتية للمراسلة العالمية، بما في ذلك واجهة برمجيات واتساب الرسمية من ميتا (Meta WhatsApp API), إرسال أرقام الهواتف بالتنسيق الدولي الكامل والمطلق (على سبيل المثال، 201111111111 لمصر، و 966500000000 للمملكة العربية السعودية).

تؤدي مدخلات المستخدمين الخام غالباً إلى حدوث اختلافات وتناقضات في التنسيق المحلي:

• البادئات المحلية الديناميكية (مثل إضافة 0 قبل أرقام الهواتف المحمولة في الشرق الأوسط وأوروبا).
• رموز الفصل غير القياسية مثل المسافات أو الشرطات أو الأقواس.
• إغفال رموز الاتصال الدولية تماماً عندما يملأ العملاء المحليون النماذج.

تلتقط إضافة كود الدولة المتقدم (Advanced Country Code) هذه المدخلات، وتطابقها مع قاعدة بيانات الدول النشطة لديك، وتقوم بتنظيف تناقضات التنسيق، وربط بيانات الهاتف القياسية بالحقول المناسبة.

1. تبويب الإعدادات العامة (General Settings)

يدير هذا التبويب سلوكيات النظام الأساسية، والخيارات الاحتياطية الجغرافية، واتجاهات تخطيط الواجهة.

كود الدولة الافتراضي (Default Country Code)

يحدد this الإعداد الدولة الاحتياطية الأساسية التي تظهر في القائمة المنسدلة عندما لا يمكن تحديد موقع الزائر جغرافياً.

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

محاذاة كود الدولة (Country Code Alignment)

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

• auto (اكتشاف تلقائي للنظام): يتكيف اتجاه المحاذاة تلقائياً ليتوافق مع اتجاه لغة موقعك الحالية (من اليسار لليمين LTR للغة الإنجليزية، ومن اليمين لليسار RTL للغة العربية).
• left (فرض اتجاه اليسار LTR): يفرض اتجاه المحاذاة من اليسار إلى اليمين. نوصي بهذا بشدة لحقول الهواتف الرقمية للحفاظ على اتساق محاذاة الأكواد والأرقام الدولية بشكل مستمر.
• right (فرض اتجاه اليمين RTL): يفرض اتجاه المحاذاة من اليمين إلى اليسار.

اكتشاف الموقع الجغرافي عبر عنوان الـ IP

• تحديد الموقع عبر Geo-IP: عند التفعيل، تكتشف الإضافة دولة الزائر من خلال البحث عن عنوان الـ IP الخاص بشبكته.
• تخطي المنطقة الزمنية والجغرافية: إذا فشل البحث عن بعد أو قيد المستخدم صلاحيات البحث، تستخدم الإضافة البيانات الوصفية للمنطقة الزمنية (Intl.DateTimeFormat().resolvedOptions().timeZone) كبديل محلي لتحديد الدولة الصحيحة.
• تحسين تجربة المستخدم (UX): تحديد كود دولة العميل تلقائياً وبشكل فوري عند تحميل الصفحة، مما يلغي الحاجة لاختيار العلم يدوياً أثناء الشراء.

البحث عن مشغل الخدمة (Carrier Lookup)

• التعرف في الوقت الفعلي: يحدد شبكة اتصالات الهاتف المحمول النشطة للعميل (مثل Vodafone أو Orange أو STC أو Zain) أثناء تنسيق المدخلات.
• مؤشرات الحالة: يوفر حلقات تحقق من صحة البحث عن الشبكة، مما يمنح المستخدمين تأكيداً مرئياً ويحسن جودة البيانات المدخلة.

2. تبويب عمليات الدمج والتكامل (Integrations)

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

الموجهات الأساسية المهيأة مسبقاً

تقوم الإضافة بقفل المحددات الأربعة التالية لضمان عمل النظام بشكل صحيح دون أخطاء:

مطابقة المحددات المخصصة (Custom Selector Mappings)

يمكنك ربط ومطابقة أي حقول نماذج مخصصة (مثل نماذج Elementor Forms، أو Gravity Forms، أو Contact Form 7) بمحرك التنسيق والتطبيع:

1. انقر على زر إضافة حقل جديد (Add New Field).
2. أدخل معرف محدد CSS (CSS Selector ID) فريداً (باستخدام بادئة الهاش القياسية #).
3. أدخل اسماً داخلياً لسهولة التعرف عليه داخل لوحة التحكم الخاصة بك.
4. قم بتبديل حالة الحقل بين نشط (Active) و غير نشط (Inactive) حسب الحاجة.

كيفية جلب معرف حقل الإدخال المستهدف (Input ID)

اتبع هذه الخطوات للعثور على محدد CSS الصحيح لأي حقل مخصص على موقع الويب الخاص بك:

3. تبويب الدول المسموح بها (Allowed Countries)

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

شارات العدادات (Badge Counters)

توفر الترويسة عدادات في الوقت الفعلي لتتبع تكويناتك:

• عداد النشط: شارة خضراء توضح إجمالي عدد البلدان الممكنة والنشطة.
• عداد غير النشط: شارة حمراء توضح إجمالي عدد البلدان المعطلة.

أدوات البحث والاختيار

• حقل البحث المباشر: يقوم بتصفية وتصفح البلدان بسرعة في الوقت الفعلي حسب اسم الدولة، أو رمز ISO2، أو رمز الاتصال الدولي.
• خيارات الإجراءات الجماعية:
  • تحديد الكل: تمكين وتنشيط جميع دول العالم على الفور وبنقرة واحدة.
  • إلغاء تحديد الكل: تعطيل جميع الدول على الفور، مما يتيح لك بناء وتخصيص قائمتك الخاصة من الصفر.

القوائم المطوية المصنفة حسب الأقاليم (Accordions)

يتم تنظيم البلدان في مجلدات إقليمية قابلة للطي (مثل أفريقيا، الأمريكتين، آسيا، أوروبا، أوقيانوسيا) للحفاظ على ترتيب القائمة وسهولة الوصول.

• إحصائيات إقليمية: تعرض كل قائمة مطوية عدد الدول النشطة مقارنة بإجمالي الدول المتاحة في القارة (مثل 12/56).
• تحديد إقليمي جماعي: انقر على مفتاح الاختيار الجماعي للإقليم لتمكين أو تعطيل جميع دول تلك القارة المحددة على الفور.

بطاقات الدول التفاعلية

تحتوي كل بطاقة دولة على التفاصيل التالية:

• أعلام اليونيكود (Unicode Flags): أعلام بصرية تفاعلية لتحديد الدولة بشكل سريع.
• رموز الاتصال: بادئة كود الدولة القياسية (مثل +966).
• مربع الاختيار: مربع تفاعلي يحتوي على أيقونة درع أمان توضح الحالة النشطة.
• اسم الدولة: التسمية الجغرافية القياسية للدولة.

4. تجربة العميل المباشرة في الوقت الفعلي

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

1. رقم واتساب صالح ونشط بالكامل

2. رقم هاتف صالح ولكنه غير مسجل في واتساب

3. بنية وتنسيق غير صالحين إطلاقاً

5. الآليات البرمجية والتقنية (خلف الكواليس)

بالنسبة للمطورين والمدراء المتقدمين، يستخدم محرك كود الدولة لـ Wawp العديد من معالجات نصوص الواجهة الأمامية وخطافات PHP الخلفية لضمان أقصى قدر من الأداء، وتوافق التخطيط، وخيارات التعريب:

أ. مراقبات الـ DOM للواجهة الأمامية وعمليات التنظيف المتكررة

• مراقب التحول الديناميكي (Mutation Observer): تدرج الإضافة كائن MutationObserver على سياق document.body. يضمن ذلك أنه عند تحميل أو تحديث نماذج الشراء أو التسجيل ديناميكياً (مثل معالجة React أو استدعاءات أجاكس في ووكومرس)، يتم تطبيق ارتباطات حقول كود الدولة فوراً دون الحاجة لتحديث الصفحة يدوياً.
• تكامل WooCommerce Gutenberg Blocks: تدرج الواجهة الأمامية محرك تنظيف مكثف يعمل بفاصل زمني متكرر يبلغ 1000 مللي ثانية. يقوم المحرك بإزالة تسميات حقول Gutenberg الأصلية التي تتدخل وتتداخل مع القائمة المنسدلة لـ intl-tel-input ويعيد تعيين النصوص التوضيحية الافتراضية، مع تعطيل خيارات الإكمال التلقائي المتضاربة للمتصفحات.
• دروع منع تجاوز القوالب: يعترض محرك التنسيق تلقائياً إعدادات أزرار القوالب داخل فئات .iti button، معطلاً الحدود الخارجية، والتعبئة الخلفية، والظلال للحفاظ على الاتساق البصري عبر كافة قوالب ووردبريس.

ب. تحديد الموقع الجغرافي ومطابقة المناطق الزمنية

• سلسلة دقة تحديد الموقع متعددة المستويات: عند تنشيط تحديد الموقع الجغرافي، تقوم الدالة الخلفية get_client_country_by_ip() بتحديد مواقع الـ IP للزوار باستخدام ترتيب أولويات محدد:
  1. ترويسة تحديد دولة الـ IP من كلودفلير (HTTP_CF_IPCOUNTRY).
  2. ترويسات الوكيل وموازنة الأحمال (HTTP_X_COUNTRY_CODE و HTTP_X_REAL_IP_COUNTRY و HTTP_GEOIP_COUNTRY_CODE و HTTP_GEOIP_COUNTRY و HTTP_X_GEOIP_COUNTRY).
  3. وظيفة تحديد موقع الـ IP المدمجة في ووكومرس (WC_Geolocate::geolocate_ip()).
  4. استعلام سريع من واجهة برمجة تطبيقات خارجية (https://ipapi.co/{ip}/country/) مع آلية تخزين مؤقت (transient caching) مدتها 24 ساعة لمنع بطء تحميل الصفحات في الزيارات المتكررة.
• تخطي المنطقة الزمنية المحلية: في حال فشل تحديد موقع الـ IP أو حظره، يقوم نص الواجهة الأمامية البرمجي بالاعتماد على مطابقة معلمات المنطقة الزمنية المحلية للزائر (على سبيل المثال، مطابقة Africa/Cairo لـ eg ومطابقة Asia/Riyadh لـ sa ومطابقة Asia/Dubai لـ ae) لتحديد العلم الصحيح مسبقاً، مع إعداد ملف تعريف ارتباط (cookie) آمن لـ wawp_user_country يستمر لمدة 24 ساعة.