يُعد زر "إضافة إلى السلة" في ووكومرس أهم عنصر في أي صفحة منتج. فعندما يتوقف عن العمل، يتعذر على متجرك معالجة الطلبات. وكل زائر يصل إلى صفحة منتج معطلة يُمثل خسارة في المبيعات.
أظهر تقرير صادر عن معهد بايمارد أن 17% من المتسوقين عبر الإنترنت يتخلون عن مشترياتهم بسبب أخطاء في مواقع الويب. ويندرج زر "إضافة إلى السلة" المعطل أو المفقود ضمن هذه الفئة، ويؤثر على جميع زوار صفحة المنتج، وليس على نسبة ضئيلة منهم.
يعتمد الحل على نوع العطل. فالزر غير المرئي له أسباب مختلفة عن الزر الذي يظهر ولكنه لا يستجيب عند النقر عليه، أو الزر الذي يُضيف المنتجات إلى سلة التسوق ولكن الصفحة لا تُحدّث. ويُساعد تشخيص نوع العطل في تحديد الحل الأنسب للتطبيق أولاً.
يغطي هذا الدليل كل سبب وكل حل، مرتبة حسب المشاكل التي يجب استبعادها أولاً.
عادة ما يتوقف زر "إضافة إلى السلة" في WooCommerce عن العمل بسبب البرامج القديمة، أو تعارضات المكونات الإضافية أو القوالب، أو أخطاء JavaScript أو AJAX، أو إعدادات المنتج غير الصحيحة، أو مشكلات تكوين WooCommerce.
تشمل الحلول الشائعة تحديث WordPress و WooCommerce، والتحقق من تعارضات المكونات الإضافية، والتحقق من تكوين المنتج، وتحديث الروابط الدائمة، والتأكد من أن قالبك يدعم WooCommerce بشكل كامل.
قبل البدء في استكشاف الأخطاء وإصلاحها، قم بإنشاء نسخة احتياطية كاملة لموقعك الإلكتروني حتى تتمكن من استعادته بأمان إذا لزم الأمر.
حدد نوع فشلك أولاً
ليست جميع مشاكل زر "إضافة إلى السلة" متشابهة. يعتمد الحل على نوع العطل الذي تواجهه.
| نوع العطل | ما تراه | السبب الأكثر ترجيحاً |
| الزر غير ظاهر | يتم تحميل صفحة المنتج، ولكن لا يظهر أي زر | بيانات المنتج مفقودة، وإعدادات غير متوفرة، ومشكلة في القالب |
| الزر غير قابل للنقر | يظهر الزر، لكن لا يحدث شيء عند النقر عليه | خطأ في جافا سكريبت، تعارض في القالب، نصوص برمجية تحظرها الإضافات |
| تتم إضافة الزر، لكن الصفحة لا يتم تحديثها | يظهر مؤشر الدوران، ثم يتوقف، ويبقى عدد العربات دون تغيير | تم حظر AJAX بواسطة التخزين المؤقت أو إضافة أمان |
| زر إعادة التوجيه بشكل غير صحيح | يؤدي النقر إلى توجيه العميل إلى الصفحة الخاطئة | خطأ في تكوين الروابط الدائمة، لم يتم تعيين صفحة سلة التسوق |
| يعمل الزر على بعض المنتجات، وليس على منتجات أخرى | المشكلة خاصة بالمنتج | بيانات المنتج غير مكتملة، وتكوين المنتج المتغير غير صحيح |
حدد نوع العطل باستخدام هذا الجدول، ثم ابدأ بالحل الأكثر احتمالاً أن ينطبق على حالتك الخاصة.
ثلاثة أنواع من أعطال زر "إضافة إلى السلة" في ووكومرس
تطبيق الحل الخاطئ يُهدر الوقت وقد يُسبب مشاكل جديدة. حدد نوع العطل الذي يُطابق ما تراه قبل الانتقال إلى الحلول المذكورة أدناه.
![أخطاء زر إضافة إلى السلة في ووكومرس](https://seahawkmedia.com/wp-content/uploads/2026/06/woocommerce-add-to-cart-button-failures-1024x453.webp "زر "إضافة إلى السلة" في ووكومرس لا يعمل: كيف يمكن إصلاحه؟ 79")
الزر غير ظاهر على الإطلاق
عندما يختفي زر "إضافة إلى السلة" تمامًا من صفحة المنتج، فإن WooCommerce إما يخفيه عن قصد أو أن القالب لا يعرضه.
يقوم WooCommerce بإخفاء زر "إضافة إلى السلة" تلقائيًا في هذه الحالات:
- المنتج ليس له سعر محدد
- المنتج مُصنّف على أنه غير متوفر، وإعدادات المتجر لإخفاء المنتجات غير المتوفرة مُفعّلة
- المنتج المتغير ليس له أي خيارات قابلة للتكوين، أو أن جميع الخيارات غير متوفرة
- لا يحتوي المنتج الخارجي/التابع على عنوان URL خارجي مُهيأ
تحقق من إعدادات المنتج هذه قبل افتراض وجود مشكلة تقنية. انتقل إلى صفحة تعديل المنتج في ووكومرس وتأكد من أن لوحة بيانات المنتج تعرض السعر المُدخل، وأن حالة المخزون "متوفر"، أو أن إعداد "غير متوفر" مُهيأ كما تريد، وبالنسبة للمنتجات المتغيرة، تأكد من وجود خيار واحد على الأقل متوفر في المخزون.
الزر ظاهر لكن لا يمكن النقر عليه
عندما يظهر الزر ولكنه لا يستجيب للنقرات، فإن خطأً في جافا سكريبت يمنع معالج النقر من العمل. يتم عرض الزر في HTML، لكن وظيفته معطلة بسبب تعارض أو خطأ في البرمجة النصية.
افتح وحدة تحكم مطوّر البرامج في متصفحك (F12 في Chrome، ثم علامة تبويب وحدة التحكم) وأعد تحميل صفحة المنتج. انقر على زر "إضافة إلى السلة" وابحث عن رسائل الخطأ الحمراء في وحدة التحكم. أخطاء JavaScript الشائعة التي تشير إلى السبب المحدد:
- لم يتم تعريف jQuery: لا يتم تحميل jQuery أو يتم تحميله بترتيب خاطئ. غالبًا ما يكون السبب هو قيام إضافات التحسين بتأجيل تحميل jQuery.
- لا يمكن قراءة خاصية غير معرّفة: يتم تشغيل دالة جافا سكريبت الخاصة بـ WooCommerce قبل أن يكون المكون التابع لها جاهزًا. عادةً ما يكون السبب هو تعارض في المكونات الإضافية.
- لم يتم تعريف عنوان URL الخاص بـ AJAX / لم يتم تعريف wc_add_to_cart_params: لا يتم عرض معلمات سلة التسوق الخاصة بـ WooCommerce على الصفحة. عادةً ما يكون السبب هو وجود إضافة تخزين مؤقت تعرض نسخة مخزنة من الصفحة بدون جافا سكريبت الخاصة بـ WooCommerce.
لاحظ الخطأ المحدد قبل المتابعة. فهو يوضح لك بالضبط أي حل يجب تطبيقه.
يتم النقر على الزر، لكن سلة التسوق لا يتم تحديثها
عندما يبدو الزر فعالاً (يتم تسجيل النقرة وقد يظهر مؤشر التحميل)، ولكن لا يتم تحديث عدد المنتجات في السلة، ولا تتم إضافة المنتج، فهذا يعني فشل طلب AJAX. يستخدم WooCommerce تقنية AJAX لإضافة المنتجات إلى السلة دون إعادة تحميل الصفحة. وعندما يتم حظر AJAX أو فشله، يبدو أن النقرة لا تُحدث أي تأثير.
يحدث هذا في أغلب الأحيان بسبب مكونات التخزين المؤقت التي تقدم استجابات مخزنة مؤقتًا لطلبات AJAX، أو مكونات الأمان التي تحظر استدعاءات AJAX التي تصنفها على أنها مشبوهة، أو تكوين عنوان URL غير صحيح لـ AJAX في إعدادات WooCommerce.
هل يخسر متجر ووكومرس الخاص بك مبيعات بسبب زر معطل؟
يقوم فريق WooCommerce في Seahawk بتشخيص وإصلاح مشاكل سلة التسوق، وتعارضات الإضافات، وأخطاء JavaScript بسرعة. يتوفر دعم طارئ. لا عقود. لا رسوم اشتراك.
الحل الأول: تحديث ووكومرس، ووردبريس، وجميع الإضافات
يُعدّ استخدام برامج قديمة أسهل المشاكل التي يمكن استبعادها، ولكنه في الوقت نفسه أكثرها شيوعًا في التغاضي عنها. ابدأ من هنا قبل أي حل آخر، خاصةً إذا تعطل الزر بعد تحديث حديث.
![التحديثات التلقائية لـ WordPress/WooCommerce](https://seahawkmedia.com/wp-content/uploads/2025/12/Automatic-Updates.webp "زر "إضافة إلى السلة" في ووكومرس لا يعمل: كيف يمكن إصلاحه؟ 80")
لماذا يتسبب البرنامج القديم في تعطل زر "إضافة إلى السلة"
WooCommerce و WordPressوالقوالب والإضافات بشكل متكرر. وعندما يتم تحديث أحد المكونات دون أن تواكبه المكونات الأخرى، تنشأ فجوات في التوافق. يعتمد زر "إضافة إلى السلة" على سلسلة من المكونات التي تعمل معًا: نواة WordPress، وWooCommerce، والقالب النشط، وأي إضافات تُعدّل سلوك المنتج أو السلة. أي اختلاف في الإصدار في أي مرحلة من هذه السلسلة يُعطّلها.
هذا هو السبب الأكثر شيوعًا لتعطل زر "إضافة إلى السلة" مباشرةً بعد أي تحديث. إذا كان زرّك يعمل ثم تعطل بعد تحديث حديث، فمن شبه المؤكد أن مشكلة التوافق هي السبب.
كيفية تحديث كل شيء بأمان
قبل التحديث، قم بعمل نسخة احتياطية. انتقل إلى لوحة التحكم > التحديثات في لوحة تحكم ووردبريس. قم بتحديث ووردبريس الأساسي أولاً، ثم قم بتحديث جميع الإضافات، ثم قم بتحديث القالب.
بالنسبة لـ WooCommerce تحديدًا، قد تُدخل تحديثات الإصدارات الرئيسية (من 4.x إلى 5.x، ومن 5.x إلى 6.x) تغييرات جذرية. لذا، يُنصح دائمًا باختبار تحديثات WooCommerce الرئيسية على بيئة تجريبية قبل تطبيقها على بيئة الإنتاج.
بعد التحديث، امسح ذاكرة التخزين المؤقت لموقعك إذا كنت تستخدم إضافة تخزين مؤقت. ثم اختبر زر "إضافة إلى السلة" في صفحة المنتج قبل اعتبار المشكلة محلولة.
ماذا تفعل إذا تعطل الزر بعد التحديث؟
إذا تعطل الزر مباشرةً بعد تحديث معين، فمن المرجح أن يكون هذا التحديث هو السبب. ارجع إلى الإصدار السابق باستخدام إضافة WP Rollback أو استعد نسخة احتياطية من موقعك قبل التحديث. ثم راجع سجل تغييرات الإضافة ومنتدى الدعم بحثًا عن تقارير عن المشكلة نفسها قبل التحديث مرة أخرى.
الحل الثاني: حل تعارضات الإضافات والقوالب
تُعدّ تعارضات الإضافات والقوالب السبب الأكثر شيوعًا لتعطل زر "إضافة إلى السلة". اتبع هذه الخطوات بالترتيب، واختبر الحل بعد كل خطوة قبل الانتقال إلى الحل التالي.
![تعارضات إضافات ووردبريس](https://seahawkmedia.com/wp-content/uploads/2024/07/wordpress-plugin-conflicts-1024x451.png "زر "إضافة إلى السلة" في ووكومرس لا يعمل: كيف يمكن إصلاحه؟ 81")
كيفية تحديد تعارض المكونات الإضافية
تعارضات الإضافات السبب الأكثر شيوعًا لتعطل زر "إضافة إلى السلة". وأسرع طريقة لتحديد تعارض الإضافات هي تعطيل جميع الإضافات باستثناء WooCommerce ثم اختبار الزر.
انتقل إلى الإضافات > الإضافات المثبتة. حدد جميع الإضافات باستثناء WooCommerce. اختر "تعطيل" من قائمة الإجراءات الجماعية المنسدلة. ثم انقر على "تطبيق".
اختبر زر "إضافة إلى السلة". إذا كان يعمل الآن، فالمشكلة كانت في أحد الإضافات المعطلة. أعد تفعيل الإضافات واحدة تلو الأخرى، واختبر الزر بعد كل عملية إعادة تفعيل. إذا تعطل الزر مرة أخرى، فالإضافة التي تم إعادة تفعيلها مؤخرًا هي التي تسبب المشكلة.
إذا لم تتمكن من تعطيل جميع الإضافات في متجر مباشر، فاستخدم بيئة تجريبية لتكرار هذا الاختبار.
إضافات شائعة تتعارض مع زر "إضافة إلى السلة"
تُعدّ فئات معينة من الإضافات مسؤولة عن غالبية حالات تعارض زر "إضافة إلى السلة":
إضافات التخزين المؤقت: WP Rocketو W3 Total Cacheو WP Super Cache. قد تقوم هذه الإضافات بتخزين جافا سكريبت WooCommerce مؤقتًا بطرق تُعطّل وظائف AJAX. الحل: استبعاد صفحات WooCommerce من التخزين المؤقت. في WP Rocket، تُستبعد صفحات WooCommerce (السلة، صفحة الدفع، حسابي) تلقائيًا، ولكن يُرجى التحقق من ذلك في WP Rocket > الإعدادات > التخزين المؤقت > عدم تخزين هذه الروابط مؤقتًا.
إضافات التحسين: Autoptimizeو Perfmattersو Asset CleanUp. تعمل هذه الإضافات على تصغير ودمج ملفات جافا سكريبت. يؤدي دمج سكربتات WooCommerce مع سكربتات أخرى بشكل غير صحيح إلى أخطاء في تبعيات jQuery. الحل: في Autoptimize، انتقل إلى الإعدادات > خيارات جافا سكريبت، وفعّل خيار "فرض جافا سكريبت على ملف <head>". حدد خيار "استبعاد السكربتات من Autoptimize"، وأضف ملفي woocommerce.js وadd-to-cart.js إلى قائمة الاستثناءات.
إضافات الأمان: Wordfenceو Sucuriو iThemes Security. بعض إعدادات الأمان تحظر طلبات AJAX الخاصة بـ WooCommerce، وتصنفها على أنها ضارة. الحل: في Wordfence، انتقل إلى جدار الحماية > خيارات جدار الحماية، وأضف نقطة نهاية AJAX الخاصة بـ WooCommerce (wp-admin/admin-ajax.php) إلى القائمة البيضاء.
أدوات إنشاء الصفحات: Elementor، Divi، WPBakery. بعض هذه الأدوات تُعدّل قوالب WooCommerce أو تُضيف نصوصًا برمجية مُتعارضة إلى صفحات المنتجات. الحل: جرّب التبديل مؤقتًا إلى قالب منتجات WooCommerce الافتراضي.
كيفية تحديد الصراع الموضوعي
بعد استبعاد تعارضات الإضافات، انتقل إلى قالب Storefront (القالب الافتراضي الرسمي لـ WooCommerce) واختبر الزر. صُمم قالب Storefront خصيصًا لـ WooCommerce ولا توجد به أي مشاكل توافق
انتقل إلى المظهر > القوالب > إضافة جديد، ثم ابحث عن قالب Storefront. ثبّته وفعّله. لا تُغيّر أي إعدادات أخرى. جرّب زر "إضافة إلى السلة".
إذا كان الزر يعمل مع Storefront، فالمشكلة تكمن في القالب المُفعّل. تواصل مع مطوّر القالب وأبلغه بالمشكلة. أما إذا كان لا يعمل مع Storefront، فالسبب ليس متعلقًا بالقالب.
الحل الثالث: إصلاح أخطاء جافا سكريبت وأجاكس
تتسبب أخطاء جافا سكريبت و AJAX في ظهور الزر معطلاً حتى مع ضبط جميع الإعدادات الأخرى بشكل صحيح. تحقق من وحدة تحكم المتصفح أولاً لمعرفة البرنامج النصي الذي يُسبب المشكلة قبل إجراء أي تغييرات.
كيفية التحقق من أخطاء جافا سكريبت في متصفحك
افتح موقعك في متصفح كروم أو فايرفوكس. اضغط على F12 لفتح أدوات المطوّرين. انقر على تبويب وحدة التحكم. انتقل إلى صفحة منتج حيث زر "إضافة إلى السلة" معطّل.
ابحث عن رسائل الخطأ الحمراء. هذه هي أخطاء جافا سكريبت المحددة التي تسببت في خلل الزر. انسخ رسالة الخطأ كاملةً. ابحث عنها في دعم WooCommerce ومنتدى دعم الإضافة. معظم الأخطاء الشائعة لها حلول موثقة.
أثناء فتح وحدة التحكم، تحقق أيضًا من علامة تبويب الشبكة. انقر على زر "إضافة إلى السلة" وراقب الطلبات. يظهر طلب AJAX الفاشل باللون الأحمر مع رمز الحالة. تشير الحالة 403 إلى أن إضافة أمان تحظر الطلب. تشير الحالة 500 إلى وجود خطأ في خادم معالج AJAX.
إصلاح إعدادات إضافة إلى السلة باستخدام AJAX في ووكومرس
انتقل إلى ووكومرس > الإعدادات > المنتجات. ابحث عن قسم "سلوك إضافة إلى السلة". تأكد من تفعيل خيار "تمكين أزرار إضافة إلى السلة بتقنية AJAX في الأرشيفات". يتحكم هذا الإعداد في تفعيل وظيفة سلة التسوق بتقنية AJAX في صفحات المتجر والفئات.
تأكد أيضًا من تعيين صفحات سلة التسوق والدفع بشكل صحيح. انتقل إلى WooCommerce > الإعدادات > متقدم > إعداد الصفحة. تأكد من تعيين صفحات سلة التسوق والدفع إلى الصفحات الصحيحة على موقعك. إذا كانت أي منهما فارغة أو مُعينة على صفحة خاطئة، فلن يتم تنفيذ نقرات زر سلة التسوق دون أي تنبيه.
إصلاح إضافات تحسين الأداء التي تُعطل سكربتات ووكومرس
إذا كانت إضافة التحسين تقوم بتصغير أو دمج ملفات جافا سكريبت مما يتسبب في تعطل ووكومرس، فأضف البرامج النصية التالية إلى قائمة الاستثناءات الخاصة بالإضافة:
البرامج النصية التي يجب استبعادها من عملية التصغير:
- woocommerce/assets/js/frontend/woocommerce.min.js
- woocommerce/assets/js/frontend/add-to-cart.min.js
- woocommerce/assets/js/frontend/add-to-cart-variation.min.js
- jquery.js أو jquery.min.js
أيضًا، استبعد صفحات WooCommerce من تحسين JavaScript: سلة التسوق (/cart/)، صفحة الدفع (/checkout/)، حسابي (/my-account/)، وجميع صفحات المنتجات (/product/).
في WP Rocket: انتقل إلى تحسين الملفات > ملفات جافا سكريبت. أضف الاستثناءات المذكورة أعلاه إلى حقل ملفات جافا سكريبت المستثناة.
في Autoptimize: انتقل إلى خيارات JavaScript > استبعاد البرامج النصية من Autoptimize وأضف مسارات البرامج النصية لـ WooCommerce.
الحل الرابع: تحقق من معلومات المنتج وأكملها
يقوم ووكومرس بتعطيل زر "إضافة إلى السلة" تلقائيًا عند عدم توفر بيانات المنتج المطلوبة. إذا كان الزر غير موجود في بعض المنتجات ولكنه يعمل في منتجات أخرى، فابدأ من هنا.
الحقول المطلوبة التي تؤدي إلى ظهور الزر المفقود
يتطلب WooCommerce بيانات منتج محددة لعرض زر "إضافة إلى السلة". في حال عدم وجود أي من الحقول المطلوبة، يقوم WooCommerce بتعطيل الزر تلقائيًا دون ظهور رسالة خطأ.
تحقق من كل منتج حيث يكون الزر مفقوداً:
- السعر: يجب تحديد سعر أساسي لكل منتج. لن يظهر زر "إضافة إلى السلة" للمنتج الذي لا يحتوي على سعر. انتقل إلى المنتج > بيانات المنتج > عام، وتأكد من أن حقل "السعر الأساسي" يحتوي على قيمة.
- اسم المنتج: يجب أن يكون للمنتج عنوان. نادراً ما يكون هذا العنوان مفقوداً، ولكن من الأفضل التأكد منه في المسودات الجديدة.
- الرؤية: تأكد من ضبط رؤية المنتج في الكتالوج على "التسوق ونتائج البحث"، أو "التسوق". المنتجات التي تم ضبطها على "مخفي" لا يظهر زرها في صفحات الأرشيف.
- حالة المنتج: تأكد من أن المنتج منشور، وليس مسودة أو قيد المراجعة.
خيارات تكوين المنتج المتغيرة لإضافة المنتج إلى سلة التسوق
تختلف المنتجات المتغيرة في طريقة عملها عن المنتجات البسيطة. ففي صفحات المتجر/الأرشيف، يظهر زر "تحديد الخيارات" بدلاً من زر "إضافة إلى السلة" في المنتجات المتغيرة. أما في صفحة المنتج الفردية، فلا يظهر زر "إضافة إلى السلة" إلا بعد أن يحدد العميل جميع السمات المطلوبة.
إذا كان زر "إضافة إلى السلة" مفقودًا تمامًا من صفحة المنتج المتغير (وليس مجرد عرض خيارات التحديد في صفحة المتجر)، فتحقق مما يلي:
- يوجد على الأقل نوع واحد من المنتج (بيانات المنتج > الأنواع > إضافة نوع)
- يوجد على الأقل نوع واحد مُصنّف على أنه متوفر في المخزون
- يتم تعريف جميع السمات المستخدمة في الاختلافات ضمن بيانات المنتج > السمات قبل إنشاء الاختلافات
- لا تظهر علامة التبويب "الاختلافات" أي أخطاء في التكوين
لن يظهر زر "إضافة إلى السلة" للمنتج المتغير الذي لا يحتوي على أي اختلافات تم إنشاؤها، أو الذي تكون جميع اختلافاته غير متوفرة في المخزون.
حالة المخزون وإعدادات المنتجات غير المتوفرة
انتقل إلى ووكومرس > الإعدادات > المنتجات > المخزون. تأكد من تفعيل خيار "إخفاء المنتجات غير المتوفرة من الكتالوج". إذا كان مُفعلاً، فلن يظهر أي منتج مُصنّف على أنه غير متوفر في صفحات المتجر، ولن يظهر زر "إضافة إلى السلة".
تحقق أيضًا من حالة مخزون المنتج: المنتج > بيانات المنتج > المخزون > حالة المخزون. تأكد من أنه مُتاح. لن يظهر زر "إضافة إلى السلة" للمنتج الذي تم ضبطه يدويًا على "غير متوفر" بغض النظر عن إعدادات الكتالوج.
الحل الخامس: تحقق من إعدادات صفحات ووكومرس والروابط الدائمة
قد تتسبب صفحة سلة التسوق غير المُهيأة بشكل صحيح أو بنية الروابط الدائمة القديمة في حدوث أعطال صامتة لا يمكن إصلاحها مهما بلغت دقة تصحيح الأخطاء في الإضافات. تستغرق هذه الفحوصات الثلاثة أقل من 5 دقائق، وتُحل مشاكل أكثر مما يتوقعه معظم أصحاب المتاجر.
![تحسين صفحات منتجات ووكومرس](https://seahawkmedia.com/wp-content/uploads/2024/10/IMG_1074.jpeg "زر "إضافة إلى السلة" في ووكومرس لا يعمل: كيف يمكن إصلاحه؟ 82")
التحقق من تعيين صفحة سلة التسوق وصفحة الدفع
يتطلب WooCommerce وجود صفحات محددة وتعيينها بشكل صحيح لكي تعمل وظيفة سلة التسوق. إذا تم حذف صفحة سلة التسوق أو صفحة الدفع، أو إلغاء نشرها، أو إعادة تعيينها إلى صفحة خاطئة، فإن النقر على زر "إضافة إلى السلة" إما يفشل دون إشعار أو يُعيد التوجيه إلى الصفحة الخاطئة.
انتقل إلى ووكومرس > الإعدادات > متقدم > إعداد الصفحة. تحقق مما يلي:
- سلة التسوق: مُخصصة لصفحة منشورة تحتوي على الرمز المختصر [woocommerce_cart] أو كتلة سلة التسوق في ووكومرس
- صفحة الدفع: مُخصصة لصفحة منشورة تحتوي على الرمز المختصر [woocommerce_checkout] أو كتلة WooCommerce Checkout
- حسابي: مُخصص لصفحة منشورة تحتوي على كتلة "حسابي" أو رمز مختصر
إذا كانت أي منها مفقودة أو مُخصصة بشكل غير صحيح، فأعد تخصيصها. وإذا كانت الصفحات نفسها مفقودة، فأنشئ صفحات جديدة باستخدام الرموز المختصرة الصحيحة وقم بتخصيصها هنا.
قم بتنظيف بنية الروابط الدائمة الخاصة بك
يستخدم ووردبريس قواعد الروابط الدائمة لتوجيه الطلبات بشكل صحيح. إذا تَلِفت هذه القواعد، فقد تفشل طلبات AJAX الخاصة بـ WooCommerce حتى لو كانت جميع الإعدادات الأخرى صحيحة. يؤدي مسح بنية الروابط الدائمة إلى إعادة إنشاء هذه القواعد.
انتقل إلى الإعدادات > الروابط الدائمة في لوحة تحكم ووردبريس. لا تُغير أي إعدادات. انقر على حفظ التغييرات. سيؤدي هذا إلى إعادة إنشاء ملف .htaccess بقواعد روابط دائمة جديدة، وحل مشكلات التوجيه التي تتسبب في فشل زر سلة التسوق.
يستغرق هذا الإجراء أقل من 10 ثوانٍ ولا يؤثر على محتواك. يُنصح بتجربته في بداية أي عملية لحل المشكلات لأنه مجاني ويُصلح عددًا كبيرًا من أعطال سلة التسوق.
تحقق من صفحة حالة ووكومرس بحثًا عن الأخطاء
انتقل إلى ووكومرس > الحالة. تعرض هذه الصفحة نظرة عامة شاملة على تثبيت ووكومرس الخاص بك. تشير الصفوف المظللة باللون الأحمر إلى أخطاء في التكوين.
الأخطاء الشائعة التي تظهر في صفحة الحالة والتي تؤثر على زر "إضافة إلى السلة":
- قاعدة البيانات قديمة: تحتاج جداول قاعدة بيانات WooCommerce إلى التحديث. انقر على زر "تحديث قاعدة البيانات".
- WooCommerce.js: الملف مفقود أو غير قابل للوصول. هذا يمنع زر "إضافة إلى السلة" من العمل بشكل مباشر.
- تعديلات القوالب: قام قالب موقعك بتعديل ملفات قوالب WooCommerce. إذا كانت هذه التعديلات من إصدار قديم من WooCommerce، فقد لا تتضمن بعض الميزات الجديدة. لذا، يُرجى تحديث قالب موقعك أو إزالة التعديلات القديمة.
الحل السادس: مسح ذاكرة التخزين المؤقت
قد يتسبب استخدام إضافة تخزين مؤقت لعرض نسخة قديمة من صفحة منتجك في عدم استجابة زر "إضافة إلى السلة" حتى بعد تطبيق جميع الحلول الأخرى. لذا، احرص دائمًا على مسح ذاكرة التخزين المؤقت كخطوة أولى لحل المشكلة وكخطوة أخيرة بعد إجراء أي تغييرات.
مسح ذاكرة التخزين المؤقت في WP Rocket: انقر فوق رمز WP Rocket في شريط الإدارة > مسح ذاكرة التخزين المؤقت.
مسح ذاكرة التخزين المؤقت في W3 Total Cache: الأداء > مسح جميع ذاكرات التخزين المؤقت.
مسح ذاكرة التخزين المؤقت لـ WP Super Cache: الإعدادات > WP Super Cache > حذف ذاكرة التخزين المؤقت.
مسح ذاكرة التخزين المؤقت في LiteSpeed Cache: LiteSpeed Cache > مسح الكل.
مسح ذاكرة التخزين المؤقت لـ Cloudflare: لوحة تحكم Cloudflare > التخزين المؤقت > التكوين > مسح كل شيء.
امسح ذاكرة التخزين المؤقت للمتصفح: اضغط على Ctrl+Shift+Delete في متصفحي Chrome أو Firefox. امسح الصور والملفات المخزنة مؤقتًا. أعد تحميل صفحة المنتج في نافذة التصفح الخاص/المتخفي للتحقق من الإصلاح، مما يضمن عدم وجود أي مشكلة في ذاكرة التخزين المؤقت للمتصفح.
بعد مسح جميع ذاكرات التخزين المؤقت، اختبر زر "إضافة إلى السلة" في صفحة المنتج المتأثر. اختبره في نافذة التصفح الخفي لاستبعاد مشكلة ذاكرة التخزين المؤقت للمتصفح.
قائمة التحقق من استكشاف الأخطاء وإصلاحها: الترتيب الصحيح
اتبع هذه الخطوات بالترتيب. توقف عندما يعمل الزر.
- قم بعمل نسخة احتياطية كاملة للموقع وقاعدة البيانات
- حدد نوع الخطأ (لا يظهر / لا يمكن النقر عليه / النقر عليه ولكن لا يتم التحديث)
- تحقق من وحدة تحكم المتصفح بحثًا عن أخطاء جافا سكريبت، ودوّن أي أخطاء محددة
- انتقل إلى الإعدادات > الروابط الدائمة وانقر على حفظ التغييرات (لا حاجة لتغيير الإعدادات)
- تحقق من WooCommerce > الحالة بحثًا عن الأخطاء الحمراء وقم بحلها
- تحقق من بيانات المنتج: السعر المحدد، حالة المخزون (متوفر)، الخيارات المُكوّنة
- قم بتحديث ووردبريس، ووكومرس، وجميع الإضافات، وقالبك
- مسح جميع الذاكرات المؤقتة: إضافة التخزين المؤقت + Cloudflare + المتصفح
- قم بتعطيل جميع الإضافات باستثناء WooCommerce واختبرها
- إذا كان الزر يعمل مع تعطيل الإضافات، فأعد تنشيطها واحدة تلو الأخرى لتحديد التعارض
- قم بالتبديل إلى قالب المتجر الإلكتروني واختبره
- إذا كان الزر يعمل مع واجهة المتجر، فإن السبب هو السمة النشطة
- تحقق من WooCommerce > الإعدادات > متقدم > إعداد الصفحة لتعيين صفحة سلة التسوق وصفحة الدفع
- أضف نصوص WooCommerce إلى قائمة الاستثناءات الخاصة بملحق التحسين الخاص بك
أفكار أخيرة حول إصلاح زر "إضافة إلى السلة" في ووكومرس
تحدث معظم حالات فشل زر "إضافة إلى السلة" في ووكومرس بسبب تعارضات الإضافات، أو مشاكل التخزين المؤقت، أو بيانات المنتج غير المكتملة. ولكل من هذه الأسباب الثلاثة مسارات تشخيصية واضحة وحلول محددة لا تتطلب تطويرًا مخصصًا.
ابدأ بجدول التشخيص لتحديد نوع المشكلة. تحقق من صفحة الحالة وقم بمسح الروابط الدائمة أولاً - فهذا لا يكلف شيئاً ويحل عدداً كبيراً من الحالات. حدّث كل شيء قبل إجراء أي تغييرات أخرى. ثم انتقل إلى حل مشكلة تعارض الإضافات والقوالب.
إذا طبّقت جميع الحلول المذكورة في هذه القائمة وما زال الزر لا يعمل، فمن المرجح أن المشكلة تكمن في تعارض في التعليمات البرمجية المخصصة أو في إعدادات الخادم. في هذه الحالة، ينبغي على مطوّر ووردبريس مُلِمّ بـ WooCommerce مراجعة أخطاء وحدة تحكم المتصفح، وسجل أخطاء الخادم، وسجل تصحيح أخطاء WooCommerce معًا.
يقوم فريق تطوير WooCommerce التابع لشركة Seahawk بحل مشكلات زر "إضافة إلى السلة" كجزء من خدمة الدعم الطارئ والصيانة المستمرة.
الأسئلة الشائعة حول مشكلة عدم عمل زر "إضافة إلى السلة" في ووكومرس
لماذا لا يظهر زر "إضافة إلى السلة" في ووكومرس؟
أكثر الأسباب شيوعًا لعدم ظهور زر "إضافة إلى السلة" في ووكومرس هي: عدم تحديد سعر للمنتج، أو نفاد المخزون، أو ضبط إعدادات المتجر لإخفاء المنتجات غير المتوفرة، أو عدم وجود خيارات مُحددة للمنتج المتغير، أو نفاد جميع خياراته، أو عدم عرض القالب المُفعّل لروابط ووكومرس بشكل صحيح. تحقق أولًا من سعر المنتج، وحالة المخزون، وإعدادات الخيارات، ثم انتقل مؤقتًا إلى قالب Storefront لاستبعاد مشاكل القالب.
لماذا لا يعمل زر "إضافة إلى السلة" في ووكومرس بعد التحديث؟
عندما يتوقف الزر عن العمل مباشرةً بعد تحديث إضافة أو قالب أو ووكومرس، فمن شبه المؤكد أن السبب هو عدم التوافق. يمكنك الرجوع إلى الإصدار السابق باستخدام إضافة WP Rollback أو استعادة نسخة احتياطية قبل التحديث. ثم راجع سجل تغييرات الإضافة ومنتدى الدعم الخاص بها لمعرفة مشاكل التوافق المعروفة مع إصدار ووكومرس الحالي قبل إعادة تطبيق التحديث.
كيف يمكنني إصلاح مشكلة عدم عمل زر "إضافة إلى السلة" في ووكومرس مع إضافة WP Rocket؟
قد يتسبب WP Rocket في تعطيل وظيفة سلة التسوق AJAX في WooCommerce عن طريق تخزين صفحات السلة مؤقتًا أو تحسين نصوص WooCommerce البرمجية بشكل غير صحيح. انتقل إلى WP Rocket > التخزين المؤقت، وتأكد من وجود صفحات السلة، والدفع، وحسابي في قائمة "عدم تخزين هذه الروابط مؤقتًا". في "تحسين الملفات" > "ملفات JavaScript"، أضف نصوص إضافة المنتجات إلى سلة التسوق الخاصة بـ WooCommerce إلى قائمة الاستثناءات. امسح ذاكرة التخزين المؤقت لـ WP Rocket بالكامل بعد إجراء التغييرات.
لماذا لا يحدث أي شيء عند النقر على "إضافة إلى السلة" في ووكومرس؟
عندما لا يستجيب الزر للنقر، فهذا يعني وجود خطأ في جافا سكريبت يمنع معالج النقر من العمل. افتح وحدة تحكم المطور في متصفحك (F12 > علامة تبويب وحدة التحكم)، وأعد تحميل صفحة المنتج، ثم انقر على الزر. ابحث عن رسائل الخطأ الحمراء. من الأخطاء الشائعة عدم تعريف jQuery (مشكلة في تحميل jQuery) وعدم تعريف wc_add_to_cart_params (لم يتم تحميل نصوص WooCommerce البرمجية). تشير هذه الأخطاء مباشرةً إلى السبب.
ما هي أسرع طريقة لإصلاح زر "إضافة إلى السلة" في ووكومرس؟
اتبع الخطوات التالية بالترتيب: مسح الروابط الدائمة (الإعدادات > الروابط الدائمة > حفظ التغييرات)، مسح جميع ذاكرات التخزين المؤقت، التحقق من صفحة حالة WooCommerce بحثًا عن الأخطاء، التأكد من اكتمال بيانات المنتج، تحديث WordPress وجميع الإضافات، ثم تعطيل جميع الإضافات باستثناء WooCommerce لتحديد أي تعارضات. يُعطي هذا الترتيب الأولوية للحلول الأسرع والآمنة قبل الانتقال إلى خطوات استكشاف الأخطاء وإصلاحها الأكثر تعقيدًا.
كيف يمكنني إصلاح مشكلة عدم عمل خاصية إضافة المنتجات إلى سلة التسوق في ووكومرس باستخدام تقنية AJAX؟
انتقل إلى WooCommerce > الإعدادات > المنتجات، وتأكد من تفعيل خيار "تمكين أزرار إضافة إلى السلة بتقنية AJAX في الأرشيفات". ثم تحقق مما إذا كانت إضافة التخزين المؤقت أو إضافة الأمان لديك تحظر نقطة نهاية AJAX الخاصة بـ WordPress (wp-admin/admin-ajax.php). في Wordfence، أضف نقطة النهاية هذه إلى القائمة البيضاء. في إضافات التخزين المؤقت، استبعدها من التخزين المؤقت. امسح جميع ذاكرات التخزين المؤقت وأعد الاختبار.
لماذا يعمل زر "إضافة إلى السلة" مع بعض المنتجات دون غيرها؟
غالباً ما تكون هذه مشكلة في إعدادات المنتج، وتحديداً في المنتجات التي لا يعمل فيها الزر. تحقق مما إذا كانت المنتجات المتأثرة تفتقر إلى السعر، أو حالتها "غير متوفرة"، أو أنها منتجات متغيرة بدون خيارات مُحددة، أو أن إعدادات عرضها في الكتالوج تُخفيها عن صفحات المتجر. قارن إعدادات منتج يعمل بشكل صحيح مع إعدادات منتج لا يعمل لتحديد الاختلافات.
