شرح إضافة Checkout Location والتحكم في الدول والمدن أثناء إتمام الطلب

سنتعرّف في هذه المقالة على إضافة  Checkout Location لإدارة حقول الموقع في صفحة إتمام الطلب

القسم الأول: تفعيل الاضافة

القسم الثانيCheckout Location Settings :

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

 

أولًاGeneral Settings:

Default Country
تحديد الدولة الافتراضية التي سيتم اختيارها تلقائيًا عند دخول العميل إلى صفحة إتمام الطلب.
في حالة اختيار No default، يُطلب من العميل تحديد الدولة يدويًا.

 

ثانيًاField Configuration:

تُستخدم هذه الإعدادات لتحديد الحقول التي ستظهر في صفحة الـ :Checkout

• Enable State/Province selection
  تفعيل اختيار المحافظة / الولاية.
• Enable City selection
  تفعيل اختيار المدينة.

Required Fields

تحديد الحقول الإلزامية التي يجب على العميل ملؤها قبل إتمام الطلب:

• )Country إلزامي دائمًا(
• State/Province
• City

 

ثالثًاPerformance Settings:

Cache Duration
تحديد مدة تخزين بيانات المواقع مؤقتًا (الكاش) لتحسين الأداء، والقيمة الافتراضية هي 1 ساعة.

Clear Cache Now
مسح جميع بيانات الكاش لإجبار النظام على تحميل بيانات جديدة.

 

رابعًاDisplay Settings:

Field Labels
تخصيص أسماء الحقول الظاهرة للعميل:

• State/Province Label
• City Label

Progress Indicator
إظهار مؤشر مرئي يوضّح خطوات اختيار الموقع أثناء عملية الـ Checkout.

Location Summary
عرض ملخص بالموقع الذي قام العميل باختياره للتأكيد قبل إتمام الطلب.

 

خامسًاAdvanced Settings:

Debug Mode
تفعيل تسجيل الأخطاء والعمليات الخاصة بالإضافة لأغراض الفحص الفني (يُستخدم عند الحاجة فقط).

Test Database Connection
فحص اتصال الإضافة بقاعدة البيانات والتأكد من أن الجداول تعمل بشكل سليم.

Reset All Data
إعادة تعيين الإضافة بالكامل.
⚠️ تحذير: هذا الخيار يحذف جميع الدول، المحافظات، المدن، وجميع إعدادات الإضافة ولا يمكن التراجع عنه.

القسم الثالث (Countries) : الدول

من هذا القسم يتم إدارة الدول المتاحة في صفحة إتمام الطلب.

عند الدخول إلى الصفحة، في حال عدم وجود دول مضافة، تظهر رسالة تطلب البدء بإضافة أول دولة.

Add New Country

يتم الضغط على Add Your First Country لإضافة دولة جديدة.

 

القسم الرابعAdd New Country:

يُستخدم هذا القسم لإضافة دولة جديدة لقاعدة بيانات المواقع.

Basic Information

• Country Name
  اسم الدولة كما سيظهر للعملاء.
• Country Code
  كود الدولة (يُفضّل استخدام ISO 3166-1).

Display Settings

• Availability
  تحديد ما إذا كانت الدولة نشطة ومتاحة للاختيار.
• Display Order
  ترتيب ظهور الدولة (الأرقام الأقل تظهر أولًا، و0 تعني ترتيب أبجدي).
• Default Country
  تعيين الدولة كدولة افتراضية في صفحة الـ .Checkout

يتم الضغط علي  Add Country ثم Save Country للحفظ .

القسم الخامسStates & Provinces:

من هذا القسم يتم إدارة المحافظات أو الولايات لكل دولة.

1. اختيار الدولة من القائمة العلوية.

القسم السادسAdd New State:

يُستخدم لإضافة محافظة أو ولاية جديدة داخل دولة محددة.

يتضمن:

• اسم المحافظة
• الكود
• حالة التفعيل
• ترتيب الظهور

بعد الإضافة، يمكن ربط المدن بهذه المحافظة.

 

 

القسم السابع:  المدن(Cities)

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

يتم:

1. اختيار الدولة
2. اختيار المحافظة
3. عرض المدن المرتبطة بها

 

القسم الثامنAdd New City:

يُستخدم لإضافة مدينة جديدة لتظهر ضمن خيارات صفحة إتمام الطلب.

City Information

• City Name
  الاسم الكامل للمدينة.
• City Code (Optional)
  كود اختياري للمدينة.

Display Settings

• Availability
  تفعيل أو تعطيل المدينة.
• Display Order
  ترتيب الظهور (المدن الرئيسية يُفضّل أن تكون بأرقام أقل).

يتم الضغط علي  Add City ثم Save City للحفظ .

 

 

 

القسم التاسعImport / Export Location Data:

يُستخدم هذا القسم لاستيراد أو تصدير بيانات المواقع.

Import Location Data

يمكن استيراد البيانات بصيغ:

• CSV
• Excel (.xlsx)
• JSON

مع خيارات:

• إضافة بيانات جديدة فقط
• تحديث البيانات الحالية
• استبدال جميع البيانات (⚠️ يحذف البيانات القديمة)

 

 

كما يمكن:

• التحقق من صحة البيانات قبل الاستيراد
• تجاهل التكرار
• إنشاء نسخة احتياطية

 

Export Location Data

تصدير:

• الدول
• المحافظات
• المدن

بصيغة CSV، مع خيارات تخصيص اسم الملف ومحتوى البيانات.

 

المظهر النهائي للاضافة: