الإدارة
يأتي Blockstudio مزودًا بشاشة إدارة ضمن Tools > Blockstudio. وهي واجهة لفحص ما سجّله Blockstudio على مستوى المشروع من نظام الملفات، إلى جانب مستعرض للسجلات وسجلات قاعدة البيانات.
هذه ليست صفحة إعدادات عن قصد. الهدف هو إظهار ما هو موجود حاليًا: الكتل والإضافات والحقول والصفحات والمخططات والسجلات وقواعد البيانات.
الوصول
تتوفر صفحة الإدارة عند تحقق الشرطين التاليين:
- يمتلك المستخدم الحالي إمكانية
manage_options - الصفحة مفعّلة عبر
blockstudio/admin/enabled
عطّلها بالكامل باستخدام:
add_filter('blockstudio/admin/enabled', '__return_false');
العروض
نظرة عامة
النظرة العامة جرد للقراءة فقط لتسجيلات Blockstudio. وتتضمن علامات تبويب مخصصة لـ:
- الكتل: أنواع الكتل المسجّلة، ووضع العرض، وإصدار API، وعدد السمات
- الإضافات: الأهداف والأولوية ووضع العرض وعدد السمات
- الحقول: تعريفات
field.jsonالقابلة لإعادة الاستخدام - الصفحات: صفحات قائمة على الملفات، مع نوع المحتوى والحالة والمحرك وحالة المزامنة
- المخططات: مخططات
db.phpالمسجّلة، مع عدد مساحات التخزين والحقول
تستخدم الجداول مكوّن DataViews الأصلي في WordPress، لتظل الشاشة متوافقة مع wp-admin بدلًا من ابتكار واجهة منفصلة.
السجل
إذا كان مشروعك يحتوي على blocks.json مع سجلات مُهيأة، فستعرض صفحة الإدارة عرض السجل. يجلب هذا العرض الكتل المتاحة من تلك السجلات، ويتيح استيرادها مباشرةً إلى دليل الكتل المُهيأ.
يُستخدم إعداد blocks.json نفسه في كل من CLI ومتصفح الإدارة:
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}
تُدعم السجلات التي تتطلب مصادقة عبر تنسيق الكائن باستخدام الاستيفاء headers و${ENV_VAR}. راجع وثائق السجل للاطلاع على تنسيق الإعداد الكامل.
قواعد البيانات
إذا سجّل مشروعك أي مخططات db.php، فستعرض صفحة الإدارة عرض قواعد البيانات. ولكل مخطط علامة تبويب خاصة تعرض السجلات الفعلية داخل جدول DataViews.
لا تسلسل الشاشة جميع السجلات ضمن حمولة الإدارة الأولية. بدلًا من ذلك:
- تُحمّل بيانات المخطط الوصفية محليًا مسبقًا
- تُجلب السجلات عند الطلب عند فتح علامة تبويب قاعدة بيانات
- تقسّم الجداول الصفحات عبر REST API
وهذا يُبقي شاشة الإدارة قابلة للاستخدام حتى عندما تحتوي المشاريع على مجموعات بيانات كبيرة.
النطاق
النطاق الحالي محدود عن قصد:
- فحص ما سجّله Blockstudio
- استيراد الكتل من السجلات المُهيأة
- تصفح سجلات قواعد البيانات
لا يحل هذا محل سير عمل الإعدادات الحالي، ولا يحرر تعريفات الكتل أو الصفحات مباشرةً.