テーマディレクトリのURLを取得します。子テーマ利用時は子テーマディレクトリのURLを取得します。
get_theme_file_uri($file);| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第1引数 $file | 任意 | テーマからのパスを文字列で指定初期値: ''(空の文字列) |
戻り値(返す値):有効化されているテーマディレクトリのURL(引数が指定されている場合はそこからのパスを含めたURL)を返します。
子テーマが有効な場合は、子テーマディレクトリのURLを返します。引数が指定されている場合は、子テーマディレクトリ内から優先してファイルの存在を確認します。(子テーマに指定のファイルがなければ親テーマ内で探す、という手順です。)
※表示するにはechoします。
echo get_theme_file_uri();結果例:https:example.com/wp-content/themes/my_theme
echo get_theme_file_uri('images/test.jpg');結果例:https:example.com/wp-content/themes/my_theme/images/test.jpg
【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
URLを無害化するテンプレートタグ esc_url() とあわせて使います。
<?php echo esc_url(get_theme_file_uri('/img/example.jpg')); ?>下記例ではテーマディレクトリ内に格納された任意の画像を表示します。
<img src="<?php echo esc_url(get_theme_file_uri('/img/example.jpg')); ?>" alt="">※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。