コンテンツへスキップ

Dennis · 2026年6月21日

Blockstudio 7.4

Blockstudio7.4では、ファイルベースのプロジェクトの可搬性を高めます。7.2では大規模プロジェクトの調査と配布を容易にし、7.3ではその上にUIレイヤーを追加しました。7.4では、プロジェクトのページや厳選されたコンテンツをデータベースからバージョン管理されたファイルへ、さらに多く移すことに重点を置いています。

目玉機能はページコレクションです。Blockstudioにページソースのフォルダーを指定すると、ネストされたWordPressページ構造全体を生成できます。ソースにはPHP、Twig、Blade、HTML、Markdownのほか、別のローカルソースからページを返す信頼済みローダーを使用できます。

要点は次のとおりです。

  • ページコレクション:pages.jsonで、ネストされたページ一式、デフォルト、投稿タイプの動作、レイアウト、ローダー、コレクションメタデータを定義できます。
  • Markdownページ:index.mdをページコンテンツとして使用できます。page.jsonと組み合わせることも、フロントマターと単独で使うこともできます。
  • フロントエンドページレイアウト:layout.phpで同期済みページコンテンツをラップし、blockstudio_page_tree()やblockstudio_page_content()などのヘルパーを使えます。
  • 外部ドキュメントソース:コレクションローダーにより、ローカルファイルや返されたMarkdown/HTMLからページを生成できます。
  • 生のMarkdown出力:Markdownページソースを.mdまたはAccept: text/markdown経由で提供できます。
  • コレクションのカスタム投稿タイプ:コレクション独自のURL、リライトルールの自動フラッシュ、生のMarkdownルート、テーマ側の回避策を使わないページからCPTへの移行に対応します。
  • Content Sync:wp bs content pull、wp bs content push、wp bs content statusにより、許可リストに登録した投稿、ターム、リレーション、宣言済みメタ参照を可搬性のあるファイルにできます。
  • ブロックタグのプレフィックス:<theme-card>などのプロジェクトプレフィックスを、ブロックごとのエイリアスなしで、順序付けられた名前空間全体から解決できます。
  • 同期の信頼性向上:マニフェスト、ローダー、レイアウト、メタデータ、ソースファイルにまたがるページ変更を検出します。
  • ランタイムとエディターの修正:動的オプションが最新に保たれ、プログラム描画でもクエリーブロックのクラスが保持され、bsui/selectが高密度フォームでより適切に動作します。RichTextのプロパティがエディターに渡され、RichTextを含むリピーター行の削除が保存後も保持されます。

ファイルベースのページ

7.4の大部分はファイルベースのページを基盤としています。

ページコレクション

7.4以前のファイルベースのページは、主にフォルダーレベルの機能でした。page.jsonを作成し、index.phpまたはindex.twigを追加すると、Blockstudioがその単一ページをWordPressに同期します。

これまでの方法も引き続き使えます。7.4では、より大きな構造向けにもう1つのモードが加わりました。

フォルダーにpages.jsonマニフェストを追加すると、そのフォルダーがコレクションになります。

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

コレクション内のすべてのページソースが検出、正規化、同期され、パスで関連付けられます。guide/installにあるページはguideの子になります。guideページがない場合は、Blockstudioがコンテナーページを生成し、WordPressの階層がファイルシステムの構造と一致するようにします。

コレクションでは、標準のpage投稿タイプか、独自の投稿タイプを使用できます。コレクションでまだ存在しない投稿タイプを宣言すると、BlockstudioがpostTypeArgsから登録します。マニフェストのpostTypeもコレクション内のすべてのページのデフォルトになるため、プロジェクトごとにdefaultsで繰り返し指定する必要はありません。

コレクションの投稿タイプでは、コレクションのスラッグが公開URLベースになります。docsコレクションではルートページが/docs/に、path: "getting-started"を持つページが/docs/getting-started/に解決され、ネストされたパスも同じベースの下に配置されます。/docs/docs/のような重複URLは正規の場所にリダイレクトされます。コレクションの投稿タイプのルーティングが変わるとリライトルールが自動的にフラッシュされるため、新しいコレクションを追加してもパーマリンクを手動で保存する必要はありません。

外部ドキュメント、製品マニュアル、ナレッジベース、ページライブラリがWordPressで自然に扱えるようになる機能です。ソースはファイルのままでも、結果は編集可能な実際のWordPressコンテンツです。

ページコンテンツとしてのMarkdown

Markdownが、正式なページソースとして使えるようになりました。

単独のMarkdownページでは、フロントマターを使います。

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

設定とコンテンツを別々のファイルに分けたい場合は、page.jsonとindex.mdを組み合わせることもできます。index.md内のフロントマターで対応するpage.jsonフィールドを上書きでき、未定義のフロントマターキーはメタデータとして保持されます。

MarkdownはHTMLに変換された後、PHP、Twig、Bladeのテンプレートと同じページパーサーに渡されるため、最終的なコンテンツはネイティブのブロックマークアップになります。

レイアウトとページヘルパー

コレクションにはlayout.phpファイルを含められます。フロントエンドでは、Blockstudioがそのレイアウトで同期済みページコンテンツをラップします。

PHP
<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>

新しいヘルパーを使うと、コレクションを構造化データとして参照できます。

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

これにより、ページツリーからのナビゲーション、フロントマターからのページメタデータ、メインの表示領域となる同期済みWordPressブロックコンテンツを備えた、ドキュメントサイト全体の外枠を構築できます。

ローダーと生のMarkdown

コレクションには、信頼済みのローカルloader.phpファイルを含められます。ページを直接返すことも、Blockstudioに追加で検出するローカルディレクトリを指定することもできます。

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

パッケージのドキュメントフォルダー、Markdownのエクスポート、ページ一覧を返すビルドステップなど、ソースがすでに別の場所で生成されている場合に便利です。

Markdownページソースでは、生のMarkdownソースも提供できます。.mdサフィックスを付けてページをリクエストするか、Accept: text/markdownを送信してください。フロントマターはレスポンスから除去されるため、ツールは読みやすいドキュメント本文を取得できます。これはコレクションの投稿タイプでも機能し、/docs.mdや/docs/getting-started.mdのようなURLにも対応します。

ページのドキュメントを読む

コンテンツ同期

7.4では、プロジェクトをより多くファイルとして管理したいチーム向けのWP-CLIワークフロー、Content Syncも導入されました。WordPress

シェル
wp bs content pull
wp bs content push --dry-run
wp bs content status

Blockstudioでは、ブロック、フィールド、テンプレート、パターン、ファイルベースのページがすでにプロジェクト内に保存されています。Content Syncは、選択したデータベースコンテンツをこのファイル優先のワークフローに追加します。許可リストに登録した投稿、ターム、リレーションシップ、宣言済みメタをファイルに取り込み、gitでレビューして、別の環境に反映できます。

意図的に明示的な設計にしています。blockstudio.jsonで機能を有効にし、管理する投稿タイプとタクソノミーを許可リストに登録し、環境間で書き換えるメタ参照を宣言します。

pull時にBlockstudioは、可搬性のある投稿、ターム、リレーション、許可リストに登録したメタをテーマ内のファイルに書き出します。push時には、書き込み前に計画を検証し、宣言済みのpost、term、attachment参照をローカルデータベースのIDに解決します。任意の整数をIDだと推測することはありません。

7.4の対象範囲は意図的に限定しています。投稿、ターム、タームリレーション、許可リストに登録したメタ、可搬性のあるUID、添付ファイルのマニフェスト、ドライラン、削除処理、ロックされたエンティティ、ステータス報告が対象です。タクソノミー定義の取り込み、メディアファイルのバイナリコピー、ブロックマークアップ内のID書き換えは、初回バージョンでは対象外です。

これにより、チームメンバー、事例、拠点、ドキュメントの項目、その他の構造化レコードなど、厳選したコンテンツをバージョン管理できます。運用中のデータベース全体を移行対象にする必要はありません。ファイルとしてレビューできるコンテンツ一式を対象とし、数十から数百行、構造化されていて変更頻度が低いプロジェクトでは数千行程度までを想定しています。データベースのバックアップ、eコマースや注文の同期、分析データ、ログ、フォーム送信データなど、大量のデータには代用できません。

Content Syncのドキュメントを読む

同期の信頼性向上

Blockstudioが、ページソース、コレクションのマニフェスト、ローダーファイル、レイアウトファイル、メタデータ、関連パスの変更を検出するようになりました。いずれかが変わると、同期済みのWordPressページが更新されます。

ページ処理パイプラインは、実際のプロジェクトでファイルベースのドキュメントを使う際に必要となる細かな点にも対応しています。

  • Markdownページソースは、ブロック属性を含め、ネイティブのブロックコンテンツとして同期される
  • フロントマターのメタデータをフロントエンドのヘルパーとレイアウトで利用できる
  • コレクションページは、同期後も安定した識別情報を保つ
  • コレクションに属さないネストされたページは、親ページに関連付けられる
  • コレクションに属さないネストされたページは、最も近い祖先のlayout.phpを継承できる
  • 削除されたコレクションソースに対応する生成済みWordPressページがクリーンアップされる
  • コレクションをpageからカスタム投稿タイプに変更すると、同期済みの投稿が重複作成されずに移行される
  • ページの順序がmenu_orderを通じて保持される

ブロックタグのプレフィックス

ブロックタグで設定可能な名前空間プレフィックスを使えるようになりました。プロジェクトで短いプレフィックスを1つ登録すると、Blockstudioが1つ以上の名前空間からブロックを解決します。

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

これを設定すると、<theme-card>はtheme-components/cardに解決され、<theme-button>はbsui/buttonにフォールバックでき、<theme-ui-feature-matrix>はtheme-components/ui-feature-matrixに解決できます。

プロジェクトで個別に上書きする場合は、明示的なtag_aliasesが引き続き優先されます。未知のプレフィックスタグはそのまま残り、プレフィックスで解決されたブロックにも既存のブロックタグ許可/拒否フィルターが適用されます。

ブロックタグのドキュメントを読む

ランタイムとエディターの修正

7.4には、実際のプロジェクトでの使用から得られた一連の修正も含まれています。

  • 投稿、ターム、ユーザー、関連メタが変更されても、クエリーで取得する動的オプションが最新に保たれます。また、populate.fetch: trueのクエリー選択肢では、エディターで検索語が空の場合も最新のオプションを取得します。
  • プログラムで使うcore/queryとcore/commentsのブロックタグでは、生成されるラッパーマークアップ内にclassNameが保持されます。
  • テンプレートの疑似コンポーネントではcamelCaseのプロパティが保持されます。allowedFormatsやwithoutInteractiveFormattingなどのプロパティが事前に破棄されず、エディターコンポーネントに渡されます。
  • bsui/selectでオプションデータとメニューのはみ出しをより確実に扱えるようになりました。密度の高いエディターコントロール内で特に効果があります。
  • blockstudio/phpstanがtabsコンテナー内で宣言されたフィールドを認識するようになり、テンプレート、Twig/Blade、ブロックタグのバリデーションで、プロジェクト内でBlockstudioが使うフィールド形式を共通して理解できます。
  • RichTextを含むリピーター行を削除すると、その状態が保存後も保持されます。古いRichTextの値によって削除した行が復元されることはありません。

このリリースが重要な理由

7.4のテーマは可搬性です。

ページコレクションを使うと、ドキュメントサイト全体をソースファイルのフォルダーにできます。Markdownのページ機能により、そのコンテンツを簡単に作成し、読み返せます。Content Syncは、厳選したデータベースコンテンツにも同じファイル優先のモデルを拡張し、投稿、ターム、リレーションシップをgitに保存して、環境間で移動できるようにします。ブロックタグの接頭辞を使うと、大規模なブロックライブラリもテンプレート内で読みやすくなります。

Blockstudioは引き続きファイルベースです。ブロックは引き続きフォルダーで構成され、ページは引き続きファイルです。7.4では、ページ構造や厳選したコンテンツを含むプロジェクトのより多くをファイルに格納し、そのまま持ち運べるようにしました。