Повнофункціональні блоки
База даних, серверні функції, 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 і зберігає їхні 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 приймає фільтри полів, limit і offset.
bs.query()
Отримання даних із кешу за ключем. Паралельні виклики використовують один проміс, а staleTime пропускає запит, поки дані актуальні.
bs.mutate()
Оптимістичне створення, оновлення й видалення записів у реактивному масиві стану з відновленням знімка, якщо запит завершується помилкою.
bs.cache
Кеш у пам’яті для bs.query() і bs.mutate(). Читайте, задавайте, інвалідуйте або очищайте записи безпосередньо.
Опитування в реальному часі
Увімкніть режим реального часу в 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], а також переліками Access, Method і Schedule. У db.php можна використовувати Schema::make() і конструктори Field.
Портативність
SQLite і JSONC зберігаються разом із кодом: скопіюйте одну папку, щоб розгорнути застосунок.
Офіційний набір розширень
Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.
- Понад 500 шаблонів сайтів
- Системні інструкції для ШІ
- Оновлення назавжди
- Приватна спільнота Discord