コンテンツへスキップ

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

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

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

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

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

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

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

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が必要です。

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

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()を呼び出せます。

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コミュニティ