مساحة العمل
توفر مساحة العمل نظرة عامة مصغّرة تشبه Figma لجميع الصفحات التي يديرها Blockstudio. تُعرض كل صفحة كلوحة عمل داخل إطار iframe مباشر، ضمن صف أفقي واحد. حرّك العرض باستخدام لوحة اللمس، وكبّر أو صغّر بالقرص أو باستخدام Ctrl+scroll.
التفعيل
تتوفر مساحة العمل كصفحة إدارة مخفية. انتقل إلى:
/wp-admin/admin.php?page=blockstudio-canvas
لا يمكن الوصول إلى الصفحة إلا عندما يكون dev.canvas.enabled هو true، ويملك المستخدم الحالي إمكانية edit_posts.
الإعدادات
فعّل مساحة العمل واضبط سلوكها في blockstudio.json الخاص بالقالب:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
enabled |
boolean |
false |
تفعيل ميزة مساحة العمل. |
adminBar |
boolean |
true |
إظهار شريط إدارة WordPress داخل إطارات اللوحات. اضبطه على false للحصول على معاينة أنظف. |
يتوفر الإعدادان أيضًا كعاملَي تصفية:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
العروض
بدّل بين العروض باستخدام القائمة المنسدلة في الزاوية العلوية اليمنى.
- الصفحات: جميع الصفحات التي يديرها Blockstudio، كلوحات كاملة العرض في صف واحد.
- الكتل: جميع كتل Blockstudio المسجّلة ضمن تخطيط شبكي، مع عرض كل منها بقيم السمات الافتراضية.
الجرد العام وعقد توثيق API
يوفّر Canvas عقد PHP محايدًا تجاه المستهلك وذا إصدار محدد، للأدوات التي تحتاج إلى المحتوى المسجّل نفسه من دون إعادة بناء منطق اكتشاف Blockstudio أو عرضه:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
يتوفر الإصدار الحالي على هيئة Canvas::SCHEMA_VERSION. وتتضمن نتائج الجرد ما يلي:
inventory: أمثلة موحّدة لـpagesوblocksوpatternsوtemplatesوpartsوعائلةuiالعامةorder: ترتيب عرض ثابتًا عبر الأنواعsources: مسارات المصدر المحددة بدقة، مع معلومات المصدر لكل سجل؛ ويكونsourceلسجل الصفحة هوية مصدره الثابتة، بينما يمثّلpathمسار قالب العرض الفعليwarningsوerrors: مشكلات منظّمة بدلًا من مخرجات مُصدرةdeleted: المعرّفات المطلوبة التي لم تعد موجودةselection: التحديد الموحّد وما إذا كان موجّهًا
يضيف Canvas::documents() مستند عرض كاملًا لكل سجل محدد. يحتوي كل مستند على متنه وHTML المُجمّع وأسماء الكتل المغلقة التبعيات وCSS وJavaScript المحددَين بدقة والوحدات وتهيئة التفاعلية الشاملة ومتغيرات UI المضمّنة ومخرجات Tailwind. تستخدم مستندات الصفحات غلاف محتوى دلاليًا من نوع <main>؛ ويمكن للجهات المستدعية تجاوزه أو تعطيله عبر خيارات مستند العرض المشتركة. تُعرض كل صفحة محددة ضمن سياق WordPress الواجهة الأمامية المستعاد الخاص بها، بحيث تتعامل شروط الاستعلام وعوامل تصفية فئات body والرموز القصيرة والتخطيطات وعمليات إعادة التوجيه واستدعاءات wp_enqueue_scripts مع الصفحة نفسها، لا مع طلب الإدارة أو REST الذي طلب نتيجة مساحة العمل. تُدمج فئات body التي يزوّدها المستدعي مع الفئات السياقية للصفحة، وتُعزل سجلات الإضافة إلى طوابير الواجهة الأمامية بين المستندات. تحل مساحة العمل عمليات الاستدعاء هذه بحسب أسماء دوالها العامة WordPress، ليُحافَظ على السياق نفسه عند تحميل Blockstudio عبر Composer أو ضمن نطاق تطبيق منقول.
دلالات التحديد الدقيقة
التحديد صارم:
- عدم وجود مفاتيح أنواع معروفة يعني تحميل كل الأنواع.
- تحميل
trueأوnullأو"*"يعني تحميل كل السجلات لذلك النوع. - تحمّل السلسلة أو القائمة السلاسلَ أو القوائمَ المقتصرة على المعرّفات أو الأسماء أو الأسماء اللطيفة أو المسارات أو مسارات المصدر المطابقة تمامًا.
- السلسلة أو القائمة الفارغة أو
falseلا تحمّل أي سجلات من ذلك النوع. - بمجرد وجود مفتاح لأي نوع، لا تُكتشف الأنواع المحذوفة ولا تُزامن ولا تُعرض ولا تُجمّع.
وهذا يجعل الطلبات التي تقتصر على العناصر المتغيرة آمنة للمشاريع الكبيرة. تُحل الكتل والصفحات الموجودة عبر سجلاتها المعتمدة. وعندما لا يكون محمّلًا في طلب الواجهة الأمامية سوى إسقاط الصفحة المحفوظ، تنفّذ مساحة العمل اكتشافًا للمصدر للقراءة فقط، وتدمج معرّفات المنشورات والروابط الدائمة المطابقة دون مزامنة المحتوى. وينطبق دمج الهوية نفسه عندما يملأ مصدر اكتشاف منطقي السجل المدعوم بالمصدر أولًا، كي يظل عرض الصفحة السياقي يستخدم منشور WordPress المُدار المطابق. ولا يُكتشف الهيكل الجديد للجلسة الحية إلا حول الدليل المتغير، بينما لا تُجمّع مصادر القوالب المحددة للأنماط ومحرر الموقع إلا بعد تحديدها.
يتبع مسار تحديث REST القاعدة نفسها لمعاملَي الاستعلام الحاليين blocks وpages. على سبيل المثال، يعيد ?blocks=theme/hero تلك الكتلة دون أي صفحات؛ استخدم كلا المعاملين للحصول على استجابة مختلطة. أما استدعاء المسار دون أي منهما فيحافظ على الاستجابة القديمة الكاملة.
الوضع المباشر
يستخدم الوضع المباشر أحداثًا مرسلة من الخادم (SSE) لاكتشاف تغييرات الملفات وتحديث مساحة العمل في الوقت الفعلي. عند تحرير قالب كتلة أو صفحة، أو ورقة أنماط، تُحدّث اللوحات المتأثرة تلقائيًا خلال نحو ثانية.
بدّل الوضع المباشر من القائمة المنسدلة. يظهر مؤشر أخضر نابض عند تفعيله. ويستمر الإعداد بين الجلسات عبر localStorage.
يتتبع الوضع المباشر التغييرات في ملفات .php و.json و.css و.scss و.js و.twig و.html داخل أدلة الكتل والصفحات. وتؤدي التعديلات المعروفة إلى تحديث الكتلة أو الصفحة المسجّلة وحدها. أما الكتلة أو الصفحة الجديدة فعلًا فتُطلق تمريرًا واحدًا لاكتشاف الهيكل ضمن نطاق دليلها، ما يتيح إنشاء المحتوى أثناء جلسة مباشرة مفتوحة دون إعادة فحص مصادر غير ذات صلة.
وضع التركيز
انقر على تسمية أي لوحة للدخول إلى وضع التركيز. تملأ اللوحة المحددة مساحة العرض كاملةً مع إمكانية التمرير عموديًا. اضغط Escape أو انقر زر الإغلاق للعودة إلى النظرة العامة.
عناصر التحكم
| الإجراء | الإدخال |
|---|---|
| التحريك | التمرير / السحب بإصبعين على لوحة اللمس |
| التكبير والتصغير | Ctrl+scroll أو القرص |
| ملاءمة العرض | القائمة المنسدلة |
| تكبير إلى 100% | القائمة المنسدلة |
| تركيز اللوحة | النقر على تسمية اللوحة |
| الخروج من التركيز | Escape / زر الإغلاق |
الأمان
لا يُحمّل نص مساحة العمل وبيانات الصفحات إلا عند تحقق جميع الشروط التالية:
- إعداد
dev.canvas.enabledهوtrue. - يمتلك المستخدم الحالي إمكانية
edit_posts.
لا يرى الزوار العموميون نص مساحة العمل أو البيانات الوصفية للصفحات مطلقًا.