عام
سجل Blockstudio أداة CLI لتوزيع كتل WordPress المثبتة من السجلات المستضافة.
يعمل مثل shadcn/ui، لكن لكتل WordPress. لا توجد حزمة npm لتثبيتها. شغّل أمرًا، فيُنقل مصدر الكتلة إلى مشروعك وتصبح ملكًا لك بالكامل.
طريقة العمل
- ينشر مؤلفو الكتل ملف
registry.jsonعلى URL يسرد الكتل المتاحة. - تضيف
blocks.jsonإلى القالب أو الإضافة لتحديد السجلات التي تريد استخدامها. - تشغّل
npx blockstudio add ui/tabsفيُضاف مجلد الكتلة إلى مشروعك.
هذا كل شيء. ينزّل CLI الملفات، ويحل التبعيات، ويكتبها على القرص. ولا يجري أي تحويل. مجلد كتل WordPress واحد يعمل بالطريقة نفسها في كل مكان.
ما يدعمه
السجل لا يقيّد نوع الكتل؛ فهو ينسخ المجلدات. تعمل أي كتلة موجودة في مجلد:
- كتل Blockstudio:
block.json+ قالب PHP/Twig/Blade + أصول اختيارية - كتل
@wordpress/create-block: ناتج بناء JS كامل معedit.jsوsave.jsوغيرها - كتل PHP عادية: أي كتلة مسجلة باستخدام
register_block_type() - كتل ثابتة: كتل تحتوي على
block.jsonفقط ولا تتضمن عرضًا من جهة الخادم
لا يهم CLI ما يحتويه المجلد؛ إذ يقرأ بيان الملفات من السجل وينزّل الملفات المحددة فيه فقط.
لوحة إدارة WordPress
إذا كان للقالب النشط blocks.json مُعدّ بسجلات، فستظهر السجلات نفسها أيضًا في Tools > Blockstudio > Registry داخل wp-admin.
تتيح لك أداة التصفح الإدارية هذه معاينة الكتل المتاحة واستيرادها دون لمس CLI. يظل تنسيق الإعدادات كما هو، وتبقى blocks.json المرجع الأساسي.
البدء السريع
npx blockstudio init
npx blockstudio add ui/tabs
راجع البدء للاطلاع على الإعداد الكامل.