説明
plugin_dir_url() は、プラグインのディレクトリのURLを返す関数です。
基本構文
plugin_dir_url( string $file ): string引数
$file：プラグインのファイルパス（通常__FILE__）
戻り値
末尾にスラッシュ付きのディレクトリURL。
使い方（サンプル）
$url = plugin_dir_url( __FILE__ ) . 'assets/app.js';注意点
- 末尾にスラッシュが付きます。
実務での使いどころ
- プラグインの中の、CSSやJavaScript、画像のURLを作るとき。
- 定数として保持し、プラグイン全体で使い回すとき。
よくあるミスと対処
- パスが欲しいのに、これを使っている。この関数が返すのはURL。
requireにはplugin_dir_path()を使う。 - 引数に
__FILE__を渡し忘れる。 - 末尾に
/が付くことを忘れ、スラッシュが重なる。
NG例
wp_enqueue_script( 'my', plugin_dir_url( __FILE__ ) . '/js/a.js' ); // スラッシュが重なるOK例
wp_enqueue_script( 'my', plugin_dir_url( __FILE__ ) . 'js/a.js' );使い分け早見表
| 関数 | 返すもの |
|---|---|
plugin_dir_url() |
プラグインのフォルダのURL（末尾に / あり） |
plugin_dir_path() |
プラグインのフォルダのパス |
plugins_url() |
プラグインのファイルのURL |
関連項目
plugin_dir_path()、plugins_url()
公式リファレンス：plugin_dir_url() | Function | WordPress Developer Resources
コメント