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

説明

基本構文

current_theme_supports( string $feature, mixed ...$args ): bool

引数

• $feature：機能名
• ...$args：追加の引数

戻り値

対応していれば true。

使い方（サンプル）

if ( current_theme_supports( 'post-thumbnails' ) ) {
	// アイキャッチ対応
}

注意点

• プラグインが、テーマの対応状況に合わせて動作を変えるときに使います。

実務での使いどころ

• テーマが、ある機能（アイキャッチ画像など）を、有効にしているかを、確認するとき。
• プラグインが、テーマの機能に、合わせて動作を変えるとき。

よくあるミスと対処

• after_setup_theme より前に呼び、まだ有効になっておらず false になる。
• 機能によって、引数が必要な場合がある（html5 の要素など）。引数なしでは、意図した判定にならない。
• 機能の名前を、間違えている。

NG例

if ( current_theme_supports( 'post-thumbnails' ) ) { // after_setup_theme より前に呼ぶと、false
	// ...
}

OK例

add_action( 'wp', function () {
	if ( current_theme_supports( 'post-thumbnails' ) ) {
		// ...
	}
} );

使い分け早見表

関連項目

add_theme_support()

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