VibeFox LP Express for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

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

PHP: 8.0 أو أحدث.

LP Express: لا حاجة إلى حساب API. لا تملك LP Express واجهة برمجية عامة للأسعار. واجهة Unisend البرمجية متاحة فقط للعملاء المتعاقدين، ولا تستخدمها هذه الإضافة، لذلك تُدخل أسعارك الخاصة (التعاقدية). أنشئ الطرود في حسابك على Unisend ("Mano siuntos").

قائمة محطات الطرود: تستخدم الإضافة قائمة LP Express العامة للمحطات، وهي القائمة نفسها التي كانت تستخدمها إضافات LP Express القديمة. وقت إصدار النسخة 1.1.0 لم تكن هذه القائمة الإلكترونية متاحة. وما دامت غير متاحة، تستخدم الإضافة آخر نسخة مُنزَّلة إن وُجدت، وإلا فقائمتك الخاصة. كن مستعدًا لإدخال قائمتك الخاصة (انظر الإعدادات).

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

التثبيت

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

2. انقر Activate.

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

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

5. املأ جدول الأسعار (صف واحد على الأقل) أو التكلفة الاحتياطية. تحقق من سطر الحالة الخاص بمحطات الطرود أعلى الصفحة، وأضف قائمة محطاتك الخاصة إذا لم تكن القائمة الإلكترونية متاحة.

6. أضف VibeFox LP Express إلى منطقتك في ليتوانيا في WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones واختر الدول.

الإعدادات

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

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

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

عام

Enable/Disable: يشغّل LP Express أو يوقفه في جميع المناطق دفعة واحدة.

Method title: اسم طريقة الشحن الذي يراه العملاء. يتجاوزه عنوان طريقة المنطقة. الافتراضي: LP Express parcel terminal.

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

الأسعار (بعملة متجرك؛ يمكن كتابة الكسور مثل 2.99 أو 2,99)

Price table: صف واحد لكل دولة وجهة. انقر + Add country لإضافة صف، والعلامة × لحذفه. اختر * Any other country لأي دولة ليس لها صف خاص. يحتوي كل صف على Base price وأعمدة وزن: XS (≤1 kg) وS (≤2 kg) وM (≤3 kg) وL (≤5 kg) وXL (>5 kg). الوزن هو وزن السلة، أو وزن عنصر واحد مع Per item. العمود الفارغ يستخدم السعر الأساسي للصف. 0 يعني مجانًا. الأسعار غير الرقمية تُبلَّغ بعد الحفظ وتُترك فارغة.

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

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

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

التوافر

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

Maximum weight (kg): يُخفي الطريقة عندما تكون السلة أثقل من ذلك. تقبل محطات LP Express طرودًا حتى 30 كغ. الافتراضي: 30. 0 يعني لا حد.

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

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

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

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

محطات الطرود

Terminal list: مصدر المحطات.

Own terminal list: محطة واحدة في كل سطر بالصيغة ID | Name | City | Address | ZIP، مثلًا 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. الحقلان ID وCity مطلوبان. تُتجاهل الأسطر التي تبدأ بالرمز #. استخدم معرّفات المحطات التي يتوقعها حسابك في Unisend.

حفظ الإعدادات يعيد تحميل قائمة المحطات.

متقدم

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

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

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

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

تُخزَّن قائمة المحطات الإلكترونية مؤقتًا لمدة 24 ساعة. يُتذكَّر التنزيل الفاشل لمدة 15 دقيقة، حتى لا تنتظر صفحة الدفع القائمة في كل تحديث. مهلة التنزيل 10 ثوانٍ. تُعرض المحطات النشطة فقط من القائمة.

تعمل الطريقة في الدفع الكلاسيكي وفي كتلتي السلة والدفع. وهي متوافقة مع تخزين الطلبات عالي الأداء في WooCommerce (HPOS). الأسعار بعملة متجرك. لا تحوّل الإضافة العملات.

لا تطلب الإضافة أسعار LP Express أو Unisend، ولا تُنشئ شحنات، ولا تطبع ملصقات، ولا تستدعي شركة توصيل، ولا تتتبع الطرود. أنشئ الطرود في حسابك على Unisend ("Mano siuntos"). التوصيل حتى الباب بواسطة مندوب ليس جزءًا من هذه الطريقة.

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

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

المحطة إلزامية. في الدفع الكلاسيكي يرى العميل Please select an LP Express parcel terminal. وفي الدفع بالكتل يكون Place order معطّلًا حتى تُختار محطة. وفي الحالتين يتحقق الخادم من المحطة مقابل القائمة مرة أخرى، فتُرفض معرّفات المحطات المزوّرة أو القديمة.

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

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

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

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

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

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

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

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

لا توجد محطات طرود: تعذّر تحميل القائمة الإلكترونية، ولا توجد نسخة محفوظة ولا قائمة خاصة. تحاول الإضافة مرة أخرى كل 15 دقيقة. أدخل قائمتك الخاصة في Own terminal list، أو اختر Only my own list.

قائمة المحطات قديمة: احفظ صفحة الإعدادات. سيعيد ذلك تحميل قائمة المحطات. مع قائمتك الخاصة، حدّث الأسطر بنفسك.

لا يستطيع العميل إتمام الطلب: يجب اختيار محطة طرود. إذا رأى العميل الرسالة "The LP Express parcel terminal list is temporarily unavailable"، فلا توجد محطات متاحة الآن. أضف قائمتك الخاصة.

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

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

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

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

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