一般的な使用法

プラグインにJavaScriptファイル、CSSファイル、またはその他の外部ファイルが含まれている場合、これらのファイルのURLが必要になる可能性があります。これを行うには、次のようにplugins_url()関数を使用します： 

  1. plugins_url( 'myscript.js', __FILE__ );

これにより、myscript.jsの完全なURLが返されます。例えばexample.com/wp-content/plugins/myplugin/myscript.jsのようになります。

プラグインのJavaScriptまたはCSSをページに読み込むには、それぞれwp_enqueue_script()またはwp_enqueue_style()を使用し、plugins_url()の結果をファイルURLとして渡します。

利用可能な関数

WordPressには、プラグイン、テーマ、およびWordPress自体内のファイルやディレクトリへのパスやURLを決定するための多くの他の関数が含まれています。各関数の使用に関する完全な情報については、個別のDevHubページを参照してください。

プラグイン

  1. plugins_url()
  2. plugin_dir_url()
  3. plugin_dir_path()
  4. plugin_basename()

テーマ

  1. get_template_directory_uri()
  2. get_stylesheet_directory_uri()
  3. get_stylesheet_uri()
  4. get_theme_root_uri()
  5. get_theme_root()
  6. get_theme_roots()
  7. get_stylesheet_directory()
  8. get_template_directory()

サイトホーム

  1. home_url()
  2. get_home_path()

WordPress

  1. admin_url()
  2. site_url()
  3. content_url()
  4. includes_url()
  5. wp_upload_dir()

マルチサイト

  1. get_admin_url()
  2. get_home_url()
  3. get_site_url()
  4. network_admin_url()
  5. network_site_url()
  6. network_home_url()

定数

WordPressは、コンテンツおよびプラグインディレクトリへのパスを決定する際に、以下の定数を使用します。これらはプラグインやテーマによって直接使用されるべきではありませんが、完全性のためにここにリストされています。 

  1. WP_CONTENT_DIR  // no trailing slash, full paths only
  2. WP_CONTENT_URL  // full url
  3. WP_PLUGIN_DIR  // full path, no trailing slash
  4. WP_PLUGIN_URL  // full url, no trailing slash
  6. // Available per default in MS, not set in single site install
  7. // Can be used in single site installs (as usual: at your own risk)
  8. UPLOADS // (If set, uploads folder, relative to ABSPATH) (for e.g.: /wp-content/uploads)

関連

WordPressディレクトリ:

home_url() ホームURL http://www.example.com
site_url() サイトディレクトリURL http://www.example.com または http://www.example.com/wordpress
admin_url() 管理ディレクトリURL http://www.example.com/wp-admin
includes_url() インクルードディレクトリURL http://www.example.com/wp-includes
content_url() コンテンツディレクトリURL http://www.example.com/wp-content
plugins_url() プラグインディレクトリURL http://www.example.com/wp-content/plugins
wp_upload_dir() アップロードディレクトリURL（配列を返す） http://www.example.com/wp-content/uploads