# الإضافات

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

ميزة Pro

يتطلب تثبيت الإضافات وإدارتها [WCPOS Pro](/ar/getting-started/pro-license.md). يعرض الإصدار المجاني كتالوج الإضافات ولكنه يعطّل عناصر التحكم في التثبيت والتفعيل.

## الإضافات المتاحة[​](#available-extensions "رابط مباشر إلى الإضافات المتاحة")

### بوابات الدفع[​](#payment-gateways "رابط مباشر إلى بوابات الدفع")

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

[بوابة Stripe Terminalمدفوعات البطاقات الحضورية على أجهزة Stripe Terminal ‏(S700, WisePOS E). يدعم MOTO ووضع المحاكي.](/ar/payment/gateways/stripe-terminal.md)

[بوابة SumUp Terminalقبول مدفوعات البطاقات عبر قارئات بطاقات SumUp.](/ar/payment/gateways/sumup-terminal.md)

[دفع Vipps MobilePayمدفوعات عبر الهاتف باستخدام رمز QR أو إشعار دفع. Vipps (النرويج)، MobilePay (الدنمارك، فنلندا).](/ar/payment/gateways/vipps-mobilepay.md)

[فاتورة عبر البريد الإلكترونيإرسال رابط دفع إلى العميل عبر البريد الإلكتروني لتسوية الطلب عبر الإنترنت.](/ar/payment/gateways/email-invoice.md)

هل تريد إنشاء بوابتك الخاصة؟ ابدأ من [قالب بوابة الدفع](/ar/reference/gateway-template.md) — أو راجع [نظرة عامة على بوابات الدفع المخصصة](/ar/payment/gateways/.md) للاطلاع على القائمة الكاملة.

### متعدد اللغات[​](#multilingual "رابط مباشر إلى متعدد اللغات")

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

[تكامل WCPOS مع Polylangتكامل Polylang — مزامنة المنتجات حسب اللغة واختيار اللغة لكل متجر لـ WCPOS Pro.](/ar/extensions/polylang.md)

[تكامل WCPOS مع WPMLتكامل WPML — تصفية منتجات POS إلى لغة واحدة.](/ar/extensions/wpml.md)

[تكامل WCPOS مع WP Multilangتكامل WP Multilang — تصفية منتجات POS إلى لغة واحدة.](/ar/extensions/wp-multilang.md)

### القسائم ورصيد المتجر[​](#coupons-and-store-credit "رابط مباشر إلى القسائم ورصيد المتجر")

[قسائم StoreApps Smart Coupons الذكية لـ WCPOSاستخدام رصيد المتجر من StoreApps Smart Coupons في WCPOS، مع تسميات الرصيد في الإيصال وسجل تدقيق ملاحظات الطلب.](/ar/extensions/storeapps-smart-coupons.md)

### المخزون[​](#inventory "رابط مباشر إلى المخزون")

[تكامل WCPOS مع ATUMربط متاجر WCPOS Pro بمواقع ATUM Multi-Inventory للمخزون والتسعير وSKU حسب الموقع.](/ar/extensions/atum.md)

## تصفح الإضافات[​](#browsing-extensions "رابط مباشر إلى تصفح الإضافات")

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

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

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

### التصفية والبحث[​](#filtering-and-search "رابط مباشر إلى التصفية والبحث")

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

## تثبيت إضافة[​](#installing-an-extension "رابط مباشر إلى تثبيت إضافة")

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

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

## التفعيل وإلغاء التفعيل[​](#activating-and-deactivating "رابط مباشر إلى التفعيل وإلغاء التفعيل")

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

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

## تحديث الإضافات[​](#updating-extensions "رابط مباشر إلى تحديث الإضافات")

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

### التحديثات التلقائية[​](#auto-updates "رابط مباشر إلى التحديثات التلقائية")

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

## استكشاف الأخطاء وإصلاحها[​](#troubleshooting "رابط مباشر إلى استكشاف الأخطاء وإصلاحها")

### رسالة "يتطلب Pro" على الأزرار[​](#requires-pro-message-on-buttons "رابط مباشر إلى رسالة \"يتطلب Pro\" على الأزرار")

تكون أزرار التثبيت والتفعيل والتحديث معطلة في الإصدار المجاني من WCPOS. قم بالترقية إلى [WCPOS Pro](/ar/getting-started/pro-license.md) لإدارة الإضافات.

### فشل تثبيت الإضافة[​](#extension-fails-to-install "رابط مباشر إلى فشل تثبيت الإضافة")

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

### الإضافة لا تظهر بعد التثبيت[​](#extension-not-appearing-after-install "رابط مباشر إلى الإضافة لا تظهر بعد التثبيت")

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

### تعذر تحميل الفهرس[​](#catalog-not-loading "رابط مباشر إلى تعذر تحميل الفهرس")

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

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

***

## للمطورين[​](#for-developers "رابط مباشر إلى للمطورين")

### إنشاء امتداد POS[​](#creating-a-pos-extension "رابط مباشر إلى إنشاء امتداد POS")

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

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

### الإرسال إلى الدليل[​](#submitting-to-the-directory "رابط مباشر إلى الإرسال إلى الدليل")

تتم صيانة كتالوج الامتدادات في مستودع GitHub [`wcpos/extensions`](https://github.com/wcpos/extensions). لإدراج امتدادك:

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

### اصطلاحات إصدارات GitHub[​](#github-release-conventions "رابط مباشر إلى اصطلاحات إصدارات GitHub")

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

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

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

للحصول على التفاصيل الكاملة حول مخطط الكتالوج وعملية الإرسال، راجع مستودع [`wcpos/extensions`](https://github.com/wcpos/extensions).