Lazy Blocks使い方完全ガイド【日本語決定版】全コントロールタイプ・条件分岐(Controls Conditions)・Pro機能まで徹底解説

この記事は、当サイトの運営者が実際にLazy Blocks（Pro版含む）を導入・検証した上で執筆しています。記載内容は実機での動作確認に基づくものであり、確認できていない情報については本文中でその旨を明記しています。

1. インストールと初回ブロック作成

インストール

まずはLazy Blocks公式サイトで最新の機能・料金プランを確認しておきましょう。無料版・Pro版の違いもここで一通り把握できます。

確認したら、WordPress管理画面の「プラグイン」→「新規追加」で「Lazy Blocks」を検索し、インストール・有効化します。有効化すると、左メニューに「Lazy Blocks」という項目が追加されます。

なお、条件分岐やPosts/Taxonomy/Users連携などPro版の機能が最初から必要だと分かっている場合は、無料版を入れる前に公式サイトのPro版ページから直接申し込む方が二度手間になりません。

初めてのブロックを作る

この時点で保存すれば、投稿画面の「＋」ブロック追加メニューに、作成したブロックが表示されるようになります。

2. コントロールの種類一覧

Lazy Blocksには複数のコントロール（入力フィールドの種類）が用意されています。主なものは以下の通りです。

2-1. 無料版で使える21種類

ひとくちに「コントロール」といっても数が多いので、まずは無料版だけで使える21種類を一覧にしました。ACFの無料版だと主要フィールドは5〜6種類程度なので、この時点でかなり気前が良いことが分かると思います。

2-2. Pro限定の9種類

ここから先はPro版でのみ追加される9種類です。単に入力欄の種類が増えるだけでなく、サイトの中にすでにある投稿・タクソノミー・ユーザーと直接つながるタイプが揃っているのが特徴です。

無料版とPro版の境界で特に重要なのは、Repeater（繰り返しフィールド）が無料版で使えることです。ACFではこの機能はPro版限定のため、ここがLazy Blocksを選ぶ大きな理由になります。

3. Repeater Controlの使い方

基本設定

Controlsタブで「Repeater」を追加し、その中にサブフィールド（Text、Image など）を好きなだけ追加します。フロントエンド側では、追加したサブフィールドの数だけ繰り返し出力されます。

注意点：ネストされたリピーターは非対応

リピーターの中にさらにリピーターを入れる「入れ子構造」は公式に非対応とされています。
複数の独立したリピーターに分割する設計を検討してください。

4. 出力方法の使い分け（PHP／Handlebars／テーマテンプレート）

Lazy Blocksでは、ブロックの出力方法を3種類から選べます。

方法	向いているケース
PHP	条件分岐やエスケープ処理など、柔軟な制御が必要な場合。本サイトのサンプルコードもこの形式
HTML + Handlebars	シンプルな出力で、テンプレートエンジン的な書き方をしたい場合
テーマテンプレートファイルを指定	既存のテーマ内のPHPファイルとしてブロックコードを管理したい場合。バージョン管理（Git）と相性が良い

5. ラッパーdiv制御の最新方法

Lazy Blocksは初期状態で、出力したブロックを自動的に<div>で囲みます。このラッパーdivを削除・制御したい場合の方法が、2025年にアップデートされました。

このフィルターは2025年6月リリースのv4.0.0で一度削除されました。
既存ブロックが壊れるのを防ぐためv4.0.1で復活していますが、現在は非推奨扱いで、管理画面に移行を促す通知が表示されます。

ネット上の解説記事の多くは、いまだにこの方法を「正解」として紹介していますが、情報が古いので注意してください。

6. InnerBlocksの正しい使い方

子ブロックを内包できる「InnerBlocks」機能には、2つの実装方法があります。

旧方式：Inner Blocksコントロール（非推奨）

以前はControlsタブから「Inner Blocks」という項目を追加するだけで使えましたが、2023年6月リリースのv3.4.0で非推奨になり、将来のアップデートで削除される予定です。新規に作るブロックでは使わないでください。

現行の推奨方式：<InnerBlocks />コンポーネント

Controlsタブでは追加しません。代わりに、ブロックの出力コード（PHP／HTML+Handlebars／テーマテンプレート）内に直接<InnerBlocks />というタグを書き込みます。

PHP

<div class="custom-layout">
  <h3>Content Section</h3>
  <InnerBlocks allowedBlocks="[ 'core/paragraph', 'core/image' ]" />
</div>

Copy

<div class="custom-layout">
  <h3>Content Section</h3>
  <InnerBlocks allowedBlocks="[ 'core/paragraph', 'core/image' ]" />
</div>

allowedBlocks：中に配置できるブロックの種類を制限

template：あらかじめ決まった構成をテンプレートとして用意

1つのブロックにつき<InnerBlocks />は1つだけ使用可能

【移行手順】
①ブロックの出力コード（フロントエンド・エディタ両方）に<InnerBlocks />を追加
②Controlsタブから旧「Inner Blocks」コントロールを削除、の2ステップです。

ラッパーdivの制御：InnerBlocksエリアにも自動でラッパーdivが付きます。消したい場合は次のフィルターを使います（第5章で紹介したブロック全体用のallow_wrapperフィルターとは別物です）。

PHP

add_filter( 'lazyblock/あなたのブロックslug/allow_inner_blocks_wrapper', '__return_false' );

Copy

add_filter( 'lazyblock/あなたのブロックslug/allow_inner_blocks_wrapper', '__return_false' );

7. エクスポート・インポート

作成したブロックは、Lazy Blocksの管理画面から個別に、あるいはまとめてJSON/PHP形式でエクスポートできます。

案件ごとに同じようなブロック（お知らせボックス、スタッフ紹介など）を使い回すことが多い制作者にとって、このエクスポート機能は特に有用です。

自分専用の「ブロック部品ライブラリ」を育てていくような使い方ができます。

8. Pro版でできること

無料版だけでも実務レベルのブロックは十分作れます。ただ、いくつか実際に使ってみると「これは地味に効く」と感じるPro限定機能があるので、具体的な場面とあわせて紹介します。

Controls Conditions（条件分岐）：入力欄を出したり隠したりできる

例えば「CTAボックス」ブロックを作ったとします。
「セール中かどうか」のトグルを用意して、オンのときだけ「割引率」の入力欄を表示する——こういう条件分岐が無料版だと組めません。

結果、使わない設定項目まで常にズラッと並ぶ、少し不親切な編集画面になりがちです。

Controls Conditionsを使うと、必要なときだけ必要な項目が現れる、まるで市販のプラグインのような編集画面が作れます。自分だけが使うならまだしも、クライアントやチームメンバーに編集を任せる場面では、この差はかなり大きいです。

ここは検索してもピンポイントの手順を書いた日本語記事がほとんど見当たらなかった部分なので、実際の設定手順・選べる演算子・つまずきやすいポイントまで一段深く掘り下げておきます。

設定手順（3ステップ）

例として、「セール中」というトグルをONにしたときだけ「割引率」の数値欄を表示する、というよくあるケースで説明します。

1. 先に条件の判定に使うコントロール（今回は「セール中」というToggle）と、条件で出し分けたいコントロール（「割引率」というNumber）の両方を、普通にControlsタブへ追加しておきます。
2. 出し分けたい側（「割引率」）の設定パネルを開き、「Conditional Logic」という項目を探します。ここで「Add condition」をクリックすると条件行が1つ追加されます。
3. 条件行で「参照するコントロール（セール中）」「演算子（Is equal to）」「値（true、またはチェック済みの状態）」を選んで保存すれば完了です。以後、編集画面では「セール中」がONのときだけ「割引率」欄が表示されるようになります。

選べる演算子（実機で確認済み）

UI上の選択肢は基本的に5つですが、参照先コントロールの種類によって選べる演算子が変わります。ここが地味に分かりにくいので一覧にしました。

UI表示名	意味	使える場面
Is equal to	等しい	すべてのコントロールで使用可
Is not equal to	等しくない	すべてのコントロールで使用可
Contains	部分一致	すべてのコントロールで使用可
Has any value	何か入力・選択されている	checkbox / toggle / message / inner_blocks以外
Has no value	空である	checkbox / toggle / message / inner_blocks以外
Is greater than / Is less than	数値・件数の大小比較	参照先がnumber / range / gallery / posts / taxonomy / users / repeaterの場合のみ出現
Has style / Has no style	ブロックスタイルの適用有無	参照先に「Block Styles」を指定した場合のみ出現

また、参照先はControlsタブで追加した項目だけでなく、コアの「Class Name（CSSクラス名）」や「Block Styles（ブロックスタイル）」を指定することもできます。select・radio・checkbox・toggleのように選択肢（choices）を持つコントロールを参照する場合、値欄は自由入力ではなく「選択肢のvalueから選ぶドロップダウン」に自動的に切り替わります。

複数条件の組み合わせ方（AND / OR）

条件は「グループ」という単位でまとめられます。同じグループ内に追加した条件同士はAND（すべて満たす）、グループを分けて追加した条件同士はOR（どちらか満たす）という扱いになります。「A地方 かつ 会員ランクがゴールド」を条件にしたいのか、「A地方 または B地方」のように選択肢を広げたいのかで、同じグループに条件を足すか、新しいグループを足すかを使い分けてください。

【上級者向け】JSONで見るとこういう構造になっている

ブロックをJSONエクスポートすると、条件は「表示/非表示を制御される側のコントロール自身」にconditional_logicというキーで保存されているのが分かります。他サイトへの移植やバックアップの際、JSONを直接いじりたい人向けに構造を載せておきます。

"conditional_logic": [
  [
    { "control": "toggle_sale", "operator": "==", "value": "true" }
  ]
]

外側の配列がグループ（グループ同士はOR）、内側の配列が1グループ内の条件（条件同士はAND）です。controlには参照先コントロールのname属性の値（ラベルではない）、valueには参照先の選択肢のvalue（ラベルではない）を指定します。

覚えておきたい2つの注意点

• Conditionsは編集画面の表示/非表示だけを制御するものです。フロント（実際に公開されるページ）の出力には一切影響しません。条件を満たさなかった項目の値も、そのままデータとしては保存されています。表示・非表示をフロント側でも制御したい場合は、PHP出力コード側でif文として別途書く必要があります。
• ブロック設定サイドバーには、これとは別に「ブロック全体をどの投稿タイプで使えるようにするか」を決める「Condition」という機能があります。名前が紛らわしいですが、コントロール単位のConditional Logicとは完全に別物なので混同しないようにしてください。

Posts / Taxonomy / Users Control：サイトの中身と直接つながる

無料版のフィールドは基本的に「その場でテキストや画像を入力する」ものですが、Pro版ではサイト内にすでにある投稿・カテゴリ・ユーザーを選んでフィールドに入れられます。

「関連記事」ブロックで実際の投稿から3つ選ぶ、「執筆者紹介」ブロックでユーザー一覧から選ぶ——ACFの投稿オブジェクト・ユーザーフィールドに相当する機能で、ここが使えるようになると、ACF・SCFからの乗り換えでも機能面の不満がほぼなくなります。

PHP出力コードを書く際は、実際に保存される値の形を知っておくとエラーで悩む時間が減ります。

コントロール	初期設定での値の形	注意点
Taxonomy	文字列（term slugそのもの。例："wordpress-blog"）	multipleがfalseなら配列にもオブジェクトにもならない、素の文字列
Users	文字列としてのユーザーID（例："1"）	数値ではなく文字列である点に注意。get_userdata()に渡す前に意識しておくと安全
Posts	出力形式の設定によって変化	Post ID形式・Post Object形式などを選べるため、選んだ形式に合わせてPHP側の受け取り方を変える

Styles & Scripts：ブロックごとにCSS/JSを持ち歩ける

ブロックのビルダー画面内で、そのブロック専用のCSS・JSを直接書いて管理できる機能です。通常、ブロックの見た目を整えるにはテーマのfunctions.phpやスタイルシートに別途コードを追記する必要がありますが、この機能を使うとブロック自体が「見た目込みで完結したパーツ」になります。

案件をまたいで同じブロックを使い回したい人にとっては特に相性が良く、エクスポートした1つのJSONファイルの中にCSS/JSも含まれるので、次の案件でインポートするだけですぐ同じ見た目で使えます。

この機能は、ブロックを配る側だけでなく受け取る側にも効いてきます。

当サイトがPro版向けに配っているブロックは、まさにこの欄にCSSとJSを置いています。
だから無料版で読み込むとHTMLは出るのに装飾も動作も効きませんし、逆にPro版さえあれば、JSONを読み込んだ時点で完成品が手に入ります。

当サイトのリンク経由でPro版を購入された方には、そのブロック集を開くパスワードをお渡ししています。
中身と受け取り方は下のページにまとめました。

Panels & Dividers：編集画面をグループ分けして整理できる

入力項目が10個、20個と増えてくると、編集画面は縦に長くなり見づらくなります。Panels & Dividersを使うと、「基本設定」「デザイン設定」「上級者向け設定」のように項目をグループ化し、パネルごとに折りたたんで表示できます。

複雑なブロックほど恩恵が大きく、特にクライアントに納品するようなブロックでは、必要な項目だけをパッと見つけられる画面にできるかどうかで、後々の「使い方がわからない」という問い合わせの数が変わってきます。

SEO Enhancements：Yoast・Rank Mathとの相性問題を解消

意外と見落とされがちですが、独自ブロックの中に書いた文章は、Yoast SEOやRank Mathのコンテンツ解析（キーワード出現率や読みやすさのチェックなど）にうまく認識されないことがあります。SEO Enhancementsは、この解析対象にカスタムブロックの内容もきちんと含められるようにする機能です。SEOを意識した記事作りをしている人には地味に重要なポイントです。

---

こうして並べてみると、Pro版は「無料版でできないことを無理やり足す」というより、自分やクライアントが毎日触る編集画面そのものを快適にする方向の機能が中心だと分かります。無料版でリピーターまで使えることを考えると、コスパは十分に見合っていると思います。

料金プラン

プラン	料金（年額）	対象サイト数
Personal	$49	1サイト
Freelancer	$169	20サイト
Agency	$299	無制限

参考までに、ACF Proは$49（1サイト）〜$249（無制限）という価格帯です。Lazy Blocksは無料版の時点でリピーター機能を含んでいるため、「まず無料で試して、条件分岐や投稿連携が必要になったらPro版を検討する」という進め方が現実的です。

Pro版の申し込みは、プラグイン管理画面内の「Upgrade」ボタンからでも可能ですが、こちらの公式サイトのPro版ページから直接申し込んでいただくと、当サイトの検証・記事作成の励みになります。機能は同じなので、お手数でなければご協力いただけると嬉しいです。

「HTMLやCSSは書けないから自分には関係ない」と思う必要はありません。今は生成AIにデザインを相談すれば、コードそのものは一瞬で用意できる時代です。そのコードをLazy Blocksに流し込んで「入力フォーム化」するところまでが、これまで数万円かけて外注していた作業を自分でまかなえるようになる部分だと考えると、Pro版の年額費用はかなり回収しやすい投資だと感じます。

9. よくあるエラーと対処法

ブロックのプレビューで「重大なエラーが発生しました」と表示される

PHP出力コードの構文エラーが原因であることがほとんどです。wp-config.phpに以下を追記してデバッグログを有効化し、/wp-content/debug.logのFatal error:から始まる行を確認してください。

PHP

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Copy

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

特によくある原因

• コード内に名前付き関数を宣言してしまっている（eval()実行の制約に抵触）
• <?phpタグの開始・終了位置がずれている
• Repeaterのスラッグ名と、PHPコード内で参照している配列キーが一致していない

保存したのに投稿画面にブロックが表示されない

ブロックのCategory設定が正しいか、ブラウザのキャッシュが残っていないかをまず確認してください。

それでも解決しない場合、レンタルサーバーのWAF（Webアプリケーションファイアウォール）設定が原因になっているケースがあります。 ConoHa WINGやエックスサーバーなど、管理画面からWAFを有効化できるサーバーでは、PHPコードを編集・保存する際にWAFが「不正な操作」と誤検知し、正常に保存できないことが確認されています。

PHPコントロールの内容を編集する際は、一時的にサーバー管理画面からWAFをオフにしてから保存し、完了後に再度オンに戻す、という手順で解決するケースが多いです。保存がうまくいかない・保存したはずの内容が反映されないという場合は、まずこれを疑ってみてください。

実際にLazy Blocksでどこまでのデザインが作れるかは、Arkhe Blocksの無料版が使えなくなった人へ｜安全な代替手段で紹介している自作ブロックの実例も参考になります。

まとめ

Lazy Blocksは無料版だけでもリピーター機能を含む実務レベルのブロックが作成できる、数少ない選択肢です。ラッパーdiv制御やInnerBlocksの仕様は今後もアップデートされていく可能性があるため、このページも随時更新していく予定です。