説明
パラメータ
- $fileファイル名を指定(省略時は'')。
返り値
テーマ内にあるファイルのパス名を返す。注意
パラメータ$fileが''の場合は、 get_stylesheet_directory関数で取得できるパス名が適用される(末尾に'/'は付かない)。
$fileが''以外の場合は、現在のテーマ内にそのファイルが存在するか調べ、存在する場合はそのファイルのパス名が適用される。現在のテーマが子テーマで現在のテーマ内にそのファイルが存在しない場合は、親テーマのファイルとみなし(存在確認はされない)そのパス名が適用される。
使用例
- テーマがあるディレクトリのパス名を取得する。
<?php $path = get_theme_file_path(); ?> - テーマ内にある「js/common.js」のパス名を取得する。
<?php $path = get_theme_file_path( 'js/common.js' ); ?>
フィルター
[4.7.0]パス名を返す前に'theme_file_path'フィルターを呼び出す。パラメータ$pathには適用したパス名が、$fileには本関数が受け取った内容が格納されている。return apply_filters( 'theme_file_path', $path, $file );アクション
実行するアクションはありません。ソースファイル
/wp-includes/link-template.php最終更新 : 2018年05月27日 10:44
関連
お勧め
標準で使用できる数少ないショートコード[caption]とは(2018年5月27日 更新)
画像をアップロードして「投稿に追加」ボタンをクリックすると、投稿記事内にリンク付きのimgタグか、ショートコードのが挿入される。ここではそれらの書式を整理する。WP_List_Tableクラスを使ってみた(2018年5月27日 更新)
WordPressの管理画面ではデータを一覧表示しているページがいくつもある。今回この仕組みを自分のプラグインでも使ってみたいと思い、調査しながらプラグインに組み込んでみた。
投稿ページでユニークなテンプレートを選択しよう(2018年5月27日 更新)
4.7の変更点に「投稿タイプテンプレート」がある。これは従来固定ページ('page')向けに任意のテンプレートを適用できる機能が拡張されたもので、投稿ページ('post')はもちろんカスタム投稿タイプのページにも適用可能になっている。
カスタムブロックを作っていると、ブロック自身の「サイズ」を指定するUIを持たせることがある。そんなときにちょっとモヤっとするのが、「マージン」や「パディング」の設定しているパネルのタイトルが「サイズ」なこと。この「サイズ」の原文は「Dimensions」であり、個人的にもう少しスッキリするワードに変更してみた。
管理画面でツールバー(Admin bar)を非表示にする(2013年3月5日 更新)
WordPress使ってちょっと変わったサイトを構築する際、管理画面のツールバーを表示させたくないケースがある。一般に公開するサイト側であれば、 show_admin_bar関数で非表示にできるのだが、管理画面ではこれを使ってもツールバーは消えてくれない。