Privacy Policy © 2026 eBIZ CREATE Inc.

2026年のWordPressフルサイト編集とGutenbergカスタマイズ実践ガイド

viewpath20261118 003939 ac0078fe5507b3c1ae44b10088c2e33f

【動作確認済み環境】 ・WordPress:6.5 ・PHP:8.2 ・確認日:2026年4月 ・テーマ:Twenty Twenty-Four ※環境によって動作が異なる場合があります。必ず検証環境でお試しください。 実際のWeb制作の現場で、「新規案件はフルサイト編集(FSE)で構築するべきか、クラシックテーマを維持するべきか」というご相談をよくいただきます。 Gutenbergが登場して以来、ブロックエディターの機能は大きく進化しました。しかし、設定ファイルの記述方法やクライアントが運用しやすい設計など、実務レベルで迷うポイントは少なくありません。 この記事では、日々の案件で直面した課題や失敗した経験をもとに、FSEの導入判断から効率的なカスタマイズ手順まで、現場で本当に使えるノウハウをシェアします。 ・フルサイト編集を実案件へ導入するための具体的な判断基準がわかります ・ブロック構築を効率化し、制作スピードを上げる方法がわかります ・クラシックテーマから移行する際の注意点と解決策がわかります ・theme.jsonを用いた実践的な基本設定とカスタマイズ手順がわかります ・長期的な運用保守を見据えたブロックエディターの設計手法がわかります

1. 2026年版フルサイト編集の実務的な導入手順と判断基準

【動作確認済み環境】 ・WordPress:6.4.3 ・PHP:8.1 ・確認日:最新バージョンリリース時 ・テーマ:Twenty Twenty-Four ※環境によって動作が異なる場合があります。必ず検証環境でお試しください。 「FSE(フルサイト編集)は実際の案件で使えるレベルなのか」 日々のWeb制作業務の中で、制作者仲間からこのような相談を受けることが増えました。従来のPHPを中心としたクラシックテーマから、ブロックベースのテーマへの移行は、制作フローを根本から変える大きな決断です。 本記事では、実案件での導入経験を踏まえ、FSEを採用するかどうかの判断基準と、具体的な導入へのステップを正直にシェアします。 この記事でわかること ・FSE(フルサイト編集)の基本的な仕組み ・実案件でFSEを採用する際の判断基準 ・クラシックテーマから移行する際の注意点 ・FSEの導入に向いているケースと向いていないケース FSE(フルサイト編集)とは、ブロックエディターの直感的な操作感を活かし、ヘッダーやフッターを含むサイト全体を編集できるWordPressの機能です。従来はPHPファイル(header.phpやfooter.phpなど)を直接編集して構築していましたが、FSEではHTMLベースのブロックテンプレートと、theme.jsonという設定ファイルを中心に構築を進めます。 実務において、まず最初に取り組むべきはtheme.jsonの設計です。このファイルでサイト全体のカラーパレット、タイポグラフィ、余白のルールを一元管理します。ここにしっかりとした設計を落とし込むことで、運用フェーズでクライアントが意図しないデザイン崩れを起こすリスクを大幅に減らすことができます。 なぜtheme.jsonによる一元管理が推奨されるのかというと、WordPressのコア(本体)が生成するCSSと連動しているためです。従来のようにstyle.cssに大量のCSSを記述するのではなく、theme.jsonでルールを定義することで、必要なCSSだけが適切なタイミングで読み込まれるようになり、パフォーマンスの向上にもつながります。 正直に言うと、私自身も初めてFSEを実案件に導入した際は、独自のCSSで無理やり上書きしようとして苦労しました。ブロックが持つ標準の設定やtheme.jsonの仕様を無視してカスタマイズを進めた結果、WordPressのアップデート時にデザインが崩れてしまった経験があります。それ以来、独自のCSSを追加する前に「theme.jsonで解決できないか」をまず検討するフローを社内のデフォルトにしています。 ここでよくある間違いが、すべての案件で無理にFSEを採用しようとすることです。FSEは素晴らしい機能ですが、ピクセルパーフェクトな複雑なアニメーションを多用するコーポレートサイトなどには、現時点では不向きな場面もあります。

項目向いているケース向いていないケース
FSEの採用ブログメディアやシンプルな構成のサイト複雑なアニメーションや高度な独自処理が必要なサイト
theme.jsonサイト全体の統一されたデザインルール管理ページごとに全く異なるレイアウトを多用する場合
長期的な保守性や将来性を考えると、WordPressの開発方針は明らかにブロックベースのFSEへと舵を切っています。そのため、新規で立ち上げるシンプルな構成のサイトや、クライアント自身による更新頻度が高いオウンドメディアなどでは、積極的にFSEを導入する価値があります。 迷ったときは、以下の基準で整理してみてください。 ・クライアントが直感的にノーコードでレイアウトを変更したいか ・デザインの自由度よりも、運用時の更新のしやすさを優先するか ・既存のクラシックテーマに依存したプラグインを多用しないか これらに当てはまる場合、FSEは非常に強力な選択肢となります。実務での導入は、まずは自社のテストサイトなど、影響の少ない小規模なプロジェクトから小さく始めてみる形をおすすめします。

2. Gutenbergカスタマイズで実案件の効率を上げるブロック構築法

【動作確認済み環境】 ・WordPress:6.4 ・PHP:8.1 ・確認日:4月 ・テーマ:独自テーマ(FSE対応) ※環境によって動作が異なる場合があります。必ず検証環境でお試しください。 実務の現場でよく直面するのが、「クライアントが直感的に更新できるようにしたいけれど、運用時のデザイン崩れは防ぎたい」というジレンマです。Gutenberg(ブロックエディター)のカスタマイズにおいて、一から独自のカスタムブロックをReactで開発する方法もありますが、制作効率とメンテナンス性を考慮すると、既存のコアブロックを拡張するアプローチが非常に実用的です。 この記事では、実際の案件で採用している「ブロックスタイル(Block Styles)の追加」によるカスタマイズ手法をシェアします。

既存ブロックに独自のスタイルを追加する

見出しブロックやボタンブロックなど、WordPressに標準で用意されているブロックに対し、テーマ独自のスタイルバリエーションを追加する方法です。以下のコードをテーマの機能を追加・カスタマイズするファイルである`functions.php`に記述します。
php
<?php
/
 Gutenbergブロックに独自のスタイルを追加する

 実行タイミング: init(WordPressの初期化処理が完了したタイミング)
 記述場所: functions.php
/
function ebiz_register_block_styles() {
// ボタンブロックに「矢印付きボタン」のスタイルを追加
register_block_style(
'core/button', // 対象となるコアブロック名
array(
'name'  => 'arrow-btn', // CSSクラス名として出力される識別子
'label' => '矢印付き',    // エディター上で表示される名前
)
);

// 見出しブロックに「下線付き」のスタイルを追加
register_block_style(
'core/heading',
array(
'name'  => 'underline-heading',
'label' => '下線付き',
)
);
}
// initフック(特定のタイミングで処理を実行する仕組み)に登録
add_action( 'init', 'ebiz_register_block_styles' );
このコードを追加すると、エディターの右側パネルに新しいスタイルの選択肢が表示されます。選択すると、出力されるHTMLに`is-style-arrow-btn`といったCSSクラスが付与されるため、あとはテーマのCSSファイルで装飾を行うだけです。

なぜこのアプローチを推奨するのか

この書き方を案件のデフォルトにしている理由は、長期的な保守性に優れているからです。内部的な動作として、WordPressのコアブロックの構造自体は変更せず、単にCSSクラスを付与するだけにとどまります。 もし将来的にWordPressのメジャーアップデートがあり、コアブロックのHTML構造に変更が加えられたとしても、独自のReactコードで出力制御を行っているカスタムブロックに比べて、影響を受けるリスクを大幅に抑えられます。また、PHPとCSSの知識だけで実装できるため、制作チーム内での引き継ぎもスムーズに行えます。

実案件での判断基準

以前、自治体向けのポータルサイト構築案件で、多数のカスタムブロックを独自開発するか迷ったことがありました。しかし、運用担当者のスキルセットや将来的な保守・メンテナンスの負担を考慮し、最終的に「既存ブロックのスタイル拡張」と「ブロックパターン(あらかじめ組まれたブロックのまとまり)の登録」を組み合わせる手法を選びました。 結果として、エディター画面の動作も軽く保つことができ、WordPress公式のアップデートにも追従しやすい堅牢なサイトを納品することができました。

向いているケース・向いていないケースまとめ

項目向いているケース向いていないケース
ブロックスタイルの追加既存ブロックのHTML構造のままで、見た目だけを変えたい場合独自の入力フィールドや、複雑なHTML構造の出力を伴う独自の要素を作りたい場合
独自フィールドが必要な場合は、外部プラグインであるAdvanced Custom Fieldsを用いたカスタムブロックの作成や、ネイティブなブロック開発を検討することをおすすめします。要件に合わせて適切なアプローチを選択することで、制作効率と運用後の安定性を両立させることができます。ぜひ実案件の設計の参考にしてみてください。

3. クラシックテーマからFSEへの移行でつまずくポイントと解決策

クラシックテーマからFSE(フルサイト編集:ブロックエディターでサイト全体を編集できるWordPressの新機能)へ移行する際、実務で直面しやすい壁とその乗り越え方をシェアします。 従来のPHPベースのテーマ構築に慣れているほど、FSE特有のファイル構造や概念の違いに戸惑う場面が多いのが実情です。 実際の案件でも、これまでfunctions.phpで制御していた処理をどう扱うべきか、迷うケースによく遭遇します。

テーマ構造の根本的な違いとエラーの原因

クラシックテーマでは、header.phpやfooter.phpといったPHPファイルでレイアウトを構築していました。 しかし、FSEではHTMLファイルにブロックのマークアップを記述する形式に変わります。 以前、企業サイトの移行案件で、既存のナビゲーションメニューやウィジェット領域を引き継ごうとして表示崩れを起こした経験があります。 原因は、FSEが従来のメニュー機能やサイドバーの仕組みを非推奨とし、代わりにナビゲーションブロックやテンプレートパーツを使用する仕様に変わっている点でした。

functions.phpからtheme.jsonへの役割移行

デザインの制御も大きく変わります。 これまでstyle.cssやfunctions.phpのフック(WordPressの処理に割り込んで独自の処理を追加する仕組み)で行っていたカラーパレットやフォントの設定は、theme.jsonという設定ファイルに集約されます。 実際の案件で導入しているtheme.jsonの基本的な書き方を紹介します。
json
/<strong> theme.json : テーマのルートディレクトリに配置します </strong>/
/<strong> サイト全体の色やフォントなどの基本設定を定義するタイミングで読み込まれます </strong>/
{
"version": 2,
"settings": {
"color": {
"palette": [
{
"slug": "primary",
"color": "#005baa",
"name": "Primary Color"
}
]
}
}
}
この書き方が推奨される理由は、エディター側のUIとフロントエンドのCSS変数が自動的に連携されるためです。 内部的にWordPressがCSSを生成してくれるので、個別にCSSを記述する手間が省け、保守性が向上します。

よくあるハマりポイント:既存ショートコードの扱い

クラシック環境で多用していた独自のショートコードをFSE環境にそのまま持ち込むと、エディター上でプレビューが正しく反映されないことがあります。 長期的には、ショートコードをカスタムブロックへ移行することが推奨されます。 しかし、予算や納期の都合で難しい場合は、エディター標準の「ショートコードブロック」を活用して段階的に移行する判断をしています。
項目向いているケース向いていないケース
FSEへの完全移行新規構築や全面リニューアルの場合複雑なPHP処理を多用している既存サイトの場合
theme.jsonの活用サイト全体でデザインルールを統一したい場合ページ単位で全く異なるCSS設計が必要な場合
ブロック化の推進運用者がコードに触れずレイアウト変更したい場合固定的なデザインを厳密に守る必要がある場合
FSEへの移行は、単なるテーマの切り替えではなく、サイト構築の概念そのものを再設計するプロセスです。 迷ったときは、運用者がどこまで自由にレイアウトを編集できるべきか、という基準で判断すると整理しやすいです。

4. 実務で使えるtheme.jsonの基本設定とカスタマイズ例

【動作確認済み環境】 ・WordPress:6.4 ・PHP:8.1 ・確認日:直近の検証時 ・テーマ:独自FSEテーマ(ブロックテーマ) ※環境によって動作が異なる場合があります。必ず検証環境でお試しください。 FSE(フルサイト編集:ブロックエディターでサイト全体を編集できるWordPressの新機能)を実案件で導入する際、最も頭を悩ませるのが「クライアントがエディターで自由にデザインを壊せてしまう」という問題ではないでしょうか。 実際の案件でも、「見出しの色をブランドカラー以外に変更されてしまった」「余白を適当にいじられてレイアウトが崩れた」というご相談をよくいただきます。こうしたトラブルを未然に防ぎ、制作者側でコントロールするための要となるのが`theme.json`です。 ここでは、実務で安全にFSEを運用するための`theme.json`の基本設定と、よく使うカスタマイズ例をシェアします。

theme.jsonでできることとその役割

`theme.json`は、ブロックエディターのUI設定やデフォルトのスタイルを制御するための中核ファイルです。具体的には、以下の3つの役割を持っています。 1. 機能の制限(フォントサイズ変更やカスタムカラーピッカーの無効化など) 2. プリセットの定義(ブランドカラーや指定のフォントサイズの登録) 3. デフォルトスタイルの適用(サイト全体や特定ブロックの初期CSS設定) このファイルを適切に設定することで、エディター上に表示される選択肢を「サイトのトンマナに合ったものだけ」に制限できます。

実務のベースとなるtheme.jsonのコード例

実際の案件でベースとして使用している`theme.json`の記述例です。プロジェクトのルートディレクトリ(テーマフォルダの直下)に配置します。
json
{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 2,
"settings": {
"color": {
// ユーザーによる任意のカラーコード入力を禁止
"custom": false,
// コアのデフォルトカラーパレットを非表示
"defaultPalette": false,
// サイト専用のカラーパレットを定義
"palette": [
{
"slug": "primary",
"color": "#005a9e",
"name": "メインカラー"
},
{
"slug": "text",
"color": "#333333",
"name": "テキストカラー"
}
]
},
"typography": {
// 任意のフォントサイズ入力を禁止
"customFontSize": false,
// コアのデフォルトフォントサイズを非表示
"defaultFontSizes": false,
// サイト専用のフォントサイズを定義
"fontSizes": [
{
"slug": "small",
"size": "14px",
"name": "小"
},
{
"slug": "medium",
"size": "16px",
"name": "標準"
}
]
},
"spacing": {
// 任意の余白サイズ入力を禁止(規定のステップのみ許可)
"customPadding": false,
"customMargin": false
}
}
}
この設定が推奨される理由は、デザインの統一性を保つためです。`custom: false`を設定すると、エディター上のカラーピッカーが消え、事前に定義した「メインカラー」や「テキストカラー」しか選べなくなります。内部的には、ここで定義した値がCSSカスタムプロパティ(CSS変数)として自動出力されるため、フロントエンドのスタイリングも非常にスムーズになります。

なぜ制限をかけるのか(実務での判断基準)

以前の案件で、自由度を高く設定したまま納品したことがありました。数ヶ月後にサイトを確認すると、意図しない蛍光色が使われていたり、フォントサイズがバラバラになっていたりして、ブランドイメージが損なわれていました。 それ以降、私たちのチームでは「エディターの自由度は必要最小限に絞る」ことをデフォルトの設計基準にしています。制限をかけることは、クライアントの操作を縛るためではなく、迷わず安全に更新できる環境を提供するためです。

よくある間違いと注意点

`theme.json`を編集する際、よくあるのがJSONの構文エラー(カンマの付け忘れや余分なカンマ)によって、エディター画面が真っ白になったり設定が反映されなかったりするトラブルです。編集時は、VS CodeなどのエディターでJSONのフォーマットチェックを有効にしておくことをお勧めします。 また、クラシックテーマ(従来のPHPベースのテーマ)でも`theme.json`は使用可能ですが、すべての設定が反映されるわけではありません。ブロックテーマとクラシックテーマでは挙動が異なる部分があるため、混同しないように注意が必要です。

向いているケース・向いていないケースまとめ

項目向いているケース向いていないケース
theme.jsonによる厳密な制限複数人で記事を更新するサイト、ブランドガイドラインが明確なサイト個人のブログなど、執筆者が自由に装飾を楽しみたいサイト
カスタムカラーの無効化コーポレートサイトやメディアサイトデザインツールのようにエディターを使いたい場合
長期的な保守性を考えると、`theme.json`でデザインの仕様を中央集権的に管理するアプローチは、今後のWordPress開発においてスタンダードな手法となっていきます。迷ったときは、「ユーザーが自由に数値を入力できる項目は極力減らし、選択肢を用意する」という考え方を軸にすると整理しやすいです。

5. 運用保守を見据えたブロックエディターの最適な設計手法

実際の案件でサイトを納品した数ヶ月後、「レイアウトが崩れてしまった」「ブランドカラーではない色に変更してしまった」といったご相談をいただくことはありませんか。ブロックエディターは自由度が高い反面、操作に不慣れな方が編集すると、意図しないデザインの崩れを引き起こすことがあります。 ここでは、クライアントが安全に運用でき、制作者側も保守がしやすくなるブロックエディターの設計手法をシェアします。 ・運用時のレイアウト崩れを防ぐ具体的な方法がわかります ・theme.jsonを活用した編集権限のコントロール手法がわかります ・保守性を高めるブロックパターンの適切な使い方がわかります ■ theme.jsonを活用したデザインの制限 運用保守を考える際、最初に設定したいのがtheme.json(テーマの全体的なスタイルやエディターの動作を制御する設定ファイル)による制限です。すべての機能を開放するのではなく、必要な機能だけを有効にすることで、運用時のトラブルを大幅に減らすことができます。

json
// theme.jsonに記述します
// エディターでの自由な色変更やタイポグラフィ変更を制限する例
{
"version": 2,
"settings": {
"color": {
"custom": false, // カスタムカラーのピッカーを無効化
"palette": [
// ブランドカラーのみをパレットに登録
{
"slug": "brand-primary",
"color": "#005baa",
"name": "メインカラー"
}
]
},
"typography": {
"customFontSize": false // 任意のフォントサイズ入力を無効化
}
}
}
この書き方が推奨される理由は、デザインの統一性をシステム側で担保できるためです。内部的には、エディターのUIから余分な設定項目が消え、事前に定義したパレットやサイズのみが選択可能になります。これにより、HTMLやCSSの知識がない担当者でも、迷わず正しいデザインでコンテンツを作成できるようになります。 ■ ブロックのロック機能とパターンの活用 正直にお話しすると、以前はすべてのページを固定のカスタムフィールドで設計していました。しかし、ブロックエディターが主流になった現在では、ブロックのロック機能とブロックパターンを組み合わせる方法を案件のデフォルトにしています。理由は、柔軟なレイアウト構築と堅牢な運用を両立できるからです。
php
// functions.phpなどに記述します
// 特定のパターンのブロックをロックして登録する例
register_block_pattern(
'my-theme/hero-section',
array(
'title'       => 'ヒーローセクション',
'categories'  => array( 'header' ),
// lock属性を使って、ブロックの削除や移動を制限
'content'     => '
<div class="wp-block-group"><div class="wp-block-group__inner-container is-layout-flow wp-block-group-is-layout-flow">
<h2 class="wp-block-heading">見出しを入力</h2>
</div></div>
',
)
);
■ よくある間違いとハマりポイント やりがちですが控えた方がよいのが、不要な標準ブロックをすべてPHPの `allowed_block_types_all` (使用可能なブロックを制限するフィルターフック)で非表示にするアプローチです。WordPressのアップデートで新しいブロックが追加された際、意図せず使えるようになってしまったり、プラグインが追加するブロックとの競合が起きたりすることがあります。制限をかける場合は、theme.jsonでの機能制限と組み合わせるのが安全です。 ■ 向いているケース・向いていないケースまとめ
項目向いているケース向いていないケース
theme.jsonでの制限複数人で記事を執筆するメディアサイトや、ブランドガイドラインが厳格なコーポレートサイトの場合運用者がWeb制作の知識を持ち、自由にデザインを組みたい個人ブログなどの場合
ブロックのロックランディングページやトップページなど、レイアウトを崩したくない重要なページの場合日々のブログ記事など、内容に合わせて柔軟に見出しや画像を追加したい場合
長期的に見てこの選択は正しいかという観点では、WordPress本体がフルサイト編集(FSE)とtheme.jsonを中心とした設計へ完全にシフトしているため、この仕様に沿った構築が今後の保守性を最も高く保てます。メジャーアップデートの影響も受けにくく、将来的なテーマのリニューアル時にもデータを安全に引き継ぎやすくなります。 迷ったときは、以下の基準で整理するとスムーズです。 ・デザインのルール(色・フォント)は theme.json で制御する ・レイアウトのルール(配置・崩れ防止)は ブロックパターンとロック機能 で制御する ・コンテンツの入力(テキスト・画像)は 運用者に開放する

image?i=182142

2026年のWordPressフルサイト編集とGutenbergカスタマイズ実践ガイド