VibeFox SmartPost for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

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

PHP: 8.0 أو أحدث، مع امتداد SimpleXML (مضمَّن في معظم تثبيتات PHP).

SmartPost: لا حاجة إلى حساب API أو مفتاح. تأتي قائمة نقاط الاستلام من قائمة الأماكن المفتوحة لـ SmartPost. لا تتوفر لدى SmartPost واجهة برمجية عامة للأسعار، لذا تُدخل أسعارك الخاصة (التعاقدية). أنشئ الشحنات في حسابك التجاري لدى SmartPost (SmartPosti).

الدول: توجد نقاط استلام SmartPost في إستونيا ولاتفيا وليتوانيا وفنلندا. لا تُعرض طريقة الشحن لدول الوجهة الأخرى.

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

التثبيت

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

2. انقر على Activate.

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

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

5. راجع جدول الأسعار (الأسعار الافتراضية مُعبّأة مسبقًا)، وأحجام الصناديق، وحالة نقاط الاستلام في أعلى الصفحة.

6. أضف VibeFox SmartPost إلى المنطقة أو المناطق التي تضم إستونيا ولاتفيا وليتوانيا و/أو فنلندا من WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones واختر الدول.

الإعدادات

جميع الإعدادات في صفحة واحدة: WooCommerce > Settings > Shipping > VibeFox SmartPost. وهي تنطبق على جميع مناطق الشحن. عند إضافة الطريقة إلى منطقة، تحتوي نافذة المنطقة على حقل واحد فقط:

Title (zone): الاسم الذي يراه العملاء لهذه المنطقة. اتركه فارغًا لاستخدام Method title العام.

في أعلى الصفحة تعرض الإشعارات المشكلات وحالة نقاط الاستلام. يظهر إشعار أحمر عندما لا يُحدَّد أي سعر، لأن الطريقة عندئذ لا تظهر في الدفع. تعرض كتلة Pickup points available at checkout لكل دولة عدد نقاط الاستلام المتاحة وعدد المدن التي تتوفر فيها. وتبيّن أيضًا متى تُستخدم نسخة محفوظة من القائمة لأن قائمة SmartPost غير متاحة حاليًا، ومتى يتعذر تحميل دولة بالكامل، ومتى لا تملك دولة أسعارًا. يعيد الزر Refresh pickup point lists now تنزيل القوائم ويعرض الأرقام الجديدة.

عام

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

Method title: اسم طريقة الشحن الذي يراه العملاء. يحل محله Title الخاص بطريقة المنطقة. الافتراضي: SmartPost parcel locker.

Tax status: Taxable يضيف ضريبة WooCommerce إلى تكلفة الشحن، وNone لا يضيفها.

الأسعار (بعملة متجرك؛ ويمكن كتابة الكسور مثل 3.50 أو 3,50)

Price table: صف لكل دولة (إستونيا، لاتفيا، ليتوانيا، فنلندا)، مع سعر لكل حجم صندوق S وM وL وXL، وعمود Free from. الصفر يعني مجانًا. الخلية الفارغة تعني أن حجم الصندوق ذاك غير متاح: تُخفى الطريقة عندما يحتاج الطرد إلى ذلك الصندوق. لا تُخدَم الدولة التي تكون جميع خلاياها فارغة. Free from هو مجموع السلة الذي يصبح عنده SmartPost مجانيًا في تلك الدولة؛ اتركه فارغًا إذا لم يكن هناك شحن مجاني. الأسعار التي ليست أرقامًا تُبلَّغ بعد الحفظ وتبقى فارغة. الأسعار الافتراضية: إستونيا 3.50، لاتفيا 4.00، ليتوانيا 4.00، فنلندا 5.00 لكل صندوق.

Box sizes (cm): المقاس الداخلي لكل صندوق، مع أقصر ضلع أولًا (Side 1 (smallest)، Side 2، Side 3 (largest)). تُرتَّب أضلاع المنتج بالطريقة نفسها وتُقارَن جنبًا إلى جنب، ويُستخدم أصغر صندوق يتسع له. المنتجات بلا أبعاد تُعدّ مناسبة لصندوق S. الطرد الذي لا يتسع لأي صندوق يُخفي الطريقة. تُحوَّل أبعاد المنتج من وحدة القياس في المتجر. الافتراضيات: S 12 x 36 x 60، M 20 x 36 x 60، L 36 x 38 x 60، XL 36 x 60 x 60. الأحجام التي ليست أرقامًا موجبة تُبلَّغ بعد الحفظ ولا تُغيَّر.

Calculation: كيفية احتساب السعر.

Per order (all items stacked in one box): تُرصّ جميع العناصر على أقصر ضلع في طرد واحد، ويُستخدم سعر الصندوق الذي يتسع له. هذا هو الخيار الافتراضي.

Per item (each item in its own box, prices added up): يحصل كل عنصر على صندوقه الخاص، ويُضرب سعر الصندوق في الكمية، ثم تُجمع الأسعار.

التوفّر

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

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

Minimum cart total: يعرض الطريقة فقط من مجموع السلة هذا فما فوق. اتركه فارغًا لعرضها دائمًا.

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

Ignore shipping zones: يعرض SmartPost للدول المذكورة أدناه دون إضافته إلى منطقة. عندما يكون معطّلًا، تُحدَّد الدول بمناطق الشحن التي أُضيفت إليها الطريقة. وهذا الخيار موصى به.

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

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

Pickup point types: نقاط SmartPost التي يستطيع العميل اختيارها: Parcel lockers (APT)، وParcel boxes (IPB)، وParcel shops (PUDO)، وPosti post offices (Finland). اتركه فارغًا لعرض خزائن الطرود وصناديق الطرود ومتاجر الطرود (الافتراضي). وما هي الأنواع الموجودة يعتمد على الدولة: فلاتفيا مثلًا لديها صناديق طرود فقط، ومكاتب البريد موجودة في فنلندا فقط.

City order: عندما يكون مفعّلًا تأتي المدن الكبرى أولًا (تالين، وريغا، وفلنيوس، وهلسنكي، وغيرها من المدن الكبرى)، ثم بقية المدن أبجديًا. وعندما يكون معطّلًا تكون جميع المدن مرتبة أبجديًا.

متقدم

Debug log: يسجّل تفاصيل احتساب الأسعار وقائمة نقاط الاستلام في WooCommerce > Status > Logs (المصدر vfd-smartpost). تُسجَّل الأخطاء، مثل تعذّر توفر قائمة نقاط الاستلام، دائمًا. لا تُسجَّل أي بيانات للعملاء.

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

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

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

تُخزَّن قائمة نقاط الاستلام لكل دولة مؤقتًا لمدة 24 ساعة، وتُحفظ نسخة من آخر قائمة سليمة. ويُتذكَّر التنزيل الفاشل لمدة 15 دقيقة، حتى لا تنتظر صفحة الدفع القائمة عند كل تحديث. مهلة التنزيل 15 ثانية. تُعرض الكتابات المختلفة للمدينة نفسها (مثل Riga وRīga) كمدينة واحدة.

تعمل الطريقة في الدفع الكلاسيكي وفي كتلتي Cart وCheckout. وهي متوافقة مع High-Performance Order Storage (HPOS) في WooCommerce. الأسعار بعملة متجرك. ولا تحوّل الإضافة العملات.

لا تطلب الإضافة أسعار SmartPost، ولا تنشئ شحنات، ولا تطبع ملصقات، ولا تستدعي مندوب توصيل، ولا تتتبع الطرود. أنشئ الشحنات في حسابك التجاري لدى SmartPost (SmartPosti). التوصيل المنزلي بواسطة مندوب ليس جزءًا من هذه الطريقة، ولا توجد خريطة.

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

عندما يختار العميل SmartPost تظهر قائمتان أسفل الطريقة: -- Select city -- و-- Select pickup point --. تنتمي القوائم دائمًا إلى دولة الشحن. في الدفع الكلاسيكي هي دولة عنوان التوصيل، أو دولة عنوان الفوترة عندما لا يُشحن الطلب إلى عنوان مختلف؛ وتُعاد بناء القوائم عند تغيّر الدولة. وفي الدفع بالكتل تتبع القوائم دولة عنوان التوصيل. تُحدَّد مدينة عنوان التوصيل مسبقًا عندما تطابق مدينة في القائمة. يُعرض كل نقطة مع اسمها وعنوانها. يُتذكَّر الاختيار أثناء الدفع، فلا يضيع عند تحديث صفحة الدفع.

نقطة الاستلام إلزامية. في الدفع الكلاسيكي يرى العميل Please select a SmartPost pickup point in the shipping country. وفي الدفع بالكتل يكون Place order معطّلًا إلى أن تُختار نقطة. وفي الحالتين يتحقق الخادم من النقطة مجددًا بقائمة دولة الشحن، فتُرفض المعرّفات المزوَّرة أو القديمة، وكذلك النقطة التابعة لدولة أخرى. وإذا تعذّر توفر قائمة الدولة مؤقتًا، يرى العميل رسالة ويستطيع اختيار طريقة شحن أخرى.

تُحفظ معرّف النقطة واسمها ومدينتها ودولتها في الطلب. وتظهر في شاشة الطلب أسفل عنوان التوصيل (مع معرّف المكان)، وفي صفحة استلام الطلب، وفي My account > Orders، وفي رسائل الطلب الإلكترونية (HTML والنص العادي) تحت اسم SmartPost pickup point.

لتغيير نقطة الطلب، افتح الطلب وانقر على Change بجوار SmartPost pickup point. اختر مدينة ونقطة من دولة شحن الطلب. تُحفظ النقطة الجديدة فورًا، وتسجّل ملاحظة في الطلب النقطة القديمة والجديدة.

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

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

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

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

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

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

لا يظهر SmartPost في الدفع: تحقق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن دولة الشحن هي إستونيا أو لاتفيا أو ليتوانيا أو فنلندا، وأن الطريقة مضافة إلى منطقة دولة العميل (أو أن Ignore shipping zones مفعّل وأن الدولة مسموح بها). افتح صفحة الإعدادات: يوضح الإشعار إن لم يُحدَّد أي سعر، أو إن كانت لدولة ما أسعار مفقودة، أو إن كانت لدولة ما نقاط استلام مفقودة. تحقق أيضًا من حدود الوزن، وMinimum cart total، وExcluded shipping classes، وأحجام الصناديق: فالطرد الذي لا يتسع لأي صندوق، أو الصندوق الذي تكون خانة سعره فارغة، يُخفي الطريقة. ومع تفعيل Debug log يوضح WooCommerce > Status > Logs (المصدر vfd-smartpost) سبب إخفاء الطريقة.

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

لا توجد نقاط استلام لدولة: تعذّر تحميل قائمة SmartPost ولا توجد نسخة محفوظة. تعيد الإضافة المحاولة كل 15 دقيقة. انقر لاحقًا على Refresh pickup point lists now. تحقق أيضًا من أن Pickup point types يتضمن نوعًا موجودًا في تلك الدولة.

قائمة نقاط الاستلام قديمة: انقر على Refresh pickup point lists now في صفحة الإعدادات. تُعاد تنزيل القوائم أيضًا كل 24 ساعة.

لا يستطيع العميل إتمام الطلب: يجب اختيار نقطة استلام من دولة الشحن. إذا رأى العميل الرسالة "The SmartPost pickup point list is temporarily unavailable"، فلا توجد نقاط متاحة لتلك الدولة في الوقت الحالي.

بأي عملة الأسعار: بعملة متجرك. لا تحوّل الإضافة العملات.

للمطورين: يغيّر الفلتر vfd_smpt_places_url عنوان URL لقائمة الأماكن لدولة ما (المعاملات: URL، رمز الدولة)، مثل التوجيه إلى مرآة تُرجع الـ XML نفسه.

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

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

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

SmartPost وSmartPosti علامتان تجاريتان لمالكيهما. هذه الإضافة غير تابعة لـ SmartPost ولا معتمدة من قِبلها.