Перейти до вмісту

Повнофункціональні блоки

База даних, серверні функції, cron і CLI в одній папці.

db.php

Визначте схему — отримайте кінцеві точки CRUD

db.php
<?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

Власні серверні функції

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.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 для розробки на їхній основі.

Інфраструктура

Cron, CLI, код налаштування та портативність.

Plus

Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

  • Понад 500 шаблонів сайтів
  • Системні інструкції для ШІ
  • Оновлення назавжди
  • Приватна спільнота Discord