VibeFox Omniva for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

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

PHP: 8.0 أو أحدث.

Omniva: لا يلزم حساب API. لا تملك Omniva واجهة برمجة تطبيقات عامة للأسعار. واجهة Omniva OMX متاحة فقط للعملاء المتعاقدين، ولا تستخدمها هذه الإضافة، لذلك تُدخل أسعارك الخاصة (التعاقدية). سجّل الطرود في حسابك التجاري لدى Omniva.

Parcel machine list: تُنزّل الإضافة ملف المواقع المفتوح لدى Omniva من omniva.ee (لا يلزم مفتاح أو عقد). يجب أن يتمكن خادمك من إرسال طلبات HTTPS صادرة إلى www.omniva.ee.

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

التثبيت

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

2. انقر Activate.

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

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

5. راجع الأسعار حسب البلد وحجم الطرد، وأحجام الطرود، وسطر حالة Parcel machine list.

6. أضف VibeFox Omniva إلى منطقة الشحن الخاصة بإستونيا أو لاتفيا أو ليتوانيا (أو إليها جميعًا) في WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones واختر البلدان.

الإعدادات

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

Title (zone): الاسم الذي يراه العميل لهذه المنطقة. اتركه فارغًا لاستخدام Method title العام.

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

عام

Enable/Disable: يُفعّل Omniva أو يُوقفه في جميع المناطق دفعة واحدة.

Method title: اسم طريقة الشحن الذي يراه العملاء. يحل Title طريقة المنطقة محله. الافتراضي: Omniva parcel machine.

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

الأسعار (بعملة متجرك؛ ويمكن كتابة الكسور العشرية مثل 3.50 أو 3,50)

Price by parcel size: صف واحد لكل بلد (إستونيا ولاتفيا وليتوانيا)، مع الأعمدة S وM وL وXL وFree from. أدخل سعر كل حجم طرد من Omniva للبلد المستهدف. تعني الخلية الفارغة أن هذا الحجم غير متاح في ذلك البلد: تُخفى الطريقة عندما يحتاج الطرد إليه. و0 تعني مجانًا. Free from هو مجموع السلة (بعد الخصومات، كما يظهر في السلة) الذي يصبح الشحن إلى ذلك البلد عنده مجانيًا؛ اتركه فارغًا إذا لم يكن هناك شحن مجاني. قبل أن تحفظ أسعارك، يبدأ الجدول بالقيمة 3.50 لإستونيا و4.00 للاتفيا وليتوانيا. عند تفعيل ضرائب WooCommerce، يزيل زر صغير -% بجوار كل سعر ضريبة القيمة المضافة لبلد متجرك من السعر المُدخل (للأسعار التي تعرفها شاملة الضريبة).

Calculation: كيفية تحديد حجم الطرد والسعر.

Parcel sizes (cm): الأبعاد القصوى لكل حجم، وتُدخل باسم Smallest side وMiddle side وLargest side. تُرتَّب أبعاد المنتج بالطريقة نفسها وتُقارن جنبًا إلى جنب؛ وتُرتَّب القيم عند الحفظ. تُحوَّل أبعاد المنتج من وحدة المتجر إلى سم. تتسع المنتجات التي لا أبعاد لها في الحجم S. وإذا لم يتسع شيء، تُخفى الطريقة. الافتراضي: S 9 x 38 x 64، وM 19 x 38 x 64، وL 38 x 39 x 64، وXL 39 x 64 x 64. تحقق منها مقابل أحجام طرود Omniva الحالية.

التوفر

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

Maximum weight (kg): يُخفي الطريقة عندما تكون السلة (أو، مع Per item، عنصر واحد) أثقل من ذلك. تقبل أجهزة الطرود التابعة لـ Omniva طرودًا تصل إلى 30 كغ. الافتراضي: 30. و0 يعني بلا حد. تُحوَّل وحدة وزن المتجر إلى كغ.

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

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

Ignore shipping zones: يعرض Omniva للبلدان أدناه دون إضافته إلى منطقة. عندما يكون مُعطّلًا، تُحدَّد البلدان بمناطق الشحن التي أُضيفت إليها الطريقة. يُنصح بإبقائه مُعطّلًا.

Countries (without zones): بلدان الوجهة لهذا الوضع. لا يُستخدم هذا الحقل إلا عندما يكون Ignore shipping zones مُفعّلًا. اتركه فارغًا لجميع بلدان الشحن. وفي أي وضع لا يُعرض Omniva إلا حيث توجد له أجهزة طرود: إستونيا ولاتفيا وليتوانيا.

أجهزة الطرود

Post offices: يعرض أيضًا مكاتب البريد التابعة لـ Omniva في القائمة نفسها. تُدرج Omniva مكاتب البريد لإستونيا. مُعطّل افتراضيًا.

City order: يعرض المدن الأكبر أولًا (تالين وريغا وفيلنيوس وغيرها)، ثم بقية المدن أبجديًا. مُفعّل افتراضيًا. عندما يكون مُعطّلًا، تُرتَّب المدن أبجديًا.

Parcel machine list: سطر حالة يعرض عدد أجهزة الطرود لكل بلد (ومكاتب البريد إذا كانت مُفعّلة) وموعد آخر تنزيل من omniva.ee. انقر Update the list now لتنزيل القائمة فورًا؛ وإذا لم يستجب omniva.ee، تبقى النسخة المحفوظة.

متقدم

Debug log: يسجل تفاصيل حساب الأسعار وقائمة أجهزة الطرود في WooCommerce > Status > Logs (المصدر vfd-omniva). وتُسجَّل الأخطاء، مثل عدم توفر قائمة أجهزة الطرود، دائمًا. ولا تُسجَّل أي بيانات للعملاء.

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

كيف تعمل عند الدفع

عندما يُدخل العميل عنوان تسليم في إستونيا أو لاتفيا أو ليتوانيا، يطلب WooCommerce سعر الشحن من الإضافة. تتحقق الإضافة من وزن السلة ومجموعها الأدنى وفئات الشحن المستثناة، ثم تحدد حجم الطرد من أبعاد المنتج. إذا لم يتسع الطرد لأي حجم، أو لم يكن للحجم سعر في ذلك البلد، أو لم يكن هناك جهاز طرود متاح، تُخفى الطريقة، فلا يرى العميل أبدًا صفحة دفع لا يمكن إتمامها. وإذا بلغ مجموع السلة Free from للبلد، يصبح السعر 0. ويُحفظ حجم الطرد في سطر الشحن الخاص بالطلب باسم Omniva parcel size.

تُنزَّل قائمة أجهزة الطرود من omniva.ee مرة واحدة يوميًا، وتُخزَّن في قاعدة بيانات WordPress لا في مجلد الإضافة. وإذا فشل التنزيل، تستمر النسخة المحفوظة في العمل، وتُجرى المحاولة التالية بعد 15 دقيقة، حتى لا ينتظر الدفع omniva.ee عند كل تحديث للصفحة. ومهلة التنزيل 15 ثانية.

تعمل الطريقة في الدفع الكلاسيكي وفي كتلتي Cart وCheckout. وهي متوافقة مع WooCommerce High-Performance Order Storage (HPOS). الأسعار بعملة متجرك. ولا تحوّل الإضافة العملات.

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

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

عندما يختار العميل Omniva، تظهر قائمتان أسفل الطريقة: -- Select city -- و-- Select parcel machine --. لا تُعرض إلا المدن وأجهزة الطرود في بلد التوصيل؛ وعندما يغيّر العميل البلد، تتغير القائمتان أيضًا. في إستونيا تكون المدن مقاطعات، وتُدرج تالين وتارتو وبيرنو منفصلة؛ وفي لاتفيا وليتوانيا تكون مدنًا وبلديات. تُحدَّد مدينة عنوان الشحن تلقائيًا عندما تتطابق مع مدينة في القائمة. ويُعرض كل جهاز طرود مع اسمه وعنوانه. يُحفظ الاختيار أثناء الدفع، فلا يضيع عند تحديث صفحة الدفع.

جهاز الطرود مطلوب. في الدفع الكلاسيكي يرى العميل Please select an Omniva parcel machine. وفي الدفع بالكتل يكون Place order مُعطّلًا حتى يُختار جهاز طرود. وفي الحالتين يتحقق الخادم من جهاز الطرود مرة أخرى مقابل القائمة، فيُرفض المعرّف المزوَّر أو جهاز الطرود من بلد آخر.

يُحفظ معرّف جهاز الطرود واسمه ومدينته وبلده في الطلب. وتظهر هذه البيانات في شاشة الطلب أسفل عنوان الشحن (مع معرّف جهاز الطرود)، وفي صفحة استلام الطلب، وفي My account > Orders، وفي رسائل الطلب الإلكترونية (HTML والنص العادي) بوصفها Omniva parcel machine.

لتغيير جهاز الطرود في طلب، افتح الطلب في WooCommerce > Orders، وانقر Change بجوار جهاز الطرود، واختر مدينة وجهاز طرود من بلد توصيل الطلب، ثم انقر Save parcel machine. وتسجل ملاحظة الطلب جهاز الطرود القديم والجديد.

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

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

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

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

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

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

لا يظهر Omniva في الدفع: تحقق من أن الترخيص فعّال، وأن Enable/Disable مُفعّل، وأن بلد التوصيل إستونيا أو لاتفيا أو ليتوانيا، وأن الطريقة مُضافة إلى منطقة بلد العميل (أو أن Ignore shipping zones مُفعّل وأن البلد مسموح به). افتح صفحة الإعدادات: يشرح الإشعار الأحمر إذا لم يُحدَّد أي سعر أو لم تتوفر قائمة أجهزة طرود. وتحقق أيضًا من أبعاد المنتجات (الطرد الأكبر من حجم XL، أو حجم بخلية سعر فارغة، يُخفي الطريقة)، وحدود الوزن، وMinimum cart total، وExcluded shipping classes. وعند تفعيل Debug log، يوضح WooCommerce > Status > Logs (المصدر vfd-omniva) سبب إخفاء الطريقة.

لا توجد أجهزة طرود: تعذر تنزيل القائمة من omniva.ee ولا توجد نسخة محفوظة. تعيد الإضافة المحاولة كل 15 دقيقة. انقر Update the list now؛ وإذا فشل، تحقق من أن خادمك يستطيع الوصول إلى www.omniva.ee، وراجع الخطأ في WooCommerce > Status > Logs.

جهاز طرود جديد غير ظاهر: تُحدَّث القائمة مرة واحدة يوميًا. انقر Update the list now لتنزيلها فورًا.

يُحتسب سعر خاطئ: يعتمد السعر على حجم الطرد المحدد من أبعاد المنتج. تحقق من أبعاد المنتجات، وCalculation، وParcel sizes (cm). وعند تفعيل Debug log، يعرض السجل الحجم المختار والسعر.

لا يستطيع العميل إتمام الطلب: يجب اختيار جهاز طرود. وإذا رأى العميل الرسالة "The Omniva parcel machine list is temporarily unavailable"، فلا توجد أجهزة طرود متاحة الآن؛ انظر "لا توجد أجهزة طرود".

بأي عملة الأسعار: بعملة متجرك. ولا تحوّل الإضافة العملات.

للمطورين: يغيّر الفلتر vfd_omniva_locations_url عنوان ملف المواقع (CSV بصيغة Omniva)، ويغيّر vfd_omniva_countries قائمة بلدان الوجهة (الافتراضي EE وLV وLT).

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

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

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

Omniva علامة تجارية مملوكة لصاحبها. هذه الإضافة غير مرتبطة بـ Omniva ولا معتمدة من قِبلها.