# الاتصال بمتجرك

سطح المكتب والجوال فقط

تظهر هذه الشاشة فقط في تطبيقات سطح المكتب والجوال. يصل مستخدمو الويب إلى POS مباشرة على `yourdomain.com/pos` ويسجلون الدخول باستخدام بيانات اعتماد WordPress الخاصة بهم.

## نظرة عامة على شاشة الاتصال[​](#connect-screen-overview "رابط مباشر إلى نظرة عامة على شاشة الاتصال")

عند فتح تطبيق WCPOS لسطح المكتب أو الجوال، ستظهر شاشة الاتصال. من هنا تتم إدارة اتصالات المتجر وعمليات تسجيل دخول المستخدمين.

<!-- -->

## إضافة متجر جديد[​](#adding-a-new-store "رابط مباشر إلى إضافة متجر جديد")

1. أدخل عنوان URL لمتجر WooCommerce في حقل النص (مثال: `https://mystore.com`)
2. انقر على **الاتصال**
3. ستتم إعادة توجيهك لتسجيل الدخول باستخدام بيانات اعتماد WordPress الخاصة بك
4. بعد تسجيل الدخول بنجاح، ستعود إلى التطبيق

## متاجر متعددة[​](#multiple-stores "رابط مباشر إلى متاجر متعددة")

يمكنك الاتصال بأي عدد تحتاج إليه من متاجر WooCommerce. يظهر كل متجر كبطاقة منفصلة في شاشة الاتصال، وتعرض:

* **اسم المتجر** والأيقونة المفضلة
* **عنوان URL للمتجر**
* **المستخدمون المسجلون الدخول** لذلك المتجر

يفيد ذلك عند إدارة عدة مواقع أو شركات.

## عدة مستخدمين لكل متجر[​](#multiple-users-per-store "رابط مباشر إلى عدة مستخدمين لكل متجر")

يمكن أن يكون لكل متجر عدة مستخدمين مسجلين الدخول في الوقت نفسه. يفيد ذلك في:

* **تغييرات الورديات** - يمكن لأمين الصندوق الجديد تسجيل الدخول قبل أن يسجل السابق خروجه
* **إعدادات أجهزة تسجيل متعددة** - أمناء صندوق مختلفون على أجهزة مختلفة
* **التبديل السريع** - بدّل بسهولة بين حسابات المستخدمين

### إضافة مستخدم[​](#adding-a-user "رابط مباشر إلى إضافة مستخدم")

انقر على  الزر بجانب "المستخدمون المسجلون الدخول" لإضافة مستخدم آخر إلى ذلك المتجر.

### تبديل المستخدمين[​](#switching-users "رابط مباشر إلى تبديل المستخدمين")

انقر على شارة مستخدم (مثل "Brenda") لفتح POS بذلك المستخدم.

### إزالة مستخدم[​](#removing-a-user "رابط مباشر إلى إزالة مستخدم")

انقر على **×** في شارة المستخدم لتسجيل خروج ذلك المستخدم من المتجر.

## إزالة متجر[​](#removing-a-store "رابط مباشر إلى إزالة متجر")

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

## المتجر التجريبي[​](#demo-store "رابط مباشر إلى المتجر التجريبي")

في أسفل الشاشة، قد ترى رابط "الدخول إلى المتجر التجريبي". يصلك هذا بمتجر WooCommerce تجريبي لتجربة ميزات WCPOS دون التأثير في بيانات متجرك.

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

أول ما يجب التحقق منه: `X-Frame-Options`

تستخدم تطبيقات سطح المكتب والهاتف المحمول **iframes** لتسجيل الدخول، والدفع، والإيصالات. **أي** ترويسة خادم أو إضافة ترسل `X-Frame-Options: DENY` أو `SAMEORIGIN` ستؤدي إلى تعطيل تسجيل الدخول. هذا هو السبب الأكثر شيوعا لفشل تسجيل الدخول إلى التطبيق — تحقق من ترويسات استجابة صفحة تسجيل الدخول (أدوات المطور في المتصفح، أو `curl -I https://yourstore.com/wp-login.php`) قبل أي شيء آخر.

لا يمكن الاتصال بمتجري؟

* تأكد من تثبيت إضافة WCPOS وتفعيلها على موقع WordPress الخاص بك
* تحقق من أنك تستخدم URL الصحيح (ضمّن `https://` — تتطلب WooCommerce REST API استخدام SSL)
* جرّب أولا فتح `yourdomain.com/pos` في متصفح ويب للتأكد من أن الإضافة تعمل
* تحقق من إمكانية الوصول إلى WooCommerce REST API
* تحقق من أن حساب المستخدم لديك يملك صلاحيات الوصول إلى POS

يفشل تسجيل الدخول في تطبيق سطح المكتب أو الهاتف المحمول

تحدث معظم حالات فشل تسجيل الدخول إلى التطبيق بسبب إضافة أمان أو تخزين مؤقت تحظر iframe تسجيل الدخول:

* **رؤوس `X-Frame-Options`** (التي يعيّنها مكوّن إضافي للأمان أو خادمك) تحظر iframe تسجيل الدخول — راجع الملاحظة أعلاه. عطّل مكوّن الأمان الإضافي مؤقتًا، وسجّل الدخول، ثم أعد تفعيله (تستمر جلستك نحو أسبوع).
* **مكوّنات الأمان الإضافية** — Wordfence وReally Simple Security وWPS Hide Login وiThemes/Solid Security وDefender Pro من الأسباب الشائعة. راجع القائمة الكاملة والإصلاحات في [تعارضات المكوّنات الإضافية](/ar/support/troubleshooting/plugin-conflicts.md).
* **المصادقة الثنائية في Wordfence** — لا يظهر حقل رمز المصادقة الثنائية داخل iframe تسجيل الدخول. عطّل المصادقة الثنائية لمستخدمي POS في الوقت الحالي.
* **URL تسجيل دخول مخصّص** (مثل WPS Hide Login) — لا يستطيع التطبيق العثور على صفحة تسجيل الدخول. استخدم URL القياسي `/wp-admin/`.
* يمكن أن تستمر **مكوّنات التخزين المؤقت الإضافية** في عرض نموذج تسجيل الدخول المحظور حتى بعد تعطيل المكوّن الإضافي المسبّب للمشكلة — امسح التخزين المؤقت، أو امسح تخزين التطبيق المؤقت / أعد تثبيت تطبيق سطح المكتب.

"تتطلب REST API المصادقة" أو يظهر خطأ من مكوّن أمان إضافي على شاشة الاتصال

يتطلب مكوّن إضافي (مثل Force Login أو مكوّن مصادقة JWT إضافي) المصادقة لجميع طلبات REST API، لذلك لا يستطيع التطبيق قراءة المعلومات العامة لموقعك. يعرض التطبيق الآن رسالة الخادم الفعلية (مثل *"يمكن للمستخدمين المصادق عليهم فقط الوصول إلى REST API"*) بدلًا من الإبلاغ عن نوع الموقع بشكل خاطئ.

**الإصلاح:** اضبط مكوّن الأمان الإضافي للسماح بالوصول غير المصادق عليه إلى `/wp-json/wcpos/` و `/wp-json/wc/v3/`، أو عطّله فقط للمدة اللازمة لإكمال الاتصال الأول.

"لا يبدو أنه موقع WordPress" (تطبيق سطح المكتب)

يكتشف تطبيق سطح المكتب REST API عبر رأس HTTP `Link`. إذا أغرق مكوّن إضافي (غالبًا **Image Prioritizer** أو مكوّنات أداء إضافية أخرى) ذلك الرأس أو اقتطعه، يفشل الاكتشاف. **الإصلاح:** عطّل مكوّنات الأداء الإضافية الخاصة بتحسين الصور / تعديل الرؤوس، ثم أعد المحاولة.

يقول التطبيق إنه يحتاج إلى تحديث / يتعطل بعد التحديث

تحقق من عدم وجود عدم تطابق في الإصدار بين التطبيق ومكوّن الخادم الإضافي — ربما دفع متجر التطبيقات تحديثًا للتطبيق بينما لا يزال مكوّن WCPOS الإضافي بحاجة إلى تحديث (أو العكس). تأكد من أن التطبيق ومكوّن WCPOS الإضافي على **نفس الإصدار الرئيسي**. تتطلب تطبيقات WCPOS v1.9.0+ أن يكون مكوّن WCPOS الإضافي **v1.8.0 أو أحدث**.

خطأ "تعذر إنشاء قاعدة بيانات المتجر السريعة"

هذه حالة سباق تحدث عند تسجيل الدخول لأول مرة. **أغلق التطبيق بالكامل وحاول مرة أخرى** — ينجح عادة في المحاولة الثانية.

التوقف عند شاشة اختيار المستخدم (تطبيق سطح المكتب)

بعد تسجيل الدخول، يظهر اسم المستخدم الخاص بك لكن لا يظهر مسار واضح للمتابعة. **انقر على اسم المستخدم/الاسم الخاص بك** للانتقال إلى POS — فالاسم نفسه هو الزر.

هل يستمر فشل الاتصال؟

* جرّب الوصول إلى `yourdomain.com/pos` في متصفح ويب أولا للتحقق من أن الإضافة تعمل
* تحقق من سجلات الأخطاء في موقعك بحثا عن أي مشكلات
* تأكد من أن مزود الاستضافة لا يحظر REST API — راجع [ملاحظات خاصة بالاستضافة](/ar/support/performance/server.md)
* تأكد من أن الخادم يستوفي [الحد الأدنى من المتطلبات](/ar/support/performance/server.md)