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

المتطلبات

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

PHP: 8.0 أو أحدث، مع امتداد cURL. امتداد SOAP في PHP غير مطلوب.

Purolator E-Ship Web Services (للأسعار الفورية فقط): سجّل في E-Ship Web Services عبر Purolator E-Ship Resource Centre على موقع Purolator. تُصدر Purolator مفاتيح وكلمات مرور منفصلة لبيئتي التطوير والإنتاج. كما تحتاج إلى رقم حساب الفوترة الخاص بك لدى Purolator والرمز البريدي الكندي الذي ترسل منه. إذا كنت تستخدم الأسعار الثابتة فقط، فلا تحتاج إلى مفاتيح API.

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

التثبيت

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

OpenCart 3

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

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

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

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

5. للأسعار الفورية، املأ قسم Purolator API (live rates): مفتاح API، وكلمة المرور، ورقم حساب الفوترة، والرمز البريدي الكندي لمكان الإرسال، وإذا لم تكن عملة متجرك CAD، فسعر صرف CAD. للاختبار، فعّل Development environment مع مفتاح التطوير. املأ Country prices أو Fallback price إذا أردت أسعارًا ثابتة أو بديلًا (انظر الإعدادات). فعّل Enable Purolator وانقر Save.

OpenCart 4

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

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

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

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

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

الإعدادات

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

إذا لم تستطع الأسعار الفورية العمل بالقيم المحفوظة (مفتاح أو كلمة مرور أو حساب فوترة مفقود، أو لا يوجد رمز بريدي كندي لمكان الإرسال، أو لا يوجد سعر صرف CAD)، أو لم يكن هناك لا بيانات API ولا أسعار ثابتة، يظهر تحذير في قسم General. ويوضح التحذير أيضًا ما إذا كانت الأسعار الثابتة تُستخدم في الأثناء أم أن الطريقة مخفية. ويظهر تحذير أيضًا إذا كانت وحدة وزن المتجر غير معروفة للإضافة. عندها تُقرأ أوزان المنتجات بالكيلوغرام؛ أضف فئة وزن بوحدة kg في System > Localisation > Weight Classes.

لا يُحفظ حقل الرقم الذي لا يحتوي على رقم يساوي 0 أو أكبر. وتذكر رسالة تظهر بعد Save الحقل والقيمة. يبقى الحقل فارغًا، أو يأخذ قيمته الافتراضية في حقول الوزن. وتُحفظ القيمة الخاطئة في Country prices بالقيمة 0، وتذكر الرسالة البلد والعمود. ولا يُحفظ شيء ويظهر خطأ إذا كان عنوان الطريقة فارغًا أو أطول من 64 حرفًا، أو إذا كان Min cart weight (kg) أكبر من Max cart weight (kg)، أو إذا لم يكن ترتيب العرض عددًا صحيحًا، أو إذا كانت فئة الضريبة أو المنطقة الجغرافية غير صالحة.

عام

يرى العميل سعر Purolator واحدًا. تنطبق الإعدادات على كل منطقة جغرافية. ويمكنك قصر الطريقة على منطقة جغرافية أو على دول في Availability.

Enable Purolator: يعرض Purolator عند الدفع أو يخفيه. الافتراضي: معطّل.

Method title: اسم طريقة الشحن الذي يراه العميل عند الدفع. الافتراضي: Purolator. مطلوب، 64 حرفًا كحد أقصى.

Tax class: فئة الضريبة لتكلفة الشحن، أو No tax (الافتراضي). وهي تحدد ما إذا كان المتجر يضيف ضريبة فوق السعر. بالنسبة إلى العناوين الكندية يتضمن إجمالي Purolator بالفعل GST/HST/PST/QST. انظر أدناه Canadian sales taxes.

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

واجهة Purolator API (الأسعار الفورية)

عند تعبئة مفتاح API وكلمة المرور وحساب الفوترة، يأتي السعر من خدمة الويب Purolator E-Ship Estimating (Quick Estimate، حسب إجمالي وزن السلة). وإذا لم تُرجع Purolator سعرًا، يُستخدم السعر الثابت، أو تُخفى الطريقة إذا لم يوجد سعر ثابت. ويتضمن القسم رابطًا إلى Purolator E-Ship Resource Centre حيث تسجّل وتحصل على المفاتيح. وتُسجَّل تفاصيل الأخطاء في السجل، ولا تُعرض للعميل أبدًا.

API key: مفتاح E-Ship Web Services الخاص بك للبيئة المختارة. وبعد الحفظ يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها.

API password: كلمة المرور المرتبطة بالمفتاح. ومثل المفتاح، لا تُعرض مرة أخرى بعد الحفظ.

Billing account number: رقم حساب Purolator الخاص بك. تستخدم التقديرات أسعار هذا الحساب. وتقبل بيئة التطوير حساب الاختبار الوارد في وثائق Purolator. ومسح هذا الحقل يحذف أيضًا مفتاح API وكلمة المرور المحفوظين.

Development environment: يستخدم بيئة التطوير الخاصة بـ Purolator (devwebservices) مع مفتاح التطوير. والأسعار بيانات اختبار. أوقفه في المتجر المفعّل للعمل الفعلي.

Ship-from postal code: الرمز البريدي الكندي الذي تُرسل منه الطرود، مثل L4W 5M8. لا يملك OpenCart رمزًا بريديًا للمتجر، لذلك لا يُؤخذ من عنوان المتجر: أدخله هنا.

Service in Canada: Cheapest available (الافتراضي)، وPurolator Ground، وPurolator Ground 9AM، وPurolator Ground 10:30AM، وPurolator Ground Evening، وPurolator Express، وPurolator Express 9AM، وPurolator Express 10:30AM، وPurolator Express 12PM، أو Purolator Express Evening.

Service to the USA: Cheapest available (الافتراضي)، وPurolator Ground U.S.، وPurolator Express U.S.، وPurolator Express U.S. 9AM، وPurolator Express U.S. 10:30AM، أو Purolator Express U.S. 12:00.

International service: Cheapest available (الافتراضي)، وPurolator Express International، وPurolator Express International 9AM، وPurolator Express International 10:30AM، أو Purolator Express International 12:00.

إذا لم تكن الخدمة المختارة متاحة للعنوان، تُستخدم أرخص خدمة متاحة.

Canadian sales taxes: يستخدم أسعار Purolator دون GST/HST/PST/QST. وبالنسبة إلى العناوين الكندية يتضمن إجمالي Purolator هذه الضرائب. فعّل هذا الخيار عندما يضيف المتجر الضريبة على الشحن بنفسه (فئة ضريبة في General)، حتى لا تُحتسب الضريبة مرتين. الافتراضي: معطّل.

CAD → (store currency) rate: أسعار Purolator بالدولار الكندي CAD. إذا لم تكن عملة المتجر الافتراضية CAD، فأدخل كم وحدة من عملتك تساوي CAD واحدًا، مثل 0.68. ومن دون هذه القيمة لا تُستخدم الأسعار الفورية. وإذا كانت عملتك الافتراضية CAD، فاترك الحقل فارغًا.

Default product weight (kg): يُستخدم لكل منتج لا وزن له. الافتراضي: 0.5. تُحوَّل الأوزان من فئة وزن المنتج، وتُرسل إلى Purolator كوزن إجمالي بالرطل كأعداد صحيحة مقرّبة إلى الأعلى.

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

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

Fallback price: السعر لبلد ليس له صف في Country prices ولا صف *. اتركه فارغًا لإخفاء الطريقة لتلك البلدان.

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

الشروط

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

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

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

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

التوفر

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

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

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

متقدم

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

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

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

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

Export: انقر Download JSON لحفظ الإعدادات في ملف JSON. لا يُصدَّر مفتاح API وكلمة المرور.

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

كيف يعمل أثناء الدفع

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

ومع بيانات API، ترسل الإضافة إلى Purolator طلب Quick Estimate: حساب الفوترة الخاص بك، والرمز البريدي لمكان الإرسال، ومدينة العميل ومقاطعته أو ولايته، وبلده ورمزه البريدي، وإجمالي وزن السلة بالأرطال كأعداد صحيحة. ويلزم رمز بريدي صالح لكندا، ورمز ZIP صالح للولايات المتحدة؛ وتُرسل البلدان الأخرى بالرمز البريدي كما أُدخل. ولا تُرسل الأبعاد (الوزن الحجمي). ترد Purolator بالفرنسية عندما يعرض العميل المتجر بالفرنسية، وإلا فبالإنجليزية. وتُرجع Purolator أسعار جميع الخدمات؛ فتأخذ الإضافة الخدمة التي اخترتها أو الأرخص، وتزيل ضرائب المبيعات الكندية إذا كان ذلك مضبوطًا، وتحوّل السعر من CAD. ويُحسب السعر بعملة المتجر الافتراضية، ويُقرَّب إلى منازله العشرية، ويُعرض للعميل بعملته مع الضريبة الخاصة بـTax class المحددة.

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

إذا لم تُرجع Purolator سعرًا (واجهة API متوقفة، أو بيانات دخول أو رمز بريدي خاطئ، أو الخدمة غير متاحة، أو لا يوجد سعر صرف CAD)، فلا يرى العميل أي خطأ. يُستخدم السعر الثابت، أو تُخفى الطريقة إذا لم يوجد سعر ثابت. ويُكتب السبب في السجل.

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

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

الطلبات

عندما يُنفَّذ طلب بسعر Purolator الفوري، تُحفظ الخدمة مع الطلب. وفي Sales > Orders تعرض صفحة الطلب، فوق السجل، لوحة Purolator تتضمن Purolator service (الاسم والرمز) وLive rate (excl. tax). وتبقى اللوحة ظاهرة حتى لو عُطّلت الطريقة لاحقًا. ولا تملك الطلبات المسعَّرة بالأسعار الثابتة أو بالشحن المجاني هذه اللوحة. ويعرض الطلب نفسه عنوان الطريقة وتكلفة الشحن كأي طريقة شحن أخرى في OpenCart.

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

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

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

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

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

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

لا يظهر Purolator أثناء الدفع: تحقق من أن الترخيص نشط وأن Enable Purolator مفعّل. تحقق من Geo zone (أو أن Ignore shipping zones مفعّل والبلد مسموح به)، وحدود الوزن، وMinimum order amount. وإذا لم تُرجع Purolator سعرًا، فلن تظهر الطريقة إلا مع سعر للبلد، أو صف *، أو Fallback price. وتحقق من أن المنتجات لديها Requires Shipping على Yes.

لا تظهر الأسعار الفورية: انظر إلى حقل Log في صفحة الإضافة. وأخطاء API تظهر هناك دائمًا. فعّل Debug log وأعد تحميل صفحة الدفع للحصول على التفاصيل. ومع مفاتيح API يجب أن يحتوي العنوان على رمز بريدي صالح (كندا) أو رمز ZIP صالح (الولايات المتحدة). وتحقق أيضًا من التحذيرات في قسم General.

HTTP 401 في السجل: مفتاح API أو كلمة المرور لا يطابقان البيئة المختارة. تعمل مفاتيح التطوير فقط مع Development environment مفعّلًا، وتعمل مفاتيح الإنتاج فقط مع تعطيله.

السعر يختلف عن موقع Purolator: يستخدم Quick Estimate أسعار حساب الفوترة الخاص بك وإجمالي الوزن المقرَّب إلى الأعلى بالأرطال الكاملة، دون الوزن الحجمي. وبالنسبة إلى العناوين الكندية يتضمن الإجمالي ضرائب المبيعات؛ استخدم Canadian sales taxes إذا ضبطت Tax class. وتُحوَّل الأسعار بـCAD → (store currency) rate الخاص بك.

اختفت قيمة بعد الحفظ: اقرأ الرسالة التي تظهر بعد Save. لم تكن القيمة رقمًا يساوي 0 أو أكبر، لذلك لم تُحفظ. أعد إدخالها كرقم عادي.

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

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

للمطوّرين: يمكن استبدال عنوان Purolator API بالإعداد vfd_prlr_api_url (للاختبارات)؛ وليس له حقل في صفحة الإعدادات.

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

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

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

Purolator علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ Purolator ولا معتمدة منها.