VibeFox Mondial Relay for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

WooCommerce: 7.0 أو أحدث، مثبّت ومفعّل. لا تُفعَّل الإضافة بدونه.

PHP: 8.0 أو أحدث.

حساب Mondial Relay: يأتي رمز العلامة التجارية (Enseigne) وPrivate Key مع حساب أعمال لدى Mondial Relay: راجع قسم المحترفين على mondialrelay.fr، أو منطقة العميل «Connect»، أو جهة الاتصال للمبيعات لديك. تحتاج أداة اختيار الخريطة إلى رمز العلامة التجارية فقط. وتحتاج قائمة أقرب النقاط إلى الاثنين. ولأغراض الاختبار، توفّر Mondial Relay رمز العلامة التجارية BDTEST13 مع Private Key بقيمة PrivateK.

مفتاح ترخيص VibeFox: يُشترى من vibefox.net. ويعمل المفتاح الواحد على نطاق واحد فقط.

التثبيت

1. في WordPress، انتقل إلى Plugins > Add New > Upload Plugin، واختر ملف ZIP الخاص بالإضافة، ثم انقر على Install Now. يمكنك أيضًا رفع مجلد vfd_mondialrelay إلى /wp-content/plugins/ عبر FTP.

2. انقر على Activate.

3. افتح الإعدادات: WooCommerce > Settings > Shipping > VibeFox Mondial Relay، أو انقر على Settings أسفل اسم الإضافة في صفحة Plugins.

4. أدخل مفتاح ترخيص VibeFox في كتلة الترخيص أعلى الصفحة، ثم انقر على Activate.

5. أدخل رمز العلامة التجارية (Enseigne)، وأدخل Private Key إذا كنت تستخدم وضع القائمة. املأ Country prices.

6. أضف VibeFox Mondial Relay إلى مناطق الشحن للبلدان التي تشحن إليها، في WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones.

الإعدادات

جميع الإعدادات في صفحة واحدة: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. وتنطبق على جميع مناطق الشحن. وعند إضافة الطريقة إلى منطقة، لا تحتوي نافذة المنطقة إلا على حقل واحد:

Title (zone): اسم هذا الخيار في صفحة الدفع. اتركه فارغًا لاستخدام Name العام.

تُظهر التحذيرات أعلى الصفحة المشكلات التي تُخفي الطريقة: غياب رمز العلامة التجارية، وغياب Private Key في وضع القائمة، وعدم وجود سعر لفرنسا أو بلجيكا أو إسبانيا.

عام

Enable/Disable: يفعّل Mondial Relay أو يعطّله على مستوى المتجر.

Name: اسم طريقة الشحن الذي يراه العملاء في صفحة الدفع. الافتراضي: Mondial Relay Point Relais.

Tax status: Taxable يضيف ضريبة WooCommerce إلى تكلفة الشحن، وNone لا يضيفها.

حساب Mondial Relay

Brand code (Enseigne): إلزامي، حتى 8 أحرف، مثل BDTEST13 للاختبارات. تستخدمه خريطة نقاط الاستلام وWeb Service. بدونه لا يستطيع العملاء اختيار Point Relais، لذلك لا تظهر الطريقة في صفحة الدفع.

Private Key: مطلوب فقط لأداة الاختيار List of nearest points. وعند ضبط رمز العلامة التجارية وPrivate Key، يُختبر الاتصال بخدمة Mondial Relay Web Service في كل مرة تحفظ فيها الإعدادات، وتظهر رسالة تبيّن إن كانا صالحين.

أداة اختيار نقطة الاستلام

Selector: الطريقة التي يختار بها العميل Point Relais.

Mondial Relay map (official widget, brand code only): أداة Mondial Relay Parcel Shop Picker الرسمية، وتُحمَّل من Mondial Relay عندما يفتحها العميل. وهذا هو الخيار الافتراضي.

List of nearest points (Web Service, needs the Private Key): قائمة منسدلة بأقرب النقاط إلى الرمز البريدي للتوصيل، يحمّلها خادمك. وإذا تعذّرت خدمة Web Service، تُعرض الخريطة بدلًا منها.

الأسعار (بعملة متجرك)

Country prices: السعر حسب بلد الوجهة ووزن الطرد. انقر على + Add country لإضافة صف، وعلى علامة الإغلاق لحذف صف. واستخدم صف * Default لجميع البلدان الأخرى. لكل صف عمود Price وأعمدة للوزن: XS حتى 1 كغ، وS من 1 إلى 2 كغ، وM من 2 إلى 3 كغ، وL من 3 إلى 5 كغ، وXL فوق 5 كغ. إذا كان عمود الوزن فارغًا أو يساوي 0، يُستخدم عمود Price. الأرقام العشرية بنقطة أو فاصلة (4.90 أو 4,90). تُحذف الصفوف التي لا تحتوي على أي سعر عند الحفظ، وتُبلَّغ القيم التي ليست أرقامًا وتُترك فارغة.

Fallback cost: يُستخدم للبلدان التي لا يوجد لها صف في الجدول. اتركه فارغًا لإخفاء الطريقة في تلك البلدان.

Calculation type: كيفية احتساب السعر.

Per order (weight of the whole parcel): سعر واحد للسلة، ويُختار عمود الوزن حسب الوزن الإجمالي للسلة. وهذا هو الخيار الافتراضي.

Per item (each item priced by its own weight): يُسعَّر كل عنصر حسب وزنه الخاص ويُضرب في كميته، ثم تُجمع الأسعار.

Free shipping from: المجموع الفرعي للسلة (بعد الخصومات، دون الضريبة) الذي يصبح الشحن عنده مجانيًا. اتركه فارغًا إذا لم يكن هناك شحن مجاني.

التوفر

Min weight (kg): يخفي الطريقة عندما تكون السلة أخف من هذا الوزن. القيمة 0 تعني بلا حد.

Max weight (kg): يخفي الطريقة عندما تكون السلة أثقل من هذا الوزن. تقبل Mondial Relay طرودًا تصل إلى 30 كغ في Points Relais. الافتراضي: 30. القيمة 0 تعني بلا حد.

Minimum subtotal: يعرض الطريقة فقط عندما يبلغ المجموع الفرعي للسلة هذا المبلغ على الأقل. اتركه فارغًا لعرضها دائمًا.

Disabled shipping classes: يخفي الطريقة عندما تحتوي السلة على عناصر من فئات الشحن هذه في WooCommerce.

Ignore shipping zones: يقدّم الطريقة للبلدان المذكورة أدناه، أو لجميع البلدان المدعومة عندما تكون القائمة فارغة، حتى لو لم تكن أي منطقة شحن تشملها.

Countries (ignore zones): بلدان الوجهة لهذا الوضع. لا يُستخدم هذا الحقل إلا عند تفعيل Ignore shipping zones.

متقدم

Debug log: يسجّل حساب الأسعار واستدعاءات Web Service في WooCommerce > Status > Logs (المصدر vfd-mondialrelay). وتُسجَّل الأخطاء دائمًا حتى مع إيقاف هذا الخيار. ولا يُسجَّل أي مفتاح أو بيانات عميل.

Remove data on uninstall: عند التفعيل، يؤدي حذف الإضافة إلى إزالة الإعدادات وطرق المناطق. ولا يحذف إلغاء التفعيل أي شيء أبدًا. وتبقى نقاط الاستلام المحفوظة في الطلبات.

كيف تعمل في صفحة الدفع

تُعرض الطريقة فقط للبلدان التي لديها Points Relais: فرنسا وبلجيكا ولوكسمبورغ وإسبانيا والبرتغال وهولندا. وتُخفى عندما لا يستطيع العميل اختيار نقطة: بدون رمز العلامة التجارية، أو في وضع القائمة بدون Private Key.

عندما يُدخل العميل عنوان التوصيل، يطلب WooCommerce من الإضافة سعر الشحن. تتحقق الإضافة من وزن السلة، والحد الأدنى للمجموع الفرعي، وفئات الشحن المستثناة. ويأتي السعر من صف البلد (أو صف *): عمود الوزن، وإلا فعمود Price. وإن لم يوجد صف، تُستخدم التكلفة الاحتياطية. وإن لم يوجد سعر، تُخفى الطريقة. وإذا بلغ المجموع الفرعي Free shipping from، يصبح السعر 0.

تعمل الطريقة في صفحة الدفع الكلاسيكية وفي كتلتَي Cart وCheckout. وهي متوافقة مع High-Performance Order Storage (HPOS) في WooCommerce.

لا تطلب الإضافة أسعار الشحن الفورية، إذ لا تتوفر لدى Mondial Relay واجهة برمجية عامة لأسعار الشحن. ولا تنشئ شحنات، ولا تطبع ملصقات، ولا تتتبع الطرود. أنشئ الشحنات في مساحة «Connect» الخاصة بك لدى Mondial Relay باستخدام رقم Point Relais الظاهر في الطلب. ولا يُقدَّم التوصيل إلى المنزل (Domicile).

نقاط الاستلام

وضع الخريطة: عندما يختار العميل Mondial Relay، يظهر زر Choose a Point Relais أسفل الطريقة. ويفتح هذا الزر الخريطة الرسمية لـ Mondial Relay لبلد التوصيل والرمز البريدي ووزن الطرد. وبعد أن يختار العميل نقطة، تُعرض باسم Selected: ويتحول الزر إلى Change Point Relais. تُحمَّل أداة الخريطة من widget.mondialrelay.com، ومكتبة الخريطة من unpkg.com، فقط عندما يفتح العميل الخريطة. اذكر ذلك في سياسة الخصوصية لديك.

وضع القائمة: تعرض القائمة المنسدلة - Choose a Point Relais - أقرب 10 نقاط إلى الرمز البريدي للتوصيل، مع المسافة. وتُعرض النقطة المختارة مع ساعات عملها. تُحمَّل القائمة من خادمك، لذلك لا يعمل أي برنامج نصي تابع لطرف ثالث في المتصفح. وتُخزَّن القوائم مؤقتًا لمدة 12 ساعة، والردود الفارغة لمدة ساعة، ويُتذكَّر الطلب الفاشل لمدة 5 دقائق. ومهلة Web Service 10 ثوانٍ. وإذا لم تكن القائمة متاحة، يرى العميل الرسالة "The list of pickup points is not available right now. Please use the map." وتُعرض عليه الخريطة.

النقطة إلزامية. وبدونها يرى العميل Please choose a Mondial Relay pickup point. ولا يُتم الطلب. وتُرفض النقطة الواقعة في بلد غير بلد عنوان التوصيل. وفي وضع القائمة تُتحقَّق النقطة أيضًا من القائمة الخاصة بالعنوان.

يُحفظ رقم Point Relais واسمه وبلده وعنوانه في الطلب. وتظهر في شاشة الطلب أسفل عنوان التوصيل (مع رقم Point Relais)، وفي صفحة الشكر، وفي My account > Orders، وفي رسائل البريد الإلكتروني للطلب (HTML ونص عادي) باسم Mondial Relay pickup point.

مفتاح الترخيص

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. وتوجد كتلة الترخيص أعلى صفحة WooCommerce > Settings > Shipping > VibeFox Mondial Relay. الصق المفتاح في License key وانقر على Activate. تعرض الكتلة الحالة، مثل التاريخ الذي يبقى فيه الترخيص فعالًا ونطاقك. استخدم Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا الموقع. ويفتح الرابط Manage licenses and domains in your account حسابك على vibefox.net.

المفتاح الواحد يعمل على نطاق واحد. ولا تؤدي إزالة المفتاح من موقع إلى تحرير خانة النطاق الخاصة به. حرّرها من حسابك على vibefox.net.

بدون مفتاح فعّال لا تُعرض Mondial Relay للعملاء في صفحة الدفع. ويظل مديرو المتجر المسجّلون يرونها، مع الوسم (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. ويظهر تذكير في صفحة Plugins وفي صفحات WooCommerce. ولا تتأثر الطلبات الحالية.

عندما تنتهي صلاحية الترخيص، تواصل الإضافة العمل، لكن التحديثات والدعم تتطلب التجديد. وتُعاد مراجعة الحالة تلقائيًا في الخلفية.

استكشاف الأخطاء وإصلاحها

لا تظهر Mondial Relay في صفحة الدفع: تحقّق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن الطريقة مضافة إلى منطقة بلد العميل (أو أن Ignore shipping zones مفعّل والبلد مسموح به). راجع التحذيرات أعلى صفحة الإعدادات: تُخفى الطريقة بدون رمز العلامة التجارية، وفي وضع القائمة بدون Private Key، ولبلد بلا سعر، وخارج حدود الوزن والمجموع الفرعي، ولبلدان بلا Points Relais.

فشل اختبار Web Service بعد الحفظ: تعرض الرسالة خطأ Mondial Relay، مثل رمز علامة تجارية أو مفتاح أمان غير صالح. تحقّق من رمز العلامة التجارية وPrivate Key لدى Mondial Relay.

قائمة النقاط فارغة أو غير متاحة: يجب على العميل إدخال الرمز البريدي أولًا. وإذا تعذّرت خدمة Web Service، تُعرض الخريطة بدلًا منها. فعّل Debug log وافتح WooCommerce > Status > Logs، المصدر vfd-mondialrelay، لمعرفة السبب.

لا تُفتح الخريطة: تُحمَّل الخريطة من widget.mondialrelay.com وunpkg.com. تحقّق من أن أداة حظر الخصوصية أو البرامج النصية لا تحجبهما. ويمكن للمطوّرين تغيير عناوين البرامج النصية باستخدام المرشِّحات vfd_mrel_widget_script_url وvfd_mrel_leaflet_script_url وvfd_mrel_leaflet_style_url. ويمكن تغيير قائمة البلدان المدعومة بالمرشِّح vfd_mrel_supported_countries.

تُظهر كتلة الترخيص خطأ: اتبع الرسالة في الكتلة. فمثلًا، إذا كان المفتاح مستخدمًا بالفعل على نطاق آخر، فحرّر خانة في حسابك على vibefox.net ثم انقر على Check now. وإذا تغيّر عنوان الموقع، فانقر على Check now لتفعيل المفتاح للنطاق الجديد. وإذا تعذّر الوصول إلى خادم التراخيص، تواصل الإضافة العمل بآخر حالة معروفة.

إلغاء التثبيت

يُبقي إلغاء تفعيل الإضافة على جميع الإعدادات. ولا يُمسح إلا قوائم نقاط الاستلام المخزّنة مؤقتًا. ولحذفها، ألغِ تفعيلها ثم احذفها من صفحة Plugins. ويُحذف دائمًا مفتاح الترخيص وحالة الترخيص لهذه الإضافة والذاكرة المؤقتة. ولا تُحذف الإعدادات وطرق المناطق إلا إذا كان Remove data on uninstall مفعّلًا، وإلا فتبقى لإعادة التثبيت لاحقًا. وتبقى نقاط الاستلام المحفوظة في الطلبات، وتحتفظ الطلبات الحالية بسطور الشحن الخاصة بها.

Mondial Relay علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ Mondial Relay ولا تحظى بتأييدها.