
WooCommerce 11.2: ما الذي يتغير في 6 أكتوبر وما يجب اختباره قبل التحديث
يصدر WooCommerce 11.2 في 6 أكتوبر. تعرّف على تغيير فلاتر التاريخ والميزات التجريبية المحذوفة وما يجب اختباره على بيئة التجربة قبل التحديث.

من المقرر إصدار WooCommerce 11.2 في أسبوع 6 أكتوبر 2026، وحتى 4 أكتوبر لا يزال في المرحلة التجريبية (Beta). معظم ما يتضمنه هذا الإصدار تغييرات صغيرة ومنطقية، لكن بعضها ليس كذلك، وأحدها قد يغيّر الأرقام في تقاريرك دون أن يُظهر أي خطأ على الإطلاق.
يتناول هذا الدليل ما ورد في ملاحظات ما قبل الإصدار للنسخة 11.2 والتنبيهات التقنية المرتبطة بها للمطورين، والتغييرات التي قد تؤثر على متجر يعمل فعليًا، وكيفية اختبارها على نسخة تجريبية (Staging) قبل التحديث. جميع المعلومات هنا مستمدة من مدونة مطوري WooCommerce الرسمية ومستودعه على GitHub وصفحة الإضافة على WordPress.org. وحيثما كان هناك تفصيل قد يتغير قبل الإصدار النهائي، فقد جرى التنبيه إلى ذلك.
ملخص سريع (TL;DR)
- من المخطط إطلاق WooCommerce 11.2 في أسبوع 6 أكتوبر 2026. أحدث نسخة مستقرة حاليًا هي 11.1.2. لا تقم بتشغيل النسخة التجريبية على متجر حي.
- التغيير الأكثر احتمالًا لمفاجأتك: فلاتر التاريخ في
wc_get_orders()وwc_get_products()أصبحت تقرأ تاريخًا مثل2026-07-20باعتباره يومًا وفق المنطقة الزمنية للمتجر. قد تعيد التقارير وعمليات التصدير والمهام المجدولة التي ترشح حسب التاريخ نتائج مختلفة دون أي خطأ.- تتأثر استعلامات الطلبات فقط في المتاجر التي لا تزال تحفظ الطلبات في جداول مقالات ووردبريس. أما المتاجر التي تعتمد تخزين الطلبات عالي الأداء (HPOS) فترى التغيير على المنتجات فقط.
- تمت إزالة الميزات التجريبية لاسترداد السلات المتروكة وAgentic Checkout. وانتقلت واجهة Dual API التجريبية من النواة إلى إضافة مستقلة.
- اختبر على بيئة التجربة (Staging): شغّل استعلام التاريخ نفسه على 11.1.2 و11.2، ثم اختبر إتمام الدفع والقسائم وعمليات الاستيراد وأي شيفرة مخصصة تتعامل مع الخطافات (Hooks) المعدلة.
متى يصدر WooCommerce 11.2، وما النسخة المستقرة حاليًا؟
تحدد ملاحظات ما قبل الإصدار للنسخة 11.2، المنشورة في 21 سبتمبر 2026، أسبوع الإطلاق في 6 أكتوبر. ويورد ملف متابعة الإصدار لـ WooCommerce على GitHub إطلاق beta 1 في 21 سبتمبر، وbeta 2 في 28 سبتمبر، وأول نسخة مرشحة للإصدار (Release Candidate) في 5 أكتوبر، والإصدار المستقر في 6 أكتوبر. وقد نُشرت beta 2 بالفعل كإصدار تمهيدي على GitHub.
النسخة المستقرة الحالية هي 11.1.2، التي صدرت في 22 سبتمبر. وتذكر صفحتها على WordPress.org متطلب WordPress 7.0 أو أحدث وPHP 7.4 أو أحدث. لا تحدد ملاحظات 11.2 متطلباتها الدنيا الخاصة، لذا تحقق من ملف readme في الإصدار النهائي قبل افتراض تطابقهما.
مواعيد الإصدار قابلة للتحرك. فقد تأجل إطلاق الإصدار 11.1 ليوم واحد في يوم موعده نفسه، وأعلنت WooCommerce ذلك في تنبيه للمطورين. تعامل مع 6 أكتوبر كخطة لا كوعد، واقرأ ملاحظات الإصدار النهائية فور ظهورها. قد يُعاد صياغة بعض التفاصيل أدناه أو تُضاف تفاصيل جديدة بحلول ذلك الوقت، لأن ملاحظات ما قبل الإصدار كُتبت استنادًا إلى النسخة التجريبية الأولى.
لماذا قد يتغير تقرير WooCommerce دون أي خطأ في 11.2؟
هذه هي النقطة الأولى التي ينبغي فهمها. في الإصدار 11.2، تقرأ الدالتان wc_get_orders() وwc_get_products() سلسلة تاريخ مثل 2026-07-20 باعتبارها يومًا في المنطقة الزمنية للمتجر. سابقًا، كانت حدود اليوم تُبنى بطريقة تتجاهل المنطقة الزمنية للمتجر، ما قد يجعل تصفية يوم واحد تعيد نافذة زمنية تقع في معظمها ضمن اليوم الخطأ.
لا يظهر أي خطأ برمجي. فالتصدير الليلي أو سكربت المطابقة أو أداة لوحة التحكم المخصصة أو مزامنة المحاسبة التي تمرر نطاق تاريخ ستعيد ببساطة مجموعة صفوف مختلفة بعد التحديث.
ما الاستعلامات المتأثرة؟
يسمّي طلب الدمج (Pull Request) الذي يقف وراء هذا التغيير، والذي تشير إليه ملاحظات WooCommerce، متغيرات الاستعلام المحددة. وهذه هي المتغيرات التي يوردها:
| الدالة | متغير الاستعلام | التخزين | متأثر في 11.2 |
|---|---|---|---|
wc_get_orders() |
date_paid |
الطلبات في جداول مقالات ووردبريس | نعم |
wc_get_orders() |
date_completed |
الطلبات في جداول مقالات ووردبريس | نعم |
wc_get_orders() |
date_paid, date_completed |
جداول HPOS | لا، وفق ملاحظات الإصدار |
wc_get_products() |
date_on_sale_from, date_on_sale_to |
المنتجات | نعم |
wc_get_orders() |
date_created, date_modified |
الطلبات في جداول مقالات ووردبريس | لا، وفق طلب الدمج |
تلخص ملاحظات الإصدار النطاق في جملة واحدة: تتغير استعلامات المنتجات في كل متجر، بينما تتغير استعلامات الطلبات فقط في المتاجر التي لا تزال تحفظ الطلبات كمقالات ووردبريس. أصبح HPOS هو الوضع الافتراضي للمتاجر الجديدة منذ WooCommerce 8.2 في أكتوبر 2023، لذا لن ترى متاجر كثيرة أي تغيير في الطلبات، أما المتاجر الأقدم التي لم تتحول إليه فستتأثر.
تحذير واحد: يذكر طلب الدمج المتغيرين date_on_sale_from وdate_on_sale_to للمنتجات. لم أتمكن من التأكد من المصادر مما إذا كانت معاملات تاريخ أخرى للمنتجات متأثرة، لذا إذا كانت شيفرتك تصفي المنتجات بأي تاريخ آخر فاختبرها بدلًا من الافتراض.
ما حجم الانزياح؟
نشر كاتب طلب الدمج جدولًا يوضح مقدار اليوم المطلوب الذي كانت النافذة القديمة تغطيه فعليًا عند الاستعلام عن تاريخ في شهر يوليو. هذه الأرقام هي تحليل الكاتب نفسه وليست قياسًا مستقلًا:
| المنطقة الزمنية للمتجر | الفارق في ذلك التاريخ | نسبة اليوم الصحيح في النافذة القديمة |
|---|---|---|
| Europe/Berlin | +2 | ساعتان من 24 ساعة |
| Asia/Tokyo | +9 | 9 ساعات من 24 ساعة |
| America/New_York | -4 | 20 ساعة من 24 ساعة |
| America/Los_Angeles | -7 | 17 ساعة من 24 ساعة |
النمط الواضح: المتاجر الواقعة شرق التوقيت العالمي (UTC)، بما في ذلك معظم أوروبا، كانت الأكثر ابتعادًا عن الصواب. المتجر الذي يكون فارقه عن UTC صفرًا في التاريخ المستعلم عنه يكون غير متأثر في الغالب، لكن ذلك يعتمد على التاريخ. فمتجر في لندن يكون على UTC+0 شتاءً وUTC+1 صيفًا، لذا قد يكون المتجر نفسه دقيقًا في يناير ومخطئًا في يوليو.
ثلاثة تغييرات سلوكية أصغر ضمن الإصلاح نفسه
يورد طلب الدمج بضعة تأثيرات إضافية تستحق المعرفة:
- النطاقات باتت تشمل اليوم الأخير كاملًا. النطاق مثل
2026-07-19...2026-07-20كان يقلّص يومه الأخير إلى الثانية الأولى فقط من ذلك اليوم. أما الآن فيغطي اليوم بالكامل، وهو ما يشير الكاتب إلى أنه التغيير الأرجح أن تلاحظه المتاجر لأن استعلام النطاق يعيد يومًا إضافيًا من البيانات. - التاريخ المرفق بوقت يشير إلى يوم تلك اللحظة بتوقيت UTC. قيمة مثل
2026-07-20 22:00:00في متجر على UTC-4 كانت تشير سابقًا إلى يوم 21 وأصبحت الآن تشير إلى يوم 20، بما يطابق آلية عمل HPOS بالفعل. - لا تتم كتابة أو ترحيل أي بيانات. يعدل التغيير نتائج الاستعلامات فقط، لذا تبقى البيانات المخزنة دون مساس.
فخ التصحيح المزدوج
إذا كانت شيفرتك تتجاوز السلوك القديم عبر إزاحة نافذة التاريخ بنفسها لتتطابق المجاميع اليومية، فستقوم الآن بالتصحيح مرتين وتعرض اليوم الخطأ. يقول كاتب طلب الدمج إنه لا توجد أي إشارة تحذيرية عند حدوث ذلك ولم يتمكن من حصر التكاملات التي تفعل ذلك. ابحث في شيفرتك الخاصة وفي أي إضافة تقارير مخصصة عن أي إزاحات مبرمجة يدويًا قبل التحديث، لا بعده.
كيف تفحص متجرك
أولًا، اعرف كيف تُخزَّن طلباتك. في لوحة تحكم ووردبريس (wp-admin)، انتقل إلى WooCommerce > الإعدادات > خيارات متقدمة > الميزات وتحقق من إعداد تخزين بيانات الطلبات. ثم قارن النتائج على نسختين من الموقع: واحدة على 11.1.2 والأخرى على 11.2. يطبع هذا السكربت الأعداد ليوم يحتوي على طلبات حقيقية. استبدل بتاريخ المثال تاريخًا من بياناتك الفعلية.
<?php
// compare-dates.php
// Run with: wp eval-file compare-dates.php
$day = '2026-09-15'; // use a day that has real orders and sales
foreach ( array( 'date_paid', 'date_completed' ) as $key ) {
$ids = wc_get_orders(
array(
$key => $day,
'limit' => -1,
'return' => 'ids',
)
);
echo $key . ': ' . count( $ids ) . " orders\n";
}
$ids = wc_get_products(
array(
'date_on_sale_from' => $day,
'limit' => -1,
'return' => 'ids',
)
);
echo 'date_on_sale_from: ' . count( $ids ) . " products\n";شغّله على النسختين وضع المخرجين جنبًا إلى جنب. إذا تطابقت الأعداد، فالأرجح أن متجرك غير متأثر لهذه الاستعلامات. وإذا اختلفت، حدد التقرير أو المهمة التي تستخدم هذا الفلتر وقرر أي رقم هو الصحيح قبل تحديث موقع الإنتاج.
يمكنك أيضًا فحص إعداد المنطقة الزمنية من سطر الأوامر:
wp option get timezone_stringإذا أعاد هذا الأمر سلسلة فارغة، فقد يستخدم موقعك إزاحة UTC يدوية بدلًا من منطقة زمنية مسماة. تحقق من الإعدادات > عام في wp-admin.
ما الذي أُزيل في WooCommerce 11.2؟
تغادر ثلاث ميزات تجريبية النواة. كانت الثلاث معطلة افتراضيًا، لذا لم تستخدمها معظم المتاجر، لكن الإزالة تظل إزالة.
تحول Dual API التجريبية إلى إضافة
قدمت WooCommerce 10.9 واجهة Dual API التجريبية، وهي بنية برمجية تعتمد على الكود أولًا لتوليد نقاط نهاية GraphQL من أصناف PHP. في 11.2 ينتقل المحرك خارج النواة إلى إضافة منفصلة باسم WooCommerce Dual API. ونظرًا لأنها كانت دائمًا خلف راية ميزة (Feature Flag)، فلا يؤثر التغيير إلا على المطورين الذين فعّلوها وبنوا عليها.
التفاصيل المهمة إذا كنت منهم:
- أُزيلت واجهة إثبات المفهوم المدمجة للمنتجات والقسائم التي كانت موجودة من 10.9 إلى 11.1. ولا تعيد الإضافة الجديدة هذه النقاط.
- أُلغيت راية الميزة. تثبيت الإضافة وتفعيلها هو ما يشغّل المحرك.
- تتطلب الإضافة WooCommerce 11.2 أو أحدث وPHP 8.1 أو أحدث. ويجب على أي إضافة تعتمد عليها التصريح بـ
Requires Plugins: woocommerce, woocommerce-dual-apiفي ترويستها. - تؤكد WooCommerce أن Dual API لا تزال تجريبية، وأن أي شيء تحت نطاق الأسماء
Automattic\WooCommerce\Apiقد يتغير بطرق غير متوافقة في أي إصدار، وأنه لا ينبغي استخدامها في إضافات الإنتاج.
النقطة الأخيرة تستحق الأخذ بجدية. إذا كان متجر أحد العملاء يعتمد على إضافة مبنية على هذا المحرك، فاسأل مطور الإضافة عن خطته.
اختفاء استرداد السلات المتروكة وواجهة Agentic Checkout API
أُزيلت كل من الميزة التجريبية لاسترداد السلات المتروكة وواجهة Agentic Checkout API التجريبية. وتزول مسارات wc/agentic/v1 دون نقطة نهاية بديلة. كما يقوم تحديث قاعدة البيانات في 11.2 بإلغاء أي إجراءات استرداد مجدولة في قائمة الانتظار وحذف جدول wc_email_unsubscribes.
لا تذكر ملاحظات ما قبل الإصدار ما إذا كان يمكن التراجع عن خطوة قاعدة البيانات هذه. تعامل معها كخطوة أحادية الاتجاه. إذا كنت قد فعّلت هذه التجارب يومًا وتهتم بأي بيانات في ذلك الجدول، فخذ نسخة احتياطية كاملة أولًا وافحص الجدول قبل التحديث.
ما تغييرات المطورين التي قد تعطل الشيفرة المخصصة؟
تسرد WooCommerce العديد من تنبيهات المطورين في ملاحظات 11.2، معظمها محدود النطاق. يغطي هذا الجدول التغييرات المرجح أن تهمك، مع ما ينبغي البحث عنه في شيفرتك.
| التغيير | ما يجب البحث عنه | من يتأثر |
|---|---|---|
انتقال register_wp_admin_settings في admin_init من الأولوية 10 إلى 999 |
register_wp_admin_settings أو صفحات إعدادات أو أصناف بريد مضافة على admin_init |
مطورو الإضافات. استدعاء remove_action() دون تحديد الأولوية لن يفعل شيئًا الآن بصمت. |
| التحقق من الويب هوك (Webhook) للمقالات المحذوفة والمستعادة | WC_Webhook::is_valid_post_action، مستهلكو الويب هوك لـ product.deleted |
المتاجر ذات تكاملات Webhook. نقل منتج متعدد الأنواع إلى المهملات أثناء طلب واجهة أمامية يرسل الآن إشعارًا لكل نوع فرعي. |
| إمكانية حذف سمات المنتج وإعادة إنشائها في عملية واحدة | wc_delete_attribute() |
الشيفرة التي تقرأ سمة بعد حذفها يجب أن تعاملها الآن كمفقودة. |
| تطبيق القسائم المتسلسلة بالترتيب الذي أدخله العميل | المتاجر التي تفعل الخصومات المتسلسلة | قد تتغير مجاميع السلة عندما تتساوى أولوية القسائم. |
| محرر الطلبات في لوحة التحكم يرفض الكميات السالبة في بنود الطلب | woocommerce_quantity_input_min_admin |
إعادة سلسلة نصية فارغة لإزالة الحد الأدنى لم تعد تعمل. أعِد رقمًا. |
| قوالب المنتجات الكلاسيكية تعرض التصنيفات الأب أولًا | woocommerce_product_meta_category_orderby |
القوالب الكلاسيكية. يعيد هذا الفلتر الترتيب القديم. |
| تطبيع أنواع عرض تصنيفات المنتجات عند الحفظ | المقارنات مع display_type |
قيمة مثل Custom_Grid تُحفظ بصيغة custom_grid، لذا تتوقف المقارنات ذات الأحرف الكبيرة عن التطابق. |
wp_kses_post() يرشّح الآن تسميات الودجات وتلميحات مربعات الاختيار |
عناصر تحكم مخصصة داخل WC_Widget::form() |
تُزال السكربتات أو سمات معالجات الأحداث في تلك الحقول. |
| تصديرات Blueprint تسقط إعدادات الدفع | مسارات التجهيز المبنية على Blueprint | أضف خطوة يدوية لإعداد بوابات الدفع بعد الاستيراد. |
رسائل خطأ PhotoSwipe لم تعد تستبدل %url% |
errorMsg مخصص يحتوي على %url% |
يظهر الرمز حرفيًا كما هو. |
| معاملات ترقيم صفحات أرشيف المنتجات في القوالب الكلاسيكية | ترقيم صفحات مخصص في الأرشيف | القيم الافتراضية تتبع الآن بنية base وformat المستخدمة في paginate_links(). |
تسرد الملاحظات أيضًا بضعة تغييرات في خطافات استعلام مجاميع التقارير وترتيب ودجات المنتجات القديمة. إذا كنت تدير تقارير مخصصة، فاقرأ القائمة الكاملة للتنبيهات على مدونة المطورين بدلًا من الاعتماد على هذا الملخص وحده.
للعثور على الشيفرات المتأثرة عبر SSH، نفّذ هذه الأوامر من المجلد الجذري لووردبريس. كل أمر يعرض السطور المطابقة فقط لتراجعها قبل تغيير أي شيء.
grep -rn "wc_get_orders\|wc_get_products" --include=*.php wp-content/plugins wp-content/mu-plugins wp-content/themes | grep -i date
grep -rn "register_wp_admin_settings" --include=*.php wp-content
grep -rn "woocommerce_quantity_input_min_admin" --include=*.php wp-content
grep -rn "%url%" --include=*.php --include=*.js wp-content/themes wp-content/pluginsيمكنك أيضًا سرد كل إضافة مفعّلة وإصدارها لبناء قائمة فحص الإضافات أمام 11.2:
wp plugin list --status=active --fields=name,versionما الذي يتغير في Store API ومكوّني السلة وإتمام الدفع؟
إذا كنت تشغّل واجهة متجر منفصلة (Headless) أو صفحة دفع مخصصة أو شيفرة تتواصل مع Store API، فهناك ثلاثة تغييرات تستحق القراءة بدقة.
فلتر جديد لحدود كمية السلة
يضيف WooCommerce 11.2 الفلتر woocommerce_store_api_cart_item_quantity_validation. كانت السلة القديمة تملك woocommerce_update_cart_validation لرفض تغيير الكمية، لكن مكوّني السلة وإتمام الدفع لم يكن لديهما مكافئ. كل من حاول تقييد الكميات في مكوّن السلة بالفلتر القديم وجد أنه لا يُستدعى أبدًا.
يعمل الفلتر الجديد بعد فحوصات WooCommerce الخاصة بالحد الأدنى والأقصى والمضاعفات، عند تحديث الكمية أو إعادة إضافة منتج موجود بالفعل في السلة. ولا يعمل عند الإضافة الأولى للمنتج؛ ولذلك تشير WooCommerce إلى الإجراء woocommerce_store_api_validate_add_to_cart.
add_filter(
'woocommerce_store_api_cart_item_quantity_validation',
function ( $valid, $quantity, $product, $cart_item ) {
if ( $quantity > 5 ) {
return new WP_Error(
'quantity_limit',
sprintf( 'You can order up to 5 of "%s".', $product->get_name() )
);
}
return $valid;
},
10,
4
);فخّان يردان مباشرة من التنبيه: إعادة كائن WP_Error فقط هي ما يرفض التغيير. أي قيمة أخرى، بما في ذلك false، يتم تجاهلها وتُقبل الكمية. كما أن النمط القديم بإضافة إشعار عبر wc_add_notice() وإعادة false لا ينتقل إلى هنا، لذا فإن دالة منسوخة دون تعديل من woocommerce_update_cart_validation ستقبل كل تغيير. احتفظ بدالتك القديمة أيضًا، لأنها لا تزال تغطي سلة الكود المختصر (Shortcode).
حدود المعدل وإخفاقات جلسة السلة
تعيد Store API الآن رمز HTTP 429 بدلًا من 400 عندما تتجاوز الطلبات حد المعدل (Rate Limit). العميل البرمجي الذي يعامل كل رمز 400 كخطأ تحقق وأي رمز آخر كشيء مختلف قد يتعامل مع هذا بشكل سيئ. تحقق من كيفية استجابة واجهتك الأمامية للرمز 429.
فشل تحميل جلسة السلة يعيد الآن الرمز 500 دون ترويستي Cart-Token أو Cart-Hash. وتقول WooCommerce إن على العملاء التعامل مع غياب الترويستين كسلة غير متاحة، لا كسلة جديدة.
تغييرات التخطيط في المكوّنات
يستخدم مكوّنا السلة وإتمام الدفع الآن عمودًا ثابتًا بعرض 360px لملخص الطلب، وتنتقل نقطة التحول إلى عمودين من 700px إلى 920px من عرض الحاوية. قد يختل تنسيق CSS المخصص المكتوب اعتمادًا على عرض نسبي أو استعلام وسائط عند 700px، لذا افتح صفحة الدفع على عدة مقاسات شاشة في بيئة التجربة.
ما الجديد لأصحاب المتاجر في 11.2؟
ليس كل ما في الإصدار مصدر مخاطرة. هذه أبرز الإضافات التي تسلط ملاحظات ما قبل الإصدار الضوء عليها:
- رسائل البريد لطلبات الانسحاب. يضيف WooCommerce رسائل بريد قابلة للتهيئة تؤكد استلام طلب انسحاب العميل من الطلب وتنبه التاجر. تدير كليهما من WooCommerce > الإعدادات > البريد الإلكتروني، بما يشمل المستلمين والمحتوى الإضافي والمعاينات وتفعيل كل رسالة.
- مطابقة مستورد CSV للمنتجات. عند تفعيل «تحديث المنتجات الحالية»، يطابق المستورد الآن عبر GTIN أو UPC أو EAN أو ISBN إذا خلا الصف من ID وSKU. ترتيب المطابقة هو ID ثم SKU ثم المعرّف العالمي الفريد. أي معرّف غير فارغ لا يطابق شيئًا يتخطى الصف بدل إنشاء منتج، وتُرفض المطابقة مع نوع منتج مختلف حتى لا يغيّر التحديث نوع المنتج بصمت.
- تنظيف أضيق بعد الاستيراد. لم يعد التنظيف بعد الاستيراد ينفذ عمليات حذف على مستوى الموقع كله للأنواع الفرعية اليتيمة وبيانات المقالات الوصفية وعلاقات التصنيفات؛ بل يزيل فقط المنتجات المؤقتة التي أنشأها الاستيراد نفسه.
- حقول التاريخ في حقول الدفع الإضافية. يمكن للمطورين إضافة حقول تاريخ إلى مكوّن إتمام الدفع، مثل تاريخ التسليم المفضل، بحدود مثل «من الغد حتى 30 يومًا مقبلة». وتستخدم منتقي التاريخ الأصلي للمتصفح.
- خيارات تنسيق إضافية للمكوّنات. تحصل صورة المنتج على أنماط حدود، وتحصل كمية المنتج على خيارات للحدود والظلال والاستدارة والألوان، ويمكن تثبيت فلاتر المنتجات (Sticky)، وتحصل الشرائح (Chips) على خيارات للخطوط والتباعد.
تغيير مستورد CSV هو ما يجب تجربته على بيئة التجربة إذا كنت تحدث الكتالوجات من ملفات الموردين. شغّل ملف اختبار صغيرًا يجمع صفوفًا تحتوي على معرفات وأكواد SKU ورموز باركود فقط، وتحقق من الصفوف التي تتحدث وتلك التي يتم تخطيها.
ماذا عن تغييرات خطافات المنتجات المعلنة سابقًا؟
أعلنت WooCommerce عن تغييرات منفصلة في خطافات حفظ المنتجات وإعادة ترتيبها في تنبيه للمطورين بتاريخ 25 أغسطس، بهدف تسريع الحفظ وإعادة الترتيب في الكتالوجات الكبيرة. ويغطي مقال MagicWP السابق، WooCommerce 11.1 و11.2: ما الجديد وما قد يتعطل، تلك التغييرات بالتفصيل، بما في ذلك set_object_terms وخطافات الترتيب، لذا لم تُكرر هنا. إذا كانت شيفرتك تتعامل مع حفظ المنتجات أو إعادة ترتيبها بالسحب والإفلات، فاقرأ ذلك المقال قبل الاختبار.
هل يغيّر WooCommerce 11.2 متطلب PHP؟
ليس بعد، بحسب ما تظهره المصادر. يشير تنبيه للمطورين نُشر في 29 سبتمبر إلى أن WooCommerce 11.6، المخطط له في فبراير 2027، سيتطلب PHP 8.1 أو أحدث. وسيعرض WooCommerce 11.3 إشعارًا إداريًا قابلًا للإخفاء في المتاجر التي تعمل على PHP 7.4 أو 8.0، وتقول WooCommerce إن 11.3 يستمر في العمل على تلك الإصدارات. ويمكن للمتاجر على إصدارات PHP الأقدم مواصلة التحديث حتى 11.5.
يختلف هذا عن مقترح سابق نُشر في 8 سبتمبر وكان يستهدف 11.5 ويناير 2027. تنبيه 29 سبتمبر هو الأحدث ويؤجل الموعد إلى 11.6. كما توصي WooCommerce حاليًا بإصدار PHP 8.3 أو أحدث.
الموضع الوحيد الذي يهم فيه PHP 8.1 بالفعل في 11.2 هو إضافة Dual API التي تتطلبه. إذا كانت استضافتك لا تزال تشغل إصدارًا أقدم، فخطط للترقية الآن. يغطي دليل MagicWP حول إصدار PHP المناسب لووردبريس في 2026 كيفية الاختيار.
كيف تختبر WooCommerce 11.2 على بيئة التجربة؟
لا تثبت النسخة التجريبية على متجر حي. فدليل اختبارات البيتا من WooCommerce نفسه ينص على أن تشغيل النسخ التجريبية في الإنتاج ليس فكرة جيدة ما لم تستطع توقع التغييرات والأعطال. استخدم نسخة تجريبية، وانتظر الإصدار المستقر لموقع الإنتاج.
خذ نسخة احتياطية أولًا. أنشئ نسخة احتياطية فورية جديدة قبل أي تغيير. كما يحتفظ MagicWP بنسخ احتياطية يومية خارجية مع استعادة بنقرة واحدة، موضحة في وثائق النسخ الاحتياطي.
أنشئ نسخة تجربة (Staging). الأفضل نسخة كاملة من الموقع الحي، تضم طلبات ومنتجات حقيقية حتى تعيد استعلامات التاريخ بيانات فعلية. ميزة Staging في MagicWP مشروحة في مواقع التجربة والترحيل الأكثر سلاسة.
سجّل خط أساس على 11.1.2. شغّل سكربت مقارنة التواريخ أعلاه واحفظ مخرجاته. وصدّر تقريرًا تعتمد عليه، مثل إجمالي المبيعات اليومية، لتكون لديك أرقام للمقارنة.
حدّث بيئة التجربة. لتجربة البيتا مبكرًا، ثبّت إضافة WooCommerce Beta Tester على نسخة التجربة فقط، وحوّل إلى قناة البيتا ثم حدّث. وبعد 6 أكتوبر، حدّث إلى الإصدار المستقر بدلًا من ذلك:
wp plugin update woocommerce wp plugin get woocommerce --field=versionأعد تشغيل السكربت والتقرير. قارن النتائج بخط الأساس. أي فرق ينبغي أن يتطابق مع تغييرات فلتر التاريخ أعلاه، ويجب أن تكون قادرًا على تفسيره.
اختبر المسارات الحرجة. أتمّ الشراء كزائر وكعميل مسجل. غيّر كمية في مكوّن السلة. طبّق قسيمتين إذا كنت تستخدم الخصومات المتسلسلة. عدّل طلبًا في لوحة الإدارة. نفّذ استيراد CSV صغيرًا. افحص أي مستهلكين لـ Webhook.
افحص تخطيط الواجهة الأمامية. راجع صفحتي السلة وإتمام الدفع على مقاسات الهاتف والجهاز اللوحي وسطح المكتب، وكذلك ترقيم صفحات أرشيف المنتجات في القالب الكلاسيكي إذا كنت تستخدمه.
اقرأ السجلات. افحص سجل أخطاء PHP وسجلات WooCommerce تحت WooCommerce > الحالة > السجلات بحثًا عن تحذيرات جديدة، خصوصًا تنبيهات الدوال المهملة من الإضافات.
اختر نافذة التحديث الإنتاجي المناسبة. حدّث خلال فترة هدوء، وتجنب أيام إغلاق الشهر أو المطابقة المحاسبية، لأن تغيير فلتر التاريخ يؤثر تحديدًا على هذا النوع من العمل.
إذا تعطل شيء على بيئة التجربة، فلم تخسر شيئًا. وإذا تعطل شيء في الإنتاج بعد التحديث، فاستعد النسخة الاحتياطية من الخطوة 1 وأصلحه على بيئة التجربة قبل المحاولة مجددًا.
الأسئلة الشائعة
متى يصدر WooCommerce 11.2؟
من المخطط إطلاق WooCommerce 11.2 في أسبوع 6 أكتوبر 2026. تذكر ملاحظات ما قبل الإصدار ذلك الأسبوع موعدًا للإطلاق، ويسجل ملف متابعة الإصدار على GitHub يوم 5 أكتوبر لأول نسخة مرشحة ويوم 6 أكتوبر للإصدار المستقر. قد تتأخر المواعيد، كما تأخر 11.1 ليوم واحد، لذا راجع مدونة المطورين في ذلك اليوم. وحتى ذلك الحين، أحدث نسخة مستقرة هي 11.1.2.
هل سيعطل تغيير فلتر التاريخ تقاريري؟
قد يغير أرقامها، وهو أمر يختلف عن تعطلها. الاستعلامات التي ترشّح عبر date_paid أو date_completed في المتاجر التي تحفظ الطلبات في جداول مقالات ووردبريس، واستعلامات المنتجات التي ترشح بتواريخ التخفيض، أصبحت الآن تستخدم المنطقة الزمنية للمتجر. المتاجر على HPOS غير متأثرة في الطلبات. شغّل الاستعلام نفسه على 11.1.2 و11.2 في بيئة التجربة وقارن الأعداد قبل تحديث الإنتاج.
هل أحتاج إلى PHP 8.1 لأجل WooCommerce 11.2؟
لا تذكر المصادر التي راجعتها متطلب PHP جديدًا للنسخة 11.2 نفسها، وتطلب 11.1.2 إصدار PHP 7.4 أو أحدث. إلزامية PHP 8.1 مخطط لها في WooCommerce 11.6، المستهدف في فبراير 2027، مع ظهور إشعار في 11.3. أما إضافة Dual API فتحتاج PHP 8.1 اليوم بالفعل. تأكد من متطلبات 11.2 النهائية في ملف readme الخاص بها.
هل ينبغي تثبيت النسخة التجريبية 11.2 على متجري الحي؟
لا. ينصح دليل اختبارات البيتا من WooCommerce بالاختبار المسؤول وعدم تشغيل النسخ التجريبية في الإنتاج ما لم تكن لديك خبرة تمكنك من توقع التغييرات والأعطال. ثبّت إضافة Beta Tester على نسخة تجربة، أو انتظر الإصدار المستقر في 6 أكتوبر أو بعده. تشغيل بيتا على صفحة دفع حية يعرّض الطلبات الحقيقية للخطر دون أي فائدة.
هل سأفقد بيانات عند إزالة استرداد السلات المتروكة؟
من المحتمل ذلك إذا كنت قد استخدمتها. يلغي تحديث قاعدة البيانات في 11.2 إجراءات الاسترداد الموضوعة في قائمة الانتظار ويحذف جدول wc_email_unsubscribes. لا تذكر الملاحظات ما إذا كان يمكن عكس ذلك، لذا عامله كإجراء دائم. إذا كنت قد فعّلت هذه التجربة، خذ نسخة احتياطية للموقع وافحص ذلك الجدول أولًا. وإذا لم تفعلها قط — وهو الوضع الافتراضي — فلن يتغير شيء بالنسبة لك.
كيف أحدد كميات السلة في مكوّن السلة؟
استخدم الفلتر الجديد woocommerce_store_api_cart_item_quantity_validation في 11.2 وأعد كائن WP_Error للكميات التي تريد رفضها. إعادة false أو إضافة إشعار عبر wc_add_notice() لا يعملان. يعمل الفلتر عند تحديث الكمية والإضافات المتكررة، لا عند الإضافة الأولى للمنتج التي تحتاج إلى الإجراء woocommerce_store_api_validate_add_to_cart بدلًا منه.
هل أحتاج لتغيير أي شيء إذا لم يكن لدي كود مخصص؟
على الأرجح قليل جدًا. معظم التغييرات الكاسرة تؤثر على الكود المخصص والإضافات والتكاملات. مع ذلك، راجع ملاحظات التوافق مع 11.2 لإضافاتك المفعلة، وأجرِ عملية شراء عادية على بيئة التجربة، وعاين تخطيط السلة وإتمام الدفع لأن عرض عمود ملخص الطلب قد تغير. وعلى المتاجر التي لديها تقارير أو تصديرات تعتمد على التاريخ إجراء مقارنة التواريخ في كل الأحوال.
الخاتمة
يعد WooCommerce 11.2 في معظمه إصدارًا مرتبًا، والتغيير الوحيد الذي يجب أخذه على محمل الجد هو إصلاح فلاتر التاريخ. فهو يجعل الاستعلامات صحيحة، لكن الاستعلام الصحيح قد يغيّر رقمًا كنت تعتمد عليه، ويفعل ذلك بصمت. شغّل الاستعلام نفسه على نسختين من متجرك وستعرف في دقائق ما إذا كان يمسك.
الباقي عبارة عن قائمة تحقق: راجع شيفرتك المخصصة أمام جدول التنبيهات، وأزل أي اعتماد على التجارب المحذوفة، وتفحص تخطيطات المكوّنات. وإذا أردت مكانًا للتدرب على التحديث، فإن استضافة WooCommerce من MagicWP توفر بيئة تجربة بنقرة واحدة ونسخًا احتياطية عند الطلب، بحيث لا يكلفك اختبار WooCommerce 11.2 قبل 6 أكتوبر سوى نسخة من متجرك بدلًا من المخاطرة بمتجرك الحي.
الخطوات التالية
- اقرأ ملاحظات ما قبل الإصدار الرسمية لـ WooCommerce 11.2.0 وتابع مدونة المطورين لملاحظات الإصدار النهائية.
- اقرأ التنبيه حول فلتر التحقق الجديد لكمية السلة في Store API إذا كنت تبني قواعد سلة مخصصة.
- اقرأ المقال حول انتقال Dual API إلى إضافة مستقلة إذا كانت أي إضافة تستخدمها مبنية عليها.
- اقرأ التنبيه حول متطلب PHP 8.1 المخطط له في WooCommerce 11.6.
- راجع دليل MagicWP حول النسخ الاحتياطي لموقع ووردبريس واستعادته.
تلقَّ أبرز ما ننشره في MagicWP عبر البريد.
ملاحظات هندسية شهرية وتحديثات المنتج ونصائح لتحسين أداء ووردبريس. بلا رسائل مزعجة، ويمكنك إلغاء الاشتراك في أي وقت.

