WordPressテーマ開発環境の構築
コードを書き始める前に、安定していて効率的なローカル開発環境を整えることが成功の鍵です。これにより、本番サイトに影響を与えることなくテストできるだけでなく、開発効率も大幅に向上します。従来はサーバーやレンタルサーバー上で直接作業する方法もありましたが、現代の開発者にとってはローカル環境が第一の選択肢です。
ローカル開発環境の選択と設定
主流の選択肢には、XAMPP、MAMP（macOS向け）、Local by Flywheel などの統合環境があります。これらを使えば、Apache、MySQL、PHPをワンクリックでインストールでき、面倒な設定作業を省けます。より高度なカスタマイズ性を求める開発者は、Dockerを使って完全に分離された再現可能な開発環境を構築することもできます。どのツールを選ぶ場合でも重要なのは、PHPのバージョン（推奨は7.4以上）とMySQL/MariaDBのバージョンが、対象の本番環境と互換性があることです。
最初のテーマディレクトリを準備しましょう
WordPressテーマファイルの保存場所/wp-content/themes/ディレクトリ内に、新しいフォルダを作成します。たとえばmy-first-themeこれがあなたのテーマディレクトリです。WordPressに有効なテーマとして認識されるには、このディレクトリ内に少なくとも2つのファイルが必要です。style.cssとindex.phpその中で、style.cssヘッダーのコメント情報は非常に重要で、テーマのメタデータが含まれています。
推薦図書 WordPressテーマ開発完全ガイド：ゼロからプロフェッショナルレベルのテーマを構築する。
はい。style.css文件的开头，你需要添加如下格式的注释：
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme/
Author: Your Name
Author URI: https://example.com/
Description: 这是一个用于学习WordPress主题开发的示例主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/テーマの主要ファイル構成とテンプレートシステム
WordPressのテンプレート階層（Template Hierarchy）を理解することは、テーマ開発の要です。この仕組みにより、WordPressはブログのトップページ、個別記事、カテゴリーページなど、異なるページリクエストに応じて適切なテンプレートファイルを自動的に選び、表示します。
テンプレート階層の役割を理解する
テンプレート階層は、具体的なものから一般的なものへと探していくルールです。たとえば、ユーザーが特定の記事にアクセスした場合、WordPress は次の順に探します。single-post-{slug}.php -> single-post-{id}.php -> single.php -> singular.php -> index.php最初に見つかったファイルがページのレンダリングに使用されます。つまり、特定のテンプレートファイルを作成することで、さまざまなコンテンツの表示方法を細かく制御できます。
必ず押さえるべき基本テンプレートファイル
それに加えて、index.phpこの最終バックアップテンプレートでは、以下のテンプレートファイルが特によく使われる重要なファイルです。
* header.php：Webページのヘッダーを定義し、通常は以下を含みます<head>セクション、サイトタイトル、メインナビゲーション。
* footer.php: Webページのフッターを定義し、著作権情報やスクリプトなどを含みます。
* functions.php: 这是主题的“功能中心”，用于添加主题支持、注册菜单、侧边栏，以及引入自定义功能和样式脚本。
* style.css: 主样式表，除了提供元数据，也定义所有视觉样式。
* page.php`: 静的なページをレンダリングするために使用されます。
* single.php`: 単一の記事をレンダリングするために使用されます。
* archive.php: カテゴリー、タグ、著者などのアーカイブページのレンダリングに使用します。
* 404.php: 用于渲染“页面未找到”的错误页面。
テンプレートタグ（Template Tags）を使って、たとえば<?php get_header(); ?>と<?php get_footer(); ?>テンプレート内でこれらのモジュール化されたファイルを簡単に読み込めます。
推薦図書 WordPressテーマ開発の究極ガイド：ゼロからプロフェッショナルなウェブサイトの構築まで。
深入主题功能与循环
functions.php文件是主题的“大脑”，而“WordPress循环”（The Loop）则是驱动内容显示的“心脏”。掌握这两者，你才能真正让主题“活”起来。
テーマ機能ファイルの強力な役割
functions.phpこのファイルはテーマの読み込み時に自動的に呼び出されます。ここではさまざまなものを使用できますadd_theme_support()関数を使ってテーマ機能を宣言します。たとえば、アイキャッチ画像の有効化、カスタムロゴ、メニュー機能などです。
function my_theme_setup() {
// 添加对文章特色图片的支持
add_theme_support('post-thumbnails');
// 添加对自定义Logo的支持
add_theme_support('custom-logo');
// 注册导航菜单位置
register_nav_menus(array(
'primary' => __('主导航菜单', 'my-first-theme'),
'footer' => __('页脚菜单', 'my-first-theme'),
));
}
add_action('after_setup_theme', 'my_theme_setup');さらに、ここで使用できますwp_enqueue_style()とwp_enqueue_script()関数を使って、CSS と JavaScript ファイルをテーマに正しく追加し、依存関係を適切に保ち、プラグインとの競合を防ぎます。
WordPressループの書き方をマスターする
ループは、データベースからコンテンツを取得してページに表示するためのPHPコード構造です。基本的なパターンは次のとおりです。
備考：この翻訳はPHPコードのみを対象としたもので、HTMLコードは含まれていません。
<!-- 在这里输出文章内容 -->
<h2>あなたのウェブサイトのタイトルを表示するには、次のコードを使用してください。</h2>
<div>あなたが送信したメッセージは長すぎます。最大300文字まで送信できます。</div>
終わりました。ありがとうございました。
<p></p>
endif; 終わりループの内部では、「the_」で始まる一連のテンプレートタグを使用することができます。例えば：the_title()、the_content()、the_excerpt()、the_permalink()などを使って、現在の記事の各種情報を出力します。ループを理解し、自在に使いこなすことが、コンテンツ表示をカスタマイズするための基本です。
テーマのカスタマイズと高度な機能を実現
基本機能が整ったら、WordPressカスタマイザーやカスタム投稿タイプなどの高度な機能を活用して、テーマにさらなる機能性と柔軟性を加えることができます。
推薦図書 入門から上級者まで：プロフェッショナルレベルのWordPressテーマを作成するための完全な開発ガイド。
カスタマイザーでテーマオプションを追加
WordPressカスタマイザー（Customizer）は、リアルタイムでプレビューできる画面を提供し、ユーザーがテーマ設定を調整できるようにします。次の方法でfunctions.phpカスタマイザーにパネル、ブロック、設定項目を追加します。例えば、フッターに著作権表示テキストを追加するオプションを設けるといった具合です。
function my_theme_customize_register($wp_customize) {
// 添加一个区块
$wp_customize->add_section('my_theme_footer', array(
'title' => __('页脚设置', 'my-first-theme'),
'priority' => 30,
));
// 添加一个设置项
$wp_customize->add_setting('footer_copyright', array(
'default' => '',
'sanitize_callback' => 'sanitize_text_field',
));
// 为该设置项添加一个控件（输入框）
$wp_customize->add_control('footer_copyright', array(
'label' => __('页脚版权文本', 'my-first-theme'),
'section' => 'my_theme_footer',
'type' => 'text',
));
}
add_action('customize_register', 'my_theme_customize_register');そしてその後、footer.phpここでは、「使用」を使っています。get_theme_mod('footer_copyright')この値を出力してください。
カスタムの記事タイプと分類体系を作成する方法
製品、ポートフォリオ、チームなどの特別なコンテンツを表示する必要があるサイトでは、デフォルトの「投稿」や「固定ページ」だけでは不十分な場合があります。その場合は、カスタム投稿タイプ（CPT）やカスタムタクソノミーを作成できます。これは通常、プラグインまたは直接で行います。functions.phpここで使用されているのはregister_post_type()とregister_taxonomy()関数を使って実装できます。これにより、管理画面に独立したコンテンツ管理エリアを設け、そのための専用テンプレートファイルを作成できます。たとえばsingle-product.php。
概要
WordPressテーマ開発は、構造から機能へ、基礎から応用へと段階的に進むプロセスです。ローカル環境の構築や基本ファイルの作成から始まり、テンプレート階層やループの仕組みを深く理解し、さらに〜を通じてfunctions.php機能を拡張し、最後にカスタマイザーとカスタム投稿タイプを活用して高度なカスタマイズを実現します。各工程は密接につながっており、WordPressのコーディング標準とベストプラクティス（国際化やセキュリティなど）に従うことが重要です。この強力なテンプレートシステムを継続的に実践・探求することで、ゼロから機能性に優れ、独自性のあるデザインと高いパフォーマンスを備えたプロフェッショナルなWordPressテーマを構築できるようになります。
FAQ よくある質問
WordPressのテーマ開発にはPHPに精通しなければならないのでしょうか？
はい、PHPはWordPressの中核となるプログラミング言語であり、テーマ開発を深く進めるにはPHPの習得が不可欠です。基本的なPHPの構文、関数、条件分岐、ループを理解する必要があります。ただし、初心者であれば、既存のテーマの修正やテンプレートタグの活用から始め、実践を通じて少しずつPHPスキルを高めていくことができます。
私のテーマに多言語翻訳を追加するにはどうすればいいでしょうか？
テーマの国際化（i18n）対応を適切に準備する必要があります。コード内では、ユーザー向けのすべての文字列を WordPress の翻訳関数でラップしてください。たとえば__('文本', 'my-text-domain')またはesc_html_e('文本', 'my-text-domain')。必ずstyle.cssヘッダーのコメントと…load_theme_textdomain()関数呼び出し時に正しく設定することText Domain。その後、翻訳者はPoeditのようなツールを使って生成できます.poと.mo翻訳ファイル。
なぜ私のカスタムスタイルやスクリプトが読み込まれていないの？
这通常是因为没有正确使用WordPress的脚本和样式队列系统。请确保在functions.phpここで使用されているのはwp_enqueue_style()とwp_enqueue_script()函数来添加资源，并通过wp_enqueue_scriptsフックを使ってそれらを呼び出します。テンプレートファイル内で直接使用するのは避けてください<link>または<script>タグがハードコードされて導入されています。
主题开发中如何保证良好的安全性？
首要原则是：对所有来自用户或数据库的动态数据进行转义或清理后再输出。在输出HTML时，使用esc_html(), esc_attr(), esc_url()などの関数を使ってエスケープします。フォーム送信やカスタムオプションを処理する際は、次のようなデータ検証・サニタイズ関数を使用します。sanitize_text_field()。ユーザーの入力は決して信用しないでください。
自分のトピックにサブトピックを作成するにはどうすればいいですか？
新しいフォルダーを作成し、通常は親テーマ名に追加して名前を付けます-child例えば、twentytwentyfive-child。そのフォルダー内に1つ作成しますstyle.cssこのファイルについては、ヘッダー部分のコメントに以下の内容を必ず含めてください：Template: parent-theme-folder-nameこの行で親テーマを指定します。次に、子テーマのstyle.css上書き用のスタイルを記述するか、修正が必要な親テーマのテンプレートファイルを子テーマのディレクトリにコピーして編集してください。これは、安全なアップデートとテーマのカスタマイズに推奨される方法です。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語