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

المتطلبات

PrestaShop: من 8.0 إلى 9.x.

PHP: 8.0 أو أحدث. يرفض الوحدة التثبيت على إصدارات PHP الأقدم.

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

قائمة محطات الطرود: تستخدم الوحدة قائمة LP Express العامة للمحطات (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). لا يلزم أي مفتاح. إذا كانت هذه القائمة عبر الإنترنت غير متاحة، تستخدم الوحدة آخر نسخة نُزِّلت إن وُجدت، وإلا فقائمتك الخاصة. كن مستعدًا لإدخال قائمتك الخاصة (انظر الإعدادات).

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

التثبيت

1. في لوحة الإدارة انتقل إلى Modules > Module Manager وانقر على Upload a module. اختر ملف ZIP الخاص بالوحدة.

2. عند انتهاء الرفع انقر على Configure، أو ابحث عن VibeFox LP Express لاحقًا في قائمة الوحدات وانقر على Configure.

3. الصق مفتاح ترخيص VibeFox في License key في كتلة الترخيص أعلى صفحة Configure وانقر على Activate (انظر مفتاح الترخيص).

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

عند التثبيت تُنشئ الوحدة شركة الشحن LP Express parcel terminal مع نص مدة التوصيل Delivery to an LP Express parcel terminal. تُعيَّن شركة الشحن إلى منطقة ليتوانيا وإلى جميع مجموعات العملاء. يمكنك إضافة مناطق وتغيير مجموعات العملاء ومدة التوصيل والشعار وحدود الحجم في Shipping > Carriers. لا تحدد الأسعار هناك: السعر يأتي دائمًا من الوحدة.

الإعدادات

جميع الإعدادات موجودة في صفحة الوحدة: Modules > Module Manager > VibeFox LP Express > Configure. لكل قسم زر Save خاص به، وهو يحفظ الصفحة بأكملها. يعيد كل حفظ تحميل قائمة المحطات أيضًا.

في أعلى الصفحة تعرض الإشعارات المشكلات وحالة المحطات. يظهر تحذير عندما لا يُحدَّد أي سعر أو لا تتوفر أي محطة طرود، لأن شركة الشحن عندئذٍ لا تظهر في الدفع؛ ويظهر أيضًا عندما تُحذف شركة الشحن، وعندما لا تكون وحدة وزن المتجر من الوحدات التي تعرفها الوحدة (kg وg وlb وoz)، لأن أوزان المنتجات تُقرأ عندئذٍ على أنها كيلوغرامات. يعرض سطر المعلومات عدد محطات الطرود المتاحة وعدد المدن، ومصدرها: القائمة عبر الإنترنت، أو نسخة محفوظة منها (مع تاريخها)، أو قائمتك الخاصة.

عند الحفظ، يُرفض عنوان الطريقة الفارغ أو غير الصالح كاسم لشركة الشحن برسالة Enter a valid method title.، ويُرفض أيضًا العنوان الذي يتجاوز 64 حرفًا. في الحالتين لا يُحفظ شيء. يُبلَّغ عن أي مبلغ أو وزن ليس رقمًا (أو سالب)، ويُحتفظ بقيمته السابقة. يُبلَّغ أيضًا عن Minimum weight (kg) الأكبر من Maximum weight (kg) (30 كغ عندما يكون الحد الأقصى فارغًا)، لأن شركة الشحن لن تظهر أبدًا، ويحتفظ الوزنان بقيمتيهما السابقة. تُبلَّغ الأسعار في الجدول التي ليست أرقامًا وتُترك فارغة.

عام

Enable/Disable: يُشغّل LP Express أو يوقفه. وهو المفتاح نفسه لحالة شركة الشحن في Shipping > Carriers.

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

Tax status: None يعني أن الأسعار أدناه نهائية. Taxable مع قاعدة ضريبية (خيار واحد لكل قاعدة ضريبية في متجرك) يعني أن PrestaShop يضيف ضريبة الشحن تلك إلى الأسعار أدناه. هذه هي قاعدة الضريبة الخاصة بشركة الشحن.

الأسعار (بعملة المتجر الافتراضية؛ يمكن كتابة الكسور مثل 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 يعني لا حد. الفارغ يعني 30 كغ في مناطق شركة الشحن، ولا حد فقط لدول Ignore shipping zones الواقعة خارج تلك المناطق.

Minimum cart total: يعرض شركة الشحن فقط ابتداءً من مجموع السلة هذا (المنتجات التي تحتاج إلى شحن، بعد الخصومات، دون الضريبة). اتركه فارغًا لعرضها دائمًا.

Ignore shipping zones: يعرض LP Express للدول أدناه دون أن تحدد المناطق بنفسك. عندئذٍ تُربط شركة الشحن بكل منطقة نشطة (بما في ذلك المناطق المُنشأة لاحقًا). تبقى المناطق التي كانت لشركة الشحن من قبل مسموحة لجميع دولها. عندما تُعيد إيقاف الخيار، تستعيد شركة الشحن المناطق التي كانت لها من قبل. عند إيقافه، تُحدَّد الدول بمناطق شركة الشحن في Shipping > Carriers. وهذا ما يُوصى به.

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: يكتب تفاصيل احتساب الأسعار وقائمة المحطات في logs/vfd_lpex_debug.log.php داخل مجلد الوحدة. لا يمكن فتح الملف من الويب. تُسجَّل الأخطاء، مثل عدم توفر قائمة المحطات، دائمًا. لا تُسجَّل أي بيانات للعملاء.

Log: يعرض حجم السجل وأحدث إدخالاته. انقر على Clear log لتفريغه.

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

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

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

الأسعار والمبالغ بعملة المتجر الافتراضية. ثم يُعرض السعر بعملة سلة العميل باستخدام سعر صرف PrestaShop.

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

إذا عدّلت شركة الشحن في Shipping > Carriers بعد أن أصبح لها طلبات، يحفظها PrestaShop كنسخة جديدة من شركة الشحن. تتبع الوحدة النسخة الجديدة تلقائيًا.

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

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

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

اختيار محطة إلزامي. بدون اختيارها، تعرض Continue في خطوة الشحن وPlace order الرسالة Please select an LP Express parcel terminal. عندما ينقر العميل على Continue، يتحقق الخادم من المحطة مقابل القائمة مرة أخرى، فيُرفض معرّف محطة مزوّر أو قديم برسالة The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.

يُحفظ معرّف المحطة واسمها ومدينتها مع الطلب. وتظهر في الكتلة LP Express parcel terminal في صفحة الطلب في لوحة الإدارة (مع Terminal ID)، وفي صفحة تأكيد الطلب، وفي تفاصيل طلب العميل. وفي رسالة تأكيد الطلب ورسالة الطلب الجديد إلى التاجر تُضاف إلى اسم شركة الشحن على الصورة LP Express parcel terminal: متبوعةً بالمحطة. إذا لم يكن للطلب محطة، تعرض صفحة الطلب في لوحة الإدارة No parcel terminal was chosen for this order.

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

تعمل الوحدة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox LP Express هي الكتلة الأولى في Modules > Module Manager > VibeFox LP Express > Configure، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مقنّعًا، والحالة (مثلًا تاريخ انتهاء صلاحية الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. تحتها السطر Product: presta-shipping-lp-express والرابط Manage licenses and domains in your account الذي يفتح حسابك على vibefox.net. يستطيع تغيير المفتاح فقط الموظفون الذين لديهم صلاحية Configure للوحدة. نصوص الكتلة تتبع لغة لوحة الإدارة (الإنجليزية والروسية متوفرتان).

إذا لم يُقبل المفتاح، تُبيّن الكتلة السبب، مثل Key not found، أو This key belongs to another product، أو Domain limit reached، أو License expired on مع تاريخ. بعد تغيير عنوان المتجر، أو بعد تحرير خانة نطاق في حسابك، انقر على Check now. إذا تعذّر الوصول إلى خادم التراخيص، تواصل الوحدة العمل بآخر حالة معروفة.

يعمل المفتاح الواحد على نطاق واحد: نطاق المتجر الرئيسي، وكذلك في إعداد المتاجر المتعددة. إزالة المفتاح من المتجر لا تحرر خانة النطاق. حرّر الخانة من حسابك على vibefox.net.

بدون مفتاح نشط لا تظهر شركة الشحن LP Express للعملاء عند الدفع، ولا يُحسب أي سعر. واجهة متجر PrestaShop لا تعرف أنك مسجّل الدخول إلى لوحة الإدارة، لذلك تُخفى شركة الشحن عنك أيضًا: يمكنك إعداد الوحدة قبل شراء المفتاح، لكن لا يمكنك اختبارها عند الدفع. يظهر تذكير في Modules > Module Manager على التبويب Alerts. الطلبات الحالية لا تتأثر.

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

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

لا يظهر LP Express عند الدفع: تحقق من أن الترخيص نشط وأن Enable/Disable مُفعّل. في Shipping > Carriers تحقق من أن شركة الشحن تغطي منطقة دولة العميل ومجموعته (أو أن Ignore shipping zones مُفعّل والدولة مسموحة). افتح صفحة الوحدة: يوضح التحذير ما إذا لم يُحدَّد أي سعر أو لم تتوفر أي محطة طرود. تحقق أيضًا من حدود الوزن وMinimum cart total. قد تكون المنتجات مقيّدة بشركات شحن معينة في صفحة المنتج. عند تفعيل Debug log يعرض الحقل Log في صفحة الوحدة سبب إخفاء شركة الشحن.

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

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

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

بأي عملة تكون الأسعار: بعملة المتجر الافتراضية. يرى العملاء الذين يدفعون بعملة أخرى السعر محولًا بسعر صرف PrestaShop.

تقول الصفحة إن شركة الشحن LP Express غير موجودة: حُذفت شركة الشحن في Shipping > Carriers. أعد ضبط الوحدة في Modules > Module Manager لإنشائها من جديد.

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

انتقل إلى Modules > Module Manager، وافتح القائمة بجوار VibeFox LP Express، واختر Uninstall. تُحذف دائمًا مفتاح الترخيص وحالة الترخيص. تُمسح قائمة المحطات المخزنة مؤقتًا دائمًا. إذا كان Remove data on uninstall مُفعّلًا، تُحذف شركة الشحن (تحتفظ الطلبات بسجلها)، وتُزال الإعدادات والسجل والنسخة المحفوظة من قائمة المحطات. وإذا كان معطّلًا، تُوقف شركة الشحن فقط وتبقى جميع الإعدادات والنسخة المحفوظة. إعادة تثبيت الوحدة تعيد لشركة الشحن المحفوظة الحالة التي كانت عليها. لا يُحذف المحطة المحفوظة في الطلبات أبدًا.

LP Express علامة تجارية مملوكة لصاحبها. هذه الوحدة غير تابعة لـ LP Express ولا معتمدة من قِبلها.