
Blockstudio 7が登場しました。プロジェクト史上最大のリリースであり、コードベース全体を一から全面的に書き直しました。すべてのクラス、フック、コード行を、最新のPHP、WordPressのコーディング規約と長期的な保守性を重視して再構築しました。

しかし、これは単なるリファクタリングではありません。Blockstudio 7では、ファイルベースのページとパターン、投稿メタデータのストレージシステム、SEOとの連携、そしてそれらを支える新しいHTMLからブロックへのパーサーなど、重要な新機能を導入しました。さらに、Blockstudioは完全に無料のオープンソースになりました。

新機能を見ていきましょう。

## 無料のオープンソース

2020年からBlockstudioの開発を続け、毎年数多くのリリースを公開してきました。利用者から好評を得ていましたが、商用のWordPressブロックフレームワークとして市場に定着させるのは、常に困難でした。

状況を変えたのはLLMです。AIコーディングアシスタントはブロックコードを十分に書けるようになりましたが、作業には整理されたファイルベースの構造が必要です。WordPressのブロックマークアップは、HTMLのコメントをシリアライズしてJSON属性を埋め込み、DOM構造と混在させるため複雑です。人間にとっても扱いにくく、LLMにはさらに正しく処理するのが困難です。

Blockstudioのファイル優先のアプローチは、常にシンプルさを目指してきました。フォルダーに`block.json`とPHPテンプレートを置くだけです。データベースへの登録も、Reactも、ビルド工程もありません。v7では、その方針をさらに推し進めています。HTMLからブロックへのパーサーにより、プレーンなHTMLを書くだけで、有効なブロックマークアップに自動変換できます。すべてのデータはファイルシステム内に保たれます。データベースへの書き込みは、ファイルテンプレートを使ってPHP APIまたはCLIから明示的に要求したページ同期のみです。

Blockstudioのオープンソース化は自然な次の一歩です。LLMがBlockstudioのコードを学習するほど、コード生成の精度は高まります。公開されたコードベースとドキュメント、そしてあらゆるツールで利用できる事前構築済みの[AIコンテキストファイル](https://blockstudio.dev/ja/docs/dev/ai/)。これが、AI支援によるWordPress開発に最適な環境を実現する方法です。

プラグイン全体を[GitHub](https://github.com/inline0/blockstudio)で公開しており、誰でも利用、フォーク、貢献できます。ライセンスキーも、有料の壁も、機能制限もありません。

## 新機能

### ファイルベースのページ

これは7.0の大きな追加機能のひとつです。ページ全体をファイルテンプレートとして定義し、ページ同期APIまたはCLIを実行すると、ネイティブのブロックコンテンツとしてデータベースに同期できるようになりました。WordPress

`page.json`とテンプレートファイルを含むフォルダーを作成します。

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.php"
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>
```

`wp bs pages sync`を実行すると、BlockstudioがHTMLをWordPressブロックとして解析し、データベース内のページを作成または更新します。

#### キーによるブロックのマージ

テンプレートを同期すると、通常はユーザーの編集内容が上書きされます。`key`属性を使うと、同期後もユーザーのコンテンツを保持できます。

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

キーが一致するブロックは、テンプレートの更新後もユーザーが編集した内容を保持します。キーのないブロックはすべて置き換えられます。

#### ブロックバインディング

キーの代わりに、WordPressコアの[Block BindingsAPI](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/)を使って、ブロックを投稿メタデータに直接接続できます。これはBlockstudioの機能ではなく、ネイティブのWordPress APIです。Blockstudioは`metadata`属性を生成されたブロックマークアップに渡すだけです。コンテンツはブロックマークアップではなくメタデータに保存されるため、テンプレートを同期してもユーザーの編集内容が失われません。データは`WP_Query`経由でクエリでき、REST APIからも利用できます。

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

2つの方法は同じテンプレート内で併用できます。

#### 編集の制御

ページでは`blockEditingMode`と`templateLock`を使って、ユーザーが変更できる内容を制御できます。

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

これにより、ユーザーがテキストやメディアを編集できる状態を保ちながら、ページ構造をロックできます。テンプレート内の`blockEditingMode`属性を使えば、個々の要素でページ単位の設定を上書きできます。

#### 投稿IDへの固定

`postId`を使ってページテンプレートを既存のWordPress投稿に紐付けると、ページの重複を防ぎ、テンプレートが常に正しい投稿を更新するようにできます。

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

詳しくは[ページのドキュメント](https://blockstudio.dev/ja/docs/pages-and-patterns/pages/)をご覧ください。

### ファイルベースのパターン

ページと同様に、ブロックパターンもファイルテンプレートとして定義できるようになりました。HTMLでパターンを記述すると、Blockstudioがブロックマークアップに変換し、ネイティブのWordPressブロックパターンとして登録します。ブロックインサーターに表示され、ユーザーはどこにでも配置できます。

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

ページと異なり、パターンはデータベースに登録されません。ページの読み込みごとにメモリ上で登録されます。詳しくは[パターンのドキュメント](https://blockstudio.dev/ja/docs/pages-and-patterns/patterns/)をご覧ください。

### HTMLからブロックへのパーサー

ページとパターンはどちらも、新しいHTMLパーサーによって処理されます。このパーサーは標準のHTMLテンプレートをWordPressブロックマークアップに変換します。グループやカラムなどのコンテナブロックと、段落や見出しなどのリーフブロックを自動で処理します。パーサーはトレイトベースのレンダラー構成を採用しているため、`blockstudio/parser/renderers`フィルターを使って他のブロックタイプにも簡単に対応できます。

```php title="functions.php"
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );
```

登録すると、任意のページやパターンのテンプレートでブロックを使用できます。

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### ストレージ

フィールドの値を、ブロック属性に加えて投稿メタデータやサイトオプションに保存できるようになりました。これは大きな変更です。

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

値を投稿メタデータに保存すると、次のことができます。

- `WP_Query`と`meta_query`を使ってフィールド値で投稿を検索する
- ヘッドレス環境向けにREST API経由でフィールドデータにアクセスする
- SEOツールやキャッシュレイヤーなど、他のプラグインとデータを共有する

グローバルなサイト全体の設定には、オプションテーブルに値を保存することもできます。

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

すべてのAPIについては、[ストレージのドキュメント](https://blockstudio.dev/ja/docs/blocks/storage/)をご覧ください。

### カスタムフィールド

再利用可能なフィールド定義を複数のブロックで共有できるようになりました。フィールドセットを一度定義すれば、どのブロックからでも参照できます。複数のブロックで同じフィールド構造を使う場合、定義の繰り返しをなくせます。

blockstudioディレクトリに`field.json`を作成します。

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

次に、`custom/`プレフィックスを使って任意のブロックから参照します。

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

`idStructure`プロパティは各フィールドIDの先頭に付くため、`heading`は`hero_heading`になります。`overrides`キーを使うと、インスタンスごとにフィールドのプロパティを上書きすることもできます。

詳しくは[カスタムフィールドのドキュメント](https://blockstudio.dev/ja/docs/blocks/attributes/custom-fields/)をご覧ください。

### Tailwind CSS v4

v4向けにTailwindサポートを全面的に再構築しました。v6ではCDNを使ってクライアント側でコンパイルし、投稿の保存時にディスクへ保存していました。Blockstudio 7では、[TailwindPHP](https://github.com/dnnsjsk/tailwindphp)経由でフロントエンドのリクエストごとにサーバー側でTailwindをコンパイルします。Node.jsもCLIも不要で、ビルド工程もありません。

コンパイルには候補ベースのキャッシュを使用します。Blockstudioが最終的なHTMLからすべてのCSSクラス名を抽出し、CSS設定と合わせて並べ替えてハッシュ化し、キャッシュファイルを確認します。周囲のHTML（nonce、タイムスタンプ、動的コンテンツ）が変わっても、クラスが同じなら同じキャッシュが使われます。

設定にはTailwind v4のCSS優先構文を使用します。カスタムテーマとユーティリティクラスは`blockstudio.json`に直接定義するか、`blockstudio/tailwind/css`フィルター経由で定義できます。

```php title="functions.php"
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});
```

ブロックエディターでは、同梱のTailwind CDNスクリプトにより、入力中にライブプレビューが表示されます。`classes`フィールドタイプでは、すべてのTailwindユーティリティを自動補完できます。フロントエンドでは常にサーバーでコンパイルしたCSSを使用し、`</head>`の前にインラインstyleタグとして挿入します。

設定方法の詳細は[Tailwindのドキュメント](https://blockstudio.dev/ja/docs/tailwind/)をご覧ください。

### インタラクティブ性 API

Blockstudioが[WordPress Interactivity API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/)に対応しました。block.jsonで有効にしてください。

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

テンプレートに`data-wp-*`ディレクティブを追加します。

```php title="index.php"
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>
```

ストアのロジックを記述した`script.js`を作成します。

```javascript title="script.js"
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});
```

Blockstudioはフロントエンドとブロックエディターの両方で、importmap、モジュールの読み込み、ディレクティブの処理を行います。`data-wp-context`を使う宣言的なディレクティブ（`data-wp-bind--hidden`や`data-wp-text`など）だけのブロックなら、JavaScriptなしで動作します。フロントエンドでは`wp_interactivity_state()`によるサーバー側の状態管理にも対応しています。

設定方法の詳細は[Interactivityのドキュメント](https://blockstudio.dev/ja/docs/blocks/interactivity/)をご覧ください。

### SEOコンテンツ分析

Blockstudioブロックは動的なため、デフォルトではフィールドのコンテンツがSEOプラグインから見えません。Blockstudio 7では、Yoast SEO、Rank Math、SEOPressとの自動連携により、この問題を解決します。`text`、`textarea`、`richtext`、`wysiwyg`、`link`フィールドのテキスト値（ネストされたリピーター行を含む）を抽出し、各プラグインのコンテンツ分析に渡します。SEOプラグインで、キーワード密度、読みやすさ、その他の指標を使ってブロックコンテンツを適切に分析できるようになりました。設定は不要です。

### リピーターの初期行

リピーターフィールドで、事前入力された行の配列を指定する`default`プロパティを使えるようになりました。ブロックを挿入すると、エディターとフロントエンドの両方で、指定した行と値がリピーターに入力されます。

```json title="block.json"
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}
```

`min`プロパティはフィールド単位の初期値にも対応しています。リピーターに`min: 3`があり、内部フィールドに`default`値がある場合、自動生成される行は空ではなく、それらの初期値で入力されます。

## 機能強化と修正

- **フィールド初期値を使ったリピーター`min`**: 自動生成される最小行数の行で、フロントエンドとエディターの両方にフィールド単位の初期値を使うようになりました
- **Tailwindエディタースタイル**: コンパイル済みのTailwind CSSをCDNとともにブロックエディターのiframeに挿入するようになり、カスタム`@apply`ルールとテーマ設定がエディターでも機能します
- **[AIコンテキストファイル](https://blockstudio.dev/ja/docs/dev/ai/)**: `blockstudio-llm.txt`を、v7ドキュメント全体と重複を取り除いたJSONスキーマ（約48kトークン）から構成した静的ファイルとして再構築し、v6の動的生成に置き換えました
- **コードフィールドの別ウィンドウ表示**: コードフィールドを別ウィンドウで開けるようになりました。独立した取り消し・やり直し機能とJavaScriptの構文ハイライトに対応しています
- **Tailwind v4のサーバー側コンパイル**: 上記の[Tailwindセクション](#tailwind-css-v4)を参照してください
- **APIバージョン3**: サイトエディターやレスポンシブプレビューを含め、iframe内のエディターでブロックが正しく表示されるようになりました
- **アセットのドット表記**: アセットの接尾辞に、よりすっきりしたファイル命名規則を採用しました（`*.inline.css`、`*.editor.js`、`*.scoped.css`）
- `useBlockProps`の使用時に`WP_Block_Supports`から出る`bs_render_block()`警告を修正
- 条件付きフィールドの初回読み込み時に初期値が反映されない問題を修正
- フロントエンドで`<RichText />`コンテンツからドル記号が取り除かれる問題を修正
- 他のプラグインが登録したタクソノミーでも`populate`機能が動作するよう修正
- WPML環境で発生する`optionsPopulate`のnullエラーを修正

## 内部の仕組み

### 全面的な書き直し

これはリファクタリングでも整理でもありません。すべてのクラスを一から書き直しました。その結果、よりすっきりとしたモジュール構成になり、保守や拡張がしやすいコードベースになりました。

### 最新のPHP

Blockstudio 7にはPHP 8.2以降が必要で、全体を通して最新の型宣言を使用しています。

## 互換性に影響する変更

メジャーバージョンアップデートである7.0には、互換性に影響する変更がいくつか含まれています。多くの変更には後方互換の代替手段がありますが、アップグレード前に確認してください。移行手順の詳細は、[v7移行ドキュメント](https://blockstudio.dev/ja/docs/dev/migration/v7/)をご覧ください。

### フック名をsnake_caseに変更

すべてのPHPフック名をcamelCaseからsnake_caseに変更し、WordPressコアの規約に合わせました。

```php title="functions.php"
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});
```

以前のcamelCase名も引き続き使えますが、更新をおすすめします。

### フィールドのスイッチはデフォルトでオフ

`switch`プロパティのデフォルト値が`false`から`true`に変わりました。v6では、すべてのフィールドの左端に表示されないトグルがあり、デフォルトで有効でした。v7ではスイッチは任意設定となり、フィールドラベルに目のアイコンが表示されます。以前のスイッチの動作を前提としている場合は、フィールド定義に`"switch": true`を追加してください。

### アセットファイル名にドット表記を採用

アセットの接尾辞に、ハイフンの代わりにドットを使うようになりました（`style.inline.css`ではなく`style-inline.css`）。以前のハイフン表記も引き続き使えますが、今後はドット表記を推奨します。

### npmインポートプレフィックス

ESモジュールのインポートで、`blockstudio/`の代わりに`npm:`を使うようになりました。

```javascript title="script.js"
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
```

後方互換性のため、`blockstudio/`プレフィックスも引き続きサポートされます。

### 削除された機能

**管理画面とコードエディター。** WordPressの管理設定ページと組み込みのブロックコードエディターを削除しました。設定はすべて`blockstudio.json`およびPHPフィルター経由で行うため、ブロックとともにバージョン管理できます。

以前のバージョンではコードエディターをブロックのプレビューに利用できましたが、本格的な開発環境と同等の機能には至りませんでした。プラグインの複数の機能は、単独のエディター内で対応できず、長年追加できないままでした。また、本格的なIDEの代わりになることもありませんでした。これを削除することで、妥協することなくファイルベースの開発に専念できます。

**ライセンスキー。** 不要になりました。Blockstudioは無料のオープンソースです。

**ブロックライブラリ。** 組み込みの「Blockstudio Elements」ライブラリ（Gallery、Slider、Image Comparison、Code、Icon）を削除しました。これらはプラグインに同梱されていたブロックのサンプルです。使用していた場合は、v6のブロックフォルダーをテーマのblockstudioディレクトリにコピーしてください。

## はじめに

Blockstudio 7をインストールして、数分で最初のブロックを作成できます。手順に沿って進めるには[はじめてガイド](https://blockstudio.dev/ja/docs/general/getting-started/)を、v6からアップグレードする場合は[v7移行ガイド](https://blockstudio.dev/ja/docs/dev/migration/v7/)をご覧ください。

ソース全体を[GitHub](https://github.com/inline0/blockstudio)で公開しています。課題の報告、PR、フィードバックを歓迎します。
