VibeFox Blue Express for OpenCart — المساعدة

المتطلبات

OpenCart: 3.0.x (تم الاختبار على 3.0.5.0) أو 4.0.2 وما بعده (تم الاختبار على 4.1.0.3).

PHP: 8.0 أو أحدث.

حساب Blue Express (للأسعار المباشرة فقط): تحتاج الأسعار المباشرة إلى حساب تجارة إلكترونية لدى Blue Express ومفتاح واجهته البرمجية (x-api-key). اطلبه من Blue Express: developers.bluex.cl أو gpo.integraciones@bx.cl. يجب أن تكون الخدمة التي تستخدمها (EX أو PY أو MD) مفعّلة في عقدك مع Blue Express. إذا كنت تستخدم الأسعار الثابتة فقط، فلا تحتاج إلى مفتاح واجهة.

مناطق تشيلي: للحصول على سعر مباشر، يجب أن يتضمن عنوان التسليم منطقة تشيلية. إذا كان متجرك يفتقر إلى مناطق تشيلي، فيمكن للإضافة إضافتها لك (راجع Configuration).

نقاط الاستلام: تُحمَّل خريطة Blue Express في متصفح العميل من widget-pudo.blue.cl.

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

التثبيت

التنزيل ملف zip واحد يحتوي على الحزم لكلا إصداري OpenCart. فكّ ضغطه على جهازك. يحتوي على README.txt، وحزمة OpenCart 3 vfd_blue_express-oc3-(version).ocmod.zip، وحزمة OpenCart 4 vfd_blue_express.ocmod.zip. ثبّت الحزمة الخاصة بإصدار OpenCart لديك فقط. مفتاح الترخيص هو نفسه لكلا الإصدارين.

OpenCart 3

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، واضغط Upload، واختر الملف vfd_blue_express-oc3-(version).ocmod.zip. لا تضيف الإضافة أي تعديلات OCMOD، لذلك لا تحتاج إلى تحديث Extensions > Modifications. ويمكنك بدلًا من Installer نسخ محتويات مجلد upload الموجود في هذه الحزمة إلى المجلد الجذري لمتجرك.

2. انتقل إلى Extensions > Extensions، واختر نوع الإضافات Shipping. ابحث عن VibeFox Blue Express واضغط Install (الزر الأخضر +).

3. اضغط Edit (زر القلم) لفتح صفحة الإعدادات.

4. أدخل مفتاح ترخيص VibeFox في حقل License key داخل كتلة الترخيص أعلى صفحة Edit، ثم اضغط Activate (راجع License key).

5. أدخل مفتاح الواجهة البرمجية والخدمة ورمز منطقة الإرسال (مثل SCL)، وسعر صرف CLP إذا لم تكن عملة متجرك CLP، والأسعار الثابتة (مثل CL=4500). فعّل Enable/Disable للتوصيل إلى المنزل، وPickup point option إذا أردت تقديم الاستلام من نقاط Blue Express. اضغط Save. راجع Configuration.

OpenCart 4

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، واضغط Upload، واختر الملف vfd_blue_express.ocmod.zip. لا تغيّر اسم الملف: يأخذ OpenCart 4 رمز الإضافة من اسم الملف، والحزمة التي يُغيَّر اسمها لا تعمل.

2. تظهر الحزمة في قائمة الإضافات المثبتة في الصفحة نفسها. اضغط Install (الزر الأخضر +) بجوارها.

3. انتقل إلى Extensions > Extensions، واختر نوع الإضافات Shipping. ابحث عن VibeFox Blue Express، واضغط Install (الزر الأخضر +)، ثم Edit (زر القلم).

4. أدخل مفتاح الترخيص والإعدادات كما في الخطوتين 4 و5 لـ OpenCart 3. صفحة الإعدادات وحقولها هي نفسها في الإصدارين.

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

Configuration

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Shipping > VibeFox Blue Express > Edit. تظهر الأقسام في القائمة على اليسار. يحفظ زر Save واحد الصفحة كاملة دون إعادة تحميلها. كما يُمسح كل حفظ الأسعار المخزنة مؤقتًا لـ Blue Express وبيانات البلديات. ولا يستطيع حفظ الإعدادات إلا المستخدمون المسؤولون الذين لديهم صلاحية التعديل لهذه الإضافة. تنطبق الشروط والأسعار وفئة الضريبة أدناه على الخيارين معًا.

تُرفض القيم غير الصالحة مع خطأ، ولا يُحفظ شيء: اسم فارغ أو يحتوي على الأحرف < > ; = # { }، أو اسم أطول من 64 حرفًا، أو عدد سالب أو غير صالح، أو Min weight (kg) أكبر من Max weight (kg)، أو Sort order ليس عددًا صحيحًا، أو فئة ضريبة أو منطقة جغرافية غير معروفة.

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

General

Enable/Disable: يفعّل أو يعطّل التوصيل إلى المنزل عبر Blue Express في صفحة الدفع.

Name: اسم طريقة الشحن المعروض في صفحة الدفع للتوصيل إلى المنزل. الافتراضي: Blue Express. حقل إلزامي، بحد أقصى 64 حرفًا.

Tax class: فئة الضريبة لتكلفة الشحن، أو None (no tax on shipping) (الافتراضي). أسعار Blue Express تشمل IVA. اختر None إذا كان لا يجب على OpenCart إضافة ضريبة فوقها. يسري هذا على الخيارين معًا.

Sort order: موضع Blue Express بين طرق الشحن في صفحة الدفع. عدد صحيح.

الاستلام من نقاط Blue Express (PUDO)

Pickup point option: يقدم التوصيل إلى نقطة Blue Express يختارها العميل، كخيار ثانٍ بجانب التوصيل إلى المنزل. معطّل افتراضيًا.

Pickup point name: اسم طريقة الشحن المعروض في صفحة الدفع للاستلام من نقطة Blue Express. الافتراضي: Blue Express pickup point. حقل إلزامي، بحد أقصى 64 حرفًا.

واجهة Blue Express البرمجية (مطلوبة للأسعار المباشرة)

API key: مفتاح واجهة Blue Express البرمجية (الترويسة x-api-key). بدونه تُستخدم الأسعار الثابتة فقط. بعد الحفظ يبقى الحقل فارغًا ويعرض A key is saved - leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها.

Remove the saved API key: فعّله واحفظ لحذف المفتاح المحفوظ.

Service: خدمة Blue Express المستخدمة للسعر: Express (EX) (الافتراضي)، أو Prioritario (PY)، أو SameDay (MD). يجب أن تكون مفعّلة في عقدك مع Blue Express.

Origin district code: رمز منطقة Blue Express للمكان الذي تشحن منه، مثل SCL لسانتياغو (الافتراضي). اسأل Blue Express إذا لم تكن متأكدًا.

CLP per 1 (your currency): تعرض التسمية عملة متجرك الافتراضية، مثل CLP per 1 EUR. أسعار Blue Express بالبيزو التشيلي (CLP). أدخل كم يساوي وحدة واحدة من عملة متجرك الافتراضية بالـ CLP، مثل 1050. من دون هذه القيمة لا تُستخدم الأسعار المباشرة. وتُتجاهل عندما تكون عملة المتجر CLP.

السعر

Rate source: طريقة حساب السعر. يحتاج السعر المباشر إلى عنوان تشيلي يتضمن منطقة وبلدية (مدينة). تُكتب الأخطاء في السجل ولا تُعرض على العميل أبدًا.

Fixed prices: سطر واحد لكل دولة بالصيغة كود_الدولة=السعر، بعملة المتجر الافتراضية، دون الضريبة، مثل CL=4500 في متجر بعملة CLP أو CL=4.50 في متجر بعملة EUR. يُقبل الفاصل أو النقطة كفاصل عشري. تُتجاهل الأسطر غير الصالحة وتُدرج في تحذير عند الحفظ. لا يكون للدولة التي ليس لها سطر سعر ثابت، لذلك تُخفى الخيارات عنها عندما يكون السعر الثابت مطلوبًا. ويمكن استخدام الأسعار الثابتة لأي دولة.

Fixed price per: Order (الافتراضي) يحصّل السعر مرة واحدة. أما Item (price x quantity) فيضربه في عدد القطع في السلة. ويسري هذا على السعر الثابت فقط. وسعر الواجهة يكون دائمًا للشحنة كاملة.

Conditions

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

Max weight (kg): يخفي الطريقة عندما تكون السلة أثقل من هذا. الافتراضي: 100. 0 يعني بلا حد، والحقل الفارغ يعني 100 kg.

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

الشحن المجاني

Free shipping: يفعّل الشحن المجاني من مجموع فرعي للسلة.

Free from subtotal: المجموع الفرعي للسلة (بعملة المتجر، والمنتجات التي تحتاج إلى شحن، بعد الكوبون، من دون الضريبة) الذي يصبح الشحن عنده مجانيًا. عندئذٍ لا يُرسل أي طلب إلى Blue Express. ويُستخدم فقط عندما يكون Free shipping مفعّلًا.

Availability

Geo zone: اعرض Blue Express فقط للعناوين الواقعة في هذه المنطقة الجغرافية. All zones (الافتراضي) يعني بلا حد. تُدار المناطق الجغرافية في System > Localisation > Geo Zones. لا يُتحقق منها مع Ignore shipping zones.

Ignore shipping zones: اعرض الخيارين في كل منطقة جغرافية. عندئذٍ تُحدد الدول بالقائمة أدناه.

Countries: الدول المقصودة لهذا الوضع. اتركه فارغًا للسماح بجميع الدول. ولا يُستخدم إلا مع Ignore shipping zones.

المناطق التشيلية (يظهر فقط عندما تفتقر مناطق تشيلي في متجرك)

تحتاج Blue Express إلى منطقة عنوان تشيلي (مثل RM وVS وغيرهما) للحصول على السعر المباشر. تُؤخذ المنطقة من منطقة العنوان، بحسب رمزها أو اسمها. يعرض هذا القسم عدد مناطق تشيلي في متجرك، والمناطق الناقصة (المتجر القياسي OpenCart 3.0.5 لديه 15 من أصل 16، من دون Ñuble). اضغط Add Chilean regions لإضافة المناطق الناقصة كمناطق لتشيلي بالرموز التي تستخدمها Blue Express. المناطق التي لديك بالفعل، سواء بالرمز أو بالاسم، لا تُضاف مرة ثانية. ولا يتغير شيء حتى تضغط الزر. ويمكنك أيضًا إضافتها بنفسك في System > Localisation > Zones.

متقدم

Debug log: يسجل الطلبات والقرارات في storage/logs/vfd_blex_debug.log.php. لا يمكن قراءة هذا الملف من الويب. تُسجَّل أخطاء الواجهة دائمًا. ولا تُسجَّل مفاتيح الواجهة وعناوين العملاء أبدًا. أوقف السجل عندما تنتهي. يُدوَّر السجل عند بلوغه 5 ميغابايت.

Log: يعرض حجم السجل وآخر إدخالاته. اضغط Clear log لتفريغه.

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

Import / Export

Export: اضغط Download JSON لحفظ الإعدادات في ملف JSON. ولا يُصدَّر مفتاح الواجهة.

Import: ألصق ملف JSON صُدِّر سابقًا واضغط Import لاستعادة الإعدادات، مثلًا في متجر آخر. تُفحص القيم كما في الحفظ العادي. ويبقى مفتاح الواجهة المحفوظ.

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

عندما يعرض OpenCart طرق الشحن، يطلب من الإضافة سعر كل خيار مفعّل. إذا كانت Geo zone محددة (وكان Ignore shipping zones معطلًا) وكان العنوان خارجها، فلن يُعرض Blue Express. ومع Ignore shipping zones تحدد قائمة Countries ذلك. ولا تُحتسب إلا المنتجات التي يكون فيها Requires Shipping على Yes: أما المنتجات الأخرى فلا تضيف وزنًا ولا تدخل في المجموع الفرعي. ثم تتحقق الإضافة من وزن السلة وMinimum order subtotal. والمجموع الفرعي هو سعر المنتجات التي تحتاج إلى شحن، بعد خصم الكوبون وقبل الضريبة. ولا تُؤخذ بطاقات الهدايا ونقاط المكافآت ورصيد المتجر في الحسبان. وإذا انطبق الشحن المجاني، يكون السعر 0 ولا يُرسل أي طلب إلى Blue Express.

للحصول على سعر مباشر، يجب أن يكون العنوان في تشيلي، مع منطقة ومدينة (بلدية). تطلب الإضافة أولًا من Blue Express التعرف على البلدية، ثم تطلب السعر للخدمة ومنطقة الإرسال والوجهة والطرود. ويُرسل كل منتج بوزنه وأبعاده المحوَّلة إلى كيلوغرام وسنتيمتر من فئتي الوزن والطول الخاصتين به. والمنتجات التي ليس لها وزن أو حجم تُرسل كـ 0.01 kg، 10 x 10 x 10 cm. وتُرسل القيمة المصرح بها بعملة CLP. ويُحوَّل سعر CLP إلى عملة المتجر الافتراضية، ويُقرَّب إلى منازله العشرية، ويُعرض للعميل بعملته مع ضريبة Tax class المختارة.

تُخزَّن الأسعار مؤقتًا لمدة ساعة، وبيانات البلديات لمدة تصل إلى 12 ساعة، من دون أن تتجاوز مدة التخزين المؤقت لدى OpenCart (ساعة واحدة افتراضيًا). ويُتذكَّر الطلب الفاشل لمدة 5 دقائق، والمهلة 10 ثوانٍ، حتى لا تُبطئ واجهة بطيئة أو غير متاحة كل تحديث لصفحة الدفع. ولا تُعرض أخطاء الواجهة على العميل أبدًا: إذ تُخفى الطريقة، أو يُستخدم السعر الثابت في وضع الاحتياط. ويُكتب السبب في السجل.

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

في OpenCart 4 ينقر العميل Choose في كتلة طريقة الشحن بصفحة الدفع، ويختار Blue Express أو Blue Express pickup point في نافذة Shipping method options. تعمل الخيارات بالطريقة نفسها كما في OpenCart 3؛ ويرد وصف مربع نقطة الاستلام في نقاط الاستلام.

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

عند تفعيل Pickup point option، يظهر مربع يحتوي على زر Choose pickup point أسفل Blue Express pickup point في خطوة Delivery Method من صفحة الدفع في OpenCart. يفتح الزر الخريطة الرسمية لـ Blue Express حيث يختار العميل نقطة. تظهر النقطة المختارة مع اسمها وعنوانها، ويتحول الزر إلى Change pickup point. تُحفظ النقطة لجلسة الدفع، ويُعاد حساب السعر بسعر الاستلام (PUDO) من Blue Express. وإذا تغير السعر، يعرض الخيار السعر الجديد. وإذا لم يعد الخيار متاحًا لتلك النقطة، تُعاد تحميل خطوة التوصيل. وإلى أن تُختار نقطة، يعرض الخيار سعر التوصيل إلى المنزل.

لا يستطيع العميل المتابعة دون نقطة: يُرفض Continue في خطوة التوصيل مع الرسالة Please choose a Blue Express pickup point. ويُتحقق من ذلك في المتصفح ثم من المتجر مرة أخرى. ويُرفض رمز النقطة غير المكتمل مع الرسالة The selected Blue Express pickup point is not valid. Please choose it again on the map.، ويبقى الاختيار السابق كما هو. وإذا فشل الحفظ، يرى العميل الرسالة The pickup point could not be saved. Please try again.

في OpenCart 4 ينقر العميل Choose في كتلة طريقة الشحن بصفحة الدفع. تعرض نافذة Shipping method options المربع نفسه مع Choose pickup point أسفل Blue Express pickup point ما دام هذا الخيار محددًا. وعندما يتغير السعر مع النقطة المختارة، يعرض الخيار داخل النافذة السعر الجديد، وإذا كان خيار الاستلام محفوظًا بالفعل للدفع، يتم تحديث حقل طريقة الشحن وكتلة تأكيد الطلب أيضًا. وإذا لم يعد الخيار متاحًا لتلك النقطة، تُغلق النافذة ويُعاد تحميل قائمة طرق الشحن. ويُمنع Continue في النافذة من دون نقطة مع الرسالة Please choose a Blue Express pickup point. داخل المربع، ويتحقق المتجر منها مرة أخرى. يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه عند كل تأكيد؛ وتُحدَّث نقطة الاستلام الخاصة بالطلب معه، وتُزال عند تغيير الطلب إلى طريقة شحن أخرى.

عند إتمام الطلب، تُحفظ النقطة في الطلب مع رمز وكالة Blue Express واسمها وعنوانها ومنطقتها. كما تُضاف إلى طريقة الشحن الخاصة بالطلب بعد اسم خيار الاستلام، مثل Blue Express pickup point: Blue Point Providencia, Av. Providencia 1234، ليراها العميل في رسائل الطلب البريدية وفي صفحات الطلبات في حسابه.

في صفحة الطلب في لوحة الإدارة (Sales > Orders، View) تظهر النقطة في اللوحة Blue Express pickup point مع رمزها ومنطقتها. وإذا لم تكن للطلب نقطة، تعرض اللوحة Not chosen. اضغط Edit لاختيار نقطة أخرى عبر Choose on the Blue Express map، أو لإدخال Agency code وName وAddress يدويًا، ثم اضغط Save pickup point. ويُحدَّث نص طريقة شحن الطلب أيضًا، ويُضاف التغيير إلى سجل الطلب دون إشعار العميل (Blue Express pickup point changed: الرمز القديم -> الرمز الجديد). ولا يتطلب تغيير النقطة إلا صلاحية تعديل الطلبات، لا الوصول إلى إعدادات الإضافة. وتحتفظ الطلبات الحالية ببيانات نقطة الاستلام الخاصة بها.

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

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox Blue Express هي أول كتلة في Extensions > Extensions > Shipping > VibeFox Blue Express > Edit، فوق الإعدادات. ألصق المفتاح في License key واضغط Activate. بعد ذلك تعرض الكتلة المفتاح مقنّعًا، والحالة (مثل التاريخ الذي ينتهي عنده الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها السطر Product: opencart-shipping-blue-express والرابط Manage licenses and domains in your account الذي يفتح حسابك في vibefox.net. ولا يستطيع تغيير المفتاح إلا المستخدمون المسؤولون الذين لديهم صلاحية التعديل لهذه الإضافة. وتتبع نصوص الكتلة لغة لوحة الإدارة (وتشمل الإنجليزية والروسية).

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

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

من دون ترخيص نشط لا يُعرض Blue Express للعملاء في صفحة الدفع ولا يُحسب أي سعر. ويرى مستخدم الإدارة الذي سجّل الدخول إلى الإدارة في المتصفح نفسه الطريقة في المتجر، مع العلامة (unlicensed — visible to admins only)، فيمكنك إعداد الإضافة واختبارها قبل شراء مفتاح. وبعد أن تفتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard الخاصة بالإدارة. اغلقه بالزر × لإخفائه لمدة 7 أيام. ولا تتأثر الطلبات الحالية.

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

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

لا يظهر Blue Express في صفحة الدفع: تحقق من أن الترخيص نشط وأن Enable/Disable (أو Pickup point option) مفعّل. اقرأ التحذيرات في أعلى صفحة الإضافة. تحقق من Geo zone (أو Ignore shipping zones وCountries)، وحدود الوزن، وMinimum order subtotal، وتحقق إذا كنت تستخدم الأسعار الثابتة أو الاحتياط من أن Fixed prices يحتوي على سطر للدولة. وتحقق من أن المنتجات لديها Requires Shipping على Yes.

لا تظهر الأسعار المباشرة: مع Blue Express API only تُخفى الخيارات عندما لا يوجد سعر. فعّل Debug log، وأعد تحميل صفحة الدفع، وانظر إلى حقل Log في صفحة الإضافة. الأسباب الشائعة: لا يوجد مفتاح واجهة، أو عملة متجر غير CLP من دون Exchange rate، أو منطقة أو بلدية ناقصة في العنوان، أو بلدية لا تتعرف عليها Blue Express، أو خطأ في الواجهة (مثل HTTP 401 أو 403 عند رفض مفتاح الواجهة). ومع Blue Express API, fixed price if the API gives no rate يحصل العملاء على السعر الثابت بينما تعالج المشكلة.

العناوين التشيلية لا تحتوي على منطقة: تعرض الصفحة تحذيرًا عن المناطق الناقصة. اضغط Add Chilean regions في صفحة الإضافة. ويحتاج العملاء الذين حُفظت عناوينهم دون منطقة إلى تعديل العنوان واختيار المنطقة.

تُضاف الضريبة فوق سعر Blue Express: أسعار Blue Express تشمل IVA. اضبط Tax class على None (no tax on shipping).

لا تُفتح الخريطة: تُحمَّل الخريطة في متصفح العميل من widget-pudo.blue.cl، لذلك يجب أن يكون هذا العنوان متاحًا وغير محظور في موقعك.

تبدو الأسعار قديمة بعد تغيير: اضغط Save في صفحة الإضافة. وهذا يمسح الأسعار المخزنة مؤقتًا وبيانات البلديات.

تقول الصفحة "Warning: You do not have permission to modify VibeFox Blue Express!": قد تكون مجموعة مستخدمي الإدارة لديك تملك صلاحية عرض الإعدادات فقط. امنح المجموعة صلاحية التعديل لـ extension/shipping/vfd_blue_express (OpenCart 3) أو extension/vfd_blue_express/shipping/vfd_blue_express (OpenCart 4) في System > Users > User Groups.

للمطورين: يمكن استبدال عناوين واجهة Blue Express وخريطتها بالإعدادين vfd_blex_api_url وvfd_blex_widget_url (للاختبارات)، وليس لهما حقول في صفحة الإعدادات.

الإزالة

انتقل إلى Extensions > Extensions، واختر النوع Shipping، واضغط Uninstall (الزر الأحمر −) بجوار VibeFox Blue Express. تُحذف مفاتيح الترخيص وحالة الترخيص لهذه الإضافة دائمًا. يعيد OpenCart دائمًا ضبط Sort order وTax class وGeo zone، وحالة الطريقة. تُحذف الأسعار المخزنة مؤقتًا دائمًا. وإذا كان Remove data on uninstall مفعّلًا، تُحذف إعدادات Blue Express والسجل أيضًا. وإذا كان معطلًا، تبقى الإعدادات الأخرى محفوظة وتُستخدم من جديد عند إعادة تثبيت الإضافة. ولا تُحذف نقاط الاستلام المحفوظة في الطلبات أبدًا، ويحتفظ نص طريقة شحن الطلبات الحالية بنقطة الاستلام.

لإزالة ملفات الإضافة أيضًا في OpenCart 4، انتقل بعد الإلغاء إلى Extensions > Installer، واضغط في قائمة الإضافات المثبتة Uninstall (الزر البرتقالي −) بجوار VibeFox Blue Express، ثم Delete (زر سلة المهملات الأحمر) لحذف الحزمة المرفوعة.

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