Dennis · 14 أكتوبر 2026
Blockstudio 7.7
يضيف Blockstudio 7.7 مسارات افتراضية للمستندات التي لا تملك منشور WordPress، ويحسّن عمليات البناء المستهدفة للعرض المسبق، ويزيد موثوقية تحرير الكتل الحالية وعرضها. كما يوسّع فحوص وسوم الكتل في PHPStan ويحسّن إمكانية الوصول في مكوّنات UI المضمّنة.
يظل سير العمل المعتمد على الملفات كما هو. تُعرض الكتل من قوالبها، وتتغير الصفحات المدعومة بالملفات عبر مزامنة صريحة باستخدام CLI أو API. لا يقدم هذا الإصدار مزامنة تلقائية للصفحات عند طلبات الزوار أو الإدارة.
باختصار:
- المسارات الافتراضية: اعرض معرض مكوّنات أو فهرسًا أو مستندًا كاملًا آخر دون إنشاء منشور أو كتابة معالج إعادة توجيه مخصص.
- عمليات البناء المستهدفة للعرض المسبق: تسجل عمليات البناء باستخدام HTTP ملفات المصدر التي تستخدمها كل صفحة، ما يتيح لعملية بناء لاحقة عرض المسارات المتأثرة فقط.
- الاحتفاظ بذاكرة التخزين المؤقت: أبقِ أوراق الأنماط المتقاعدة متاحة للصفحات المخزنة مؤقتًا، وافحص إدخالات خريطة التقديم المبكر غير المستخدمة أو احذفها.
- موثوقية المحرر: تحتفظ الكتل المحددة معًا بقيمها الخاصة، ويعمل التراجع والإعادة مع RichText وحقول الشريط الجانبي، ويبقى السياق الموروث مرتبطًا بالكتلة الصحيحة.
- سلامة محتوى الملفات: تبقى القوائم المتداخلة وعناصر تقسيم الصفحة وHTML المضمّن والرموز القصيرة والسمات المهروبة سليمة عند التحليل والعرض.
- تحسينات PHPStan: تُفحص وسوم البادئات والأسماء المستعارة وعناصر الصفحات المعينة ومتغيرات القوالب وفق تعريفات المشروع نفسه.
- UI يسهل الوصول إليها: تعرض عناصر التحكم حالتها على نحو صحيح، وتبدّل التسميات الإدخال الصحيح، وتستخدم مكوّنات القوائم والجداول بنية HTML صالحة.
- الترجمات: تُحمّل ترجمات JavaScript المثبتة في المحرر ونظرة عامة الإدارة، بما فيها عناصر التحكم بالحقول التي لم تكن مترجمة سابقًا.
المسارات الافتراضية
تأتي بعض الصفحات من البيانات بدلًا من منشور يديره المحرر. فقد يحتاج مرجع المكوّنات، مثلًا، إلى URL وعنوان مستند خاصين به، دون إدخال في wp_posts.
سجّل ذلك المستند باستخدام Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
يخدم المسار /components/. تعمل دالة الاستدعاء الخاصة به داخل مخزن إخراج Blockstudio، لذا تتلقى الكتل المعروضة أنماطها ونصوصها البرمجية وأصول UI المجمعة ومخرجات Tailwind عبر المسار المعتاد. لا يحوّل WordPress المسار المطابق إلى خطأ 404 ولا يعيد توجيهه إلى منشور.
لمجموعة من عناوين URL، عيّن prefix إلى true ووفّر دالة استدعاء match. تتلقى الدالة المسار الواقع أسفل المسار الأساسي وتعيد القيمة التي يحتاج إليها العارض. يؤدي إرجاع null أو false إلى ترك الطلب لـ WordPress. استخدم urls لسرد المسارات التي ينبغي أن تتضمنها عملية بناء العرض المسبق الثابت. يُضمّن المسار المنفرد غير ذي البادئة تلقائيًا.
يعيد Virtual_Routes::urls() عناوين URL مطلقة للتكاملات التي تُنشئ خريطة موقع. ولا يضيف المستندات الافتراضية تلقائيًا إلى خريطة موقع منشورات WordPress.
راجع المسارات الافتراضية للاطلاع على API والخيارات كاملةً.
عمليات بناء عرض مسبق أدق
تسجل الآن عمليات البناء في وضع الرسم البياني التي تُعرض عبر HTTP الملفات التي استخدمها كل مسار: قالب WordPress، وقوالب الكتل المعروضة وأصولها، وتعريفات صفحات الملفات وتخطيطاتها، والاعتماديات المضافة عبر blockstudio/render/dependencies.
في عملية البناء التالية، يقارن build_plan() تلك الاعتماديات. يؤدي تغيير قالب كتلة إلى تحديد المسارات التابعة له لإعادة العرض دون إعادة بناء الصفحات الأخرى غير المرتبطة. وتظل تغييرات الإعدادات المشتركة مؤثرة في عملية البناء بأكملها، كما تُعرض المسارات الجديدة أو المنتهية صلاحيتها كالمعتاد.
التغييرات التي تقتصر على قاعدة البيانات ليست اعتماديات ملفات. يجب أن يفرض النشر الذي يحتاج إلى جلب خيار أو منشور أو قيمة أخرى من قاعدة البيانات عملية بناء، أو يعرض عناوين URL المتأثرة صراحةً.
يصلح الإصدار أيضًا تغيّر هويات البناء أثناء العرض الأول، وخرائط التقديم المبكر المخزنة مؤقتًا في ذاكرة التعليمات البرمجية والقديمة، واستبعاد عناوين URL صالحة لمجرد احتواء مساراتها على search أو preview. تتجاوز طلبات Markdown التي تستخدم Accept: text/markdown ذاكرة HTML المؤقتة، وترسل الاستجابات ذات الصلة Vary: Accept.
يحترم العرض المسبق الثابت الآن المرشحات التي يسجلها القالب النشط عند تحديد ما إذا كان سيُرفق خطافاته. يمكن للقالب تعطيل الميزة دون أن يؤدي البحث السابق عن الإعدادات إلى إبقائها نشطة.
راجع العرض المسبق الثابت.
الاحتفاظ بذاكرة التخزين المؤقت وصيانتها
قد تعيش صفحة HTML مخزنة مؤقتًا بعد انتهاء هوية بيئة التشغيل التي جمّعت ورقة أنماطها. يتحكم cache.namespaceGrace في مدة إتاحة المساحات الاسمية المتقاعدة بعد أن تكتشف عملية التنظيف تقاعدها أول مرة:
{
"cache": {
"namespaceGrace": 777600
}
}
يحتفظ هذا المثال بالملفات المتقاعدة لمدة تسعة أيام. والافتراضي يوم واحد. وتُستثنى من تنظيف الملفات المتقاعدة المساحات الاسمية النشطة حاليًا وتلك التي تخدم عناصر العرض المسبق المنشورة.
تتضمن خريطة التقديم المبكر أيضًا أوامر للفحص والتنظيف:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
تُبلغ هذه الأوامر عن الإدخالات الخاصة بالمواقع المحذوفة أو المجلدات المفقودة وتحذفها. ويؤدي حذف موقع من شبكة متعددة المواقع إلى إزالة إدخالاته أيضًا. ويُبلّغ عن مستندات المسارات المفقودة بشكل منفصل بدلًا من التسبب في إزالة إدخال موقع صالح بالكامل.
راجع التخزين المؤقت لإرشادات الاحتفاظ، وصيانة الخريطة لمعرفة الأوامر.
محرر أكثر موثوقية
يؤدي الآن تحرير كتلة محددة مع كتل أخرى إلى تحديث تلك الكتلة وحدها. ويحافظ الحفظ على محتوى كل كتلة ومفاتيحها وبياناتها الوصفية وأقفالها بدلًا من نسخ السمات بين الكتل المحددة.
توجد قيم RichText مباشرةً في سمات الكتل، لذا يمكن لـ Gutenberg تضمينها في التراجع والإعادة. وتشارك حقول الشريط الجانبي في سجل المحفوظات نفسه. يُمرر InnerBlocks templateLock="false" كقيمة منطقية فعلية، ويفك قفل المحتوى حتى عندما تكون منطقة خارجية مقفلة.
تتلقى عمليات التحميل المسبق الأولية معرّف المنشور المحرر ونوعه، كي تتمكن القوالب من قراءة البيانات الوصفية الصحيحة عند العرض الأول. وتحتفظ الكتل الفرعية المتطابقة تحت آباء مختلفين بسياق موروث منفصل في عمليات التحميل المسبق وذاكرات العرض المؤقتة. ولم تعد تغييرات السمات أو السياق أثناء الطلب الأول تترك المعاينة متأخرة عن التغييرات.
يمنع Blockstudio أيضًا إدراج عناصر علامات عرض مخفية بين جذور الكتل. وترى محددات الأشقاء المتجاورين مثل .card + .card الآن علاقات العناصر نفسها في المحرر والواجهة الأمامية، مع بقاء عروض معاينة المحرر وأداة الإدراج منفصلة.
تخزين أكثر أمانًا للخيارات على مستوى الموقع
لا تزال الحقول المدعومة بالخيارات توفر قيمًا على مستوى الموقع، لكن حفظ منشور لم يعد يكتب بلا تمييز كل النسخ المحفوظة من تلك الحقول:
- لا تكتب عمليات حفظ المسودات والمنشورات قيد الانتظار والخاصة والمجدولة خيارات الموقع المباشرة.
- تكتب عمليات حفظ المنشورات المنشورة الحقول المُرسلة التي تغيرت أثناء ذلك التعديل.
- لا يعيد حفظ العنوان فقط لنسخة قديمة قيمة أحدث على مستوى الموقع.
- لا تحذف الحقول المفقودة والكتل المحذوفة الخيارات الموجودة.
- يزيل
nullالصريح خيارًا. وتظل السلاسل الفارغة وfalseوالصفر والمصفوفات الفارغة قيمًا صالحة.
هذا هو التغيير السلوكي الرئيسي الذي ينبغي التحقق منه عند الترقية. إذا كان تكامل ما يستخدم منشورًا خاصًا أو مسودة لتحديث خيار مباشر، فاكتب ذلك الخيار صراحةً أو استخدم منشور إعدادات منشورًا. ولا يتأثر تخزين بيانات المنشور الوصفية بقيد النشر فقط.
راجع التخزين للاطلاع على قواعد الحفظ كاملةً.
يبقى محتوى الملفات سليمًا
يحافظ مسار التحويل من HTML إلى الكتل على مزيد من البنية التي كتبتها:
- تتحول القوائم المتداخلة إلى كتل قوائم داخلية ضمن عنصرها الأب. وتُحفظ فئات القائمة والعنصر؛ أما القوائم المسطحة العادية فتحافظ على مخرجاتها السابقة.
- تتحول
mainوheaderوfooterوarticleوasideإلى كتل مجموعات تحافظ على عنصرها بدلًا من HTML خام يتجاوز عرض الكتل. - تحتفظ فقرات النص الغني المعينة بالعلامات المضمنة، وتُحلّ الفقرات التي تحتوي على صور فقط إلى كتلة الصورة المعينة، كما تحتفظ وسوم الرموز القصيرة بمحتواها.
- تُفك ترميز السمات المهروبة ثم تُهرّب مرة واحدة، بما في ذلك سمات
InnerBlocksوRichTextوالعنصرuseBlockProps. - تُقبل علامات أكبر من داخل سمات العلامات ذاتية الإغلاق المحاطة بعلامات اقتباس.
- تصل سمات HTML العامة إلى جذر كتلة Blockstudio عندما لا تعرّفها الكتلة كحقول. ويعرض
wp bs pages syncالسمات المخزنة التي لم تُعرض.
تُعرض الآن الصفحات المدعومة بـ Blade والأنماط وقوالب محرر الموقع عبر Blockstudio\Blade_Renderer، مع دعم illuminate/view من الإصدار 8 إلى 12. وتسجل جميع ملفات الامتداد المستهدفة للكتلة نفسها، وتتبع أولوياتها وحقول مجموعاتها وقوائم الأهداف المخطط الموثق.
تُتتبّع أيضًا اعتماديات SCSS المتداخلة. يؤدي تحرير جزء مستورد بواسطة جزء آخر إلى تغيير إصدار ورقة الأنماط التابعة وتحفيز إعادة تجميعها.
تحسينات PHPStan
يوسّع التحقق من وسوم الكتل في حزمة blockstudio/phpstan المثبتة بشكل منفصل ليشمل وسوم البادئات والأسماء المستعارة وعناصر الصفحات المعينة والتخطيطات وكتل UI المضمّنة، واختياريًا مصادر PHP الأخرى في المشروع. وتطابق دقة حل المساحات الاسمية بيئة التشغيل، بما فيها المساحات التي تحتوي على واصلات، كما تُقبل سمات HTML العامة المُمررة.
تُعامل متغيرات قوالب الكتل مثل $a و$block و$context على أنها معرّفة بواسطة Blockstudio. وتظل أنواع الحقول محفوظة بعد استخدام عامل الدمج عند القيم الفارغة وisset() ضمن PHPStan 2.3، بينما تحتفظ القوالب التي تعيّن قيمة $a خاصة بها بالنوع الذي عيّنته.
تُطرح هذه التغييرات في blockstudio/phpstan 0.1.9. حدّث الحزمة بشكل منفصل عن الإضافة؛ فهي تتطلب PHPStan 2.1.47 أو أحدث:
composer require --dev blockstudio/phpstan:^0.1.9
راجع PHPStan للإعداد والتحليلات المسبقة.
إمكانية الوصول والترجمات
تعرض مفاتيح UI المضمّنة حالتها الموسعة على الزر الفعلي. وتسمّي تسميات مربعات الاختيار والمفاتيح وأزرار الاختيار عناصر التحكم الخاصة بها وتبدّلها. ولم تعد مسارات التنقل والترقيم وقوائم التنقل والجداول تدرج عناصر التفاف غير صالحة بين القوائم أو الجداول وعناصرها الفرعية.
تعرض مفاتيح إظهار كلمات المرور حالتها المضغوطة، ولها مساحة نقر أكبر. وتقبل الحقول autocomplete، كما تقبل حقول كلمة المرور معرّفًا صريحًا وتسميات يسهل الوصول إليها. ويمكن نقل التركيز إلى منافذ عرض الشرائح بلوحة المفاتيح، وتحترم رسوم مؤشرات التحميل والهياكل العظمية تفضيلات تقليل الحركة.
يحمّل المحرر ونظرة عامة الإدارة الترجمات المثبتة لـ JavaScript ضمن نطاق النص blockstudio. وأصبحت قوائم السمات والعناصر النائبة وإجراءات النوافذ المنبثقة للأكواد وشارات الصور والملفات قابلة للترجمة. وتظل السلاسل التي لا تتوفر لها ترجمة باللغة الإنجليزية.
الوثائق والترقية
تضيف الوثائق أدلة لمواقع التوثيق، ومزامنة المحتوى، وقوالب محرر الموقع، ووسوم الكتل، والجزر، وأنواع الحقول المخصصة، والنشر، والعرض المسبق، وإعداد السجل، وأدوات التحليل، وشاشات تطبيق UI. ويعكس دليل ترحيل ACF أساليب التسجيل الحالية في ACF وارتباطات الكتل.
تستخدم أمثلة التعبئة المخصصة الآن مرشح مجموعة البيانات المسماة ذي الوسيط الواحد والمدعوم. وتشرح وثائق الأصول ترتيب أوراق الأنماط في الواجهة الأمامية وكيفية تحميل تجاوزات القالب بعد الكتلة CSS. وتستخدم عمليات تثبيت المساهمين حزمة Font Awesome العامة دون بيانات اعتماد للسجل.
يظل PHP 8.2 وWordPress 6.7 الحد الأدنى للمتطلبات. تتوفر المسارات الافتراضية وأوامر الصيانة الجديدة دون تغيير مجموعات الصفحات الحالية. راجع قواعد حفظ تخزين الخيارات أعلاه، وحدّث حزمة PHPStan المنفصلة إذا كنت تستخدمها، واستمر في تشغيل مزامنة الصفحات صراحةً كما في السابق.
7.7.1 متابعة
يجعل التصحيح 7.7.1 نتائج المزامنة أوضح وأكثر أمانًا. لم يعد الدمج باستخدام المفاتيح الذي لا يغيّر المنشور ينشئ مراجعة أو يحدّث طابع وقت التعديل. تُحفظ حالات النشر الحالية، ويُبلّغ عن استبدال العناوين والروابط الثابتة التي تملكها الملفات، وتُذكر الصفحات المقفلة أو المحذوفة في تقرير CLI. يعلّم Content Sync الأجسام التي يملكها Page Sync ويحافظ على نسخ المراجعة الحالية. كما يحمي التصحيح السمات التي يملكها WordPress من معرّفات الحقول المتعارضة، ويحافظ على فئات المحرر التي أضافتها عوامل التصفية الأخرى.