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

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

تطبيقَا سطح المكتب والهاتف المحمول فقط

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

نظرة عامة على شاشة الاتصال​

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

إضافة متجر جديد​

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

متاجر متعددة​

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

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

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

عدة مستخدمين لكل متجر​

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

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

إضافة مستخدم​

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

تبديل المستخدمين​

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

إزالة مستخدم​

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

إزالة متجر​

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

المتجر التجريبي​

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

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

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

تستخدم تطبيقات سطح المكتب والهاتف المحمول إطارات iframe لتسجيل الدخول والدفع والإيصالات. أي ترويسة خادم أو إضافة ترسل 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.
  • تحقق من امتلاك حساب المستخدم أذونات الوصول إلى نقطة البيع.
فشل تسجيل الدخول في تطبيق سطح المكتب أو الهاتف المحمول

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

  • تمنع ترويسات X-Frame-Options (التي تضبطها إضافة أمان أو الخادم) إطار تسجيل الدخول — راجع الملاحظة أعلاه. عطّل إضافة الأمان مؤقتًا، وسجّل الدخول، ثم أعد تفعيلها (تستمر جلستك نحو أسبوع).
  • إضافات الأمان — من الأسباب الشائعة Wordfence وReally Simple Security وWPS Hide Login وiThemes/Solid Security وDefender Pro. راجع القائمة الكاملة والحلول في تعارضات الإضافات.
  • Wordfence 2FA — لا يظهر حقل رمز 2FA في إطار تسجيل الدخول. عطّل 2FA لمستخدمي نقطة البيع مؤقتًا.
  • عنوان 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 بحاجة إلى تحديث (أو العكس). في v1.10، يجب أن يكون كل من التطبيق وإضافة WCPOS على سلسلة إصدار v1.10 لأن التطبيق يستخدم واجهة API للمزامنة v2 الخاصة بالإضافة. إذا حُدّث أحد الطرفين فقط وفشلت الطلبات مع rest_no_route، فحدّث الطرف الآخر.

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

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

تعذّر تجاوز شاشة اختيار المستخدم (تطبيق سطح المكتب)

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

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