VibeFox Bob Go for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

WooCommerce: 5.0 أو أحدث، مثبّت ومفعّل. لا تُفعَّل الإضافة بدونه.

PHP: 8.0 أو أحدث.

حساب Bob Go (للأسعار الفورية فقط): لا يستخدم Bob Go مفاتيح API. تحتاج إلى حساب Bob Go (bobgo.co.za)، ومتجر WooCommerce مثبّت كقناة مبيعات (Sales channels) في حسابك لدى Bob Go، مع تفعيل «Rates at checkout» لهذه القناة، وإعداد خدماتك وأسعارك هناك. إذا كنت تستخدم الأسعار الثابتة فقط، فلا تحتاج إلى حساب Bob Go.

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

التثبيت

1. في WordPress، انتقل إلى Plugins > Add New > Upload Plugin، واختر ملف ZIP للإضافة، ثم انقر Install Now. يمكنك أيضًا رفع مجلد vfd_bob_go إلى /wp-content/plugins/ عبر FTP.

2. انقر Activate.

3. في حسابك لدى Bob Go، ثبّت متجر WooCommerce كقناة مبيعات. فعّل «Rates at checkout» لهذه القناة، وأعدّ خدماتك وأسعارك.

4. افتح الإعدادات: WooCommerce > Settings > Shipping > VibeFox Bob Go، أو انقر Settings تحت اسم الإضافة في صفحة Plugins.

5. أدخل مفتاح ترخيص VibeFox في كتلة الترخيص أعلى الصفحة، ثم انقر Activate.

6. تحقق من نطاق المتجر، وعنوان الإرسال (ship from)، وإذا كانت عملة متجرك ليست ZAR فتحقق من سعر التحويل إلى ZAR (انظر الإعداد).

7. أضف VibeFox Bob Go إلى منطقة شحن لجنوب أفريقيا في WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones.

الإعداد

جميع الإعدادات موجودة في صفحة واحدة: WooCommerce > Settings > Shipping > VibeFox Bob Go. وتنطبق على جميع مناطق الشحن. في كل مرة تحفظ فيها الإعدادات، تُحذف أسعار Bob Go المخزنة مؤقتًا. وعند إضافة الطريقة إلى منطقة، تحتوي نافذة المنطقة على حقل واحد فقط:

Title (zone): الاسم الذي يظهر للأسعار الثابتة والشحن المجاني في هذه المنطقة. اتركه فارغًا لاستخدام Method title العام. تُعرض أسعار Bob Go الفورية دائمًا بأسماء الخدمات المُعدّة في Bob Go.

عام

Enable/Disable: يفعّل الطريقة أو يوقفها في جميع المناطق دفعة واحدة.

Method title: يظهر للعميل في حالة الأسعار الثابتة والشحن المجاني. ويمكن للمنطقة تجاوزه. تُعرض أسعار Bob Go الفورية بأسماء الخدمات من Bob Go، مثل «The Courier Guy - Economy». الافتراضي: Bob Go.

Shipping cost: طريقة احتساب السعر.

يُسجَّل سبب غياب الأسعار الفورية في السجل، ولا يظهر للعميل أبدًا.

حساب Bob Go

يعرض هذا القسم آخر رد من Bob Go لنطاق متجرك: connected، أو the WooCommerce channel is not installed on Bob Go (HTTP 404)، أو "Rates at checkout" is not enabled for this channel (HTTP 401)، أو خطأ آخر. وإذا كانت عملة متجرك ليست ZAR ولم يُحدَّد سعر تحويل، فإنه يحذّر أيضًا من عدم طلب الأسعار الفورية.

Store domain: يتعرّف Bob Go على متجرك من خلال نطاقه. اتركه فارغًا لاستخدام نطاق موقعك. أدخل نطاقًا آخر فقط إذا كانت قناتك في Bob Go مثبّتة على عنوان مختلف، مثل example.co.za/shop لمتجر في مجلد فرعي.

ZAR conversion rate: يُسعّر Bob Go بالراند الجنوب أفريقي (ZAR). إذا كانت عملة متجرك ليست ZAR، فأدخل قيمة 1 ZAR بعملة متجرك، مثل 0.05 لليورو EUR. بهذا السعر تُحوَّل الأسعار، وتُرسل أسعار المنتجات إلى Bob Go بالراند. اتركه فارغًا إذا لم ترد استخدام الأسعار الفورية لـ Bob Go بعملتك (الأسعار الثابتة تعمل في جميع الأحوال). وإذا كانت عملة متجرك ZAR، فاتركه فارغًا. يُقبل كل من النقطة والفاصلة كفاصل عشري.

Delivery dates: يعرض نطاق تاريخ التسليم المقدَّر من Bob Go في اسم سعر الشحن. يُحفظ التقدير دائمًا مع الطلب، ويظهر في شاشة الطلب.

الشحن من (عنوان الإرسال)

يُرسل عنوان الإرسال إلى Bob Go مع كل طلب أسعار. وإذا كان عنوان متجرك في WooCommerce > Settings > General في الدولة نفسها، فتُملأ الحقول الفارغة منه.

Origin country: الدولة التي تشحن منها. الافتراضي: جنوب أفريقيا. يشحن Bob Go داخل جنوب أفريقيا فقط.

Origin province: مقاطعة جنوب أفريقية، أو Store province (if in South Africa).

Origin city / suburb: المدينة أو الضاحية التي تشحن منها، مثل Johannesburg.

Origin postal code: الرمز البريدي الذي تشحن منه، مثل 2001.

Origin street address: عنوان الشارع الذي تشحن منه.

الأسعار الثابتة (تُستخدم في الوضع الثابت، وكخيار احتياطي عندما لا يعيد Bob Go أي سعر)

Price per country: سطر واحد لكل دولة: رمز الدولة المكوّن من حرفين، ثم علامة التساوي، ثم السعر بعملة متجرك، مثل ZA=99.99. استخدم * لجميع الدول الأخرى، مثل *=199.99. تُحذف الأسطر ذات التنسيق المختلف عند الحفظ.

Flat price: السعر بعملة متجرك للدول التي لا يوجد لها سطر أعلاه. اتركه فارغًا لإخفاء الطريقة لتلك الدول.

Fixed price applies: Per order يحصّل السعر مرة واحدة. Per item (price × quantity) يضربه في عدد القطع في السلة. أسعار Bob Go الفورية تنطبق دائمًا على الشحنة كاملة.

الشروط

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

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

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

Excluded shipping classes: يخفي الطريقة إذا احتوت السلة على منتج من أي فئة شحن من فئات WooCommerce هذه.

Free shipping: يفعّل الشحن المجاني عند بلوغ مبلغ الطلب المحدد أدناه.

Free shipping from: المجموع الفرعي للسلة (بعد الخصومات وقبل الضريبة) الذي يُمنح عنده الشحن المجاني. يُستخدم فقط عندما يكون Free shipping مفعّلًا. وفي هذه الحالة لا يُطلب أي سعر من Bob Go.

Tax status: Taxable يضيف ضريبة WooCommerce إلى تكلفة الشحن، وNone لا يضيفها. عادةً ما تتضمن أسعار Bob Go ضريبة القيمة المضافة (VAT) بالفعل. في هذه الحالة اختر None كي لا تُحتسب الضريبة مرتين.

التوفر بدون مناطق شحن

Ignore shipping zones: يعرض Bob Go للدول المذكورة أدناه حتى لو لم تُضف الطريقة إلى منطقة شحن.

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

متقدم

Debug log: يسجّل حسابات الأسعار وطلبات Bob Go في WooCommerce > Status > Logs، بالمصدر «vfd_bob_go». لا تُسجَّل عناوين العملاء. وتُسجَّل أخطاء API حتى عندما يكون هذا الخيار معطّلًا.

Remove data on uninstall: عند تفعيله، يؤدي حذف الإضافة إلى إزالة جميع إعدادات Bob Go وطرق المناطق والأسعار المخزنة مؤقتًا. إلغاء تفعيل الإضافة لا يحذف أي شيء أبدًا.

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

عندما يُدخل العميل عنوان التسليم، تتحقق الإضافة من وزن السلة وMinimum order amount وExcluded shipping classes. وإذا انطبق الشحن المجاني، يرى العميل الطريقة باسم Bob Go (free)، ولا يُرسل أي طلب إلى Bob Go.

في الأوضاع الفورية ترسل الإضافة إلى Bob Go نطاق متجرك وعنواني الإرسال والتسليم وعناصر السلة، مع أسعار المنتجات بالراند. لا تُطلب الأسعار الفورية إلا بعد أن يُدخل العميل مدينة أو رمزًا بريديًا. تظهر كل خدمة يعيدها Bob Go كخيار شحن منفصل باسمها في Bob Go، وإذا كان Delivery dates مفعّلًا فتظهر معها تواريخ التسليم المقدَّرة. وتُحوَّل الأسعار بالراند باستخدام ZAR conversion rate عندما لا تكون عملة متجرك ZAR.

تُخزَّن الأسعار مؤقتًا لمدة ساعة لكل سلة وعنوان، فلا تُطلق السلة نفسها طلبًا جديدًا. ويُخزَّن الطلب الفاشل مؤقتًا لمدة 5 دقائق، ومهلة الانتظار 12 ثانية، حتى لا يُبطئ انقطاع Bob Go كل تحديث لصفحة الدفع. ولا يُوقف الطلب الفاشل صفحة الدفع أبدًا: تُخفى الطريقة، أو يُستخدم السعر الثابت في وضع الخيار الاحتياطي. ويُسجَّل السبب في سجل WooCommerce.

يُحفظ رمز خدمة Bob Go المختار وتقدير التسليم مع سطر الشحن في الطلب، ويظهران في شاشة الطلب باسم Bob Go service وEstimated delivery.

تعمل الطريقة في صفحة الدفع الكلاسيكية، وفي كتلتي Cart وCheckout. وهي متوافقة مع تخزين الطلبات عالي الأداء في WooCommerce (HPOS).

تعرض الإضافة الأسعار فقط. لا تنشئ شحنات أو بوالص شحن أو ملصقات، ولا تتتبع الطرود، ولا تزامن الطلبات مع Bob Go، ولا ترسل إشعارات بالبريد الإلكتروني. لتنفيذ الطلبات، استخدم لوحة Bob Go (أو خاصية مزامنة الطلبات الخاصة بـ Bob Go). ولا تتيح الإضافة اختيار نقطة استلام أو خزانة (Bob Box وPargo)، ولا تضيف حقل ضاحية إضافيًا في الدفع. ولا يشحن Bob Go إلا داخل جنوب أفريقيا.

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

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. تقع كتلة الترخيص أعلى WooCommerce > Settings > Shipping > VibeFox Bob Go. الصق المفتاح في License key، ثم انقر Activate. تعرض الكتلة الحالة، مثل تاريخ انتهاء الترخيص ونطاقك. استخدم Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالته من هذا الموقع. يفتح الرابط Manage licenses and domains in your account حسابك على vibefox.net.

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

بدون مفتاح فعّال، لا يظهر Bob Go للعملاء في صفحة الدفع. ويظل مرئيًا لمديري المتجر المسجلين الدخول، مع علامة (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء المفتاح. يظهر تذكير في صفحة Plugins وفي صفحات WooCommerce. ولا تتأثر الطلبات الحالية.

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

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

لا يظهر Bob Go في صفحة الدفع: تحقق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن الطريقة مضافة إلى منطقة دولة العميل (أو أن Ignore shipping zones مفعّل والدولة مسموح بها). تحقق من حدود الوزن، وMinimum order amount، وExcluded shipping classes. في الوضع الثابت، تأكد من أن الدولة أو * أو Flat price لها سعر.

لا تظهر أي أسعار من Bob Go: افتح إعدادات الإضافة. يعرض القسم Bob Go account آخر رد من Bob Go. يعني «Channel is not installed» (HTTP 404) أن نطاق المتجر ليس قناة مبيعات في Bob Go: تحقق من Store domain. ويعني «Rates at checkout is not enabled» (HTTP 401) أن الميزة معطّلة لهذه القناة. وتأكد أيضًا من أن العميل أدخل مدينة أو رمزًا بريديًا، وأنه في المتاجر غير ZAR قد حُدِّد ZAR conversion rate. فعّل Debug log وافتح WooCommerce > Status > Logs (المصدر «vfd_bob_go») للتفاصيل. ومع Bob Go live rates, fixed prices if Bob Go returns no rates سيحصل العملاء على السعر الثابت أثناء إصلاحك للمشكلة.

متجري ليس بالراند: يُسعّر Bob Go بالراند ZAR. أدخل قيمة 1 ZAR بعملة متجرك (مثلًا 0.05 لليورو EUR). بدون ذلك لا تطلب الإضافة أسعارًا من Bob Go. وتظل الأسعار الثابتة تعمل.

تُحتسب الضريبة على الشحن مرتين: عادةً ما تتضمن أسعار Bob Go ضريبة القيمة المضافة (VAT). اضبط Tax status على None.

تبدو الأسعار قديمة بعد تغيير: احفظ صفحة الإعدادات. سيؤدي ذلك إلى مسح أسعار Bob Go المخزنة مؤقتًا. تنعكس التغييرات في حسابك لدى Bob Go بعد انتهاء التخزين المؤقت لمدة ساعة أو عند حفظ الإعدادات.

تعرض كتلة الترخيص خطأ: اتبع الرسالة الظاهرة في الكتلة. مثلًا، إذا كان المفتاح مستخدمًا بالفعل على نطاق آخر، فحرّر خانة في حسابك على vibefox.net وانقر Check now. وإذا تغيّر عنوان الموقع، فانقر Check now لتفعيل المفتاح للنطاق الجديد. وإذا تعذّر الوصول إلى خادم التراخيص، تستمر الإضافة بآخر حالة معروفة.

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

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

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