wp_get_theme() の使い方｜説明・引数・注意点

説明

基本構文

wp_get_theme( string $stylesheet = '', string $theme_root = '' ): WP_Theme

引数

• $stylesheet：テーマのディレクトリ名（省略すると現在のテーマ）
• $theme_root：テーマのルートディレクトリ

戻り値

WP_Theme オブジェクト。

使い方（サンプル）

$theme = wp_get_theme();
$name = $theme->get( 'Name' );

注意点

• CSSやJSのバージョン指定に、テーマのバージョンを使うことがあります。
• get( 'Version' ) でバージョン番号を取得できます。

実務での使いどころ

• テーマの名前や、バージョン、作者などの情報を、取得するとき。
• CSSやJavaScriptの、バージョン（キャッシュの更新）に、テーマのバージョンを使うとき。

よくあるミスと対処

• $stylesheet を省略したときは、有効なテーマの情報が、返る。
• 存在しないテーマを指定しても、オブジェクトが、返る。exists() で、確認する。
• get( 'Version' ) など、項目名を、間違えている。

NG例

$theme = wp_get_theme( 'no-such-theme' );
echo $theme->get( 'Name' ); // 存在しないテーマでも、オブジェクトが返る

OK例

$theme = wp_get_theme();
$version = $theme->get( 'Version' );
wp_enqueue_style( 'my-style', get_stylesheet_uri(), array(), $version );

使い分け早見表

関連項目

get_template()、get_stylesheet()

公式リファレンス：wp_get_theme() | Function | WordPress Developer Resources