VibeFox The Courier Guy for OpenCart — المساعدة

المتطلبات

OpenCart: ‏3.0.x (تم الاختبار على 3.0.5.0) أو 4.0.2 والإصدارات الأحدث (تم الاختبار على 4.1.0.3).

PHP: ‏8.0 أو أحدث.

مفتاح API من ShipLogic (للتعرفات الفورية والخزانات): تعمل The Courier Guy على منصة ShipLogic. أنشئ مفتاح API في بوابة المندوبين الخاصة بـ The Courier Guy ضمن Settings > API Keys (حساب العمل). بدون المفتاح يُستخدم جدول الأسعار فقط، ولا يُعرض خيار الخزانة.

الشحن إلى جنوب أفريقيا: التعرفات الفورية والخزانات مخصصة للعناوين في جنوب أفريقيا فقط. يجب أن تكون جنوب أفريقيا دولة مفعّلة في المتجر (System > Localisation > Countries)، ويحتاج التعرف الفوري للمندوب إلى مقاطعات جنوب أفريقيا (المناطق)، وهي موجودة بالفعل في OpenCart 3.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. فعّل Courier to the door و/أو TCG locker، وأدخل API key من ShipLogic. للتعرفات الفورية، املأ عنوان المُرسِل (الشارع والمدينة والمقاطعة والرمز البريدي)، وإذا كانت عملة متجرك ليست ZAR فاملأ ZAR conversion rate.

6. املأ جدول الأسعار و/أو التكلفة الاحتياطية، ثم اضغط Save.

OpenCart 4

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

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

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

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

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Shipping > VibeFox The Courier Guy > Edit. تظهر الأقسام في القائمة على اليسار. يحفظ زر Save واحد في الأسفل الصفحة كاملةً دون إعادة تحميلها. يؤدي كل حفظ إلى مسح التعرفات والخزانات المخزنة مؤقتًا وآخر خطأ من ShipLogic. لا يستطيع حفظ الإعدادات إلا المستخدمون المسؤولون الذين يملكون إذن التعديل لهذه الإضافة.

إذا كان اسم الخيار أو فئة الضريبة أو ترتيب الفرز أو المنطقة الجغرافية غير صالح، فلن يُحفظ شيء وتعرض الصفحة السبب، مثل Enter a valid option name (1-64 characters, without < > ; = # { }). لا يُحفظ الرقم غير الصالح (مثل السالب): تشير الصفحة إلى الحقل وتحتفظ بقيمته السابقة، ويُحفظ الباقي. طالما أن خيارًا واحدًا على الأقل مفعّل، تخبرك التحذيرات في أعلى الصفحة إذا لم تكن جنوب أفريقيا دولةً مفعّلة، أو إذا كان مفتاح API مفقودًا، أو سعر تحويل ZAR أو عنوان المُرسِل مفقودًا، أو لا يوجد جدول أسعار ولا تكلفة احتياطية، أو لا توجد مناطق (مقاطعات) لجنوب أفريقيا، أو إذا فشل آخر طلب إلى ShipLogic (مع تاريخه وخطئه). يظهر تحذير أيضًا إذا لم يكن في المتجر فئة وزن بوحدة kg أو فئة طول بوحدة cm.

عام

كل نوع توصيل هو خيار مستقل عند الدفع.

Courier to the door: يقدم توصيل The Courier Guy بالمندوب إلى عنوان العميل. الافتراضي: مُعطّل.

Courier option name: اسم خيار المندوب عند الدفع. الافتراضي: The Courier Guy. مطلوب، بحد أقصى 64 حرفًا، دون < > ; = # { }.

TCG locker: يختار العميل خزانة استلام عند الدفع. يُعرض فقط للعناوين في جنوب أفريقيا، وفقط مع مفتاح API من ShipLogic. الافتراضي: مُعطّل.

Locker option name: اسم خيار الخزانة عند الدفع. الافتراضي: The Courier Guy locker. تنطبق القواعد نفسها المطبّقة على اسم المندوب.

Tax status: فئة الضريبة لكلا الخيارين. مع فئة ضريبية تُؤخذ التعرفات الفورية بدون ضريبة القيمة المضافة، ويضيف OpenCart ضريبة الفئة. None (live rates including VAT) (الافتراضي): تُؤخذ التعرفات الفورية شاملةً ضريبة القيمة المضافة.

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

واجهة ShipLogic API

API key: مفتاح API الخاص بك من ShipLogic من بوابة The Courier Guy. لا يُعرض للعملاء أبدًا ولا يُكتب في السجل. بعد الحفظ يبقى الحقل فارغًا ويعرض Saved - leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييره. ضع علامة على Remove the saved API key واحفظ لحذفه.

Account ID: اختياري. معرّف الحساب الرقمي في ShipLogic، ولا يلزم إلا إذا كان مفتاحك يصل إلى عدة حسابات. لا تُحفظ القيمة غير الرقمية.

التعرفات الفورية (لعناوين جنوب أفريقيا؛ إذا لم تتوفر تعرفة فورية يُستخدم جدول الأسعار)

التعرفة الفورية هي أرخص خدمة من ShipLogic من عنوان المُرسِل إلى عنوان العميل (مندوب)، أو إلى الخزانة الأقرب إلى مدينة العميل (خزانة). تحتاج إلى مفتاح API وعنوان المُرسِل، وإلى سعر تحويل إذا كان متجرك لا يستخدم الراند.

Price source: مصدر السعر.

ZAR conversion rate: تُسعّر ShipLogic بالراند الجنوب أفريقي (ZAR). إذا لم تكن عملة متجرك الافتراضية ZAR، فأدخل قيمة 1 ZAR بعملتك، مثل 0.05. يجب أن تكون القيمة أكبر من 0. بدونها لا تُستخدم التعرفات الفورية، ويُطبَّق جدول الأسعار. إذا كانت عملة متجرك ZAR، فاتركه فارغًا. لا يُحدَّث السعر تلقائيًا.

عنوان المُرسِل (المكان الذي تستلم منه The Courier Guy الطرود في جنوب أفريقيا)

عنوان المتجر في OpenCart نص حر، لذلك يُدخل عنوان المُرسِل هنا. الشارع والمدينة والمقاطعة والرمز البريدي مطلوبة للتعرفات الفورية.

Sender company: اسم شركتك.

Sender street address: مثل 12 My Road.

Sender suburb: الحي الذي يقع فيه عنوان المُرسِل.

Sender city: المدينة التي يقع فيها عنوان المُرسِل.

Sender province: اختر إحدى المقاطعات التسع في جنوب أفريقيا من القائمة.

Sender postal code: الرمز البريدي لعنوان المُرسِل.

جدول الأسعار (أسعارك الخاصة بعملة المتجر الافتراضية، دون الضرائب: يُستخدم مع Price table only، وخارج جنوب أفريقيا، وفي كل حالة لا تتوفر فيها تعرفة فورية؛ يُقبل الفاصل العشري بالفاصلة أو النقطة)

Calculation type: ينطبق على جدول الأسعار فقط. التعرفة الفورية تُحسب دائمًا للطلب كله.

Prices by weight: جدول دول، يحتوي على عمود Price وفئات الوزن XS (حتى 1 kg)، وS (حتى 2 kg)، وM (حتى 3 kg)، وL (حتى 5 kg)، وXL (أكثر من 5 kg). اضغط Add row لإضافة صف (يبدأ الصف الجديد بجنوب أفريقيا)، واضغط زر الحذف لإزالة صف. تستخدم الفئة الفارغة أو التي قيمتها 0 عمود Price. السعر 0 يعني شحنًا مجانيًا. ينطبق الصف * Any country على الدول التي لا يوجد لها صف خاص، وعلى صف دولة بلا أي سعر. يُمسح السعر الذي ليس رقمًا، وتسرده الصفحة.

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

الشروط (كلا الخيارين)

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

Max weight (kg): يخفي الخيارات أعلى من وزن السلة هذا. الافتراضي: 30. القيمة 0 تعني بلا حد، والفارغ يعني 30 kg. إذا كانت Min weight (kg) أكبر من Max weight (kg)، تعرض الصفحة تحذيرًا وتحتفظ الحدّان بقيمهما السابقة.

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

Free shipping from: مجموع السلة الفرعي الذي يصبح عنده التوصيل مجانيًا. اتركه فارغًا لعدم تقديم شحن مجاني أبدًا. عندما يبلغ المجموع الفرعي هذا الحد، تُعرض الخيارات بسعر 0 ولا يُرسل أي طلب إلى ShipLogic للتعرفة.

التوفر

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

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

Delivery type without zones: Courier to the door (الافتراضي) أو TCG locker (customer chooses a locker). يُستخدم فقط مع Ignore shipping zones. النوع الآخر ما زال يخضع لـ Geo zone.

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

متقدم

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

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

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

استيراد / تصدير

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

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

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

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

Courier to the door: تطلب الإضافة من ShipLogic أرخص خدمة من عنوان المُرسِل إلى عنوان العميل. يجب أن يتضمن العنوان شارعًا ومدينة ومقاطعة ورمزًا بريديًا. وحتى ذلك الحين يُستخدم جدول الأسعار.

TCG locker: التعرفة الفورية هي أرخص خدمة من الباب إلى الخزانة، وصولًا إلى الخزانة الأقرب إلى مدينة العميل. لا تُعاد حسابها للخزانة التي يختارها العميل. يظهر خيار الخزانة فقط للعناوين في جنوب أفريقيا وفقط مع مفتاح API.

يُقدَّم الطلب كله بوصفه طردًا واحدًا: الوزن الإجمالي، وأطول طول وعرض، والارتفاعات مكدسة. تُعامل المنتجات التي لا أبعاد لها كمكعبات طول ضلعها 10 cm. تُحوَّل الأوزان والأبعاد من فئات الوزن والطول الخاصة بالمنتجات. يُحوَّل مبلغ الراند إلى عملة المتجر الافتراضية، ويُقرَّب إلى منازلها العشرية، ويُعرض للعميل بعملته مع ضريبة الفئة الضريبية المختارة.

تنتهي مهلة طلبات ShipLogic بعد 12 ثانية. تُخزَّن التعرفات مؤقتًا لمدة ساعة، والخزانات لمدة 6 ساعات، والأخطاء لمدة 10 دقائق، حتى لا تُبطئ واجهة API البطيئة كل تحديث للدفع. إذا لم تكن هناك تعرفة فورية، يأتي السعر من الجدول، ثم من Fallback cost. إذا لم ينطبق أيٌّ منهما، يُخفى الخيار. لا تُعرض أخطاء API للعميل أبدًا.

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

في OpenCart 4، يضغط العميل Choose في كتلة طريقة الشحن عند الدفع، ويختار خيار المندوب أو الخزانة في نافذة Shipping method options. تعمل الطريقة بالطريقة نفسها في OpenCart 3.

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

عندما يختار العميل خيار الخزانة في خطوة طريقة الشحن، يظهر تحته محدد للخزانات: حقل بحث (افتراضيًا مدينة عنوان التوصيل) وقائمة بالخزانات مع الاسم والعنوان ساعات العمل. يمكن للعميل كتابة مدينة أو حي أو رمز بريدي آخر والضغط على Search. يجب اختيار خزانة قبل أن يتابع العميل، وإلا تعرض الخطوة Please choose a The Courier Guy locker.

تُتحقق الخزانة على الخادم مقابل قائمة ShipLogic عندما يتابع العميل، ومرة أخرى عند تقديم الطلب. يُؤخذ اسمها ومزودها من ShipLogic، لا من المتصفح أبدًا. ينتمي الاختيار إلى دولة المدينة أو الرمز البريدي للعنوان: إذا تغيّر عنوان التوصيل، يختار العميل من جديد.

إذا تعذّر الوصول إلى ShipLogic، يعرض المحدد: Lockers cannot be loaded right now. You can place the order without choosing one - the store will contact you about the locker. يمكن بعد ذلك تقديم الطلب بدون خزانة. ويُعلَّم الطلب في صفحة الطلب في الإدارة: Not chosen - ShipLogic was unavailable at checkout. Agree the locker with the customer.

في OpenCart 4 يظهر محدد الخزانات في نافذة Shipping method options، أسفل خيار الخزانة، ويُعاد تحميله في كل مرة تُفتح فيها النافذة، لأن العنوان قد يتغير في الدفع في صفحة واحدة. زر Continue في النافذة لا يتابع دون خزانة من القائمة، ويعرض الرسالة نفسها، ولا يمنع عدم توفر ShipLogic الطلب أيضًا. يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه في كل مرة يؤكد فيها العميل مجددًا، ويُحدَّث معه أيضًا الخزانة الخاصة بالطلب.

الطلبات

تُضاف الخزانة المختارة إلى طريقة شحن الطلب، مثل "The Courier Guy locker: الاسم — العنوان". يظهر هذا النص في Sales > Orders، وفي صفحة الطلب الخاصة بالعميل، وفي الفاتورة، وفي رسائل البريد الإلكتروني للطلب.

تحتوي صفحة الطلب في Sales > Orders على لوحة The Courier Guy فوق السجل لكل طلب شُحن عبر The Courier Guy. بالنسبة لطلب الخزانة تعرض اسم الخزانة ومعرّفها ومزودها، مع not verified (ShipLogic was unavailable at checkout) عندما تعذّر التحقق من الخزانة، أو رسالة Not chosen عندما لم يكن ShipLogic متاحًا. تظهر اللوحة حتى أثناء تعطيل الإضافة.

The Courier Guy tracking reference: احجز الطرد في بوابة The Courier Guy الخاصة بك، وأدخل مرجعه في هذا الحقل من اللوحة، واضغط Save. أفرغ الحقل واحفظ لحذفه. يرى المستخدمون المسؤولون الذين لا يملكون إذن تعديل الطلبات المرجع للقراءة فقط. يرى العميل المرجع في صفحة الطلب ضمن حسابه (للعملاء المسجلين) وفي رسائل حالة الطلب عندما تُبلغ العميل. لا يحتوي بريد الطلب الجديد على المرجع، لأنه يُدخَل لاحقًا.

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

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

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

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

من دون مفتاح نشط لا يُعرض أيٌّ من خياري The Courier Guy (التوصيل بالمندوب إلى الباب أو TCG locker) للعملاء عند الدفع، ولا تُحسب أي تعرفة. يرى المسؤول الذي سجّل الدخول إلى لوحة الإدارة في المتصفح نفسه الخيارات في المتجر، مع (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. في OpenCart 4 لا تتوفر هذه المعاينة: لا يرى المتجر تسجيل دخول الإدارة، لذلك من دون مفتاح نشط تُخفى الخيارات عن الجميع. بعد أن تفتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard الإدارة. أغلقه بـ × ليختفي لمدة 7 أيام. الطلبات الحالية لا تتأثر.

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

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

The Courier Guy does not appear at checkout: تحقق من أن الترخيص نشط وأن الخيار مفعّل (Courier to the door أو TCG locker). تحقق من Geo zone (أو Ignore shipping zones وCountries)، وحدود الوزن، وMinimum order amount. تحقق من أن الجدول أو Fallback cost يتضمن سعرًا. تحقق من أن المنتجات لديها Requires Shipping بقيمة Yes. يظهر خيار الخزانة فقط للعناوين في جنوب أفريقيا ومع مفتاح API.

Customers see no locker list: تحتاج الخزانات إلى مفتاح API وTCG locker مفعّل وعنوان توصيل في جنوب أفريقيا. تعرض صفحة الإعدادات آخر خطأ من ShipLogic إن وُجد، مثل مفتاح مرفوض.

The price is always the table price: تحقق من التحذيرات في صفحة الإعدادات. تحتاج التعرفة الفورية إلى مفتاح API وعنوان مُرسِل كامل، وإلى سعر تحويل ZAR إذا كان المتجر لا يستخدم الراند. في التوصيل بالمندوب يحتاج عنوان العميل إلى شارع ومدينة ومقاطعة (منطقة) ورمز بريدي. بالنسبة للخزانات يجب أن يجد ShipLogic خزانة قرب مدينة العميل. فعّل Debug log، وأعد تحميل صفحة الدفع، وانظر إلى حقل Log في صفحة الإضافة.

ShipLogic is down: يُعرض سعر الجدول أو السعر الاحتياطي. يمكن تقديم طلبات الخزانة دون خزانة، ويُعلَّم الطلب.

Rates look outdated after a change: اضغط Save في صفحة الإضافة. يؤدي ذلك إلى مسح التعرفات والخزانات المخزنة مؤقتًا.

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

For developers: يمكن استبدال عنوان ShipLogic API بالإعداد vfd_tcgr_api_url (للاختبارات)؛ وليس له حقل في صفحة الإعدادات.

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

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

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

The Courier Guy وShipLogic علامتان تجاريتان لمالكيهما. هذه الإضافة غير تابعة لـ The Courier Guy أو ShipLogic ولا تحظى بتأييدهما.