wp_get_theme

説明

WP_Theme wp_get_theme( [ string $stylesheet = null [ , string $theme_root = null ] ] )
テーマ情報(WP_Themeオブジェクト)を取得する。

パラメータ

  • $stylesheet
    テーマ名(ディレクトリ名)を指定(省略時はnull)。
  • $theme_root
    テーマのディレクトリ名を指定(省略時はnull)。

返り値

テーマ情報(WP_Themeオブジェクト)を返す。

注意

get_file_data関数を使ってテーマ情報を取得する代替方法として本関数を使用できる。なおテーマ情報を取得する関数としてget_theme_data関数(バージョン1.5.0~3.3.x)があったが、本関数の追加により非推奨になっている。

パラメータ$stylesheetが省略された場合は現在のテーマ情報が対象となる。

パラメータ$theme_rootは、標準のテーマディレクトリ(通常はWP_CONTENT_DIR . '/themes')以外のテーマを対象とする場合にそのパス名を指定する。


使用例

  • 現在のテーマ情報を取得する。
    <?php
    $theme = wp_get_theme();
    $theme_version = $theme->get( 'Version' );
    ?>
  • 'Twenty Seventeen'のテーマ情報を取得する。
    <?php $theme = wp_get_theme( 'twentyseventeen' ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/theme.php

最終更新 : 2017年09月06日 14:16



お勧め

初期状態で「抜粋」ウィジェットを表示する(2014年1月7日 更新)

投稿編集ページのウィジェットは標準で表示されるものとされないものがある。フォーラムに『投稿の編集画面にデフォルトで抜粋を表示させたい』という投稿があったので、ちょっと調べてみた。

親子の固定ページで同じテンプレートを使う(2013年3月20日 更新)

固定ページのテンプレートファイルは「page.php」か、ページ名(スラッグ)または投稿IDを指定したテンプレートファイルになる。固定ページでページデザインが数パターンある場合、通常は「page.php」で振り分けることになるが、もう少しスマートにできないか考えてみた。

全投稿を取得するのはnopaging=1でいい(2011年8月31日 更新)

query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?

HTML entities button:プラグイン作ってみました(2017年12月17日 更新)

以前投稿した「HTML編集モードに定型文ボタンを追加する」をアレンジして、HTML編集モードに特殊文字(HTMLエンティティ)を挿入できるボタン、顔文字を挿入できるボタン、過去の投稿ページのリンクを挿入できるボタンを追加するプラグインを作ってみました。HTML編集モードの作業効率を向上させるプラグインです。2.1.0では「Dashiconsの挿入」を追加しました。HTML編集モードをメインに使用されている方は、お試しあれ。

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目(2011年7月6日 更新)

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。