تكامل تحديد الموقع الجغرافي من ماكسمايند

تتيح إضافة وووكامرس الأساسية والمجانية لأصحاب المتاجر تحديد الموقع الجغرافي للعملاء تلقائياً لعرض معدلات الضرائب وطرق الشحن الخاصة بموقعهم. لتحديد ذلك، يتكامل وووكامرس مع بيانات MaxMind GeoLite2 الجغرافية.

تغطي هذه الوثيقة:

• تفعيل تحديد الموقع الجغرافي.
• إنشاء حساب على ماكسمايند (MaxMind).
• توليد مفتاح ترخيص ماكسمايند.
• إضافة مفتاح ترخيص ماكسمايند إلى موقعك.
• كيف يقوم موقع وووكامرس بتحديث قاعدة بيانات تحديد الموقع الجغرافي من ماكسمايند.

تفعيل تحديد الموقع الجغرافي (Enabling geolocation)

لتفعيل تكامل تحديد الموقع الجغرافي من ماكسمايند:

1. في لوحة تحكم WP Admin الخاصة بموقعك، انتقل إلى مسار WooCommerce > Settings > General.
2. قم بالتمرير للأسفل إلى قسم الخيارات العامة (General options).
3. من القائمة المنسدلة موقع العميل الافتراضي (Default customer location)، اختر تحديد الموقع الجغرافي (Geolocate) أو تحديد الموقع الجغرافي مع دعم التخزين المؤقت للصفحات (Geolocate (with page caching support)).

بمجرد تفعيل تحديد الموقع الجغرافي، ستحتاج إلى إنشاء حساب على ماكسمايند وتكوين إعدادات ماكسمايند عبر تبويب التكامل (Integration) في مسار WooCommerce > Settings.

إذا اخترت خيار تحديد الموقع الجغرافي مع دعم التخزين المؤقت للصفحات (Geolocate (with page caching support))، سترى سلاسل استعلامات ?v=$hash مضافة إلى عناوين URLs الخاصة بموقعك. على سبيل المثال، قد يبدو رابطك هكذا: https://woocommerce.com/?v=bc74b2d76824

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

إذا كنت ترغب في منع إضافة سلاسل الاستعلام هذه، حدد خيار تحديد الموقع الجغرافي (Geolocate) بدلاً من ذلك.

إنشاء حساب على ماكسمايند (Create a MaxMind account)

1. قم بزيارة صفحة التسجيل في ماكسمايند GeoLite2 sign-up page.
2. أكمل نموذج التسجيل. إذا كنت غير متأكد من الخيار الذي يجب تحديده في حقلي القطاع (Industry) والغرض المقصود (Intended use)، استخدم منصة التجارة الإلكترونية (eCommerce Platform) وتخصيص المحتوى (Content customization) على التوالي.
3. بعد إرسال النموذج بنجاح، ستتلقى بريداً إلكترونياً يحتوي على رابط لتحديد كلمة المرور الخاصة بك. انقر عليه واختر كلمة مرور آمنة.

إنشاء مفتاح ترخيص ماكسمايند (Create a MaxMind license key)

الآن بعد أن أصبح لديك حساب على ماكسمايند، يمكنك إنشاء مفتاح ترخيص.

1. سجل الدخول إلى ماكسمايند وانتقل إلى https://www.maxmind.com/en/account.
2. انقر على تبويب إدارة مفاتيح الترخيص (Manage License Keys) في لوحة تحكم حساب المستخدم الخاص بك.
3. انقر على زر توليد مفتاح ترخيص جديد (Generate new license key).
4. بعد ذلك، املأ النموذج لتوليد مفتاح ترخيص.
5. أضف وصفاً (يمكن أن يكون هذا اسم متجرك).
6. اختر زر تأكيد (Confirm).
7. سيتم عرض مفتاح ترخيص جديد لك. انسخ هذا المفتاح واحفظه في مكان آمن فوراً، حيث لن يتم عرضه إلا مرة واحدة فقط.

إضافة مفتاح ترخيص ماكسمايند إلى وووكامرس (Add MaxMind license key to WooCommerce)

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

1. في لوحة تحكم WP Admin، انتقل إلى مسار WooCommerce > Settings > Integration > MaxMind Geolocation.
2. ألصق مفتاح الترخيص الخاص بك في حقل مفتاح ترخيص ماكسمايند (MaxMind License Key).
3. انقر على زر حفظ التغييرات (Save changes).

متجر وووكامرس الخاص بك جاهز الآن لتحديد الموقع الجغرافي للعملاء باستخدام ماكسمايند.

تحديث قاعدة بيانات ماكسمايند (Updating the MaxMind database)

• يقوم النظام بالتحديث تلقائياً كل 15 يوماً، باستخدام WP-Cron المدمج في ووردبريس لتشغيل خطاف woocommerce_geoip_updater.
• إذا لم تكن ملفات قاعدة بيانات ماكسمايند على خادمك محدثة بشكل صحيح بعد هذا الوقت، يمكنك تثبيت إضافة الطرف الثالث WP Crontrol لاستكشاف أخطاء أحداث الكرون المجدولة في ووردبريس وإصلاحها.
• بمجرد تثبيت هذه الإضافة وتنشيطها، يمكنك الانتقال إلى Tools > Cron Events والتحقق من الوقت المجدولة التالي لهذا الحدث — أو اختيار تشغيله يدويومان (manual).

الأسئلة والدعم (Questions and support)

هل لا تزال لديك أسئلة وتحتاج إلى مساعدة؟

• إذا كنت تتطلع إلى توسيع الوظائف الأساسية المعروضة هنا، فنوصي بمراجعة الإضافات المتاحة في سوق وووكامرس (WooCommerce Marketplace).
• هل تحتاج إلى دعم متقدم مستمر أو تخصيص (customization) مبني لوووكامرس؟ استأجر شريك وكالة وو (Woo Agency Partner).
• هل أنت مطور (developer) تبني تكاملك أو إضافتك الخاصة لوووكامرس؟ تحقق من موارد المطورين (Developer Resources).