تغييرات REST API في ووردبريس 7.2: ماذا تراجع في إضافتك؟

أنابيب بيانات متفرعة من مركز مضيء ترمز لتغييرات ووردبريس REST API في الإصدار 7.2

لو عندك إضافة مخصصة لعميل، أو تطبيق موبايل بيقرأ من موقع ووردبريس، فالإصدار 7.2 فيه تلات تغييرات في REST API لازم تبص عليها قبل ما العميل يضغط «تحديث». اتنين منهم بيغيّروا شكل البيانات اللي كودك متعود عليها، والتالت بيديك أداة كانت ناقصة.

الإصدار النهائي من ووردبريس 7.2 مجدول يوم 8 ديسمبر 2026، والنسخة المرشحة الأولى (RC1) متاحة الآن للاختبار. يعني عندك أسابيع قليلة تراجع فيها كودك على بيئة تجريبية.

الخلاصة السريعة: ابحث في كودك عن ثلاثة أشياء: قراءة meta من مراجعة أو حفظ تلقائي عبر REST، ومقارنة $request['status'] في مسار التعليقات بنص، وأي كود يكتب ترويسة Access-Control-Allow-Methods يدويًا.

من يتأثر فعلًا بهذه التغييرات؟

لن يلاحظ صاحب موقع عادي يستخدم إضافات معروفة ومحدّثة أي فرق في الغالب. التأثير الحقيقي يقع على ثلاث فئات:

  • مطوّر الإضافات المخصصة الذي يكتب حقول ميتا على المراجعات مباشرة، أو يقرأ تعليقات عبر واجهة REST البرمجية (REST API).
  • من يبني تطبيقًا منفصلًا (Headless) أو تطبيق موبايل يقرأ المراجعات أو التعليقات من الموقع.
  • من غيّر ترويسات CORS بطرق التفافية، مثل فك ربط الدالة rest_send_cors_headers() أو استدعاء header() في أولوية متأخرة.

لو أنت فريلانسر بتسلّم مواقع لعملاء في مصر أو الخليج بإضافات مكتوبة خصيصًا لهم، فالمراجعة دي جزء من عقد الصيانة، مش رفاهية.

1. المراجعات والحفظ التلقائي: الميتا المسجّلة فقط

ما المشكلة التي أصلحها الإصدار؟

ميزة المراجعات المرئية (Visual Revisions) التي وصلت في ووردبريس 7.0 تستعيد المراجعة من خلال REST API، ثم تكتب حقول meta القادمة منها على المقال. قبل 7.2 كانت نقطة المراجعات تعيد كل مفاتيح الميتا المعلنة بـ show_in_rest، رغم أن المراجعة لا تخزّن إلا المفاتيح المفعّل لها حفظ المراجعات.

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

ما الذي تغيّر في 7.2؟

صارت استجابة المراجعة، ومعها الحفظ التلقائي (Autosave)، تحتوي فقط على المفاتيح التي تعيدها wp_post_revision_meta_keys() لنوع المقال الأصلي. وإذا لم يكن لنوع المحتوى أي ميتا مفعّل لها المراجعات، تصبح meta مصفوفة JSON فارغة [] بدل كائن مليء بالقيم الافتراضية.

ماذا تراجع في كودك؟

المفتاح يُعدّ «محفوظًا مع المراجعات» في حالتين: أن يُسجَّل بالخيار revisions_enabled (متاح منذ ووردبريس 6.4)، أو أن يُضاف عبر الفلتر wp_post_revision_meta_keys. الطريقة الأولى عند تسجيل الحقل:

register_post_meta(
    'post',
    'my_meta',
    array(
        'show_in_rest'      => true,
        'single'            => true,
        'type'              => 'string',
        'revisions_enabled' => true,
    )
);

والثانية لحقل مسجّل في كود لا تملك تعديله:

add_filter(
    'wp_post_revision_meta_keys',
    static function ( array $keys ): array {
        $keys[] = 'my_meta';
        return $keys;
    }
);

تنبيه: إضافة المفتاح إلى هذا الفلتر تعني أيضًا أن شاشة المراجعات الكلاسيكية ستستعيده. تأكد أن هذا هو السلوك المطلوب. وتذكّر أن نوع المحتوى نفسه يجب أن يدعم المراجعات، وإلا أطلق ووردبريس تنبيه doing_it_wrong.

ثلاث نقاط أخرى تستحق البحث في كودك:

  • أي عميل JavaScript يفحص نوع meta سيجد مصفوفة بدل كائن عندما لا توجد ميتا مراجَعة. القراءة المباشرة مثل revision.meta.some_key تعطي undefined في الحالتين.
  • لاستعادة مفتاح من المحرر الجديد يحتاج المفتاح إلى show_in_rest إلى جانب تفعيل المراجعات.
  • الخاصية $meta في المتحكم صارت كائنًا من الصنف WP_REST_Revision_Meta_Fields، وهو يرث من WP_REST_Post_Meta_Fields، فلن يتعطل كود يفحص الصنف الأب.

في JetEngine: إذا كنت تعرض حقول صناديق الميتا عبر REST API، فراجع على نسخة تجريبية هل تظهر في استجابة المراجعات بعد التحديث. بصراحة: لم نجد في وثائق JetEngine ما يوضح هل يسجّل حقوله مع revisions_enabled، وهذا القسم قراءة لملاحظة المطورين الرسمية وليس نتيجة اختبار.

2. نقطة التعليقات تقبل أكثر من حالة

كانت /wp/v2/comments تقبل حالة واحدة فقط في المعامل status، فإذا أردت التعليقات المعتمدة والمعلّقة معًا احتجت طلبين. في 7.2 يمكنك طلبهما مرة واحدة بإحدى الصيغتين:

/wp/v2/comments?status=approve,hold
/wp/v2/comments?status[]=approve&status[]=hold

الصلاحيات لم تتغير: المستخدم الذي لا يملك القدرة edit_posts، ومعه الطلبات غير المسجّلة، لا يستطيع إلا الحالة الافتراضية approve. أي قائمة أخرى، حتى لو احتوت approve، تُرفض بالخطأ rest_forbidden_param.

أين ينكسر الكود القديم؟

بعد التنقية أصبح $request['status'] مصفوفة دائمًا، وكذلك status داخل الوسائط التي يستقبلها الفلتر rest_comment_query. أي مقارنة بنص ستتوقف عن العمل بصمت، وهذا أخطر من خطأ ظاهر. الصيغة الآمنة تعمل في 7.1 و7.2 معًا:

// Before: only matches in 7.1 and earlier.
if ( 'hold' === $request['status'] ) {
    // ...
}

// After: works in 7.1 and in 7.2.
if ( in_array( 'hold', (array) $request['status'], true ) ) {
    // ...
}

ملاحظة: لم يُضف قيد على القيم المسموح بها، لأن WP_Comment_Query يدعم حالات تعليقات مخصصة. أي أداة تقرأ مخطط المسار ستجد status مصفوفة نصوص بدل نص واحد.

3. فلتر جديد لترويسة CORS

عندما يأتي طلب من نطاق آخر، كان ووردبريس يرسل قائمة ثابتة في ترويسة Access-Control-Allow-Methods هي OPTIONS, GET, POST, PUT, PATCH, DELETE. لتغييرها كان عليك فك ربط الدالة المسؤولة وإعادة كتابتها، وهي طريقة هشّة تتصادم إذا لجأت إليها إضافتان.

الآن يوجد خطّاف تصفية (Filter Hook) اسمه rest_allowed_cors_methods، على نمط الفلترين الموجودين منذ 5.5 للترويستين الأخريين. يستقبل قائمة الطرق والطلب الحالي (أو null عند الاستدعاء المباشر). مثال يقصر الطلبات من نطاقات أخرى على القراءة فقط لمسار عام في إضافتك:

add_filter(
    'rest_allowed_cors_methods',
    static function ( $methods, ?WP_REST_Request $request ) {
        if ( $request && str_starts_with( $request->get_route(), '/my-plugin/v1/public' ) ) {
            return array( 'OPTIONS', 'GET' );
        }
        return $methods;
    },
    10,
    2
);

لاحظ أن الكود لا يحدد نوع $methods كمصفوفة. السبب أن فلترًا سابقًا في السلسلة قد يعيد نصًا مفصولًا بفواصل، والتوصية الرسمية أن تمرّره على wp_parse_list() قبل التعديل.

تحذير: هذا ليس فحص صلاحيات. الترويسة تؤثر فقط في طلبات الفحص المسبق (Preflight) التي ترسلها المتصفحات، وأي عميل خارج المتصفح يتجاهلها. لتحديد من يفعل ماذا استخدم permission_callback في تعريف المسار.

تغيير صغير في التوافق

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

خطة مراجعة سريعة قبل 8 ديسمبر

  1. ثبّت 7.2 RC1 على نسخة تجريبية، إما بإضافة WordPress Beta Tester أو بالأمر wp core update --version=7.2-RC1. لا تجربها على موقع حي.
  2. ابحث في كود الإضافات المخصصة عن revisions، وautosaves، و$request['status']، وAccess-Control-Allow-Methods.
  3. لكل حقل ميتا يجب أن يرجع مع استعادة المراجعة، تأكد من revisions_enabled وshow_in_rest معًا.
  4. لو عندك تطبيق موبايل أو واجهة منفصلة تقرأ المراجعات أو التعليقات، اختبر شكل الاستجابة الجديد قبل نشر التحديث.

الأسئلة الشائعة

س: هل يجب أن أعدّل موقعي إذا لم أكتب كودًا مخصصًا؟
ج: في الغالب لا. التغييرات تخص الكود الذي يتعامل مع REST API مباشرة. حدّث إضافاتك المعروفة واختبر استعادة المراجعات في المحرر على نسخة تجريبية.

س: متى يصدر ووردبريس 7.2؟
ج: الموعد المجدول للإصدار النهائي هو 8 ديسمبر 2026، والنسخة المرشحة الأولى متاحة للاختبار الآن.

س: لماذا اختفت بعض حقول الميتا من استجابة المراجعة؟
ج: لأن 7.2 يعيد فقط الحقول المفعّل لها حفظ المراجعات. فعّل revisions_enabled عند التسجيل، أو أضف المفتاح عبر الفلتر wp_post_revision_meta_keys.

س: هل فلتر CORS الجديد يحمي واجهة موقعي؟
ج: لا. هو يتحكم في ما يعلنه الموقع للمتصفح فقط. الحماية الفعلية تكون عبر permission_callback لكل مسار.

الخلاصة

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

ولو عندك سؤال عن إضافة معيّنة، اكتبه في التعليقات وهنرد عليك.

مراجع إضافية: WordPress 7.2 Release Candidate 1، Framework for storing revisions of Post Meta in 6.4

مرجع المقال (بالإنجليزية): REST API changes in WordPress 7.2
المقال ده مش ترجمة حرفية: متكيّف للقارئ العربي ومضاف عليه سياق ووردبريس وElementor وJetEngine.

اترك تعليقاً