كتل متكاملة المكدس
قاعدة البيانات ودوال الخادم وcron وCLI في مجلد واحد.
db.php
عرّف المخطط واحصل على نقاط نهاية CRUD
<?php
return [
'storage' => 'sqlite',
'userScoped' => true,
'capability' => [
'create' => true,
'read' => true,
'update' => true,
'delete' => true,
],
'fields' => [
'text' => ['type' => 'string', 'required' => true],
'done' => ['type' => 'boolean', 'default' => false],
],
];rpc.php
دوال خادم مخصصة
<?php
use Blockstudio\Db;
return [
'toggle' => function (array $params): array {
$db = Db::get('my-theme/todo');
$id = (int) ($params['id'] ?? 0);
$todo = $db->get_record($id);
if ($todo) {
$db->update($id, ['done' => !$todo['done']]);
}
return ['success' => (bool) $todo];
},
'clear_done' => function (): array {
$db = Db::get('my-theme/todo');
foreach ($db->list(['done' => true], 500) as $todo) {
$db->delete((int) $todo['id']);
}
return ['cleared' => true];
},
];كل إمكانية في ملف
يضيف كل ملف إمكانية واحدة. بلا إعدادات أو كود تسجيل.
كتلة تطبيق
blockstudio/
└── my-app/
├── block.json تعريف الكتلة
├── index.php القالب + التفاعلية API
├── style.css أنماط محددة النطاق
├── script-inline.js منطق العميل
├── db.php نموذج البيانات + CRUD
├── rpc.php دوال الخادم
├── cron.php المهام المجدولة
└── db/default.sqlite
قاعدة البيانات
عرّف المخططات واحصل على نقاط نهاية CRUD.
6 أوضاع تخزين
table, sqlite, jsonc, storh, meta, post_type. اختر حسب قابلية النقل واحتياجات الاستعلام.
ملفات Storh
ملف واحد لكل سجل ضمن uploads، مع فهارس تُنشأ من المخطط وكتابات متزامنة أكثر أمانًا. ينقل wp bs db migrate –to=storh سجلات JSONC مع الاحتفاظ بمعرّفاتها.
الجداول وأنواع المحتوى
تدير آلية التخزين table جدول MySQL باستخدام dbDelta، وتضيف أعمدة للحقول الجديدة. تجعل آلية التخزين post_type كل سجل تدوينة، بحيث تتمكن WP_Query وإضافات REST API وأدوات GraphQL من قراءته.
مخططات متعددة
أعِد مخططات مسماة من db.php واحد. لكل منها تخزينها ونقاط نهايتها وضوابط الوصول الخاصة بها.
بيانات خاصة بالمستخدم
اضبط userScoped لعزل السجلات تلقائيًا، دون تصفية يدوية.
التحقق والخطافات
الأنواع والقيم المطلوبة والتعدادات والتنسيقات والأطوال وعمليات الاستدعاء وخطافات دورة الحياة.
RPC
دوال الخادم القابلة للاستدعاء من الواجهة الأمامية.
طبقة بيانات العميل
اقرأ السجلات وخزّنها مؤقتًا واكتبها من المتصفح.
عميل bs.db()
أنشئ السجلات واعرضها واحصل عليها وحدّثها واحذفها من JavaScript. تقبل list مرشحات الحقول والحد الأقصى والإزاحة.
bs.query()
عمليات جلب مخزنة مؤقتًا حسب المفتاح. تشترك الاستدعاءات الجارية في وعد واحد، وتتجاوز staleTime الطلب ما دامت البيانات حديثة.
bs.mutate()
إنشاء السجلات وتحديثها وحذفها بتفاؤل في مصفوفة حالة تفاعلية، مع التراجع إلى لقطة عند فشل الطلب.
bs.cache
الذاكرة المؤقتة داخل الذاكرة وراء bs.query() وbs.mutate(). اقرأ الإدخالات أو عيّنها أو أبطِلها أو امسحها مباشرة.
استطلاع آني
اضبط realtime في db.php، فيقارن العميل تجزئة البيانات على فترات، ثم يحدّث متجر Interactivity API. يتوقف الاستطلاع مؤقتًا في علامات التبويب المخفية.
صفحات مخزنة مؤقتًا
يجلب bs.fn() وbs.db() بيانات اعتماد حديثة من نقطة نهاية غير مخزنة مؤقتًا عند أول استدعاء، لتظل الاستدعاءات العامة تعمل على الصفحات المقدمة من ذاكرة تخزين مؤقت طويلة الأمد.
النماذج وشاشات التطبيقات
نماذج معروضة من المخطط، وحزم UI للانطلاق منها.
نماذج المخطط
امنح الحقل مفتاح مكوّن، وسيعرض bs_db_form() النموذج عبر تلك الكتل، مع تمرير تعريف الحقل إلى كل منها.
نموذج مجمّع
باستخدام ui.enabled، يرسل bsui/form block=”…” حقوله إلى نقطة إنشاء النهاية الخاصة بتلك الكتلة، ويعرض كل خطأ تحقق أسفل حقله، ثم يطلق form success أو formerror.
تطبيقات نموذجية
يسجل إعداد ui أيضًا أمثلة app/*، مثل app/kitchen-sink وapp/chat، المبنية من مكونات bsui نفسها.
البنية التحتية
Cron وCLI ورمز الإعداد وقابلية النقل.
المهام المجدولة
تُسجّل مهام cron.php في WP-Cron. ويزيلها تثبيت Composer باستخدام wp bs teardown.
CLI قاعدة البيانات
يعرض wp bs db السجلات بمرشحات الحقول، ويجلبها وينشئها ويحدّثها ويحذفها، ويطبع الجداول أو JSON أو CSV.
اختبر من الطرفية
يشغّل wp bs rpc call دالةً بمعاملات –key=value، ويشغّل wp bs cron run مهمةً فورًا مهما كان جدولها.
ملفات التهيئة
يعمل init.php وغيره من ملفات init*.php في مجلد الكتلة مرة واحدة عند init، لإعداد أمور مثل تسجيل نوع محتوى.
تعريفات أصلية لـPHP
يمكن أن يعيد rpc.php وcron.php صنفًا بأساليب #[Rpc] و#[Cron] وتعدادات Access وMethod وSchedule. ويمكن لـdb.php استخدام Schema::make() ومنشئات Field.
قابلية النقل
تنتقل SQLite وJSONC مع الكود: انسخ مجلدًا واحدًا لنشر التطبيق.
حزمة الإضافات الرسمية
قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.
- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص