本文へスキップ本文へスキップ
WordPress

今のWordPressテーマはどう作る?AIに聞いてクラシック・ブロック・ハイブリッド構成を調べてみた

~11 min

今のWordPressテーマはどう作る?AIに聞いてクラシック・ブロック・ハイブリッド構成を調べてみた
目次

WordPressのテーマを自作したことがある人なら、header.php、footer.php、single.php、functions.php あたりは見慣れていると思います。

でも最近のWordPressのテーマ構成を調べると、theme.json、templates/*.html、parts/*.html、patterns/ といったファイルが出てきます。「そもそも今のWordPressテーマってどういう構成が普通なんだろう?」と気になりました。

今回はAIにテーマの種類を整理してもらい、WordPress公式Theme Handbookを使ってファイル構成、レンダリング、拡張方法、制作現場での使い分けを確認します。クラシックテーマを否定する話ではなく、要件に応じて何を選ぶかがテーマです。

まず、テーマは大きく2種類。「ハイブリッド」は中間的な使い方

WordPress公式で基本となる分類は、クラシックテーマとブロックテーマです。

クラシックテーマ

ブロックテーマ

テンプレート

PHP

ブロックマークアップを含むHTML

必須ファイル

style.css、index.php

style.css、templates/index.html

ヘッダー・フッター

header.php、footer.phpなど

parts/*.htmlなど

編集の中心

コードとテーマの設定

サイトエディターとブロック

スタイル設定

CSS、PHP設定など

theme.json、CSSなど

向いている作り方

PHPテンプレートの厳密な設計

編集者がレイアウトを組み替える運用

※公式では「ハイブリッドテーマ」が完全に独立した第3のテーマ形式として定義されているわけではありません。一般には、クラシックテーマに theme.json やブロック関連機能を取り込んだ構成を、便宜的にそう呼びます。

今のWordPressテーマはどう作る?AIに聞いてクラシック・ブロック・ハイブリッド構成を調べてみた

クラシックテーマ:PHPで何を表示するかを決める

クラシックテーマの分かりやすい例は次のような構成です。これは制作でよくある構成例で、全フォルダが必須ではありません。

my-classic-theme/
├── assets/
│   ├── css/
│   ├── js/
│   └── images/
├── inc/
│   └── setup.php
├── template-parts/
│   └── card.php
├── archive.php
├── front-page.php
├── functions.php
├── header.php
├── footer.php
├── page.php
├── single.php
├── index.php
└── style.css

WordPressはアクセスされたURLに応じてテンプレート階層を判定し、適切なPHPファイルを読み込みます。例えば投稿詳細なら single.php が候補になり、該当テンプレートがなければより一般的なテンプレートへフォールバックします。

<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<article>
<h1><?php the_title(); ?></h1>
<div><?php the_content(); ?></div>
</article>
<?php endwhile; ?>
<?php endif; ?>

このように、PHPテンプレートの中でループやテンプレートタグを使って表示を組み立てられます。

良いところ

PHPでHTML構造を細かく制御しやすく、カスタム投稿タイプや独自タクソノミー、条件分岐が多いサイトで扱い慣れた方法を採れます。既存テーマの保守にも直結します。

気になるところ

編集担当者がレイアウトを変えるには、カスタムフィールドや独自の管理画面、テンプレート改修が必要になることがあります。柔軟性は設計次第であり、コード変更を伴う運用になりやすいのが特徴です。

ブロックテーマ:ページ構造そのものをエディターで扱う

ブロックテーマでは、テンプレートファイル自体がWordPressブロックのマークアップになっています。

my-block-theme/
├── assets/
│   └── images/
├── parts/
│   ├── header.html
│   └── footer.html
├── patterns/
│   └── feature.php
├── styles/
│   └── variation.json
├── templates/
│   ├── index.html
│   ├── single.html
│   └── page.html
├── functions.php
├── theme.json
└── style.css

必須なのは基本的に style.css と templates/index.html です。theme.json や functions.php を含め、それ以外は必要に応じて追加します。公式ドキュメントではテンプレートパーツを parts/ に置く構成が推奨されています。

例えば templates/index.html は次のような形です。

<!-- wp:template-part {"slug":"header","tagName":"header"} /-->
<!-- wp:group {"tagName":"main"} -->
<main class="wp-block-group">
<!-- wp:query {"query":{"perPage":10,"postType":"post"}} -->
<div class="wp-block-query">
<!-- wp:post-template -->
<!-- wp:post-title {"isLink":true} /-->
<!-- /wp:post-template -->
</div>
<!-- /wp:query -->
</main>
<!-- /wp:group -->
<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->

これは構造を説明する簡易例です。実際にはページネーションやQuery Loopの設定、レイアウト調整も必要になります。

ブロックテーマは「PHPを完全に使わないテーマ」ではありません。独自ブロックのサーバーサイドレンダリングや、テーマの機能登録、データ取得などにPHPは引き続き使われます。

良いところ

ヘッダー、フッター、テンプレート、パターンなどをサイトエディターから編集できる。編集担当者がページを組み替える場面では強みになります。

気になるところ

編集範囲を広くしすぎるとサイト全体の統一感を保ちにくくなります。独自ブロックの設計やブロックの属性、エディターでの表示方法など、PHPテンプレートとは違う学習が必要です。

theme.json はデザイントークンと編集設定の橋渡し

テーマ構成の中でも重要なのが theme.json。色、文字サイズ、余白、レイアウトなどの設定を、WordPressが理解できる形式で定義します。

{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 3,
"settings": {
"color": {
"palette": [
{
"slug": "brand",
"name": "Brand",
"color": "#9ED92E"
}
]
},
"layout": {
"contentSize": "760px",
"wideSize": "1200px"
}
}
}

上記は基本項目だけの例です。テーマの実装時には利用するWordPressバージョンでサポートされるスキーマを確認してください。

大事なのは theme.json がブロックテーマだけのものではないこと。クラシックテーマでも、一部のブロックエディターの設定やスタイル定義に利用できます。

CSSの代替というより「設計値をエディターとフロントで共有する」ための道具、と考えると分かりやすいです。

ブロックパターンと独自ブロックは別物

ここも混同しやすいところ。

  • ブロックパターン:既存ブロックを組み合わせたレイアウトのひな形。よくある見出し+カード+ボタンなどに向く。

  • 独自ブロック:属性や編集UI、保存・レンダリング方法を自分で実装する新しいブロック。既存ブロックでは実現しづらい独自機能に向く。

例えば「3カラムの特徴紹介」を作るだけならパターンで十分かもしれません。外部APIからの動的データ取得や特殊な編集UIが必要なら独自ブロックを検討します。

最初から何でも独自ブロックにすると、実装・更新・テストの負担が増えます。逆に、使い回すデザインを毎回手動で組むのも非効率。求められる編集自由度で選びます。

フロント側の設計だけでなく、管理画面の操作まで考える

制作で重要なのは「編集者に何を変えてほしいか」です。

例えば、デザインを厳密に固定したコーポレートサイトなら、ページの構造を自由に変更できない方が安全な場合があります。一方、キャンペーンページを頻繁に作り替えるメディアなら、パターンやブロックテンプレートの自由度が活きそうです。

WordPress 7.1ではブロックのレスポンシブスタイルや、編集画面のiframe化も進みました。特にブロックエディターへ独自CSSやスクリプトを差し込んでいる既存テーマは、エディター側へのスタイル適用を確認したいところです。

今のWordPressテーマはどう作る?AIに聞いてクラシック・ブロック・ハイブリッド構成を調べてみた

「見た目」はテーマ、「機能」はプラグインへ寄せるべき?

WordPressではテーマとプラグインの責務分離も大事です。テーマを切り替えると消えてしまうと困る機能、例えば独立した業務データやカスタム投稿タイプの定義、外部サービス連携などは、必要に応じて独自プラグインへ分離する考え方があります。

もちろんテーマ依存の表示処理をすべてプラグインに移す必要はありません。

自分なら次の基準で考えたいです。

役割

置き場所の例

ページレイアウト、スタイル

テーマ

表示専用のテンプレートパーツ

テーマ

再利用可能な業務ロジック

独自プラグイン

テーマ変更後も残す投稿タイプやAPI

独自プラグインを優先検討

フロント専用の小さなJS

テーマのアセット

テーマを作るときから「いつか見た目を作り直したらどうなるか」を考えるだけでも、将来の移行しやすさが変わります。

2026年に自作するなら、何を選ぶ?

「今はブロックテーマ一択」とは思いません。要件次第です。

  • 編集担当者がページを柔軟に作りたい:ブロックテーマ+パターン設計を第一候補に。

  • PHPによる複雑なテンプレートと厳密なHTML設計が必要:クラシックテーマも有力。

  • 既存のクラシックテーマを段階的に改善したい:theme.json や一部のブロック機能を取り込むハイブリッドな構成を検討。

  • 表示アプリ自体をWordPressから分離したい:Headless CMS化も選択肢。ただしデータ取得、プレビュー、キャッシュの運用は別に必要。

今回調べて感じたのは、新しいテーマ形式ほど常に優れている、という話ではないことです。編集する人、開発する人、更新頻度、デザイン要件、将来の保守まで考えた上で決めたいと思います。

普段PHPテンプレートに慣れている人ほど、ブロックテーマのファイル構成を一度実際に眺める価値がありそう。まずは小さな検証用テーマを作り、何がコードに残り、何が編集画面へ移るのか確かめたいです。

参考資料

過去の記事から 1 本

全 36 本のうち 24 本目の記事

related

関連記事

about

このブログについて

Web 開発・インフラ・AI を手を動かして試した記録が中心です。うまくいった話もハマった話も、仕事や日々のこともそのまま書きます。