説明
bool current_theme_supports( string $feature [ , mixed $args ] )
テーマ機能を取得する。
パラメータ
- $feature'post-formats'、'post-thumbnails'、'html5'などのテーマ機能名を指定。
- $argsテーマ機能別の個別名を指定。
返り値
テーマ機能を登録されている場合はtrueを返す。登録されていなかった場合はfalseを返す。
注意
パラメータ$argsは省略可能で、$featureによってに意味が変わる。
| $feature | $argsの内容 |
|---|---|
| 'post-thumbnails' | 投稿タイプ名 |
| 'html5' | 設定時に指定される配列の内容のいずれか |
| 'post-formats' | |
| 'custom-logo' | 設定時に指定される連想配列のキーのいずれか |
| 'custom-header' | |
| 'custom-background' |
パラメータ$featureが'custom-header-uploads'の場合は、current_theme_supports( 'custom-header', 'uploads' ); となる。
使用例
- テーマ機能'title-tag'が設定されているか調べる。
<?php if ( current_theme_supports( 'title-tag' ) ) : ?> - テーマ機能'post-thumbnails'に投稿タイプ'page'が含まれているか調べる。
<?php if ( current_theme_supports( 'post-thumbnails', 'page' ) ) : ?> - テーマ機能'post-formats'に'audio'が含まれているか調べる。
<?php if ( current_theme_supports( 'post-formats', 'audio' ) ) : ?> - テーマ機能'custom-logo'の'width'が設定されているか調べる。
<?php if ( current_theme_supports( 'custom-logo', 'width' ) ) : ?>
フィルター
[3.4.0]第2パラメータが指定され、かつそれが有効な場合、値を返す直前で"current_theme_supports-{$feature}"フィルターを呼び出す。パラメータ$argsは本関数が受け取った内容が、$theme_featureには第1パラメータで指定されたテーマ機能の内容が格納されている。return apply_filters( "current_theme_supports-{$feature}", true, $args, $theme_feature );アクション
実行するアクションはありません。ソースファイル
/wp-includes/theme.php最終更新 : 2018年10月19日 16:39
関連
お勧め
wp_titleからwp_get_document_titleへ（2018年5月27日 更新）
先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。
ツイート引用が簡単になる仕組み（2012年6月8日 更新）
WordPress 3.4では、投稿記事の中にツイートのURLを記述するだけで、投稿ページにそれっぽい表示をしてくれるようになる。ちょっと気になったので、その仕組みを追っかけてみた。5.5の機能強化：テーマ変更時に要求バージョンを確認（2020年8月12日 更新）
WordPress 5.5 RC 2が公開され、来週には正式版がリリース。変更箇所が多い「WordPress 5.5 RC 2（以降RC 2）」のソースコードを眺めていると、テーマの切り替え前にWordPressとPHPのバージョンを確認するようになっていた。
サイトヘルス機能を使ってみた（2019年4月12日 更新）
先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2（以降5.2Beta2）が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。
ブロックエディターで編集したページが出力した余分な改行を削除（2019年2月22日 更新）
ブロックエディターで編集したページのHTMLソースは、投稿本文部分の改行が目立った。Webページとしての表示は問題ないのだが、データとしては不要なので削除することにした。