WordPressテーマビルド
目標は、デザインはコードに固定し、コンテンツはエディタで編集可能なテーマを作成することです。テンプレート内のハードコードされたテキストは、クライアントが些細な編集で戻ってくる最も一般的な理由です。
アプローチの選択
| アプローチ | 選択するタイミング |
|---|---|
ブロックテーマ(theme.json、HTMLテンプレート) | 新規ビルド、クライアントがサイトエディタで編集、コンテンツが主に標準ブロック |
ハイブリッドクラシックテーマ(PHPテンプレート+theme.jsonとブロックパターン) | 正確なHTML制御が必要な複雑なカスタムマークアップや重いアニメーション |
| 子テーマ | 既存テーマの変更;親テーマを直接編集しないでください。アップデートで上書きされるため |
アニメーションを使ったデザイン主導のマーケティングサイトの場合、ハイブリッドアプローチが通常は実用的です。PHPで正確なマークアップを記述し、パターン、フィールド、ブロックエディタを通じてコンテンツを編集可能にします。
最小構成
my-theme/
├── style.css # テーマヘッダーコメント(必須)
├── functions.php # セットアップ、エンキュー、登録
├── theme.json # パレット、タイプスケール、スペーシング、レイアウト幅
├── index.php # フォールバックテンプレート(クラシック/ハイブリッド)
├── front-page.php # ホームページ
├── header.php footer.php
├── template-parts/ # セクションごとに1ファイル
├── patterns/ # ブロックパターン(自動登録)
├── assets/css assets/js assets/media
└── screenshot.png # 1200x900
style.cssヘッダー:
/*
Theme Name: My Theme
Author: Your Name
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: my-theme
*/
変換ワークフロー
- 静的ビルドを凍結する。 最初にHTML、CSS、JSを完成させて検証します。動くターゲットを変換すると作業が2倍になります。
- パーツに分割する。 ヘッダーとフッターは
header.phpとfooter.phpにwp_head()とwp_footer()を入れて配置します。ホームページの各セクションはtemplate-parts/内のファイルになり、get_template_part()で読み込みます。 - トークンを
theme.jsonに移動する(パレット、フォントサイズ、スペーシング、コンテンツ幅)。エディタにフロントエンドと同じ選択肢が表示されるようにします。CSSカスタムプロパティと同じ値を保持します。WordPressは--wp--preset--*変数を生成するため、エイリアスとして使用できます。webcraftCLIが利用可能な場合、webcraft tokens "#brand" --format theme-json -o theme.jsonはtokens.cssと同じ値からバージョン3ファイルを書き出します。 - アセットはハードコードせずにエンキューする:
add_action('wp_enqueue_scripts', function () {
$v = wp_get_theme()->get('Version');
$uri = get_theme_file_uri('assets');
wp_enqueue_style('my-theme', "$uri/css/main.css", [], $v);
wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
wp_enqueue_script('my-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});
ライブラリは可能な限りCDNではなくローカルにバンドルします。サードパーティのリクエストと同意の問題を回避できます。 5. コンテンツを編集可能にする。 セクションごとに選択:
- 独自ページを持つ繰り返しアイテム(サービス、ポートフォリオ、お客様の声):
WP_Queryでクエリするカスタム投稿タイプ。 - 1回限りのセクションテキストと画像:クライアントが挿入して編集するブロックパターン、またはカスタムフィールド。
- グローバルアイテム(電話、ソーシャルリンク、フッターテキスト):カスタマイザーまたは小さなオプションページ。
- ナビゲーション:
register_nav_menus()とwp_nav_menu()。
- 出力時にすべてをエスケープする:
esc_html()、esc_attr()、esc_url()、リッチテキストにはwp_kses_post()。文字列をテキストドメイン付きの__()またはesc_html__()でラップします。 - 画像:
wp_get_attachment_image()を使用して、srcset、sizes、寸法、遅延読み込みが生成されるようにします。必要なサイズはadd_image_size()で登録します。 - テーマサポート:
title-tag、post-thumbnails、editor-styles、responsive-embeds、html5、wp-block-styles。
WordPress内でのアニメーション
- コンテンツを非表示にするスクリプトはブロックエディタで実行してはいけません。フロントエンドでのみエンキューします(
enqueue_block_assetsではなくwp_enqueue_scripts)。 - 管理バーはスティッキーヘッダーを32px(モバイルでは46px)シフトします。
body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }でオフセットします。 - JSを遅延実行または結合するキャッシュ・最適化プラグインはロード順序を壊す可能性があります。依存関係を適切に宣言して尊重されるようにし、プラグインを有効にしてテストします。
- エディタで追加されたコンテンツにはアニメーション属性がありません。ブロッククラスごとにJSでアニメーションを適用するか、属性を含むパターンを提供します。
禁止事項
- WordPressコアまたは親テーマを編集しないでください。
- テーマを切り替えても残るべき機能(カスタム投稿タイプ、ショートコード)を、クライアントがテーマを変更する可能性がある場合にテーマに入れないでください。小さなプラグインが適切な場所です。
- ループ内でリセットせずにクエリを行わないでください(
wp_reset_postdata())。 WP_DEBUG通知を出して出荷しないでください。WP_DEBUGをオンにして開発してください。- 再配布を許可しないライセンスの有料プラグインやアセットをバンドルしないでください。
引き継ぎチェックリスト
- クライアントがコードに触れずにすべての表示テキスト、画像、メニュー項目、連絡先詳細を変更できる。
- ホームページが設定→表示設定で設定され、パーマリンクが「投稿名」に設定されている。
- ファビコン(サイトアイコン)、404テンプレート、検索テンプレート、プライバシーページが存在する。
- スクリーンショット付きの1ページ編集ガイド。
- その後、
launch-qaスキルを実行します。