WCPOS Polylang
يضيف دعم Polylang إلى WCPOS بحيث لا تعرض نقطة البيع سوى منتجات لغة واحدة — بدون ترجمات مكرّرة في البحث عن المنتجات أو شبكة الكتالوج أو سير عمل أمين الصندوق. يمكن لمتاجر WCPOS Pro تثبيت لغة لكل متجر؛ أما التثبيتات المجانية فتعود إلى اللغة الافتراضية في Polylang.
ما الذي يفعله
- يُصفّي استعلامات REST للمنتجات والتنويعات في WCPOS حسب اللغة.
- يعترض مسارات المزامنة السريعة في WCPOS (طلبات
posts_per_page=-1+fieldsالخفيفة التي تستخدمها نقطة البيع لتحديث فهرسها المحلي) بحيث لا تصل النسخ المترجمة المكرّرة إلى العميل. - في التثبيتات المجانية، يُطبّق اللغة الافتراضية لـ Polylang.
- في تثبيتات Pro، يمكن لكل متجر اختيار لغته الخاصة من قسم اللغة الجديد في محرر المتجر.
- يحترم إعداد رؤية المنتج لنقطة البيع فقط في WCPOS عند بناء حمولة المزامنة السريعة.
يتوقّف التكامل بشكل سلس عندما لا يكون Polylang مفعّلًا — يمكن تثبيت الإضافة قبل تفعيل Polylang دون حدوث أخطاء.
التثبيت
تثبيت Polylang
قم بتثبيت Polylang (أو Polylang Pro) وتهيئة لغات موقعك بالطريقة المعتادة. تأكد من تعيين لغة واحدة على الأقل كلغة افتراضية.
تثبيت WCPOS Polylang
قم بالتثبيت من دليل إضافات WCPOS في WP Admin > نقطة البيع > الإعدادات > الإضافات، أو قم بتنزيل أحدث إصدار من صفحة الإصدارات على GitHub ورفعه عبر إضافات > إضافة جديد > رفع إضافة.
(Pro) تعيين لغة لكل متجر
إذا كنت تدير متاجر متعددة على WCPOS Pro، انتقل إلى نقطة البيع > المتاجر، وقم بتحرير متجر، واختر لغته من قسم اللغة في الشريط الجانبي. اتركه على الافتراضي لاستخدام اللغة الافتراضية في Polylang.
لغة لكل متجر (Pro)
في WCPOS Pro، تضيف الإضافة قسم اللغة إلى الشريط الجانبي لمحرر المتجر. يمكن تثبيت كل متجر على رمز لغة Polylang واحد — يتم تصفية المنتجات المقدمة لذلك المتجر لتلك اللغة فقط. المتاجر التي تُترك على الافتراضي تستخدم اللغة الافتراضية في Polylang.
يتم حفظ قيمة لغة المتجر في بيانات المتجر الوصفية باسم _wcpos_polylang_language وتُعرض عبر واجهة REST API للمتاجر في WCPOS Pro (/wcpos/v1/stores)، بحيث تنتقل عبر نقطة البيع كأي إعداد متجر آخر.
ملاحظات التوافق
- المنتجات المخصصة لنقطة البيع فقط: عند تفعيل وضع نقطة البيع فقط في إعدادات WCPOS، يتم استبعاد معرّفات المنتجات المخصصة للمتجر الإلكتروني فقط من حمولة المزامنة السريعة حتى لا تظهر في نقطة البيع.
- التثبيت المجاني: لا توجد واجهة لتغيير اللغة لكل متجر — يستخدم الملحق اللغة الافتراضية في Polylang. إذا كنت بحاجة إلى تحديد لغة لكل متجر، قم بالترقية إلى WCPOS Pro.
- الملحق غير متاح: إذا تم تعطيل Polylang، فلن يقوم الملحق بأي إجراء. لن يُصدر أخطاء أو يُعيق عمل نقطة البيع.
خطافات المطوّرين
للاستخدام المتقدم، يوفّر الملحق بعض المرشّحات (filters):
| المرشّح | الغرض |
|---|---|
wcpos_polylang_resolved_language | تجاوز اللغة المستخدمة لطلب معيّن. يستقبل رمز اللغة المُحدَّد وكائن WP_REST_Request. |
wcpos_polylang_default_language | تجاوز اللغة الاحتياطية عند عدم تعيين قيمة لكل متجر. |
wcpos_polylang_is_supported | فرض تفعيل أو تعطيل الملحق بغض النظر عن اكتشاف Polylang. |
wcpos_polylang_minimum_version | اشتراط حد أدنى لإصدار Polylang (الافتراضي: بدون قيد على الإصدار). |