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

تعارضات الإضافات

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

للشخص المسؤول عن إدارة موقعك

تُجرى معظم الإصلاحات الواردة في هذه الصفحة من خلال WP Admin أو بالتعاون مع مزوّد الاستضافة. إذا كنت أمين صندوق، فأطلع المسؤول عن الموقع على هذه الصفحة.

راجع القائمة أولًا

هل تعرف الإضافة التي تغيّرت؟ افتح ابحث عن إضافتك بالاسم أدناه مباشرةً. ينقلك كل اسم إلى الحل الخاص به ضمن تعارضات الإضافات المعروفة. لا تعرف أي إضافة هي؟ ابدأ باستخدام موقع تجريبي.

ابحث عن إضافتك بالاسم

علامات تعارض الإضافات​

قد يكون السبب تعارضًا بين الإضافات إذا حدث ما يلي بعد إضافة إحدى الإضافات أو تحديثها:

  • تُظهر نافذة تسجيل الدخول خطأً أو صفحة فارغة.
  • يعرض التطبيق رسالة «تتطلب REST API الخاصة بـ WordPress على هذا الموقع المصادقة»، أو يعرض رسالة من إضافة أخرى تفيد بأن استخدام REST API يقتصر على المستخدمين الذين سجّلوا دخولهم.
  • يعرض الموقع رسالة «حدث خطأ فادح في هذا الموقع»، داخل POS أو في WP Admin.
  • يتوقف تنزيل المنتجات أو الطلبات أو العملاء، أو يتعذّر حفظ عملية بيع في المتجر.
  • تظهر صفحة الدفع الخاصة بإحدى بوابات الدفع في تبويب قديم بشكل غير سليم، أو لا تستجيب أزرارها.
  • يصبح كل شيء بطيئًا، أو تنتهي مهلة الطلبات. توجد صفحة مخصصة لبطء الدفع: أداء الدفع.

إذا اختفت قائمة نقطة البيع من WP Admin بعد تحديث إضافة، فراجع اختفاء POS بعد تحديث إضافة.

قبل البدء: استخدم موقعًا تجريبيًا​

لا تستكشف الأخطاء وتصلحها على موقعك الفعلي

قد يؤدي تعطيل الإضافات على الموقع الذي تستخدمه نقطة البيع إلى إيقاف المبيعات وتغيير متجرك الإلكتروني. أجرِ ذلك على موقع تجريبي.

ما الموقع التجريبي؟​

الموقع التجريبي نسخة من موقعك يمكنك اختبار التغييرات فيها دون أن تظهر لعملائك أو في نقطة البيع. يتيح معظم مزوّدي الاستضافة إنشاء هذه النسخة ببضع نقرات من لوحة تحكم الاستضافة.

إذا كان مزوّد الاستضافة لا يوفّر موقعًا تجريبيًا​

اسأل مزوّد الاستضافة عن كيفية نسخ الموقع. إذا لم تكن لديه طريقة لذلك، فمن المفيد الانتقال إلى مزوّد يوفّرها: ستحتاج إلى موقع تجريبي لكل تحديث للإضافات والقوالب وWordPress وWooCommerce، وليس لهذه المشكلة وحدها. تتضمن خدمات WP Engine وSiteGround وKinsta وCloudways جميعها هذه الإمكانية.

الخطوة 1: ابحث عن خطأ فادح​

عادةً ما يذكر خطأ التعطّل اسم الإضافة التي تسببت فيه. ابدأ بالبحث هناك:

  1. سجل POS. افتح صحة المتجر من القائمة الجانبية، واختر السجلات، ثم الأخطاء. راجع السجلات.
  2. سجل الأخطاء الفادحة في WooCommerce. اتبع إرشادات خطأ فادح للعثور عليه في WP Admin.
  3. اقرأ مسار الملف. سطر مثل wp-content/plugins/<plugin-name>/… يُبيّن اسم الإضافة.

إذا ذكر الخطأ اسم إضافة غير WooCommerce أو WCPOS، فعطّل تلك الإضافة على موقعك التجريبي وحاول مجددًا. إذا لم يُذكر اسم أي إضافة، فانتقل إلى الخطوة 2.

الخطوة 2: عطّل الإضافات، ثم أعد تفعيلها واحدة تلو الأخرى​

استخدم هذه الطريقة عندما لا يوجد خطأ فادح، أو عندما تكون المشكلة بطئًا في الأداء.

2.1 دوّن ما يحدث من خلل​

  1. افتح POS على موقعك التجريبي. في متصفح الويب، انتقل إلى /pos على عنوان الموقع التجريبي. في التطبيق، اربط عنوان الموقع التجريبي كمتجر آخر (راجع الاتصال)، وتحقّق من العنوان ضمن مواقعك قبل المتابعة.
  2. نفّذ الإجراء الذي يفشل، ودوّن ما تراه بدقة: الرسالة والشاشة والوقت الذي يستغرقه.
  3. عند وجود بطء، دوّن الأوقات الواردة في السجلات لتتمكن من المقارنة لاحقًا.

2.2 عطّل كل شيء باستثناء POS​

أبقِ ما يلي مفعّلًا:

  • WooCommerce
  • WCPOS
  • WCPOS Pro، إذا كان لديك
  • بوابة الدفع، إذا كانت المشكلة في صفحة الدفع الخاصة بها

عطّل كل ما عدا ذلك:

  1. انتقل إلى WP Admin > إضافات.
  2. حدّد مربع الاختيار بجانب كل إضافة أخرى.
  3. اختر تعطيل من إجراءات مجمّعة.
  4. انقر على تطبيق.

هذا هو أسفل قائمة إضافات في متجر يستخدم الإضافة المجانية، قبل تحديد أي مربع اختيار:

أسفل قائمة إضافات في WP Admin: صفوف WCPOS Pro وWCPOS وWooCommerce مع مربعات الاختيار الخاصة بها، وإشعار بتوفر إصدار جديد من WooCommerce، ثم إجراءات مجمّعة وتطبيق أسفل القائمة
  1. WCPOS Pro — اترك مربع اختياره دون تحديد. هذه الإضافة مثبّتة في هذا المتجر لكنها غير مفعّلة.
  2. WCPOS — اترك مربع اختياره دون تحديد.
  3. WooCommerce — يظهر مربع اختياره باللون الرمادي ما دام WCPOS يحتاج إليه، ولذلك يبقى مفعّلًا.
  4. إجراءات مجمّعة — اختر تعطيل بعد تحديد كل الإضافات الأخرى.
  5. تطبيق — يعطّل الإضافات المحددة.

2.3 حاول مجددًا​

  1. امسح جميع ذاكرات التخزين المؤقت: لدى مزوّد الاستضافة وشبكة CDN وأي إضافة للتخزين المؤقت.
  2. نفّذ الإجراء الذي فشل. هل يعمل الآن؟
  3. عند وجود بطء، قارن الأوقات بتلك التي دوّنتها.

يعمل الآن: من المرجح أن تكون إحدى الإضافات التي عطّلتها هي السبب. انتقل إلى إعادة تفعيل الإضافات واحدة تلو الأخرى لمعرفة أيها يعيد ظهور المشكلة.

ما زال يفشل: لم يحدّد هذا الاختبار السبب. لا تُعد تفعيل الإضافات واحدة تلو الأخرى. افحص قالبك في الخطوة 3. إذا لم يكن القالب هو السبب أيضًا، فتحقّق مما يلي:

2.4 أعد تفعيل الإضافات واحدة تلو الأخرى​

أي الإضافات تختبر أولًا

ابدأ بأنواع الإضافات الأكثر عرضة للتعارض لتجد السبب بسرعة أكبر:

  1. إضافات الأمان وتسجيل الدخول: Wordfence وSucuri وSolid Security وما شابهها
  2. إضافات التخزين المؤقت والتحسين
  3. بوابات الدفع
  4. امتدادات WooCommerce الأخرى
  5. إضافات SEO
  6. كل ما عدا ذلك

اختبر كل إضافة:

  1. فعّل إضافة واحدة.
  2. حاول مجددًا.
  3. ما زال يعمل: فعّل الإضافة التالية وحاول مجددًا.
  4. يفشل مجددًا: دوّن الإضافة التي فعّلتها للتو. من المرجح أنها سبب التعارض.

تأكّد من أن هذه الإضافة هي السبب:

  1. عطّل الإضافات التي أعدت تفعيلها، مع إبقاء WooCommerce وWCPOS وWCPOS Pro وأي بوابة دفع أبقيتها مفعّلة.
  2. فعّل الإضافة التي دوّنتها وحدها، وحاول مجددًا.
  3. تعود المشكلة: هذه الإضافة هي سبب التعارض.
  4. لا تعود المشكلة: قد تكون هناك إضافة أخرى تشارك في التسبب بها. فعّل الإضافات الأخرى واحدة تلو الأخرى، ودوّن زوج الإضافات الذي يعيد ظهور المشكلة.

2.5 دوّن ما توصّلت إليه​

  1. اسم الإضافة وإصدارها.
  2. ما تعطّله، بالعبارات التي دوّنتها في 2.1.
  3. ما إذا كان هناك إصدار أحدث.

ستحتاج إلى هذه المعلومات في الخطوة 4، وعند التواصل مع الدعم.

الخطوة 3: افحص قالبك​

لا تستخدم شاشات POS قالب موقعك، لذا نادرًا ما يتسبب القالب في تعطّل نقطة البيع. لكنه قد يعطّل ما يرسله WordPress إلى POS:

  • صفحة الدفع الخاصة بإحدى بوابات الدفع في تبويب قديم ضمن شاشة الدفع، وصفحة الدفع في المتجر الإلكتروني التي توجّه إليها بوابة الدفع عبر الويب العملاء
  • شاشات WP Admin، بما فيها إعدادات POS
  • طلبات REST API التي يرسلها POS، لأن WordPress يشغّل شيفرة قالبك عند معالجة هذه الطلبات أيضًا

اختبر باستخدام قالب افتراضي​

  1. على موقعك التجريبي، انتقل إلى قالب WordPress افتراضي، مثل Twenty Twenty-Five أو Twenty Twenty-Four.
  2. حاول مجددًا.
  3. يعمل الآن: قالبك هو السبب. أبلغ مطوّر القالب بما يتعطّل.

الخطوة 4: عالج التعارض​

بعد تحديد الإضافة، جرّب ما يلي بالترتيب.

الخيار 1: حدّث الإضافة​

  1. ابحث عن تحديث. ربما عولج التعارض بالفعل.
  2. حدّث على الموقع التجريبي أولًا، وحاول مجددًا.
  3. إذا حلّ ذلك المشكلة، وظل كل من POS وصفحة الدفع في متجرك الإلكتروني يعملان، فحدّث موقعك الفعلي.

الخيار 2: استثنِ POS من الإضافة​

يمكن حل معظم التعارضات من إعدادات الإضافة الأخرى دون تعطيلها. راجع ما يجب استثناؤه، والحل الخاص بإضافتك ضمن تعارضات الإضافات المعروفة.

الخيار 3: ابحث عن بديل​

  1. ابحث عن إضافة أخرى تؤدي الوظيفة نفسها.
  2. جرّبها على الموقع التجريبي.
  3. انقل إعداداتها قبل الانتقال إلى البديل.

الخيار 4: أبلغ مطوّر الإضافة​

أرسل إليه:

  • إصدار الإضافة، وإصدارات WordPress وWooCommerce وWCPOS لديك
  • ما يتعطّل، مع نص الرسالة كما يظهر تمامًا
  • الخطوات التي تؤدي إلى حدوث المشكلة

الخيار 5: استعن بمطوّر لإيجاد حل بديل​

إذا كانت الإضافة ضرورية لك، فغالبًا ما يستطيع مطوّر WordPress منع الجزء المتعارض من العمل على طلبات POS وصفحاته، باستخدام خطّافات الإضافة نفسها.

ما يجب استثناؤه​

تعتمد معظم الحلول أدناه على ضبط الإضافة الأخرى كي لا تتدخل في POS، بدلًا من تعطيلها. إذا كانت إضافتك مدرجة ضمن تعارضات الإضافات المعروفة، فستجد في فقرتها ما يجب تغييره. وإلا، فأرسل التفاصيل أدناه إلى المسؤول عن إدارة موقعك أو إلى دعم الإضافة.

العناوين والإعدادات للمسؤول عن إدارة موقعك

يقرأ POS بيانات متجرك ويحفظها عبر REST API لموقع WordPress. وقد تعطّله أي إضافة تحظر تلك الطلبات أو تخزّنها مؤقتًا أو تعيد كتابتها. إذا لم تكن الإضافة مدرجة:

  • إعدادات جدار الحماية وREST API: اسمح بالوصول إلى /wp-json/ نفسه، وإلى كل ما يندرج تحت /wp-json/wcpos/. أبقِ الحماية مفعّلة لكل العناوين الأخرى.
  • إعدادات التخزين المؤقت وتحسين البرامج النصية: استثنِ /pos و/wcpos-checkout/.
  • لا تجد الإعداد: أرسل هذا الجدول إلى دعم الإضافة، واسأل عن موضع إضافة هذه العناوين.
العنوانما يستخدمه POS لأجله
/wp-json/wcpos/كل ما يقرأه POS ويحفظه
/wp-json/العثور على متجرك عند اتصال التطبيق. يقرأ التطبيق هذا العنوان نفسه، وليس العناوين التي تندرج تحته
/posPOS في متصفح الويب. هذا هو المسار الافتراضي؛ قد يستخدم موقعك قيمة أخرى لـ أساس نقطة البيع ضمن WP Admin > الإعدادات > Permalinks
/wcpos-auth/نافذة تسجيل الدخول في التطبيق
/wcpos-checkout/صفحة الدفع الخاصة بإحدى بوابات الدفع في تبويب قديم، والإيصالات
نافذة تسجيل الدخول في التطبيق لا تستخدم صفحة تسجيل الدخول إلى WordPress

تسجّل تطبيقات سطح المكتب والجوال الدخول عبر نموذج WCPOS الخاص على /wcpos-auth/، في نافذة منفصلة. لا تنطبق عليه الإضافات التي تغيّر صفحة تسجيل الدخول إلى WordPress، مثل عنوان تسجيل دخول مخصص أو رموز المصادقة الثنائية أو اختبار التحقق البشري أو تسجيل الدخول بالبريد الإلكتروني فقط. لكنها تنطبق عند فتح POS في متصفح الويب، إذ يوجّهك أولًا إلى صفحة تسجيل الدخول المعتادة في WordPress.

أنواع الإضافات الشائعة التي تسبب تعارضات​

ما أنواع الإضافات التي قد تتداخل مع POS؟

الأكثر عرضة للتعارض:

  • إضافات الأمان وجدار الحماية قد تحظر طلبات REST API، أو تمنع نقطة البيع من الوصول بعد عدد كبير من الطلبات، أو تمنع تسجيل الدخول.
  • إضافات التخزين المؤقت والتحسين قد ترسل استجابات قديمة إلى POS، أو تعطّل البرامج النصية في الصفحات التي ينشئها WordPress له.
  • إضافات تسجيل الدخول والعضوية والتحكم في الوصول قد تمنع الوصول إلى REST API لمن لم يسجّل دخوله، أو تغيّر طريقة تسجيل المستخدمين للدخول.
  • أدوات إنشاء الصفحات وإضافات إدراج المحتوى في الواجهة الأمامية قد تحمّل برامجها النصية وعناصرها المتراكبة في صفحة الدفع الخاصة بإحدى بوابات الدفع.
  • أي شيء يعمل عند حفظ طلب أو منتج قد يبطئ كل عملية بيع، أو يتسبب في فشل حفظها.

نادرًا ما تسبب مشكلة: قلّما تؤثر إضافات نماذج الاتصال ووسائل التواصل الاجتماعي والتحليلات والمحتوى في POS. تعمل WooCommerce Tax معه: تحصل مبيعات POS على معدلات الضرائب الآلية نفسها المطبقة على طلباتك عبر الإنترنت.

تعارضات الإضافات المعروفة​

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

انتقل إلى: الأمان وتسجيل الدخول · التخزين المؤقت والتحسين · أدوات إنشاء الصفحات · امتدادات WooCommerce وإضافات أخرى · على مستوى الخادم · يعالجها WCPOS

إضافات الأمان وتسجيل الدخول​

هذه هي السبب الأكثر شيوعًا. تحظر الطلبات التي يرسلها POS، فلا يستطيع التطبيق الاتصال أو تسجيل الدخول أو تنزيل بيانات متجرك.

Wordfence: يتعذّر على POS الاتصال أو التنزيل

الخلل: يحظر جدار الحماية الخاص بها طلبات REST API التي يرسلها POS.

الحل: اسمح بالوصول إلى /wp-json/wcpos/ في جدار الحماية. اسمح بهذا العنوان وحده، وليس بكل REST API.

Really Simple Security: حظر REST API أو إعادة توجيه طلباتها

الخلل: تحظر الوصول إلى REST API، أو تفرض إعادة التوجيه.

الحل: عطّل قيود REST API في إعدادات متقدم الخاصة بالإضافة.

Solid Security (iThemes Security): حظر REST API أو منع نقطة البيع من الوصول

الخلل: تحظر REST API، أو تمنع نقطة البيع من الوصول باعتبار طلباتها هجوم تخمين شامل.

الحل: اسمح بعنوانَي POS، وهما /wp-json/ و/wp-json/wcpos/، وعنوان IP الخاص بخادمك نفسه. لا تسمح لعناوين IP بالوصول إلى الموقع بأكمله.

Sucuri: يتعذّر على POS الاتصال أو التنزيل

الخلل: يحظر جدار الحماية الخاص بها طلبات REST API.

الحل: اسمح بالوصول إلى /wp-json/wcpos/ في لوحة تحكم Sucuri.

Force Login والإضافات الأخرى التي تغلق REST API: «تتطلب المصادقة»

الخلل: يعرض التطبيق رسالة «تتطلب REST API الخاصة بـ WordPress على هذا الموقع المصادقة»، أو يعرض رسالة الإضافة نفسها التي تفيد بأن استخدام REST API يقتصر على المستخدمين الذين سجّلوا دخولهم.

الحل: اسمح للزوار الذين لم يسجّلوا دخولهم بالوصول إلى REST API، أو على الأقل إلى /wp-json/ و/wp-json/wcpos/.

Security Optimizer: يطلب POS في متصفح الويب عنوان URL المخصص لتسجيل الدخول

الخلل: يتوقف فتح POS في متصفح الويب عند رسالة تطلب استخدام عنوان URL المخصص لتسجيل الدخول.

الحل: سجّل الدخول إلى WP Admin عبر عنوان URL المخصص لتسجيل الدخول أولًا، ثم انتقل إلى /pos.

Jetpack CRM Client Portal: يتعذّر على المستخدمين تسجيل الدخول

الخلل: يتعذّر على المستخدمين تسجيل الدخول إلى POS.

الحل: عطّل امتداد Client Portal وحده، وليس Jetpack CRM بأكمله.

إضافات الأداء والتخزين المؤقت والتحسين​

WP Rocket, Autoptimize, Hummingbird, Smush: تعطّل صفحات الدفع في تبويب قديم

الخلل: يؤدي تأجيل تحميل JavaScript أو تصغيرها إلى تعطّل صفحات بوابات الدفع في تبويب قديم.

الحل: استثنِ /wcpos-checkout/ و/pos من تحسين JavaScript.

LiteSpeed Cache: إعادة تحميل تطبيق سطح المكتب عند الدفع

الخلل: يُعاد تحميل تطبيق سطح المكتب مرارًا عند الدفع.

الحل: حدّث WCPOS وLiteSpeed Cache، وامسح ذاكرة التخزين المؤقت، واستثنِ /wcpos-checkout/ و/pos من التخزين المؤقت.

أدوات إنشاء الصفحات وإضافات إدراج المحتوى في الواجهة الأمامية​

تحمّل هذه الإضافات برامجها النصية وعناصرها المتراكبة في صفحة الدفع التي تفتحها بوابة دفع من تبويب قديم داخل POS. تحتوي تلك الصفحة على زر إعدادات الدفع الذي يزيل البرامج النصية والأنماط منها: راجع صفحة إحدى بوابات الدفع تظهر بشكل غير سليم.

Elementor: لا تفتح طرق الدفع

الخلل: يعطّل elementor-frontend.js صفحة الدفع، فلا تفتح طرق الدفع.

الحل: في إعدادات الدفع، أزل البرنامج النصي للواجهة الأمامية الخاص بـ Elementor ضمن تعطيل البرامج النصية المحددة، أو امنع Elementor من تحميله على /wcpos-checkout/.

Omnisend وإضافات التسويق الأخرى: اختلال تخطيط صفحة الدفع

الخلل: تتسبب برامجها النصية في اختلال تخطيط صفحة الدفع وتعطيل المدفوعات.

الحل: في إعدادات الدفع، أزل برامجها النصية ضمن تعطيل البرامج النصية المحددة.

MyStickyElements, Complianz: أزرار أو شريط يغطي صفحة الدفع

الخلل: تغطي الأزرار الثابتة أو شريط ملفات تعريف الارتباط صفحة الدفع.

الحل: اضبطها لاستثناء /wcpos-checkout/، أو أزل برامجها النصية في إعدادات الدفع.

امتدادات WooCommerce وإضافات أخرى​

Stripe Tax: لا تعمل مع طلبات POS

الخلل: لا تعمل مع الطلبات المنشأة عبر REST API، وهي الطريقة التي يحفظ بها POS كل طلب.

الحل: لا يوجد حل بديل لهذه المشكلة. WooCommerce Tax هي خدمة الضرائب الآلية التي تعمل مع POS.

WP Activity Log: امتلاء قاعدة البيانات وبطء المتجر

الخلل: تسجّل كل تغيير يجريه POS، فتمتلئ قاعدة البيانات ويصبح المتجر بطيئًا.

الحل: عطّلها، أو استثنِ منتجات POS وطلباته من التسجيل.

MailerLite: خطأ في الخادم (500) عند حفظ عملية بيع

الخلل: عند تفعيل كل من MailerLite Signup Forms وتكامل MailerLite مع WooCommerce، تنفد ذاكرة الخادم ويُرجع خطأ في الخادم (500) عندما يحفظ POS طلبًا.

الحل: عطّل كليهما للتأكد، ثم تواصل مع MailerLite.

The Courier Guy Shipping: يتعذّر حفظ الطلبات

الخلل: يتعذّر على POS حفظ الطلبات بسبب خطأ في الخادم.

الحل: عُد إلى الإصدار السابق من الإضافة، أو تواصل مع مطوّرها.

Mollie: اختفاء التحويل البنكي المباشر

الخلل: تُخفي التحويل البنكي المباشر من شاشة الدفع في POS.

الحل: حدّث Mollie.

CTX Feed: أخطاء 403 في صفحة إعدادات POS

الخلل: تظهر أخطاء 403 من حين إلى آخر في صفحة إعدادات POS.

الحل: عطّلها للتأكد. لا يوجد إعداد معروف يحل المشكلة.

إضافات ماسح الباركود: يتعذّر حفظ الطلبات أو عرضها

الخلل: تفسد بيانات الطلبات التي ترسلها REST API، فيتعذّر حفظ الطلبات أو عرضها.

الحل: عطّلها. يقرأ POS الباركود بنفسه: راجع مسح الباركود.

PixelYourSite, PixelMySite: خطأ فادح

الخلل: خطأ فادح: استدعاء الدالة العضو is_type() على قيمة bool.

الحل: عطّل الإضافة.

Google Listings & Ads: خطأ فادح، لم يُعثر على فئة WCPOS

الخلل: خطأ فادح يفيد بأن فئة WCPOS لم يُعثر عليها.

الحل: احذف كل إضافات WCPOS، ثم ثبّت أحدث إصدار من WCPOS Pro فقط.

WooCommerce Subscriptions: تمنع ترقية Pro من الإصدار 1.7 أو الأقدم

الخلل: تمنع خطوة الترقية الخاصة بـ WCPOS Pro.

الحل: عطّل Subscriptions، وفعّل WCPOS Pro واترك الترقية حتى تكتمل، ثم أعد تفعيل Subscriptions.

Stripe Terminal: أبقِها معطّلة في مدفوعات WooCommerce

فعّل Stripe Terminal لـ POS فقط، من WP Admin > نقطة البيع > الإعدادات > إتمام الطلب. لا يلزم تفعيلها في WP Admin > WooCommerce > الإعدادات > المدفوعات. إذا فُعّلت هناك، فستظهر في صفحة الدفع بمتجرك الإلكتروني، وقد تسببت هناك في تعطّل الدفع للعملاء عبر الإنترنت. راجع Stripe Terminal.

التعارضات على مستوى الخادم​

ترويسات الأمان التي يضبطها خادم الويب: يتوقف POS عند شعاره أو تظهر صفحات فارغة

سطر Content-Security-Policy أو X-Frame-Options في .htaccess أو Nginx أو لوحة تحكم مزوّد الاستضافة.

الخلل: يبقى POS عند شعاره، أو تظهر صفحة دفع في تبويب قديم أو إيصال فارغًا.

الحل: استثنِ /pos و/wcpos-auth/ و/wcpos-checkout/ من تلك الترويسة. لا يكفي السماح بعناوين CDN وحده، لأن صفحة POS تبدأ ببرنامج نصي مضمّن وتجلب ملفاتها من cdn.wcpos.com وcdn.jsdelivr.net. يزيل WCPOS هذه الترويسات من صفحاته عندما يضيفها WordPress أو إحدى الإضافات، لكنه لا يستطيع إزالة ترويسة يضيفها خادم الويب.

GoDaddy Website Firewall: «تم استلام 'undefined'»

الخلل: يحظر /wp-json/، مع رسالة «تم استلام 'undefined'».

الحل: اسمح بالمسار /wp-json/ في جدار الحماية: راجع أداء الخادم.

تعارضات يعالجها WCPOS بنفسه​

إضافات كانت تسبب تعارضات ولا تحتاج الآن إلى أي إجراء منك

أبقِ WCPOS محدّثًا، ولن تحتاج هذه الإضافات إلى أي ضبط:

  • ترويسات الأمان التي تضيفها الإضافات. قد تضيف Wordfence وLiteSpeed Cache وإضافات أخرى ترويسة Content-Security-Policy تمنع تحميل POS. يزيل WCPOS ترويستَي Content-Security-Policy وX-Frame-Options من صفحاته. ويمكن للمطوّر الذي يحتاج إلى سياسة هناك ضبطها باستخدام المرشّح wcpos_content_security_policy.
  • إضافات JWT Authentication. كانت ترفض رمز تسجيل الدخول الخاص بـ POS، فيفشل كل طلب بعد تسجيل الدخول بخطأ 403. يزيل WCPOS الآن الخطأ الصادر عنها عندما يكون قد صادق على الطلب بنفسه؛ أما أخطاء الإضافات الأخرى فتظل تظهر.
  • Image Prioritizer. تملأ ترويسة Link التي تستخدمها التطبيقات للعثور على موقع WordPress. عندما لا تشير تلك الترويسة إلى REST API الخاصة بموقعك، يبحث عنها التطبيق في /wp-json/ بدلًا من ذلك. إذا ظل التطبيق يعرض رسالة «لا يبدو أن الموقع موقع WordPress»، فعطّل الإضافة.
  • الإضافات التي تعمل عند حفظ منتج (Jetpack وAstra وXero وغيرها). كانت إصدارات WCPOS القديمة تتسبب في إضافتها صفوفًا مكررة مع كل طلب. أُصلح ذلك في 1.8.12، وأزالت الترقية الصفوف المكررة.
  • WooCommerce Stripe 11.1.0. كان البرنامج النصي للبطاقات الخاص بها يمنع جميع طرق الدفع الأخرى من إتمام الدفع على صفحة دفع في تبويب قديم. ما دامت إضافة Stripe لديك أقدم من 11.1.1، يزيل WCPOS البرنامج النصي للبطاقات والأنماط الخاصة بـ Stripe من تلك الصفحة. تعمل طرق الدفع الأخرى حينها، لكن نموذج البطاقة الخاص بـ Stripe لا يظهر هناك. أصلحت Stripe التعارض في 11.1.1. حدّث Stripe، وسيُبقي WCPOS نموذج البطاقة الخاص بها على الصفحة مجددًا، حتى لو كان حفظ سابق لـ إعدادات الدفع قد عطّله.
  • MyParcel. كانت السلة التي تحتوي على منتج متنوع لا تستطيع إتمام الدفع، لأن MyParcel كانت تواجه خطأً فادحًا أثناء حفظ الطلب. يُبلغ WCPOS الآن MyParcel بأن هذا البند ليس له منتج في الكتالوج، كما يفعل WooCommerce، فتكتمل عملية البيع.

نصائح للوقاية​

الصيانة الدورية​

  1. أبقِ الإضافات محدّثة.
  2. احذف الإضافات التي لا تستخدمها، بدلًا من تركها معطّلة.
  3. اختبر كل تحديث على الموقع التجريبي قبل تطبيقه على موقعك الفعلي.
  4. راقب سرعة خادمك بالاستعانة بصفحة أداء الخادم.

اختيار الإضافات​

  1. اختر إضافات يجري تحديثها باستمرار وتحظى بتقييمات جيدة.
  2. لا تشغّل إضافتين تؤديان الوظيفة نفسها.
  3. تحقّق من أن الإضافة تذكر أنها اختُبرت مع إصدار WooCommerce لديك.
  4. أضف الإضافات واحدة تلو الأخرى، وافحص نقطة البيع بعد كل إضافة.

الحصول على المساعدة​

إذا لم تتمكن من تحديد التعارض أو حلّه، فتواصل معنا.

لمستخدمي Pro​

مع WCPOS Pro

يتضمن ترخيص Pro أولوية في الدعم عبر قنوات Pro على Discord. راجع المجاني مقارنةً بـ Pro.

دعم المجتمع​

ما يجب إرساله​

  1. إضافاتك المفعّلة مع إصداراتها. يعرضها WP Admin > Tools > Site Health > Info، مع زر نسخ معلومات الموقع إلى الحافظة.
  2. إصدارات WordPress وWooCommerce وWCPOS لديك.
  3. ما يحدث من خلل، بالعبارات التي دوّنتها.
  4. ما جرّبته بالفعل.
  5. رسائل الخطأ من السجلات. يجمع زر نسخ معلومات تصحيح الأخطاء في تبويب السجلات (مشاركة معلومات تصحيح الأخطاء في تطبيقَي iOS وAndroid) المعلومات التي نحتاجها.
  6. أوقات استجابة خادمك، إذا كان بطيئًا.