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

تعارضات المكونات الإضافية

تعد تعارضات المكونات الإضافية واحدة من أكثر الأسباب شيوعًا للمشاكل مع WCPOS. عندما تتداخل المكونات الإضافية الأخرى في ووردبريس مع وظائف WooCommerce أو WCPOS، قد تواجه أعطالًا أو مشاكل في الأداء أو سلوكًا غير متوقع.

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

يمكن أن يكون لديك تعارض في المكونات الإضافية إذا واجهت:

  • أخطاء قاتلة - "لقد حدث خطأ فادح في هذا الموقع"
  • مشاكل في الأداء - تحميل بطيء، انتهاء الوقت، أو تحميل مرتفع للخادم
  • مشاكل في الوظائف - الميزات لا تعمل كما هو متوقع
  • مشاكل في مزامنة البيانات - المنتجات أو الطلبات أو العملاء لا تتم مزامنتها بشكل صحيح
  • مشاكل في بوابة الدفع - فشل في إتمام الدفع أو أخطاء في معالجة الدفع

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

مهم

لا تقم أبدًا باستكشاف تعارضات المكونات الإضافية على موقعك المباشر. استخدم دائمًا بيئة تجريبية لتجنب تعطيل عمليات عملك.

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

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

إذا لم يوفر مضيفك موقعًا تجريبيًا​

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

  • اختبار المكون الإضافي/السمة بشكل آمن
  • تحديثات ووردبريس
  • استكشاف الأخطاء
  • أعمال التطوير

المضيفون الموصى بهم الذين يقدمون مواقع تجريبية:

  • WP Engine
  • SiteGround
  • Kinsta
  • Cloudways
  • العديد من الآخرين

الخطوة 1: تحقق من الأخطاء الفادحة​

إذا كنت تعاني من أعطال أو أخطاء حرجة، ابدأ بفحص سجلات الأخطاء:

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

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

الخطوة 2: طريقة التخلص من المكونات الإضافية​

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

2.1 إنشاء خط أساس​

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

2.2 تعطيل جميع المكونات الإضافية (باستثناء الضرورية)​

احتفظ بهذه المكونات الإضافية نشطة:

  • WooCommerce
  • WooCommerce POS (WCPOS)
  • WooCommerce POS Pro (إذا كان لديك)

قم بتعطيل كل شيء آخر:

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

2.3 اختبار المشكلة​

  1. امسح أي ذاكرة تخزين مؤقتة - إذا كنت تستخدم مكونات إضافية للتخزين المؤقت، قم بمسح جميع الذاكرات
  2. اختبر الوظائف المزعجة - هل تعمل الآن؟
  3. تحقق من الأداء - هل تحسنت أوقات التنفيذ؟

إذا تم حل المشكلة: لديك تعارض في المكون الإضافي. تابع إلى الخطوة 2.4.

إذا استمرت المشكلة: فمن المحتمل أن تكون المشكلة ليست تعارضًا في المكونات الإضافية. فكر في:

  • مشاكل موارد الخادم (راجع أداء الخادم)
  • تعارضات في السمات (راجع الخطوة 3)
  • مشاكل النواة في ووردبريس / WooCommerce

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

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

  1. قم بتمكين مكون إضافي واحد - ابدأ بالأساسية أولاً
  2. اختبر الوظيفة - تحقق مما إذا كانت المشكلة تعود
  3. إذا لم تكن هناك مشكلة - قم بتمكين المكون الإضافي التالي واختبر مرة أخرى
  4. إذا عادت المشكلة - لقد وجدت المكون الإضافي المتعارض!

ترتيب أولوية المكونات الإضافية (قم بتمكينها بهذا الترتيب):

  1. مكونات أمان - Wordfence، Sucuri، إلخ.
  2. مكونات تحسين محركات البحث - Yoast، RankMath، إلخ.
  3. مكونات الأداء - التخزين المؤقت، والتحسين
  4. بوابات الدفع - Stripe، PayPal، إلخ.
  5. امتدادات WooCommerce الأخرى
  6. مكونات ووردبريس العامة

2.5 وثق ملاحظاتك​

عندما تحدد المكون الإضافي المتعارض:

  1. دوّن اسم المكون الإضافي والإصدار
  2. وثق المشكلة المحددة التي يسببها
  3. تحقق مما إذا كانت هناك نسخة محدثة متاحة
  4. ابحث عن مكونات إضافية بديلة توفر وظائف مماثلة

الخطوة 3: تحقق من تعارضات السمات​

بينما نادرًا ما تؤثر السمات على WCPOS (نظرًا لأنها تستخدم واجهتها الخاصة)، إلا أنها قد تسبب أحيانًا مشاكل في:

  • عمليات الدفع (إذا كنت تستخدم بوابة الدفع عبر الويب)
  • وظائف منطقة الأدمن
  • استجابات واجهة برمجة التطبيقات

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

  1. على موقعك التجريبي، قم بتبديل إلى سمة ووردبريس افتراضية:
    • Twenty Twenty-Four
    • Twenty Twenty-Three
    • Twenty Twenty-Two
  2. اختبر الوظائف المزعجة
  3. إذا تم حل المشكلة - فإن سمة لديك تعاني من تعارض
تأثير السمات

من غير المحتمل أن تسبب السمات مشاكل في WCPOS مقارنةً بالمكونات الإضافية. تعمل واجهة POS بشكل مستقل عن سمة لديك. ومع ذلك، قد تؤثر السمات على:

  • صفحات الدفع في WooCommerce
  • وظائف إدارة ووردبريس
  • استجابات واجهة برمجة التطبيقات REST

الخطوة 4: حل تعارضات المكونات الإضافية​

بمجرد تحديد المكون الإضافي المتعارض، لديك عدة خيارات:

الخيار 1: تحديث المكون الإضافي​

  1. تحقق من التحديثات - قد يتم إصلاح التعارض في نسخة أحدث
  2. قم بتحديث المكون الإضافي على موقعك التجريبي أولاً
  3. اختبر بدقة قبل التحديث على الموقع المباشر

الخيار 2: العثور على بديل​

  1. ابحث عن مكونات إضافية بديلة توفر نفس الوظيفة
  2. اختبر البدائل على موقعك التجريبي
  3. نقل الإعدادات إذا كنت تقوم بتبديل المكونات الإضافية

الخيار 3: الاتصال بمطور المكون الإضافي​

  1. قدم تقريرًا عن التعارض لمطور المكون الإضافي
  2. قدم معلومات مفصلة:
    • إصدارات المكونات الإضافية المعنية
    • إصدارات ووردبريس و WooCommerce
    • رسائل الخطأ أو السلوك الدقيق
    • خطوات لإعادة إنتاج المشكلة

الخيار 4: حل مخصص​

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

  1. اتصل بمطور ووردبريس لإنشاء إصلاح مخصص
  2. فكر في استخدام روابط محددة للمكون الإضافي لتعطيل الوظائف المتعارضة
  3. استخدم المنطق الشرطي لتعطيل المكون الإضافي في الصفحات المتعلقة بـ POS

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

فئات المكونات الإضافية عالية المخاطر​

مكونات الأمان:

  • يمكن أن تمنع طلبات واجهة برمجة التطبيقات
  • قد تتداخل مع المصادقة
  • غالبًا ما تحتوي على قواعد جدار نارية عدوانية

مكونات التخزين المؤقت:

  • يمكن أن تخزن استجابات واجهة برمجة التطبيقات بشكل غير مناسب
  • قد تتداخل مع البيانات في الوقت الحقيقي
  • يمكن أن تسبب مشاكل في البيانات العالقة

مكونات تحسين محركات البحث:

  • يمكن أن تبطئ المكونات الثقيلة منطقة الإدارة
  • قد تضيف استعلامات قاعدة بيانات غير ضرورية
  • يمكن أن تتداخل مع استجابات واجهة برمجة التطبيقات REST

بناة الصفحات:

  • غالبًا ما تحمل سكريبتات ثقيلة في منطقة الإدارة
  • يمكن أن تتعارض مع صفحات إدارة WooCommerce
  • قد تتداخل مع عمليات الدفع

مكونات العضوية/القيود:

  • يمكن أن تمنع الوصول إلى واجهة برمجة التطبيقات
  • قد تتداخل مع مصادقة المستخدم
  • يمكن أن تقيد الوصول إلى الموارد المطلوبة

فئات المكونات الإضافية منخفضة المخاطر​

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

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

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

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

أفضل الممارسات لاختيار المكونات الإضافية​

  1. اختر مطورين موثوقين - تحقق من المراجعات وتكرار التحديثات
  2. تجنب الوظائف المكررة - لا تقم بتثبيت مكونات إضافية متعددة تؤدي نفس الوظيفة
  3. اقرأ معلومات التوافق - تحقق مما إذا كانت المكونات الإضافية تم اختبارها مع WooCommerce
  4. ابدأ باستخدام مكونات إضافية قليلة - أضف الوظائف تدريجيًا حسب الحاجة

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

إذا كنت غير قادر على حل تعارض المكونات الإضافية:

للمستخدمين المحترفين​

دعم المحترفين

يتلقى المستخدمون المحترفون أولوية الدعم لحل تعارضات المكونات الإضافية. يمكن لفريقنا المساعدة في تحديد وحل التعارضات نيابة عنك.

دعم المجتمع​

Discord Communitysupport@wcpos.com

عند الاتصال بالدعم​

يرجى تقديم:

  1. قائمة المكونات الإضافية النشطة مع الإصدارات
  2. إصدارات ووردبريس و WooCommerce
  3. وصف مفصل للمشكلة
  4. الخطوات التي جربتها بالفعل
  5. رسائل الخطأ من السجلات
  6. مقاييس أداء الخادم إذا كانت ذات صلة
خطأ حرجكيفية العثور على سجلات الأخطاء الفادحة
السجلاتفهم سجلات WCPOS والمقاييس
أداء الخادمتشخيص مشاكل الأداء
أداء الدفعتحسين سرعة الدفع