テンプレートファイルから再利用可能なパターンを作成
ページと同じHTMLを、そのまま挿入ツールに追加できます。
テンプレートファイルでパターンを登録
pattern.jsonとテンプレートを含むフォルダーを作成します。Blockstudioがregister_block_pattern()のボイラープレートなしで登録します。
パターンを挿入すると、実際に編集できるブロックになります。ソースはバージョン管理されたまま、ユーザーはカスタマイズ可能なレイアウトを使い始められます。
<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でタイトル、説明、カテゴリー、キーワード、ビューポート幅、投稿タイプ、ブロックタイプを設定できます。同じファイルで挿入ツールへの表示も制御できます。
カテゴリーでパターンを整理し、キーワードで検索できるようにします。ビューポート幅はプレビューの幅を設定します。
{
"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が必要です。
ソースはリクエストコンテキストなしでコンパイルされるため、動的変数はありません。エンジン組み込みの関数やフィルターに使用してください。
<div>
<h2>{{ strtoupper('Pricing') }}</h2>
<p>Simple, transparent pricing.</p>
</div><div>
<h2>{{ "pricing"|upper }}</h2>
<p>Simple, transparent pricing.</p>
</div>編集者が選択できるカスタムテンプレート
スラッグがテンプレート階層に含まれないtemplate.jsonは、カスタムテンプレートになります。postTypesに投稿タイプを一覧表示すると、編集者はテンプレートセレクターから選択できます。
Blockstudio\Site_TemplatesはPHPのソースを読み込んでコンパイルします。これにより、テストやデプロイ前のチェックでコンパイル済みマークアップを調べ、要求された項目にはselection_errors()を呼び出せます。
{
"slug": "page-landing",
"title": "Landing Page",
"description": "Full-width page without a header",
"postTypes": ["page"]
}<main>
<block name="core/post-content" />
</main>
<block name="core/template-part" slug="footer" tagName="footer" />$selected = Blockstudio\Site_Templates::templates( array( 'page-landing' ) );
$errors = Blockstudio\Site_Templates::selection_errors( 'templates' );
$header = Blockstudio\Site_Templates::get_part( 'header' );
echo $header['content'];カスタム検出パス
フィルターを使うと、たとえばプラグインから、ページ、パターン、サイトエディターのテンプレート用にルートを追加できます。
論理的な検出ソース
プレビュー、オーバーレイ、生成されたテーマでは、1つのテーマフォルダーの代わりに、合成したファイル一覧をBlockstudioに渡せます。
ライフサイクルフック
パターンの登録後と、ページ投稿の作成、更新、同期、調整後にアクションが実行されます。
パターンAPI
Blockstudio\Patterns::patterns()とget_pattern()は、PHPから登録済みパターンを読み込みます。
公式拡張キット
プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。
- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ