VibeFox Jadlog for OpenCart — المساعدة

المتطلبات

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

PHP: 8.0 أو أحدث.

عقد Jadlog (للأسعار الفورية ونقاط الاستلام): تأتي الأسعار الفورية وقائمة نقاط الاستلام من واجهة Jadlog Embarcador. وتمنح امتيازتك لدى Jadlog الوصول بعد توقيع العقد. تحتاج إلى رمز Embarcador للواجهة، ورقم CNPJ (أو CPF) للمُرسِل المسجَّل في العقد، والحساب الجاري (conta corrente)، ورقم العقد إن كان لديك. وإذا كنت تستخدم الأسعار الثابتة فقط، فلا تحتاج إلى عقد مع Jadlog.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. ألصق رمز API، وأدخل رقم CNPJ والحساب الجاري ورقم العقد ورمز CEP للمصدر، واختر خدمة Jadlog، وإذا لم تكن عملة المتجر الافتراضية BRL فأدخل سعر صرف BRL. وأضف أسعاراً ثابتة أو تكلفة احتياطية إن أردت (انظر الإعداد).

6. فعّل Enable Jadlog home delivery أو Enable Jadlog Pickup أو كليهما، واضغط Save.

OpenCart 4

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

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

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

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

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

الإعداد

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

تعرض الإضافة في أعلى الصفحة تحذيرات لإعداد غير مكتمل: لا يوجد رمز API (تُستخدم الأسعار الثابتة فقط، ولا يمكن عرض نقاط الاستلام)، ولا يوجد رمز API ولا أسعار ثابتة (لا تُعرض الطريقة أبداً)، ولا يوجد رقم CNPJ أو حساب جارٍ، ولا يوجد رمز CEP للمصدر، ولا يوجد سعر صرف BRL لمتجر لا يبيع بالريال، ولا توجد فئة وزن "kg" أو فئة طول "cm" في المتجر (وعندها تُحوَّل الأوزان والأبعاد وفق اسم وحدة فئتها؛ تحقق من System > Localisation > Weight Classes وLength Classes).

عند الحفظ، يوقف الحفظ بخطأ أي عنوان غير صالح لأحد الخيارين (فارغ، أو أطول من 64 حرفاً، أو يحتوي على < > ; = # { })، أو Sort order ليس عدداً صحيحاً، أو فئة ضريبة أو منطقة جغرافية غير موجودة. أما القيم الخاطئة الأخرى فتُحفظ مع ملاحظة فوق الإعدادات: لا يُحفظ العدد غير الصالح أو الأصغر من 0، ويُبقي الوزن الأدنى الأكبر من الوزن الأقصى الوزنين المحفوظين، ويُمسح سعر صرف BRL إذا لم يكن عدداً موجباً، ويُحفظ رمز CEP الذي لا يحتوي على 8 أرقام أو رقم CNPJ الذي لا يحتوي على 14 رقماً (أو 11 لـ CPF) كما كُتب مع تحذير، وفي جدول الأسعار يُحذف الصف ذو البلد غير المعروف ويُترك السعر غير الصالح فارغاً.

عام

لدى Jadlog خياران للتوصيل: Jadlog home delivery (هذا القسم) و Jadlog Pickup (قسم خاص به). وتنطبق الإعدادات في هذه الصفحة على الخيارين.

Enable Jadlog home delivery: يعرض التوصيل عبر Jadlog إلى عنوان العميل بالخدمة المختارة أدناه. الافتراضي: off.

Method title: اسم خيار التوصيل إلى المنزل الذي يراه العميل عند إتمام الشراء. الافتراضي: Jadlog. حقل مطلوب، بحد أقصى 64 حرفاً.

Sort order: ترتيب Jadlog بين طرق الشحن عند إتمام الشراء. عدد صحيح.

Tax class: فئة الضريبة على تكلفة الشحن، أو No tax (الافتراضي). أسعار Jadlog هي أسعار ناقل نهائية. اختر No tax إذا كان ينبغي ألا يضيف OpenCart عليها ضريبة. وينطبق على الخيارين.

أسعار Jadlog الفورية

تُطلب الأسعار الفورية فقط للعناوين في البرازيل التي تحتوي على رمز CEP مكوَّن من 8 أرقام كاملة.

API token: رمز Embarcador من Jadlog. يمكنك لصقه مع كلمة "Bearer" أو بدونها. اتركه فارغاً لاستخدام الأسعار الثابتة فقط. وبعد الحفظ يبقى الحقل فارغاً ويعرض Saved - leave empty to keep it. أدخل قيمة جديدة فقط لتغييرها. وعندما لا يكون هناك رمز محفوظ تعرض الصفحة No token saved.

Remove the saved API token: فعّله واضغط Save لحذف الرمز المحفوظ.

CNPJ: رقم CNPJ (14 رقماً) أو CPF (11 رقماً) للمُرسِل المسجَّل في عقد Jadlog، مثل 00.000.000/0000-00.

Current account (conta corrente): رقم حسابك الجاري لدى Jadlog. من دونه ومن دون CNPJ لا تستطيع Jadlog تقديم عرض سعر، ولا تُستخدم إلا الأسعار الثابتة.

Contract number: رقم عقد Jadlog الخاص بك، إذا كانت امتيازتك قد منحتك واحداً.

Origin CEP: الرمز البريدي الذي تُشحن منه الطرود، 8 أرقام (00000-000). مطلوب للأسعار الفورية: لا يوجد في OpenCart رمز بريدي للمتجر، لذلك من دون هذا الحقل تُستخدم الأسعار الثابتة فقط.

Jadlog service: الخدمة (modalidade) في عقدك للتوصيل إلى المنزل: .Package (3، الافتراضي)، .Com (9)، Expresso (0)، Rodoviário (4)، Econômico (5)، Doc (6)، Corporate (7)، Internacional (10)، Cargo (12) أو Emergencial (14). و Jadlog Pickup (40) هو الخيار الثاني.

Insurance type: Normal (N) (الافتراضي) أو Own insurance policy (A - apolice)، حسب ما هو متفق عليه في عقد Jadlog.

Volumetric weight: تحتسب Jadlog الوزن الأكبر بين الوزن الفعلي والوزن الحجمي.

BRL exchange rate: تُقدِّم Jadlog أسعارها بالريال البرازيلي. إذا كانت عملة المتجر الافتراضية BRL فلا حاجة لهذا الحقل. وخلاف ذلك أدخل قيمة 1 BRL بعملة المتجر الافتراضية، مثل 0.16. ويُضرب سعر Jadlog في هذا السعر، وتُحوَّل قيمة الطلب المُصرَّح بها والمرسلة إلى Jadlog مرة أخرى إلى BRL. ومن دون السعر لا تُستخدم الأسعار الفورية، وتنطبق الأسعار الثابتة فقط.

Delivery time: يعرض مدة التوصيل التي تُرجعها Jadlog عند إتمام الشراء، بجانب عنوان التوصيل إلى المنزل (مثل "Jadlog (3 business days)")، وبجانب كل نقطة استلام. وهو مفعّل افتراضياً. وتُحفظ مدة التوصيل دائماً مع الطلب.

Jadlog Pickup

خيار توصيل ثانٍ بالخدمة Jadlog Pickup (40). ويحتاج إلى رمز API. ومن دون نقاط يكون الخيار مخفياً.

Enable Jadlog Pickup: يعرض التوصيل إلى نقطة Jadlog Pickup التي يختارها العميل عند إتمام الشراء. الافتراضي: off.

Jadlog Pickup title: اسم هذا الخيار عند إتمام الشراء. الافتراضي: Jadlog Pickup. حقل مطلوب، بحد أقصى 64 حرفاً.

Points to show: عدد نقاط الاستلام المعروضة، من 1 إلى 10. الافتراضي: 5.

أسعار ثابتة (تُستخدم عندما لا يوجد رمز API، وللبلدان التي لا تخدمها Jadlog، وكلما لم تُرجع Jadlog أي سعر)

Price per country: جدول بالأعمدة Country و Price و XS و S و M و L و XL، بعملة المتجر الافتراضية. اضغط Add country لإضافة صف، وزر × لحذف صف. يُختار عمود الحجم بحسب وزن السلة: XS حتى 1 كغ، و S حتى 2 كغ، و M حتى 3 كغ، و L حتى 5 كغ، و XL أكثر من 5 كغ. ويُستخدم Price عندما يكون عمود الحجم فارغاً. والسعر 0 يعني شحناً مجانياً لذلك البلد. استخدم * Default (other countries) لجميع البلدان الأخرى.

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

Fixed price applies: يحصّل Per order (الافتراضي) السعر مرة واحدة. ويضربه Per item (price x quantity) في عدد العناصر في السلة. وينطبق هذا على الأسعار الثابتة والتكلفة الاحتياطية فقط. وأسعار Jadlog تغطي السلة كاملة أصلاً.

الشروط

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

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

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

Free shipping from: المجموع الفرعي (بعد القسيمة، وقبل الضريبة) الذي يصبح عنده التوصيل مجانياً. اتركه فارغاً حتى لا يكون هناك شحن مجاني.

التوفر

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

Ignore shipping zones: عند التفعيل لا تُفحص Geo zone، وتُعرض Jadlog للبلدان المذكورة أدناه. وعند الإيقاف (الافتراضي) تُطبَّق Geo zone فقط.

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

متقدم

Debug log: يسجل كل طلب واستجابة من Jadlog في storage/logs/vfd_jdlg_debug.log.php (في OpenCart 4 system/storage/logs/vfd_jdlg_debug.log.php). لا يمكن قراءة الملف من الويب. وتُسجَّل أخطاء API وطلبات Jadlog Pickup التي لا تحتوي على نقطة دائماً، حتى عندما يكون هذا الخيار معطلاً. ولا تُسجَّل الرموز و CNPJ والحساب أبداً، ويُختصر رمز CEP للعميل. أوقف السجل عندما تنتهي.

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

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

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

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

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

كيف يعمل عند إتمام الشراء

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

لعنوان توصيل في البرازيل يحتوي على رمز CEP مكوَّن من 8 أرقام كاملة، ترسل الإضافة إلى Jadlog رمز CEP للمصدر والوجهة، والوزن، ورقم CNPJ الخاص بك، والحساب الجاري، والعقد، والخدمة، ونوع التأمين، وقيمة الطلب المُصرَّح بها. تُحوَّل أوزان المنتجات من فئة الوزن في OpenCart إلى كغ، والأبعاد من فئة الطول إلى سم. وتُسعَّر السلال بلا وزن على أنها 0.1 كغ. ويُحوَّل السعر المُعاد إلى عملة المتجر الافتراضية، ويُقرَّب إلى منازله العشرية، ويُعرض بعملة العميل مع ضريبة Tax class المختارة. وإذا لم يوجد سعر فوري (لا يوجد رمز، أو عنوان خارج البرازيل، أو رمز CEP غير مكتمل، أو لا يوجد سعر صرف BRL، أو خطأ من Jadlog)، تستخدم الإضافة جدول Price per country، ثم Fallback cost. وإذا لم يعطِ أي منها سعراً، يُخفى الخيار لتلك السلة.

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

على OpenCart 4 ينقر العميل على Choose في كتلة طريقة الشحن في صفحة إتمام الشراء، ويختار خيار Jadlog في النافذة Shipping method options. والأسعار هي نفسها في OpenCart 3.

تحسب الإضافة الأسعار وتعرض نقاط الاستلام فقط. ولا تنشئ شحنات Jadlog، ولا تطبع الملصقات، ولا تطلب الاستلام من المنزل، ولا تلغي الشحنات، ولا تتتبع الطرود. ولا تعرض خريطة لنقاط الاستلام، ولا تطلب من Jadlog عروض أسعار دولية. استخدم الأسعار الثابتة للبلدان الأخرى.

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

لا يُعرض خيار Jadlog Pickup إلا للعناوين في البرازيل، وفقط عندما تكون Enable Jadlog Pickup مفعّلة ويكون رمز API محفوظاً. وعندما يُدخل العميل رمز CEP مكوناً من 8 أرقام كاملة، تطلب الإضافة من Jadlog أقرب نقاط الاستلام النشطة إليه، وتعرض تحت الخيار حتى Points to show نقطة، ولكل منها سعرها، مثل "اسم النقطة — السعر (3 business days) — العنوان". وإذا لم تكن القائمة مخزنة مؤقتاً بعد، تُحمَّل في الخلفية عندما يختار العميل Jadlog Pickup، حتى لا تنتظر خطوة طريقة التوصيل Jadlog.

يُطلب سعر كل نقطة من Jadlog. وإذا لم تعطِ Jadlog سعراً لنقطة، يُستخدم السعر الثابت، وتُستبعد النقطة التي لا يوجد لها أي سعر. وتُخزَّن قوائم النقاط مؤقتاً لمدة 12 ساعة. وسعر الخيار هو سعر النقطة المختارة. وقبل اختيار نقطة يكون السعر هو سعر أقرب نقطة لها سعر. وبعد أن يختار العميل نقطة، يُحدَّث السعر المعروض بجانب Jadlog Pickup.

النقطة مطلوبة. وعندما يضغط العميل Continue في خطوة طريقة التوصيل دون اختيار نقطة، يرى Please select a Jadlog Pickup point. وتتحقق الإضافة على الخادم من أن النقطة موجودة في قائمة Jadlog لرمز CEP التوصيل. وإذا لم تكن موجودة، يرى العميل The selected Jadlog Pickup point is not in the Jadlog list for this CEP. Please choose the point again. وعندما يكون رمز CEP غير مكتمل، أو لا توجد نقاط قريبة، أو تكون Jadlog غير متاحة، تظهر رسالة تحت الخيار.

من دون رمز API، أو عندما تكون Jadlog غير متاحة، أو عندما لا توجد نقاط نشطة قريبة، يُخفى خيار Jadlog Pickup. فالطلب الذي لا يحتوي على نقطة لا يمكن شحنه.

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

الطلبات

عند تقديم طلب بأحد خيارات Jadlog، تحفظ الإضافة خدمة Jadlog، وإذا أرجعتها Jadlog فتحفظ أيضاً مدة التوصيل بأيام العمل. وبالنسبة لطلب Jadlog Pickup تحفظ أيضاً اسم النقطة وعنوانها ومعرّفها. ويحتفظ OpenCart 4 بطلب واحد لإتمام الشراء ويحدّثه في كل مرة يؤكد فيها العميل مجدداً، وتُحدَّث بيانات Jadlog الخاصة بالطلب معه. وإذا حوّل العميل ذلك الطلب إلى طريقة شحن أخرى، تُحذف بيانات Jadlog الخاصة به.

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

تعرض صفحة الطلب في الإدارة (Sales > Orders) لوحة Jadlog تتضمن Jadlog service وDelivery time، وبالنسبة إلى Jadlog Pickup تتضمن أيضاً Pickup point وPickup point address وPickup point ID. وفي OpenCart 4 تظهر اللوحة فوق قسم History.

احجز الشحنة في نظام Jadlog بنفسك. ويعرض الطلب الخدمة ومعرّف نقطة الاستلام اللذين تحتاجهما لذلك.

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

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox Jadlog هي الكتلة الأولى في Extensions > Extensions > Shipping > VibeFox Jadlog > Edit، فوق الإعدادات. أدخل المفتاح في License key واضغط Activate. وبعد ذلك تعرض الكتلة المفتاح مُخفى، والحالة (مثل تاريخ انتهاء الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها سطر Product: opencart-shipping-jadlog ورابط 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.

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

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

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

لا يظهر Jadlog عند إتمام الشراء: تأكد من أن الترخيص نشط وأن Enable Jadlog home delivery (أو Enable Jadlog Pickup) مفعّل. تحقق من Geo zone، أو فعّل Ignore shipping zones وتحقق من Countries. تحقق من التحذيرات أعلى صفحة الإضافة، وحدود الوزن، وMinimum order amount، ومن أن المنتجات مضبوطة على Yes في Requires Shipping. وإذا لم يُدخل العميل بعد رمز CEP مكوَّناً من 8 أرقام كاملة، فلا يمكن استخدام إلا الأسعار الثابتة، لذلك أضف صفاً في Price per country أو Fallback cost.

لا تظهر إلا الأسعار الثابتة: فعّل Debug log، وأعد تحميل صفحة إتمام الشراء، وانظر إلى حقل Log في صفحة الإضافة. سيعرض السبب: لا يوجد CNPJ أو حساب جارٍ، أو لا يوجد رمز CEP للمصدر، أو رمز CEP الوجهة غير مكتمل، أو لا يوجد سعر صرف BRL، أو رسالة خطأ Jadlog.

HTTP 401 أو 403 في السجل: رفضت Jadlog رمز API. تحقق منه مع امتيازتك لدى Jadlog. يتوقف استخدام الواجهة مؤقتاً لمدة 10 دقائق بعد هذا الخطأ. ويؤدي حفظ الإعدادات إلى إلغاء التوقف، فيمكنك المحاولة من جديد فوراً.

لا تظهر نقاط الاستلام: يحتاج خيار Jadlog Pickup إلى Enable Jadlog Pickup ورمز API ورمز CEP مكوَّن من 8 أرقام كاملة في البرازيل. وإذا لم تكن لدى Jadlog نقاط نشطة قرب رمز CEP، فيُخفى الخيار. تحقق من السجل لمعرفة السبب.

الأسعار بالريال بدلاً من عملتي: أدخل BRL exchange rate (كم يساوي 1 BRL بعملة المتجر الافتراضية).

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

تُضاف الضريبة إلى أسعار Jadlog: اضبط Tax class على No tax.

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

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

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

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

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

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