تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

الإضافات

يدعم WCPOS الإضافات التي تضيف وظائف جديدة إلى نقطة البيع لديك. يتيح لك دليل الإضافات تصفّح الإضافات المتاحة وتثبيتها مباشرة من إعدادات POS وإدارة التحديثات.

ميزة Pro

يتطلب تثبيت الإضافات وإدارتها WCPOS Pro. يعرض الإصدار المجاني كتالوج الإضافات ولكنه يعطّل عناصر التحكم في التثبيت والتفعيل.

الإضافات المتاحة

بوابات الدفع

بوابات دفع مخصصة مصممة لاستخدام POS الحضوري.

هل تريد إنشاء بوابتك الخاصة؟ ابدأ من قالب بوابة الدفع — أو راجع نظرة عامة على بوابات الدفع المخصصة للاطلاع على القائمة الكاملة.

متعدد اللغات

صفِّ منتجات POS حسب اللغة حتى لا تظهر النسخ المكررة المترجمة في بحث أمين الصندوق وشبكة الكتالوج.

القسائم ورصيد المتجر

المخزون

تصفح الإضافات

افتح دليل الامتدادات من POS Settings > الإضافات (والمسمّى أيضًا الإضافات في بعض الإصدارات).

يعرض الدليل شبكة بطاقات للإضافات المتاحة. تعرض كل بطاقة:

  • الأيقونة (أو بديل على شكل قطعة أحجية إذا لم توفر الإضافة واحدة)
  • الاسم والإصدار
  • الوصف
  • شارة الفئة
  • الحالة — نشطة، غير نشطة، يتوفر تحديث، أو غير مثبتة

استخدم أزرار الفئات اللوحية في الأعلى لتصفية الإضافات حسب الفئة. يمكن أيضًا استخدام حقل البحث للعثور على الإضافات حسب الاسم أو الوصف أو الوسوم.

تثبيت إضافة

  1. افتح POS Settings > الإضافات.
  2. ابحث عن الإضافة المطلوبة وانقر على تثبيت.
  3. يتم تنزيل الإضافة وتثبيتها باستخدام مثبّت إضافات WordPress.
  4. بعد التثبيت، انقر على تفعيل لتمكينها.

خلف الكواليس، يستخدم WCPOS أداة WordPress الأصلية Plugin_Upgrader لمعالجة التثبيت، لذلك تتبع الإضافات العملية نفسها المتبعة مع أي إضافة WordPress.

التفعيل وإلغاء التفعيل

تحتوي كل إضافة مثبتة على زري تفعيل وإلغاء التفعيل في بطاقتها.

  • يؤدي تفعيل إلى تمكين الإضافة حتى يمكن تشغيلها في POS.
  • يؤدي إلغاء التفعيل إلى تعطيلها دون إلغاء تثبيتها. تبقى ملفات الإضافة على الخادم ويمكن إعادة تفعيلها في أي وقت.

تحديث الإضافات

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

التحديثات التلقائية

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

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

رسالة "يتطلب Pro" على الأزرار

تكون أزرار التثبيت والتفعيل والتحديث معطلة في الإصدار المجاني من WCPOS. قم بالترقية إلى WCPOS Pro لإدارة الإضافات.

فشل تثبيت الإضافة

  • تحقق من أن خادم WordPress لديه أذونات كتابة إلى دليل wp-content/plugins.
  • تحقق من أن خادمك يمكنه إجراء طلبات HTTPS صادرة (تحظر بعض شركات الاستضافة التنزيلات الخارجية).
  • اطلع على تفاصيل الخطأ في WP Admin > نقطة البيع > الدعم > السجلات.

الإضافة لا تظهر بعد التثبيت

  • حدّث POS — يتم تخزين قائمة الإضافات مؤقتًا لمدة تصل إلى 12 ساعة.
  • تأكد من تفعيل الإضافة (الإضافات المثبتة لكنها غير نشطة لن تعمل).

تعذر تحميل الفهرس

يتم جلب فهرس الإضافات من مصدر بعيد وتخزينه محليًا مؤقتًا لمدة 12 ساعة. إذا لم يتم تحميل الفهرس:

  • تحقق من اتصال خادمك بالإنترنت.
  • حاول مرة أخرى بعد انتهاء صلاحية التخزين المؤقت، أو امسح ذاكرة التخزين المؤقت المؤقتة في خادمك.

للمطورين

إنشاء امتداد POS

امتداد WCPOS هو إضافة WordPress قياسية تتكامل مع POS من خلال خطافات WCPOS وواجهات API الخاصة به. لإنشاء امتداد:

  1. ابدأ بإضافة WordPress. يحتاج امتدادك إلى ترويسة إضافة قياسية وملف دخول، تمامًا مثل أي إضافة WooCommerce أو WordPress.
  2. تكامل مع WCPOS. استخدم الخطافات والمرشحات التي يوفرها WCPOS لإضافة وظائف إلى واجهة POS أو الواجهة الخلفية.
  3. استضف الإصدارات على GitHub. يستخدم دليل الامتدادات GitHub Releases لتتبع الإصدارات وتوفير التحديثات.

الإرسال إلى الدليل

تتم صيانة كتالوج الامتدادات في مستودع GitHub wcpos/extensions. لإدراج امتدادك:

  1. راجع تنسيق الكتالوج ومتطلبات البيانات الوصفية في ملف README الخاص بالمستودع.
  2. افتح طلب سحب لإضافة البيانات الوصفية لامتدادك إلى catalog.json.
  3. بعد دمجه، سيظهر امتدادك في الدليل لجميع مستخدمي WCPOS Pro.

اصطلاحات إصدارات GitHub

تعتمد دورة حياة التحديث على إصدارات GitHub:

  • وسم الإصدارات باستخدام الترقيم الدلالي للإصدارات (مثل v1.0.0، v1.2.3).
  • إرفاق ملف zip للإضافة كأصل للإصدار — هذا هو الملف الذي يتم تنزيله عندما يثبّت المستخدم أو يحدّث.
  • نشر الإصدار (وليس مسودة) حتى يتمكن الدليل من اكتشافه.

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

للحصول على التفاصيل الكاملة حول مخطط الكتالوج وعملية الإرسال، راجع مستودع wcpos/extensions.