Блокове с цялостен стек
База данни, сървърни функции, 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 Шаблон + Interactivity 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 записа и запазва техните ID.
Таблици и типове публикации
Съхранението в table управлява таблица MySQL с dbDelta и добавя колони за нови полета. Съхранението в post_type създава публикация за всеки запис, така че WP_Query, плъгините REST API и инструментите GraphQL да могат да го четат.
Няколко схеми
Върнете именувани схеми от един db.php. Всяка има собствено съхранение, крайни точки и контрол на достъпа.
Данни с обхват на потребител
Задайте userScoped, за да изолирате записите автоматично, без ръчно филтриране.
Валидиране и куки
Типове, задължителни стойности, изброими стойности, формати, дължини, обратни извиквания и куки за жизнения цикъл.
RPC
Сървърни функции, извиквани от фронтенда.
Клиент bs.fn()
Извиквайте функции от JavaScript; вградените скриптове откриват автоматично името на блока.
Контрол на достъпа
Публичен достъп със CSRF защита, отворен достъп за уебхукове или достъп според правата за всяка функция.
Извиквания между блокове
Извиквайте всяка функция на блок от JavaScript или PHP и комбинирайте логиката.
Слой за данни на клиента
Четете, кеширайте и записвайте записи от браузъра.
Клиентът bs.db()
Създавайте, изброявайте, извличайте, актуализирайте и изтривайте записи от JavaScript. list приема филтри по полета, лимит и отместване.
bs.query()
Кеширани извличания по ключ. Извикванията в ход споделят един и същ promise, а 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=”…” изпраща полетата си до крайната точка за създаване на този блок, показва всяка грешка при валидиране под съответното поле и извиква formsuccess или 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], както и enum типовете Access, Method и Schedule. db.php може да използва Schema::make() и създатели на Field.
Преносимост
SQLite и JSONC вървят заедно с кода: копирайте една папка, за да разположите приложението.
Официалният комплект за разширения
Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.
- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord