get_stylesheet_directory

説明

string get_stylesheet_directory( )
現在のテーマ(スタイルシートがあるディレクトリ)のパス名を取得する。

パラメータ

パラメータはありません。

返り値

現在のテーマのスタイルシートがあるディレクトリのパス名を返す。

注意

末尾に'/'は付与されない。標準的なテーマの場合、このget_stylesheet_directory関数で取得できる値と、 get_template_directory関数で取得できる値は同じになるが、現在のテーマが子テーマの場合は異なるパスになる。そのため、確実に現在のテーマのパス名を取得する場合は、get_template_directory関数ではなく、get_stylesheet_directory関数を使う。

[6.4.0]本関数が呼び出しされた場合、返り値のパス名はグローバル変数$wp_stylesheet_pathに保持され、次回以降の呼び出しではその内容をすぐに返している。ただし'stylesheet'、'theme_root'、'stylesheet_directory'のいずれかのフィルターがある場合、グローバル変数$wp_stylesheet_pathは更新されない。

[6.4.2]6.4.0で導入されたパス名をグローバル変数$wp_stylesheet_pathに保持する仕組みが削除された。


使用例

  • 現在のテーマのスタイルシートがあるディレクトリのパス名を取得する。
    <?php $style_path = get_stylesheet_directory( ); ?>

フィルター

[1.5.0]'stylesheet_directory'フィルターを呼び出す。パラメータ$stylesheet_dirには現テーマのスタイルシートがあるディレクトリのパス名が、$stylesheetには get_stylesheet関数で取得した内容が、$theme_rootにはget_theme_root関数(パラメータは$stylesheet)で取得した内容が格納されている。
$stylesheet_dir = apply_filters( 'stylesheet_directory', $stylesheet_dir, $stylesheet, $theme_root );

アクション

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

ソースファイル

/wp-includes/theme.php

最終更新 : 2024年04月04日 12:52



お勧め

テキストエディタの文字を変更する(2018年5月27日 更新)

テキストエディタ(投稿ページの「テキスト」タブのエディタ)に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。

query_posts(WP_Queryクラス)でカスタムフィールドを使う(2011年9月15日 更新)

先週3回にわたってtax_queryパラメータを使ったカテゴリーや投稿タグ、投稿フォーマットの絞り込みを整理したが、その途中で目に付いたのが'meta_query'パラメータ。この'meta_query'パラメータは、カスタムフィールドの絞り込み条件を指定するためのもので、3.2で登場した新しいパラメータのようだ。

更新ボタンの横にスピナーを実装する(2019年5月14日 更新)

WordPressの管理画面ではAJAXを使って何らかの処理を行う際、数秒間の空き時間にアイコンがクルクル回る「スピナー」を表示しているところがある。今作っているプラグインでこの「スピナー」を使いたくなったので、実装方法を調べてみた。

公式ディレクトリに登録するならajax.googleapis.comのライブラリは利用しない(2018年5月27日 更新)

数日前、投稿一覧ページの絞り込みドロップダウンメニューを複数選択可能にするプラグイン「Posts filter multiselect」を公開したのですが、その際に指摘されたポイントを紹介します。

Login rebuilder 2.3.0の新機能を紹介(2018年5月27日 更新)

プラグイン「Login rebuilder」はログイン時の履歴(ログ)や不正なログインページへのアクセス履歴を保存している。これらの履歴情報はダッシュボートで確認できるが、バージョン2.3.0においてそれぞれがダウンロードできるようになった。