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

Адміністрування

Blockstudio має екран адміністрування в розділі Інструменти > Blockstudio. Це інтерфейс для перегляду того, що Blockstudio зареєструвала з файлової системи, а також для огляду реєстрів і записів бази даних.

Це навмисно не сторінка налаштувань. Її мета — надати огляд того, які блоки, розширення, поля, сторінки, схеми, реєстри та записи бази даних існують зараз.

Доступ

Сторінка адміністрування доступна, якщо виконуються обидві умови:

  • поточний користувач має дозвіл manage_options
  • сторінку ввімкнено через blockstudio/admin/enabled

Повністю вимкніть її за допомогою:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Подання

Огляд

Огляд — це інвентаризація реєстрацій Blockstudio лише для читання. У ньому є окремі вкладки для:

  • Блоків: зареєстровані типи блоків, режим рендерингу, версія API, кількість атрибутів
  • Розширень: цілі, пріоритет, режим рендерингу, кількість атрибутів
  • Полів: повторно використовувані визначення field.json
  • Сторінок: сторінки на основі файлів із типом запису, статусом, рушієм і станом синхронізації
  • Схем: зареєстровані схеми db.php із даними про сховище та кількість полів

У таблицях використовуються вбудовані WordPress DataViews, тож екран узгоджений із wp-admin і не створює окремого інтерфейсу.

Реєстр

Якщо у вашому проєкті є blocks.json із налаштованими реєстрами, на сторінці адміністрування з’явиться подання Реєстр. Воно отримує доступні блоки з цих реєстрів і дає змогу імпортувати їх безпосередньо в налаштований каталог блоків.

Той самий файл конфігурації blocks.json керує і CLI, і браузером адміністрування:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blocks.json",
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json"
  }
}

Підтримуються автентифіковані реєстри через формат об’єкта з інтерполяцією headers і ${ENV_VAR}. Повний формат конфігурації див. у документації Реєстру.

Бази даних

Якщо у вашому проєкті зареєстровано будь-які схеми db.php, на сторінці адміністрування з’явиться подання Бази даних. Для кожної схеми буде окрема вкладка з фактичними записами в таблиці DataViews.

Екран не серіалізує всі записи до початкового набору даних адміністрування. Натомість:

  1. метадані схеми локалізуються заздалегідь
  2. записи отримуються на вимогу, коли ви відкриваєте вкладку бази даних
  3. у таблицях можна переходити сторінками через REST API

Завдяки цьому екран адміністрування залишається зручним навіть у проєктах із великими наборами даних.

Обсяг підтримки

Поточний обсяг підтримки навмисно обмежений:

  • перегляд зареєстрованого в Blockstudio
  • імпорт блоків із налаштованих реєстрів
  • перегляд записів бази даних

Це не замінює наявний процес налаштувань і не дає змоги редагувати визначення блоків або сторінок безпосередньо.