説明
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
関連
お勧め
query_posts（WP_Queryクラス）でカテゴリーを絞り込む（2011年9月14日 更新）
久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。the_date関数で投稿日を確実に表示する（2011年12月20日 更新）
投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）
Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。
ログアウト後はいつもサイトトップ（2018年5月27日 更新）
ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。
カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。