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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إزالة متجر​

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

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

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

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

أول ما يجب التحقق منه: 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 من الأسباب الشائعة. راجع القائمة الكاملة والإصلاحات في تعارضات المكوّنات الإضافية.
  • المصادقة الثنائية في 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 — فالاسم نفسه هو الزر.

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