WordPress のテーマフォルダ構成 主要なフォルダの役割とは?

こんにちは、阿久梨絵です!
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 テーマのカスタマイズや開発がスムーズになります!
阿久梨絵でした!

上部へスクロール
Verified by MonsterInsights