VibeFox GLS ParcelShop for WooCommerce — المساعدة

المتطلبات

WordPress: 5.8 أو أحدث.

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

PHP: 8.0 أو أحدث.

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

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

التثبيت

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

2. انقر على Activate.

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

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

5. حدّد الاسم وأسعارك: صف واحد على الأقل في Country prices (مثل * Default) أو Fallback cost (راجع التهيئة).

6. أضف VibeFox GLS ParcelShop إلى منطقة شحن في WooCommerce > Settings > Shipping > Shipping zones، أو فعّل Ignore shipping zones.

التهيئة

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

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

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

عام

يسرد هذا القسم الدول التي تغطيها خريطة GLS. لا تُعرض الطريقة لدول الوجهة الأخرى.

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

Name: اسم طريقة الشحن الذي يُعرض للعميل. يمكن للمنطقة أن تستبدله بـ Title خاص بها. الافتراضي: GLS ParcelShop.

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

الأسعار

تُدخل الأسعار بعملة متجرك. يمكن أن تستخدم الكسور العشرية الفاصلة أو النقطة (4,99 أو 4.99).

Calculation type: طريقة تطبيق السعر.

Per order: يُحصَّل السعر مرة واحدة لكل طلب (الافتراضي).

Per item (price x quantity): يُضرب السعر في عدد العناصر في السلة. لا تُحتسب المنتجات الافتراضية (Virtual).

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

Fallback cost: السعر المستخدم عندما لا يحتوي الجدول على صف لدولة الوجهة ولا على صف * Default. اتركه فارغًا لإخفاء الطريقة لتلك الدول.

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

التوفر

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

Maximum weight (kg): يُخفي الطريقة عندما يكون وزن السلة أكبر من هذا الحد. الافتراضي: 20. تقبل نقاط GLS ParcelShop عادةً الطرود حتى 20 كغ، لذا تحقق من عقدك مع GLS. الفراغ أو القيمة 0 يعنيان عدم وجود حد.

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

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

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

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

متقدم

Debug log: يسجّل حساب السعر واختيارات ParcelShop في WooCommerce > Status > Logs (المصدر vfd-gls-parcelshop). لا يُسجَّل أي بيانات شخصية للعميل. أوقف السجل عند الانتهاء.

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

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

عندما يُدخل العميل عنوان التوصيل، يطلب WooCommerce من الإضافة سعر الشحن. تتحقق الإضافة أولًا من الشروط: أن دولة التوصيل مشمولة بخريطة GLS، ووزن السلة، والحد الأدنى للمجموع الفرعي للسلة، وفئات الشحن المستثناة. إذا بلغ المجموع الفرعي للسلة Free shipping from، يكون التوصيل مجانيًا. وإلا يُؤخذ السعر من صف الدولة (أو صف * Default) وعمود الوزن، أو من Fallback cost. إذا لم يُعثر على سعر، تُخفى الطريقة.

عندما يختار العميل GLS ParcelShop، يظهر زر Select GLS ParcelShop أسفل الطريقة. يفتح هذا الزر خريطة GLS ParcelShop الرسمية لدولة الشحن. بعد اختيار نقطة ParcelShop، يظهر اسمها وعنوانها، ويتغير الزر إلى Change ParcelShop. يُحتفظ بالاختيار في جلسة العميل، لذلك يبقى بعد تحديث صفحة الدفع أو إعادة تحميل الصفحة.

عند إتمام الطلب، تتحقق الإضافة من أن نقطة ParcelShop قد اختيرت وأنها في دولة الشحن. وإلا يرى العميل الرسالة يرجى اختيار نقطة GLS ParcelShop. أو نقطة GLS ParcelShop المختارة ليست في دولة الشحن الخاصة بك. يرجى اختيار نقطة ParcelShop مرة أخرى.، ولا يُتمّ الطلب. وإذا تعذّر تحميل نص خريطة GLS، يرى العميل رسالة تطلب منه إعادة تحميل الصفحة أو اختيار طريقة شحن أخرى.

تعمل خريطة GLS في متصفح العميل. في صفحة الدفع، تحمّل الإضافة نص خريطة GLS من map.gls-croatia.com، وتحمّل الخريطة بيانات نقاط ParcelShop وبلاطات الخريطة من GLS. تستلم GLS بيانات الطلب المعتادة للزائر (عنوان IP والمتصفح). لا يُرسل شيء من خادمك إلى GLS.

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

لا تحصل الإضافة على أسعار GLS الفورية، ولا تنشئ شحنات GLS، ولا تطبع البطاقات، ولا تتتبع الطرود. ليس لديها قائمة بنقاط ParcelShop على خادمك، لذلك لا تستطيع التحقق من معرّف نقطة ParcelShop لدى GLS. سلّم معرّف نقطة ParcelShop من الطلب إلى GLS بالطريقة المعتادة لديك (MyGLS أو برنامج GLS لديك أو إضافة أخرى).

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

تُحفظ نقطة ParcelShop المختارة مع الطلب: معرّفها، واسمها مع العنوان، ودولتها.

شاشة الطلب في الإدارة: يظهر اسم نقطة ParcelShop وعنوانها مع معرّفها ودولتها أسفل عنوان الشحن. إذا لم تكن لطلب GLS ParcelShop نقطة، تعرض الشاشة لم يتم اختيار نقطة ParcelShop لهذا الطلب.

صفحات العميل: تظهر نقطة ParcelShop في صفحة الشكر وفي صفحة عرض الطلب في حساب العميل.

رسائل البريد الإلكتروني: تُضاف نقطة ParcelShop إلى رسائل البريد الإلكتروني للطلبات، بصيغة HTML ونص عادي. وتتضمن الرسائل المرسلة إلى مدير المتجر معرّف نقطة ParcelShop أيضًا.

يمكن للمطورين قراءة نقطة ParcelShop من البيانات الوصفية للطلب _vfd_glps_parcelshop_id و_vfd_glps_parcelshop_name و_vfd_glps_parcelshop_country.

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

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

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

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

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

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

لا تظهر GLS ParcelShop في الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن الطريقة مضافة إلى منطقة دولة العميل (أو أن Ignore shipping zones مفعّل والدولة مسموح بها). تحقق من أن دولة الوجهة من دول خريطة GLS ولها سعر (صف للدولة، أو صف * Default، أو Fallback cost). تحقق من حدود الوزن، وMinimum cart subtotal، وExcluded shipping classes. فعّل Debug log لرؤية السبب في WooCommerce > Status > Logs.

لا تُفتح الخريطة: يرى العميل الرسالة «تعذّر تحميل خريطة GLS ParcelShop...» عندما يُحظر نص GLS، مثلًا بسبب مانع إعلانات أو مانع خصوصية، أو سياسة أمان المحتوى، أو تعطل خدمة GLS. اسمح بالنطاق map.gls-croatia.com في سياسة أمان المحتوى لديك.

التوصيل مجاني لدولة بالخطأ: تحقق من صف تلك الدولة في Country prices. الصف الذي يكون فيه Price وجميع أعمدة الوزن 0 يعطي توصيلًا مجانيًا.

لم يُحفظ الجدول أو أحد الحقول: القيمة ليست رقمًا صالحًا. تذكر الرسالة في أعلى الصفحة القيمة المعنية. استخدم أرقامًا مع الفاصلة أو النقطة كفاصل عشري.

مرشحات المطورين: vfd_glps_map_countries يغيّر قائمة دول خريطة GLS، وvfd_glps_widget_url يغيّر رابط نص خريطة GLS.

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

الإلغاء

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

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