يعتمد ووكومرس (WooCommerce) على صفحات محددة لعرض سلة التسوق، وصفحة الدفع، وحساب العميل. إذا كانت هذه الصفحات مفقودة، أو فارغة، أو لا تعرض المحتوى بشكل صحيح، فهناك عدة أسباب محتملة — بدءاً من عدم تعيين الصفحات، إلى مشاكل الروابط الدائمة (Permalinks)، أو مشاكل التخزين المؤقت (Caching)، أو التعارضات بين الإضافات والقوالب. يساعدك هذا الدليل في تشخيص المشكلة وإصلاحها.
الأسباب المحتملة
عندما لا يتم عرض صفحات ووكومرس بشكل صحيح، عادةً ما تكون المشكلة ناجمة عن أحد الأسباب التالية:
- صفحات مفقودة أو غير معيّنة — الصفحة المطلوبة في ووكومرس غير موجودة أو لم يتم تعيينها في إعدادات ووكومرس الخاصة بك.
- مشاكل الروابط الدائمة (Permalinks) — إعدادات الروابط الدائمة القديمة أو التالفة يمكن أن تمنع تحميل صفحات ونقاط نهاية (Endpoints) ووكومرس.
- التخزين المؤقت (Caching) — تقوم إضافة تخزين مؤقت أو تخزين مؤقت على مستوى الخادم (Server-level cache) بعرض نسخة قديمة من الصفحة.
- تعارض الإضافات أو القوالب — توجد إضافة أخرى أو قالبك النشط يتداخل مع إخراج صفحة ووكومرس.
تفرغ الأقسام أدناه تقديم إصلاحات خطوة بخطوة لكل سبب من هذه الأسباب.
تحديث/تفريغ الروابط الدائمة (Flush Permalinks)
إعدادات الروابط الدائمة القديمة هي أحد أكثر الأسباب شيوعاً لإرجاع صفحات ووكومرس خطأ 404 أو عرض محتوى فارغ. يؤدي تفريغ الروابط الدائمة إلى إجبار ووردبريس على إعادة بناء قواعد توجيه عناوين URL الخاصة به.
- اذهب إلى الإعدادات > الروابط الدائمة (Settings > Permalinks) في لوحة تحكم ووردبريس.
- دون تغيير أي إعدادات، انقر على حفظ التغييرات (Save Changes).
- قم بزيارة صفحة ووكومرس المتأثرة في الواجهة الأمامية لموقعك للتحقق مما إذا تم حل المشكلة.
مسح ذاكرة التخزين المؤقت (Clear your cache)
إذا كنت تستخدم إضافة تخزين مؤقت (مثل WP Super Cache، أو W3 Total Cache، أو LiteSpeed Cache) أو كان مزود الاستضافة الخاص بك يطبق تخزيناً مؤقتاً على مستوى الخادم، فقد يتم عرض نسخة مخزنة مؤقتاً من الصفحة بدلاً من المحتوى الحالي.
- امسح ذاكرة التخزين المؤقت في إضافة التخزين المؤقت الخاصة بك. تعتمد الخطوات الدقيقة على الإضافة التي تستخدمها — تحقق من وثائق الإضافة إذا لم تكن متأكداً.
- إذا كان مزود الاستضافة الخاص بك يقدم تخزيناً مؤقتاً على مستوى الخادم، فامسح هذا التخزين المؤقت أيضاً. يمكنك عادةً القيام بذلك من لوحة تحكم الاستضافة الخاصة بك.
- امسح ذاكرة التخزين المؤقت للمتصفح، أو افتح الصفحة في نافذة تصفح مخفي (Incognito أو Private).
- قم بزيارة صفحة ووكومرس المتأثرة للتحقق مما إذا تم حل المشكلة.
ملاحظة: يجب عادةً استثناء صفحات سلة التسوق والدفع في ووكومرس من التخزين المؤقت لأنها تحتوي على محتوى ديناميكي خاص بالجلسة. تحقق من إعدادات إضافة التخزين المؤقت لتأكيد استثناء هذه الصفحات.
إعادة إنشاء الصفحات باستخدام كتل ووكومرس (WooCommerce blocks)
يوفر ووكومرس الآن كتل (Blocks) مخصصة لصفحات المتجر الأساسية. تعتبر الكتل النهج الموصى به لأنها تتكامل مع محرر كتل ووردبريس، وتقدم خيارات تخصيص أكثر، وتتلقى تحديثات مستمرة. إذا كانت صفحة ووكومرس مفقودة أو تم حذف محتواها، يمكنك إعادة إنشائها باستخدام الكتلة المناسبة.
- اذهب إلى الصفحات > أضف جديد (Pages > Add New) في لوحة تحكم ووردبريس.
- امنح الصفحة عنواناً مناسباً (على سبيل المثال، "Cart" أو "Checkout" أو "My Account").
- انقر على زر إضافة الكتلة + وابحث عن كتلة ووكومرس ذات الصلة:
- كتلة سلة التسوق (Cart) — لصفحة سلة التسوق.
- كتلة الدفع (Checkout) — لصفحة الدفع.
- كتلة حسابي (My Account) — لصفحة حساب العميل.
- أدرج الكتلة في الصفحة.
- انقر على نشر (Publish).
- انتقِل إلى ووكومرس > الإعدادات > متقدم (WooCommerce > Settings > Advanced) وحدد قسم إعداد الصفحة (Page setup).
- قم بتعيين صفحتك التي أنشأتها للتو إلى الخيار المناسب (على سبيل المثال، قم تعيين القائمة المنسدلة لصفحة سلة التسوق Cart page إلى صفحة السلة الجديدة).
- انقر على حفظ التغييرات (Save changes).
تعرف على المزيد حول كتل ووكومرس.
إعادة إنشاء الصفحات باستخدام الرموز القصيرة (Shortcodes)
إذا كنت تفضل استخدام الرموز القصيرة القديمة بدلاً من الكتل، يمكنك إعادة إنشاء صفحات ووكومرس عن طريق إضافة الرمز القصير الصحيح إلى صفحة جديدة داخل كتلة رمز قصير (Shortcode block).
الرموز القصيرة التالية متاحة لصفحات ووكومرس الأساسية:
[woocommerce_cart]— يعرض صفحة سلة التسوق.[woocommerce_checkout]— يعرض صفحة الدفع.[woocommerce_my_account]— يعرض صفحة حساب العميل.[woocommerce_order_tracking]— يعرض نموذج تتبع الطلب.
بعد إنشاء الصفحة، قم بتعيينها في ووكومرس > الإعدادات > متقدم > إعداد الصفحة (WooCommerce > Settings > Advanced > Page setup) وانقر على حفظ التغييرات (Save changes).
اطّلع على القائمة الكاملة للرموز القصيرة المتضمنة مع ووكومرس.
ملاحظة: كانت الإصدارات القديمة من ووكومرس (قبل 2.1) تستخدم رموزاً قصيرة إضافية لصفحات مثل تعديل الحساب، وتغيير كلمة المرور، وعرض الطلب. يتم التعامل مع هذه الصفحات الآن كنقاط نهاية (Endpoints) ملحقة بصفحات الحساب والدفع الرئيسية. إذا كنت تشغل إصداراً حديثاً من ووكومرس، فأنت ل بحاجة إلى هذه الرموز القصيرة القديمة. تعرف على المزيد حول نقاط نهاية ووكومرس.
التحقق من تعارضات الإضافات والقوالب (Check for plugin and theme conflicts)
إذا لم تُحل المشكلة بالخطوات المذكورة أعلاه، فقد يكون هناك تعارض في الإضافات أو القوالب يمنع عرض صفحات ووكومرس بشكل صحيح. لاختبار التعارضات:
- التبديل المؤقت إلى قالب ووردبريس افتراضي (مثل Twenty Twenty-Four) والتحقق مما إذا كانت الصفحة تعرض بشكل صحيح. إذا حدث ذلك، فمنرجح أن يكون قالبك هو السبب.
- إذا لم يساعد التبديل بين القوالب، فقم بتعطيل جميع الإضافات باستثناء ووكومرس. تحقق من الصفحة مرة أخرى.
- إذا عملت الصفحة مع تعطيل الإضافات الأخرى، فأعد تفعيل الإضافات واحدة تلو الأخرى لتحديد أيها يتسبب في التعارض.
للحصول على إرشادات مفصلة، راجع دليل استكشاف الأخطاء وإصلاحها الذاتي لووكومرس.
نقاط نهاية ووكومرس (WooCommerce endpoints)
منذ إصدار ووكومرس 2.1، تم استبدال الصفحات الفردية لإدارة الحساب تأكيد الطلب بنقاط النهاية. يتم إلحاق نقاط النهاية بعناوين URL الخاصة بصفحة الحساب والدفع الرئيسية (على سبيل المثال، /my-account/edit-account/) بدلاً من طلب صفحات منفصلة.
إذا أرجع عنوان URL الخاص بنقطة النهاية خطأ 404، فحاول تفريغ الروابط الدائمة أولاً. يمكنك أيضاً مراجعة وتخصيص أسماء مسارات نقاط النهاية (Slugs) في ووكومرس > الإعدادات > متقدم > نقاط النهاية (WooCommerce > Settings > Advanced > Endpoints).
تعرف على المزيد حول نقاط نهاية ووكومرس.
روابط ذات صلة (Related links)
- كتل ووكومرس (WooCommerce blocks)
- الرموز القصيرة لووكومرس (WooCommerce shortcodes)
- دليل استكشاف الأخطاء وإصلاحها الذاتي لووكومرس
- نقاط نهاية ووكومرس (WooCommerce endpoints)
الأسئلة والدعم (Questions and support)
هل لا تزال لديك أسئلة وتحتاج إلى مساعدة؟
هذه الوثائق تتعلق بإضافة ووكومرس الأساسية والمجانية، والتي يتم توفير الدعم لها في منتديات المجتمع على WordPress.org. من خلال البحث في هذا المنتدى، غالباً ستجد أن سؤالك قد سُئل وتمت الإجابة عليه من قبل.
إذا لم تقم بإنشاء حساب على WordPress.org لاستخدام المنتديات، إليك الطريقة.
- إذا كنت تتطلع إلى توسيع الوظائف الأساسية المعروضة هنا، فنحن نوصي بمراجعة الإضافات المتاحة في سوق ووكومرس (WooCommerce Marketplace).
- هل تحتاج إلى دعم متقدم مستمر أو تخصيص (Customization) مبني خصيصاً لووكومرس؟ قم بتوظيف شريك وكالة ووو (Woo Agency Partner).
- هل أنت مطور تقوم ببناء تكامل أو إضافة خاصة بك في ووكومرس؟ تحقق من موارد المطورين.
