コンテンツへスキップ

管理画面

Blockstudioには、ツール > Blockstudioから開ける管理画面が付属しています。ファイルシステムからBlockstudioが登録した内容をプロジェクト単位で確認できるほか、レジストリやデータベースレコードも参照できます。

これは意図的に設定ページではありません。目的は、現在存在するブロック、拡張機能、フィールド、ページ、スキーマ、レジストリ、データベースレコードを可視化することです。

アクセス

管理ページは、次の両方の条件を満たす場合に利用できます。

  • 現在のユーザーにmanage_options権限がある
  • blockstudio/admin/enabledでページが有効になっている

次の設定で完全に無効にできます。

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

ビュー

概要

概要では、Blockstudioの登録内容を読み取り専用で一覧表示します。次の専用タブがあります。

  • ブロック: 登録済みブロックタイプ、レンダリングモード、APIバージョン、属性数
  • 拡張機能: 対象、優先度、レンダリングモード、属性数
  • フィールド: 再利用可能なfield.json定義
  • ページ: 投稿タイプ、ステータス、エンジン、同期状態を含むファイルベースのページ
  • スキーマ: ストレージとフィールド数を含む登録済みdb.phpスキーマ

テーブルにはネイティブのWordPressDataViewsを使用し、独自のインターフェースを作るのではなく、画面を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. テーブルでRESTAPIを使ってページ分割する

これにより、大規模なデータセットを持つプロジェクトでも、管理画面を使いやすく保てます。

対象範囲

現在の対象範囲は意図的に限定されています。

  • Blockstudioが登録した内容を確認する
  • 設定済みのレジストリからブロックをインポートする
  • データベースレコードを閲覧する

既存の設定ワークフローに取って代わるものではなく、ブロックやページの定義を直接編集するものでもありません。