انتقل إلى المحتوى

عام

سجل Blockstudio أداة CLI لتوزيع كتل WordPress المثبتة من السجلات المستضافة.

يعمل مثل shadcn/ui، لكن لكتل WordPress. لا توجد حزمة npm لتثبيتها. شغّل أمرًا، فيُنقل مصدر الكتلة إلى مشروعك وتصبح ملكًا لك بالكامل.

طريقة العمل

  1. ينشر مؤلفو الكتل ملف registry.json على URL يسرد الكتل المتاحة.
  2. تضيف blocks.json إلى القالب أو الإضافة لتحديد السجلات التي تريد استخدامها.
  3. تشغّل 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

راجع البدء للاطلاع على الإعداد الكامل.