こんにちは、阿久梨絵です!
WordPress のテーマフォルダには、さまざまなサブフォルダが格納されており、テーマの機能や管理を分割して整理しています。
特に admin や inc というフォルダは、多くのテーマで採用されており、それぞれ異なる役割を持っています。
この記事では、 WordPress のテーマフォルダ構成と、それぞれのディレクトリの用途について詳しく解説します。
WordPressテーマフォルダの基本構成
WordPressのテーマフォルダ(wp-content/themes/theme-name/)には、
以下のような一般的なファイル・フォルダが含まれています。
theme-name/
│── style.css ← テーマのメインスタイルシート
│── functions.php ← テーマの機能を定義するPHPファイル
│── header.php ← ヘッダー部分のテンプレート
│── footer.php ← フッター部分のテンプレート
│── index.php ← メインテンプレートファイル
│── inc/ ← 共通処理やカスタム関数を格納
│── admin/ ← 管理画面関連の設定ファイル
│── assets/ ← 画像・CSS・JSなどのリソース
│── template-parts/ ← テンプレートのパーツ(コンテンツやサイドバーなど)
│── languages/ ← 翻訳ファイル(theme-name.pot など)
│── woocommerce/ ← WooCommerce専用のテンプレート(ECサイト向け)
admin/ フォルダの役割
admin/ フォルダは、WordPressの 管理画面関連の処理 を格納するためのディレクトリです。
主に テーマの設定画面 を作成する場合に使用されます。
・テーマオプションページを作成
・管理画面のカスタマイズ
・カスタム設定フィールドの管理
・API連携やダッシュボード通知の追加
例:admin/options.php にテーマのカスタム設定を追加
add_action(‘admin_menu’, ‘my_theme_options’);
function my_theme_options() {
add_menu_page(
‘テーマ設定’,
‘テーマオプション’,
‘manage_options’,
‘theme-options’,
‘theme_options_page’
);
}
function theme_options_page() {
echo ‘<h1>テーマの設定画面</h1>’;
}
・add_menu_page() を使って、管理画面にカスタムメニューを追加
・theme-options ページが作成され、テーマの設定を行えるようになる
inc/ フォルダの役割
inc/ フォルダは、テーマ全体で共通して使われる機能や関数を格納 するためのディレクトリです。
WordPressテーマをモジュール化し、コードを整理するのに役立ちます。
・カスタムウィジェットの登録
・ショートコードの定義
・カスタム関数の整理
・ヘッダー・フッター・スクリプトの追加
例:inc/custom-functions.php にショートコードを追加
function my_custom_shortcode() {
return ‘<p>これはカスタムショートコードです。</p>’;
}
add_shortcode(‘custom_text’, ‘my_custom_shortcode’);
・[custom_text] を投稿やページで使うと、カスタムメッセージが表示される
その他のフォルダの管理方法
テーマによっては、以下のフォルダも使われます。
assets/(リソースファイル)
・画像、CSS、JavaScriptファイルを格納する
・wp_enqueue_style() や wp_enqueue_script() でリソースを読み込む
template-parts/(テンプレートの部品)
・get_template_part() を使って、ヘッダーやコンテンツの一部を呼び出す
・レイアウトを統一し、コードの管理を容易にする
woocommerce/(WooCommerce専用)
・WooCommerceサイト用のテンプレートを格納
・woocommerce.php でECページのデザインをカスタマイズ
まとめ
・admin/ フォルダ → WordPress の管理画面をカスタマイズするためのディレクトリ
・inc/ フォルダ → テーマ全体で使うカスタム関数や共通処理を格納するディレクトリ
・その他にも assets/ や template-parts/ など、テーマ構造を整理するフォルダが存在
このような構成を理解すると、 WordPress テーマのカスタマイズや開発がスムーズになります!
阿久梨絵でした!