ليه تعديلات CSS مش بتظهر على موقع ووردبريس رغم مسح الكاش؟

افصل مشكلة تحميل الملف عن مشكلة تطبيق القاعدة

اختر عنصرًا صغيرًا تستطيع تمييزه، مثل عنوان بطاقة، وافتح Inspect ثم Styles. ابحث عن المحدد الذي عدّلته: هل يظهر السطر الجديد؟ هل عليه شطب؟ هل يوجد داخل شرط عرض لا ينطبق على نافذتك؟ ظهور السطر مع شطب قيمته يعني أن الملف وصل، وأن المشكلة في ترتيب القواعد أو أولويتها، لا في الكاش. لا تبدأ بإضافة important لكل شيء؛ ستنقل التعارض إلى مكونات أخرى.

من Network رشّح الطلبات بكلمة CSS وافتح الاستجابة نفسها، لا نسخة الملف في محرر جهازك. ابحث عن القيمة الجديدة وسجّل عنوان الطلب كاملًا. قد تعدّل ملفًا داخل القالب الأب بينما الصفحة تستخدم ملفًا مجمعًا أو ملف القالب الابن. وقد تكون الصفحة التي تفحصها من بيئة مختلفة تمامًا عن المكان الذي رفعت إليه التعديل.

حدد طبقة النسخة القديمة

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

استخدم إصدارًا يتغير مع الملف

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

مثال تشخيصي: غيرت حجم العنوان إلى قيمة مميزة على نسخة الاختبار. إن ظهرت القيمة في Network ولم تتغير النتيجة، سجّل القاعدة الفائزة ومصدرها. وإن لم تظهر داخل الاستجابة، سجّل رابط المورد والوقت وإصدار النشر. هاتان الحالتان تحتاجان إصلاحين مختلفين، وإرسال هذا الدليل للمطور يوفر تجربة تغييرات غير مترابطة.

متى تعتبر المشكلة محلولة؟

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