# テンプレートファイルから再利用可能なパターンを作成

ページと同じHTMLを、そのまま挿入ツールに追加できます。

## テンプレートファイルでパターンを登録

`pattern.json` とテンプレートを含むフォルダーを作成します。Blockstudioが `register_block_pattern()` のボイラープレートなしで登録します。

パターンを挿入すると、実際に編集できるブロックになります。ソースはバージョン管理されたまま、ユーザーはカスタマイズ可能なレイアウトを使い始められます。

[パターン構文](https://blockstudio.dev/ja/docs/pages-and-patterns/patterns/)

index.php

```
<div>
  <h2>Pricing</h2>
  <p>Simple, transparent pricing.</p>
  <block name="core/columns">
    <block name="core/column"><h3>Starter</h3></block>
    <block name="core/column"><h3>Pro</h3></block>
  </block>
</div>
```

## ページと同じ構文

標準のHTMLはコアブロックに対応し、それ以外はブロックタグで処理します。

## 自動登録

テンプレートとpattern.jsonを配置すると、自動的に表示されます。

## 完全に編集可能

挿入したパターンは、ユーザーが個別にカスタマイズできます。

## 分類と検索に対応

カテゴリーとキーワードを使ってパターンを見つけやすくできます。

## あらゆるブロックを、どの深さでも

コア、カスタム、またはBlockstudioブロックを、どの深さにも配置できます。

## 投稿タイプの制限

パターンを適切な投稿タイプに限定できます。

## ブロックとの関連付け

パターンをブロックタイプに関連付け、候補として表示できます。

## バージョン管理に対応

パターンファイルをGitで管理し、環境間でデプロイします。

## pattern.jsonで設定

`pattern.json` でタイトル、説明、カテゴリー、キーワード、ビューポート幅、投稿タイプ、ブロックタイプを設定できます。同じファイルで挿入ツールへの表示も制御できます。

カテゴリーでパターンを整理し、キーワードで検索できるようにします。ビューポート幅はプレビューの幅を設定します。

[パターンの設定](https://blockstudio.dev/ja/docs/pages-and-patterns/patterns/)

pattern.json

```
{
  "name": "pricing-table",
  "title": "Pricing Table",
  "description": "Two-column pricing layout",
  "categories": ["featured", "commerce"],
  "keywords": ["pricing", "plans", "table"],
  "viewportWidth": 1200,
  "blockTypes": ["core/group"],
  "postTypes": ["page", "landing"]
}
```

## BladeおよびTwigソース

パターン、ページ、サイトエディターのテンプレートは、`index.php` ではなく `index.blade.php` または `index.twig` として記述します。Bladeは `illuminate/view` の8から12を使って `Blockstudio\Blade_Renderer` 経由でレンダリングされ、TwigにはTimberが必要です。

ソースはリクエストコンテキストなしでコンパイルされるため、動的変数はありません。エンジン組み込みの関数やフィルターに使用してください。

[テンプレートエンジン](https://blockstudio.dev/ja/docs/pages-and-patterns/#template-engines)

patterns/pricing/index.blade.php

```
<div>
  <h2>{{ strtoupper('Pricing') }}</h2>
  <p>Simple, transparent pricing.</p>
</div>
```

## 編集者が選択できるカスタムテンプレート

スラッグがテンプレート階層に含まれない `template.json` は、カスタムテンプレートになります。`postTypes` に投稿タイプを一覧表示すると、編集者はテンプレートセレクターから選択できます。

`Blockstudio\Site_Templates` はPHPのソースを読み込んでコンパイルします。これにより、テストやデプロイ前のチェックでコンパイル済みマークアップを調べ、要求された項目には `selection_errors()` を呼び出せます。

[サイトエディターのテンプレートガイド](https://blockstudio.dev/ja/guides/site-editor-templates/)

templates/page-landing/template.json

```
{
  "slug": "page-landing",
  "title": "Landing Page",
  "description": "Full-width page without a header",
  "postTypes": ["page"]
}
```

## カスタム検出パス

フィルターを使うと、たとえばプラグインから、ページ、パターン、サイトエディターのテンプレート用にルートを追加できます。

## 論理的な検出ソース

プレビュー、オーバーレイ、生成されたテーマでは、1つのテーマフォルダーの代わりに、合成したファイル一覧をBlockstudioに渡せます。

## ライフサイクルフック

パターンの登録後と、ページ投稿の作成、更新、同期、調整後にアクションが実行されます。

## パターンAPI

Blockstudio\Patterns::patterns()とget_pattern()は、PHPから登録済みパターンを読み込みます。

Plus

## 公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ

[Plusを入手](https://blockstudio.dev/ja/plus/)
