
WooCommerce 11.1 و11.2: ما الجديد وما الذي قد يتعطل؟
يضيف WooCommerce 11.1 حق الانسحاب الأوروبي وأدوات استرداد API، بينما يغيّر 11.2 خطافات المنتجات. إليك ما يجب فحصه قبل التحديث.

يصدر WooCommerce نسخة فرعية جديدة كل شهر تقريبًا، وهناك إصداران يبرزان حاليًا: الإصدار 11.1، الذي يضيف مجموعة من الميزات العملية المفيدة للتجار ومطوري واجهات البرمجة (API)، والإصدار 11.2، الذي يتشكل كتحديث للأداء يغيّر بهدوء طريقة إطلاق بعض أكثر الخطافات (Hooks) استخدامًا في الإضافة. إذا كنت تدير متجر WooCommerce أو تشرف على صيانة شيفرة برمجية مخصصة لمتجر، فإن فهم كلا الإصدارين يستحق الاهتمام قبل وصولهما إلى موقعك الإنتاجي.
يستعرض هذا الدليل ما هو مؤكد في WooCommerce 11.1، وما كشفه WooCommerce بالفعل حول تغييرات خطافات المنتجات في الإصدار 11.2، وكيفية الاستعداد لأي من التحديثين دون تعطيل عملية إتمام الطلب (Checkout) أو الإضافات المخصصة أو كتالوج منتجاتك.
ملخص سريع (TL;DR)
- يضيف WooCommerce 11.1 (في المرحلة التجريبية Beta وقت كتابة هذا المقال، مع استهداف إطلاق الإصدار النهائي في 1 سبتمبر 2026) مسارًا لطلب الانسحاب من الطلبات في الاتحاد الأوروبي، وتحسينات على عمليات الاسترداد عبر REST API، والتحقق من المبلغ الإجمالي عند إتمام الطلب، إلى جانب عدة إصلاحات للأداء والأخطاء البرمجية للمنتجات المتغيرة واستيراد/تصدير CSV.
- لم ينشر WooCommerce 11.2 ملاحظات الإصدار الكاملة بعد، لكن مدونة مطوري WooCommerce حذرت بالفعل من تغيير جوهري (Breaking Change): سيتخطى حفظ المنتجات وإعادة ترتيبها بعض استدعاءات الخطافات التي اعتادت إطلاقها في كل طلب، وذلك لتحسين الأداء.
- إذا كانت أي إضافة أو شيفرة مخصصة في موقعك ترتبط بالخطافات
set_object_termsأوwoocommerce_after_single_product_orderingأوwoocommerce_after_product_ordering، فيجب مراجعتها قبل التحديث إلى الإصدار 11.2.- خذ نسخة احتياطية من متجرك واختبر كلا التحديثين على نسخة تجريبية (Staging) قبل المساس ببيئة الإنتاج، خاصة إذا كنت تعتمد على شيفرة مخصصة حول المنتجات أو إتمام الطلب.
ما الجديد في WooCommerce 11.1؟
حتى أواخر أغسطس 2026، لا يزال WooCommerce 11.1 في المرحلة التجريبية، حيث يستهدف WooCommerce إطلاق نسخة نهائية مستقرة في 1 سبتمبر 2026. ونظرًا لأن أرقام النسخ التجريبية والمواعيد الدقيقة للإطلاق قد تتغير، راجع سجل تغييرات WooCommerce للتحقق من الحالة الحالية قبل جدولة التحديث. الميزات الواردة أدناه هي ما وثّقه WooCommerce لهذا الإصدار حتى الآن.
دعم حق الانسحاب من الطلبات في الاتحاد الأوروبي
يقدم WooCommerce 11.1 مسارًا مدمجًا لطلب الانسحاب من الطلب، وهو موجه للتجار الذين يحتاجون إلى دعم قواعد حق الانسحاب المعمول بها في الاتحاد الأوروبي للمشتريات عبر الإنترنت. يمكن لأصحاب المتاجر تفعيله من خلال WooCommerce ← الإعدادات ← متقدم ← الميزات. وبمجرد تفعيله، يحصل العملاء على صفحة حساب جديدة على المسار /my-account/withdraw-order/ حيث يمكنهم تقديم طلب انسحاب لطلب مؤهل. تُربط الطلبات المقدمة التي تطابق طلبًا قائمًا عبر البريد الإلكتروني ورقم الطلب بذلك الطلب تلقائيًا، كما يتلقى التاجر إشعارًا بالإضافة إلى تنبيه في صندوق الوارد الخاص بـ WooCommerce.
تُعد هذه الميزة لبنة أساسية مفيدة، وليست حلًا متكاملًا للامتثال القانوني. فهي تمنحك طريقة منظمة لاستلام طلبات الانسحاب وتتبعها، لكن التحقق مما إذا كانت سياسة الإرجاع الخاصة بك والمُدد الزمنية وإجراءات الاسترداد تلبي قوانين حماية المستهلك في الاتحاد الأوروبي يظل أمرًا ينبغي تأكيده مع مستشارك القانوني، وليس شيئًا يمكن لتحديث إضافة أن يضمنه بمفرده.
تحسينات الاسترداد عبر REST API
يحصل المطورون الذين يعملون مع واجهة WooCommerce REST API على تحسينين لعمليات استرداد الطلبات. يقبل مسار الاسترداد الحالي (POST /wc/v3/orders/{id}/refunds) الآن المعامل compute_totals ليتمكن الخادم من إعادة احتساب إجماليات الاسترداد بدلًا من إلزام العميل بإجراء تلك الحسابات. كما يتوفر مسار معاينة جديد، POST /wc/v3/orders/{id}/refunds/preview، يتيح لك التحقق من صحة الاسترداد قبل تطبيقه فعليًا — ويجدر التأكد من المسار في سجل التغييرات النهائي فور صدور 11.1، إذ قد تتغير المسارات الدقيقة للميزات التجريبية قبل الإطلاق الرسمي. وإذا كنت قد بنيت أدوات استرداد مخصصة أو لوحة دعم فني أو تكاملًا مع سوق إلكتروني فوق واجهة WooCommerce API، فإن هذا يزيل مصدرًا لتكرار منطق الحساب ويقلل خطر فشل طلب الاسترداد بعد أن تكون قد أبلغت العميل بنجاحه بالفعل.
التحقق من الإجمالي عند إتمام الطلب
يحصل مسار إتمام الطلب في Store API على حقل اختياري باسم expected_total. إذا أرسل العميل إجماليًا متوقعًا لا يطابق ما يحسبه WooCommerce من جانب الخادم، يتم رفض الطلب برسالة خطأ بدلًا من إتمامه بصمت بسعر مختلف. يسد هذا الأمر فئة كاملة من أخطاء تضارب الأسعار التي قد تظهر في مسارات الدفع المخصصة أو الواجهات المفصولة (Headless Storefronts) أو إضافات الدفع الخارجية عندما يختل التزامن بين الإجمالي لدى العميل والإجمالي على الخادم، مثلًا بعد تغيّر قسيمة خصم أو قاعدة ضريبية أو طريقة شحن في منتصف الجلسة.
إصلاحات الأداء والموثوقية
تستهدف عدة إصلاحات المجالات التي تؤثر في المتاجر ذات الكتالوجات الأكبر حجمًا:
- يحصل استيراد المنتجات وتصديرها بصيغة CSV على إصلاحات للحفاظ على المصطلحات (Terms) عند إعادة الرفع، ومنع المسح غير المقصود للصور، وتحسين التعامل مع العملات، إلى جانب معالجة أفضل لإنشاء التنويعات (Variations) أثناء الاستيراد.
- تحصل المنتجات المتغيرة على تخفيضات متعددة في عدد الاستعلامات (إصلاحات «N+1») عبر تحميل التنويعات، وعمليات البحث عن السمات، والتخزين المؤقت للأسعار، سواء في محرر المنتجات أو في واجهة المتجر.
- يتم الآن تخطي تسجيل الكتل (Block Registration) في طلبات cron وAJAX وREST عندما لا تكون هناك حاجة إليه، مما يقلل العبء على هذه الأنواع من الطلبات مع إبقاء التسجيل عند الطلب متاحًا حيثما يلزم فعليًا.
ليست أي من هذه التغييرات ميزة رئيسية تتصدر العناوين، لكنها من نوعية التحسينات التي يزداد أثرها كلما كبر كتالوج منتجاتك، وتستحق الاختبار إذا كنت تدير متجرًا يضم عددًا كبيرًا من المنتجات المتغيرة أو تعتمد على عمليات استيراد CSV بشكل منتظم.
تغييرات أخرى موجهة للمطورين
تستحق بضع تغييرات أصغر المعرفة إذا كنت تشرف على صيانة شيفرة مخصصة أو إضافات:
- أصبحت الدالة
is_rest_api_request()تكتشف الآن بشكل صحيح الطلبات التي تستخدم معامل الاستعلام?rest_route=، وليس فقط روابط REST الدائمة المنسقة. - تم إيقاف اعتماد الدالة
ProductGalleryUtils::get_product_gallery_image_count()(Deprecated). - أُعيد ترتيب بنية HTML لمحدد الكمية لتحسين توافقه مع قارئات الشاشة والتنقل عبر لوحة المفاتيح (الامتثال لمعايير WCAG).
- تم تحديث رموز العملات لكل من MOP وZMW.
- تم توسيع مزودي المحتوى القابل للتضمين في محرر البريد الإلكتروني ليشملوا YouTube وVimeo وVideoPress وTikTok وDailymotion، وأصبحت دوال الاستدعاء لوسوم التخصيص تتلقى الآن معامل نوع محتوى الوجهة بحيث يتم تهريب الوسوم (Escaping) بشكل صحيح لرسائل HTML مقارنة بالرسائل النصية العادية.
تتضمن هذه النسخة أيضًا ميزتين تجريبيتين اختياريتين: نهجًا موحدًا لتحميل أصول محرر الكتل — يذكر WooCommerce أنه يقلل بشكل ملموس عدد أصول المحرر وطلبات الشبكة في اختباراته الخاصة — وإطار تخزين مبكرًا، محكومًا براية ميزة (Feature Flag)، لمقاطع الفيديو في معرض المنتجات. كلاهما اختياري ضمن قسم الميزات التجريبية ولا تحتاج إلى تفعيله للاستفادة من بقية مزايا الإصدار 11.1.
WooCommerce 11.2: ما تم الكشف عنه بالفعل
لم ينشر WooCommerce ملاحظات الإصدار الكاملة للإصدار 11.2 بعد، لذا لا يوجد موعد إطلاق مؤكد وقت كتابة هذا المقال. لكن ما نُشر هو تنبيه للمطورين حول تغيير جوهري (Breaking Change) قادم في طريقة إطلاق الخطافات عند حفظ المنتجات وإعادة ترتيبها. ينشر WooCommerce هذه التنبيهات قبل الإصدار تحديدًا لأن التغيير قد يعطل الإضافات والشيفرة المخصصة بصمت، لذا من الأفضل التخطيط له الآن بدلًا من انتظار ملاحظات الإصدار الكاملة.
حفظ المنتج سيتخطى بعض استدعاءات الخطافات
يستدعي مسار حفظ المنتجات في WooCommerce حاليًا الدالتين wp_set_object_terms() وdelete_post_meta() حتى عندما تطابق القيم الجاري حفظها ما هو مخزن بالفعل. في الإصدار 11.2، سيتم تخطي تلك الاستدعاءات عندما لا يتغير شيء فعليًا، وهو ما يقول WooCommerce إنه قد يقلل استعلامات SQL لكل عملية حفظ بنسبة تصل إلى 45% في المتاجر التي تضم منتجات كثيرة.
الأثر العملي: سيعمل الخطاف set_object_terms بمعدل أقل مما هو عليه اليوم، لأنه لن يُطلق إلا عندما يتغير إسناد مصطلح (Term) فعليًا. إذا كانت لديك (أو لدى إضافة تعتمد عليها) شيفرة مثل:
add_action( 'set_object_terms', 'my_custom_sync_function', 10, 6 );وتفترض تلك الشيفرة أن الخطاف يُطلق عند كل حفظ للمنتج بغض النظر عما إذا كانت التصنيفات أو الوسوم أو السمات قد تغيرت فعلًا، فقد تتوقف عن العمل في مواقف كانت تعمل فيها سابقًا. يوصي WooCommerce بالتحقق مما إذا كانت دالة الاستدعاء لديك تحتاج فعلًا إلى حدث تغيير مصطلح أم أنها تحاول في الأساس التفاعل مع أي عملية حفظ للمنتج — وفي الحالة الأخيرة، تعد خطافات مثل woocommerce_update_product أو save_post_product الخيار الأكثر موثوقية مستقبلًا.
إعادة ترتيب المنتجات تحصل على خوارزمية جديدة
يستبدل WooCommerce أيضًا الخوارزمية الأساسية المستخدمة عند سحب المنتجات وإفلاتها لإعادة ترتيبها في عرض الكتالوج بلوحة التحكم. يعيد النهج الحالي فهرسة الكتالوج بالكامل عند كل عملية إعادة ترتيب؛ بينما يستخدم النهج الجديد تموضعًا قائمًا على النطاقات (Range-based Positioning) بحيث لا يمس إلا المنتجات التي تم تحريكها فعليًا، وهو أمر مهم للغاية في المتاجر ذات الكتالوجات الكبيرة حيث تكون إعادة الفهرسة الكاملة مكلفة.
سيتم إيقاف اعتماد خطافين مرتبطين (Deprecated):
woocommerce_after_single_product_orderingwoocommerce_after_product_ordering
ويُستبدلان بخطافين أكثر تحديدًا:
woocommerce_product_ordering_process_reindexed_products، الذي يُطلق بعد إعادة فهرسة كاملة للكتالوجwoocommerce_product_ordering_process_moved_products، الذي يُطلق بعد إعادة تموضع منتجات محددة
تستمر clean_post_cache في العمل كما كانت سابقًا ولن تتأثر. وإذا كانت شيفرتك لا تزال ترتبط بإجراءات الترتيب المتوقفة عن الاعتماد، فستواصل العمل، لكن WooCommerce يشير إلى أن استخدامها يؤدي إلى الرجوع (Fallback) إلى خوارزمية إعادة الترتيب القديمة غير المحسّنة، أي أنك تتخلى عن تحسين الأداء بدلًا من ظهور خطأ.
من يتأثر بهذا فعليًا؟
إذا لم تكن تشغّل إضافات مخصصة أو إضافات إلزامية (mu-plugins) أو شيفرة قالب ترتبط بحفظ المنتجات أو إعادة ترتيبها، فسيكون هذا التغيير غير مرئي إلى حد كبير؛ فالنواة الأساسية لـ WooCommerce وميزاته المدمجة مهيأة له بالفعل. يهم هذا الأمر أكثر الوكالات والمطورين الذين يديرون أدوات مخصصة لمزامنة الكتالوج، أو إضافات تعدد البائعين والأسواق الإلكترونية، أو تكاملات المخزون وأنظمة تخطيط موارد المؤسسات (ERP) الخارجية، وأي أدوات إدارية تتفاعل مع إعادة ترتيب المنتجات أو إعادة وسمها. إذا كان هذا يصف إعدادك، فيستحق الأمر البحث الآن في قاعدة شيفرتك عن أسماء الخطافات أعلاه حتى لا تضطر لتتبع عطل صامت في الأسبوع الذي يصدر فيه الإصدار 11.2.
هل يجب التحديث الآن؟ قائمة تحقق عملية
لا يُعد أي من الإصدارين تصحيحًا أمنيًا طارئًا، لذا لا داعي للاستعجال في تثبيت أي منهما على متجر حي يوم صدوره. ستوفر لك خطوات قصيرة ومدروسة وقتًا أكثر مما تستهلكه:
- خذ نسخة احتياطية جديدة قبل لمس أي شيء. يتضمن MagicWP نسخًا احتياطية عند الطلب يمكنك تشغيلها مباشرة قبل تحديث أي إضافة أو النواة، إلى جانب النسخ التلقائية اليومية، لتضمن دائمًا وجود نقطة استعادة نظيفة إذا ساءت الأمور.
- انسخ موقعك إلى بيئة تجريبية (Staging). اختبر التحديث هناك أولًا، وليس على بيئة الإنتاج. فهنا أيضًا ستكتشف أي تضارب في إجمالي إتمام الطلب، أو تعطلًا في استيراد CSV، أو إضافة مخصصة توقفت بصمت عن مزامنة مصطلحات المنتجات.
- ابحث في قاعدة شيفرتك عن أسماء الخطافات أعلاه. سيكشف لك بحث شامل بسيط عن
set_object_termsوwoocommerce_after_single_product_orderingوwoocommerce_after_product_orderingخلال دقائق قليلة ما إذا كان الإصدار 11.2 يتطلب أي تعديلات برمجية من جهتك. - راجع سجلات تغييرات إضافات WooCommerce النشطة لديك للبحث عن ملاحظات توافق صريحة مع الإصدارين 11.1 أو 11.2 قبل تحديث الإنتاج، ولا سيما بوابات الدفع وإضافات الاشتراكات وتكاملات المخزون.
- حدّث بيئة الإنتاج خلال ساعات انخفاض الزيارات، وراقب سجلات الأخطاء ومسار الطلبات عن كثب خلال الساعات القليلة الأولى بعد التحديث.
- إذا كنت تعتمد على WooCommerce REST API أو Store API، فاختبر تحديدًا إنشاء عمليات الاسترداد وإرسال إتمام الطلب على التحديث التجريبي، لأن سلوك كليهما يتغير في الإصدار 11.1.
الأسئلة الشائعة
متى يتم إطلاق WooCommerce 11.1 رسميًا؟ حتى أواخر أغسطس 2026، يتوفر WooCommerce 11.1 في المرحلة التجريبية مع استهداف إطلاق الإصدار النهائي في 1 سبتمبر 2026. يمكن أن تتغير الجداول الزمنية للإصدارات التجريبية، لذا تأكد من الحالة الحالية في سجل تغييرات WooCommerce الرسمي قبل الاعتماد على تاريخ محدد.
هل يتوفر WooCommerce 11.2 بالفعل؟ لا. لم يُنشر حتى الآن سوى تنبيه للمطورين حول التغييرات القادمة في خطافات المنتجات؛ ولم يتم الإعلان عن ملاحظات الإصدار الكاملة أو موعد إطلاق 11.2 وقت كتابة هذا المقال.
هل سيعطل WooCommerce 11.1 موقعي؟
بالنسبة لمعظم المتاجر، لا. التغييرات إضافية (مسارات جديدة، وميزة اختيارية جديدة في الإعدادات، وإصلاحات للأداء). يكمن الخطر الرئيسي في مسارات الدفع المخصصة أو تكاملات API التي لا تراعي بعد التحقق الجديد expected_total، إذ سيتم الآن رفض الإجمالي غير المتطابق بدلًا من قبوله بصمت.
ما ميزة حق الانسحاب من الطلبات للاتحاد الأوروبي في WooCommerce 11.1؟ إنها مسار مدمج واختياري يتيح للعملاء تقديم طلب انسحاب لأحد الطلبات من صفحة حسابهم، ويُخطر التاجر عند قيامهم بذلك. وهي أداة للمساعدة في إدارة طلبات الانسحاب، وليست ضمانًا بأن متجرك يستوفي متطلبات حماية المستهلك في بلد بعينه.
هل أحتاج إلى تحديث الشيفرة المخصصة قبل WooCommerce 11.2؟
فقط إذا كانت شيفرتك ترتبط بالخطاف set_object_terms متوقعةً إطلاقه عند كل عملية حفظ للمنتج، أو ترتبط بالإجراءين المتوقفين عن الاعتماد الآن woocommerce_after_single_product_ordering / woocommerce_after_product_ordering. وإذا لم تلمس أي من إضافاتك أو شيفرتك المخصصة تلك الخطافات، فلا حاجة لأي تعديلات.
كيف أختبر تحديث WooCommerce بأمان؟ انسخ موقعك الحي إلى بيئة تجريبية (Staging)، وطبّق التحديث هناك أولًا، ثم مرّ عبر مسارات إتمام الطلب والاسترداد وإدارة المنتجات المعتادة قبل تحديث بيئة الإنتاج. تجعل أداة Staging بنقرة واحدة هذه الخطوة سريعة بما يكفي لتطبيقها مع كل تحديث، وليس فقط التحديثات الكبرى.
ماذا يحدث إذا واصلت استخدام خطافات إعادة ترتيب المنتجات المتوقفة عن الاعتماد؟ ستواصل الإطلاق، لكن WooCommerce يوضح أن استخدامها يؤدي إلى رجوع المتجر إلى خوارزمية إعادة الترتيب القديمة غير المحسّنة بدلًا من الخوارزمية الجديدة القائمة على النطاقات، وبالتالي تحتفظ بالوظيفة ولكنك تفقد ميزة الأداء.
هل يجب التحديث إلى WooCommerce 11.1 فور صدوره؟ لا داعي للاستعجال في اليوم نفسه. انتظر بضعة أيام لظهور أي تقارير مبكرة عن أخطاء، واختبره أولًا في بيئة Staging، ثم حدّث الإنتاج خلال فترة زمنية ذات حركة مرور منخفضة.
الخاتمة
يقدم WooCommerce 11.1 إصدارًا متينًا وعمليًا: ميزة مفيدة حقًا على صعيد الامتثال عبر الانسحاب من الطلبات، وتحسينات حقيقية في واجهة برمجة الاسترداد لأي مطور يبني فوق WooCommerce، وحاجز حماية في إتمام الطلب يسد فجوة حقيقية في سلامة التسعير، وحزمة من إصلاحات الأداء التي تتراكم فائدتها في الكتالوجات الكبيرة. أما WooCommerce 11.2، وحتى قبل نشر ملاحظات إصداره الكاملة، فقد أشار بالفعل إلى التغيير الأكثر تأثيرًا على المطورين: حيث يجري تحسين خطافات حفظ المنتجات وإعادة ترتيبها بطرق قد تجعلها تتوقف بصمت عن الإطلاق مع الشيفرات التي كانت تفترض السلوك القديم. لا داعي للخوف من أي من التحديثين، لكن كلاهما يكافئ قليلًا من الاستعداد: البحث عن أسماء الخطافات في قاعدة شيفرتك، والاختبار في بيئة Staging، وأخذ نسخة احتياطية قبل لمس الإنتاج.
وإذا كنت تقيّم استضافة تجعل هذا النوع من الاختبار الآمن روتينًا يوميًا بدلًا من أن يكون عبئًا، فإن استضافة WooCommerce المُدارة من MagicWP تتضمن بيئة Staging بنقرة واحدة ونسخًا احتياطية عند الطلب، بحيث لا يكلفك تجربة إصدار جديد من WooCommerce سوى بضع دقائق بدلًا من قضاء ظهيرة محفوفة بالمخاطر.
تلقَّ أبرز ما ننشره في MagicWP عبر البريد.
ملاحظات هندسية شهرية وتحديثات المنتج ونصائح لتحسين أداء ووردبريس. بلا رسائل مزعجة، ويمكنك إلغاء الاشتراك في أي وقت.

