دليل المشاكل والحلول

دليل المشاكل والحلول

قائمة شاملة بأبرز المشاكل التي قد تواجهك عند استخدام AccelerateWP، مع الحلول العملية.

مشاكل التعارض والتوافق

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

المشكلة: إذا كانت لديك إضافات كاش أخرى مُثبَّتة ومُفعَّلة مثل W3 Total Cache أو WP Super Cache أو WP Fastest Cache أو LiteSpeed Cache، فإن AccelerateWP لن يعمل بشكل صحيح. الجمع بين إضافتَي كاش في وقت واحد يُسبّب تعارضاً خطيراً قد يُعطّل الموقع بالكامل أو يُظهر صفحات مكسورة.
الحل:
    اذهب إلى Plugins في لوحة إدارة ووردبريس؛
    ألغِِ تفعيل أي إضافة كاش أخرى أولاً؛
    احذفها نهائياً — إلغاء التفعيل وحده لا يكفي لأن ملفات الإعدادات قد تبقى نشطة؛
    امسح الكاش القديم إن وُجد؛
    فعّل AccelerateWP من جديد عبر cPanel.
ملاحظة: AccelerateWP يُجري فحوصات توافق تلقائية قبل التفعيل — إذا رصد وجود إضافة كاش أخرى، سيُنبّهك قبل المتابعة.

عدم دعم WordPress Multisite

المشكلة: AccelerateWP لا يدعم مواقع ووردبريس التي تعمل بوضع Multisite (شبكة المواقع). محاولة تفعيله على موقع Multisite تُسبّب سلوكاً غير متوقع.
الحل:
  • إذا كنت تدير شبكة Multisite، لا تُفعّل AccelerateWP على تلك المواقع؛
  • إذا كنت بحاجة لتسريع Multisite، تواصل مع  ⁠⁠الدعم الفني⁠  للحصول على بديل مناسب.

تعارض إضافات Redis الأخرى مع Object Cache

المشكلة: إذا كانت لديك إضافة Object Cache مستقلة كـ "Redis Object Cache" أو "W3 Total Cache مع Redis"، فهي غير متوافقة مع تطبيق AccelerateWP لـ Redis. قد تتعارض البيانات بين النسختين مما يُسبّب أخطاء في استرجاع البيانات.
الحل:
    احذف أي إضافة Object Cache مستقلة؛
    فعّل Object Cache عبر AccelerateWP فقط من خلال cPanel أو SmartAdvice؛
    لا تُثبّت إضافة Redis يدوية مجدداً — AccelerateWP يُدير النسخة الخاصة به تلقائياً.

إصدار PHP غير متوافق

المشكلة: إذا كان موقعك يعمل على إصدار PHP أقل من 7.3، لن يتمكن AccelerateWP من التفعيل وستظهر رسالة خطأ.
الحل:
    اذهب إلى cPanel وابحث عن "Select PHP Version"؛
    غيّر الإصدار إلى إصدار أعلى (يُنصح بـ 8.3 للأداء الأمثل)؛
    تأكد أن إضافات موقعك تدعم الإصدار الجديد قبل التغيير؛
    أعد تفعيل AccelerateWP بعد تحديث PHP.

إصدار ووردبريس قديم

المشكلة: AccelerateWP يتطلب ووردبريس 5.8 أو أحدث. المواقع التي تعمل على إصدارات قديمة لن تستطيع استخدام الأداة.
الحل:
    احتفظ بنسخة احتياطية كاملة من الموقع أولاً؛
    حدّث ووردبريس إلى أحدث إصدار؛
    تحقق من توافق جميع إضافاتك مع الإصدار الجديد؛
    أعد تفعيل AccelerateWP.

مشاكل المظهر والتنسيق

مظهر مكسور بعد تفعيل Minify CSS/JS

المشكلة: بعد تفعيل Minify CSS أو Combine CSS، قد يظهر تنسيق الموقع مكسوراً أو تختفي بعض الألوان والخطوط، خاصةً مع القوالب المعقدة ومُنشئي المواقع مثل (Elementor, Divi, WPBakery).
الحل:
    اذهب إلى File Optimization ← AccelerateWP؛
    في خانة "Excluded CSS Files"، أضف مسار ملف CSS الإشكالي (مثال: (.*)elementor(.*).css)؛
    امسح الكاش بالكامل وتحقق من الموقع؛
    إذا استمرت المشكلة، أوقف Combine CSS مع الإبقاء على Minify CSS فقط.
تحذير مهم: عند استثناء ملفات CSS خارجية (من نطاق مختلف)، يجب استخدام النطاق الكامل أو مسار URL الكامل. تذكر أن Minification تحذف النطاق من URL، لذا استخدم (.*) كـ Wildcard لتجنب المشاكل.

أزرار وقوائم لا تستجيب بعد تفعيل Delay JavaScript

المشكلة: بعض الأزرار، النوافذ المنبثقة (Popups)، قوائم التنقل، أو نماذج الاتصال قد تتوقف عن العمل بعد تفعيل Delay JavaScript Execution، لأنها تعتمد على تنفيذ JS فور تحميل الصفحة.
الحل:
    اذهب إلى JavaScript Files ← AccelerateWP؛
    في خانة "Excluded JS"، أضف مسار ملف JavaScript الإشكالي؛
    اختبر كل وظيفة تفاعلية على الموقع بعد التفعيل؛
    كبديل: فعّل "Apply Delay JS only on mobile" بدلاً من التطبيق الكامل.
تذكير: Delay JavaScript يعمل فقط على الصفحات المُخزَّنة في الكاش، ولا يتوافق مع خيار Combine JavaScript — استخدم أحدهما لا كليهما.

تنسيق الجوال مكسور بعد Aggressive Mobile CSS

المشكلة: خيار Aggressive Mobile CSS Optimization قد يحذف أنماط CSS ضرورية لتصميم الجوال مما يُظهر صفحات بتنسيق مكسور على الهاتف.
الحل:
    أوقف هذا الخيار فوراً من CSS ← File Optimization ← AccelerateWP؛
    امسح الكاش الكامل؛
    إذا أردت إعادة تجربته، اختبر على صفحة واحدة فقط باستخدام وضع الجوال في متصفحك قبل التطبيق الشامل.
ملاحظة: هذا الخيار مُعطَل افتراضياً لأن CloudLinux نفسها تُحذّر من تفعيله دون اختبار دقيق لكل موقع على حدة.

التنسيق القديم يظهر بعد تغيير القالب

المشكلة: بعد تغيير قالب ووردبريس (Theme)، يستمر الموقع في عرض التنسيق القديم لبعض الزوار بسبب الكاش المُخزَّن مسبقاً.
الحل:
    اذهب إلى لوحة AccelerateWP في ووردبريس؛
    انقر "Clear Cache" لمسح الكاش الكامل؛
    انقر "Regenerate Critical CSS" لإعادة توليد ملف CSS الحرج بناءً على القالب الجديد؛
    انتظر بضع دقائق حتى تكتمل عملية التوليد وتظهر إشعار "Completed".

تحديث الإضافات والقوالب يُظهر تصميماً قديماً

المشكلة: بعد تحديث إضافة أو قالب، قد يستمر الموقع في تقديم ملفات CSS/JS القديمة المُخزَّنة في الكاش للزوار.
الحل:
    امسح الكاش فوراً بعد أي تحديث من زر "Clear Cache" في AccelerateWP؛
    تحقق من مظهر الموقع في وضع التصفح الخفي (Incognito) للتأكد من أن الزوار يرون النسخة الجديدة؛
    إذا استمرت المشكلة، فعّل "Always Purge URL(s)" لإضافة الصفحات الحساسة لقائمة المسح التلقائي.

مشاكل المتاجر الإلكترونية (WooCommerce)

كسر سلة المشتريات وصفحة الدفع

المشكلة: إذا كان موقعك متجراً WooCommerce وتمّ تخزين صفحات Cart أو Checkout أو My Account في الكاش، سيرى جميع الزوار نفس محتوى السلة، أو ستظهر سلة فارغة بشكل مستمر، أو لن تعمل عملية الدفع بشكل صحيح.
الحل: AccelerateWP يستثني هذه الصفحات تلقائياً من الكاش وفق التوثيق الرسمي عبر القواعد التالية:
/cart/
/checkout/
/my-account/
يجب أن يتم التحقق من أن هذه الصفحات مُستثناة من الإعداد التالي:
Never Cache URL(s) ← Advanced Rules ← AccelerateWP
إذا لم تكن موجودة، أضفها يدوياً.

مشكلة عرض الأسعار والمخزون للمستخدمين المسجلين

المشكلة: في متاجر WooCommerce التي تعرض أسعاراً مختلفة حسب مجموعة المستخدم (تجار الجملة مقابل التجزئة)، قد يرى الزوار المسجلون الأسعار الخاطئة بسبب الكاش العام.
الحل:
    فعّل خيار "User Cache" من Caching ← AccelerateWP؛
    أضف ملف تعريف الارتباط الخاص بـ WooCommerce إلى Never Cache Cookies؛
woocommerce_items_in_cart, woocommerce_cart_hash, wordpress_logged_in_*
    امسح الكاش بالكامل وأعد الاختبار.

أداة Redis لا تُحسّن أداء موقعي WooCommerce

المشكلة: قد لا يُلاحظ بعض أصحاب متاجر WooCommerce الصغيرة أي تحسين ملحوظ بعد تفعيل Object Cache (Redis).
الحل: هذا أمر طبيعي ومتوقع. وفقاً لبيانات CloudLinux الرسمية، فإن نحو 8% فقط من المواقع تستفيد بشكل ملحوظ من Redis (بمعيار تحسين لا يقل عن 30%). Redis يُحدث فارقاً حقيقياً فقط في المواقع التي تعاني من استعلامات SQL بطيئة ومتكررة. إذا لم تصلك توصية SmartAdvice بتفعيله، فموقعك على الأرجح لا يحتاجه.

مشاكل الصور

أخطاء صلاحيات مجلدات الصور

المشكلة: لا تبدأ عملية تحسين الصور ويظهر إشعار خطأ باللون الأحمر يُشير إلى أن مجلدات النسخ الاحتياطي أو المؤقتة تفتقر لصلاحيات الكتابة.
الحل:
    حاول إعادة تفعيل Image Optimization من cPanel أولاً؛
    إذا استمرت المشكلة، تواصل مع دعم إليفانتي كلاود لإصلاح صلاحيات المجلدات؛
    يمكن إنشاء المجلدات يدوياً عبر File Manager في cPanel وضبط صلاحياتها على 755.


تجاوز الحصة الشهرية لتحسين الصور

المشكلة: يظهر إشعار أصفر يُفيد بأن حصة تحسين الصور الشهرية قد استُنفدت، وتوقفت عملية التحسين.
الحل:
  • هذا سلوك طبيعي بحسب التوثيق الرسمي. العملية ستُستأنف تلقائياً في بداية الشهر التالي؛
  • الصور التي تم تحسينها مسبقاً تبقى محسّنة ولن تتأثر؛
  • الصور الجديدة المرفوعة ستُضاف لقائمة الانتظار وتُعالج بأولوية عالية عند بدء الدورة الجديدة.


فشل إنشاء جدول قاعدة البيانات لتحسين الصور

المشكلة: يظهر خطأ يُفيد بأنه "لا يمكن إنشاء الجدول wp_wpr_image_optimization" في قاعدة البيانات، ولا تبدأ عملية تحسين الصور.
الحل:
    تحقق من أن مستخدم قاعدة البيانات لديه صلاحية إنشاء الجداول (CREATE)؛
    حاول إعادة تفعيل Image Optimization؛
    إذا استمرت المشكلة، تواصل مع دعم إليفانتي كلاود لمراجعة صلاحيات قاعدة البيانات.

صور WebP لا تظهر على بعض المتصفحات

المشكلة: بعد تحويل الصور إلى WebP، قد لا تظهر على متصفحات قديمة لا تدعم هذا التنسيق.
الحل: AccelerateWP يحتفظ بالصور الأصلية ويُقدّم WebP فقط للمتصفحات التي تدعمها. إذا لاحظت مشكلة، تأكد من أن قواعد إعادة التوجيه (Rewrite Rules) في إعدادات LiteSpeed تعمل بشكل صحيح. راجع ملف htaccess. وتأكد من وجود قواعد AccelerateWP فيه.

صور Elementor لا تستفيد من Lazy Loading

المشكلة: الصور المُضافة كـ Background Image في Elementor أو عبر وسم <style> لا تخضع لـ Lazy Loading، مما يُبطئ تحميل الصفحات الثقيلة.
الحل: هذا قيد تقني موثّق في التوثيق الرسمي لـ CloudLinux — Lazy Loading يعمل فقط على الصور ضمن وسم <img>. كحل بديل:
  • استخدم الصور كـ <img> عوضاً عن Background Image كلما أمكن؛
  • فعّل Image Optimization لتقليص حجم هذه الصور بدلاً من الاعتماد على Lazy Loading.

مشاكل Critical CSS

خاصية Critical CSS لا يمكن تفعيله من داخل ووردبريس

المشكلة: يحاول المستخدم تفعيل Critical CSS من إعدادات إضافة AccelerateWP داخل ووردبريس لكن الزر غير نشط (Disabled).
الحل: وفقاً للتوثيق الرسمي، Critical CSS لا يمكن تفعيله إلا من:
  • واجهة cPanel من قسم AccelerateWP، أو
  • توصية SmartAdvice داخل ووردبريس.
بعد تفعيله من إحدى هاتين الطريقتين، يمكن إدارة خياراته من داخل إضافة ووردبريس.

خاصية Critical CSS تُظهر تنسيقاً مكسوراً في الجزء العلوي

المشكلة: بعد تفعيل Critical CSS، قد يظهر الجزء العلوي من الصفحة (Above the Fold) بتنسيق مختلف أو ناقص أثناء فترة التوليد.
الحل:
    هذا أمر مؤقت — انتظر حتى تنتهي عملية توليد Critical CSS (تظهر لك حالتها في لوحة AccelerateWP)؛
    إذا استمرت المشكلة بعد اكتمال التوليد، أضف الأنماط الناقصة في خانة "Fallback CSS" في إعدادات AccelerateWP؛
    إذا قمت بتغيير أي تصميم CSS في موقعك، انقر "Regenerate Critical CSS" يدوياً.

مشاكل أداء الموقع العامة بعد التفعيل

الموقع أبطأ بعد تفعيل AccelerateWP!

المشكلة: في حالات نادرة، قد يشعر بعض المستخدمين بأن الموقع أبطأ مباشرةً بعد تفعيل الكاش.
الحل: الكاش يحتاج وقتاً لـ"الإحماء" (Warming Up). الصفحة الأولى لكل رابط تُولّد الكاش، وما بعدها تُقدَّم فوراً. إذا فعّلت Cache Preloading، سيتم بناء الكاش مسبقاً في الخلفية وسيتحسن الأداء بشكل ملحوظ خلال دقائق. إذا استمرت المشكلة، تحقق من:
    عدم وجود إضافات أخرى تتعارض مع AccelerateWP؛
    أن إعدادات Delay JS أو Combine JS لا تُسبّب تأخيراً في JavaScript ضروري لأداء الصفحة.

نتائج PageSpeed Insights لم تتحسن كما هو متوقع

المشكلة: بعد تفعيل AccelerateWP، لا تزال درجة PageSpeed منخفضة.
الحل: تأكد من تفعيل هذه الميزات تراتبياً:
    ميّزة Page Caching — يُحسّن TTFB بشكل كبير.
    ميّزة Minify CSS/JS — يُقلّص حجم الملفات.
    ميّزة Lazy Loading — يُحسّن مؤشر LCP.
    ميّزة Critical CSS — يُلغي blocking CSS ويُحسّن FCP وLCP.
    ميّزة Defer JS — يُلغي blocking JavaScript.
    ميّزة Reduce Font Layout Shifts — يُحسّن مؤشر CLS.
إذا بقيت المشكلة، قد تكون إضافات ووردبريس نفسها أو الصور الكبيرة هي المسبّب — وهنا يأتي دور Image Optimization وSmartAdvice لتشخيص الاختناقات الفعلية.

أخطاء عند تطبيق توصية SmartAdvice

المشكلة: عند النقر على "Apply Advice"، تظهر رسالة خطأ ولا يُطبَّق التحسين.
الحل:
إذا تسبّب تطبيق التوصية في خطأ. تواصل مع فريق الدعم إذا لم تتمكن من حلّ المشكلة بنفسك وأرسل لهم رسالة الخطأ الكاملة، وسيقومون بحلها على مستوى الخادم.