Перейти к содержимому

Администрирование

Blockstudio включает панель администрирования в разделе Инструменты > Blockstudio. Это проектный интерфейс для изучения того, что зарегистрировал Blockstudio в файловой системе, а также для просмотра реестров и записей базы данных.

Это намеренно не страница настроек. Ее цель — показать, какие блоки, расширения, поля, страницы, схемы, реестры и записи базы данных существуют в данный момент.

Доступ

Страница администрирования доступна при выполнении обоих условий:

  • у текущего пользователя есть возможность manage_options
  • страница включена через blockstudio/admin/enabled

Полностью отключить ее можно так:

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

Представления

Обзор

Обзор представляет собой доступный только для чтения перечень регистраций Blockstudio. В него входят отдельные вкладки для:

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

В таблицах используются нативные DataViews WordPress, чтобы интерфейс соответствовал 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
  • импорт блоков из настроенных реестров
  • просмотр записей базы данных

Этот интерфейс не заменяет существующий процесс настройки и не позволяет напрямую редактировать определения блоков или страниц.