• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

プラグイン・コンテンツディレクトリを特定する

提供: WordPress Codex 日本語版
移動先: 案内検索

このページ「プラグイン・コンテンツディレクトリを特定する」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

WordPress プラグインのコードを書いている時、WordPress インストール内やプラグイン・テーマのさまざまなファイルやフォルダを参照しなくてはいけないことがよくあります。

WordPress は、あるファイルやディレクトリがどこにあるのかを簡単に判定できる関数をいくつか提供しています。プラグイン内で arwp-content ディレクトリへの参照を決め打ちで書いたり、WordPress 内部定数を使ったりする代わりに、常にこれらの関数を使うようにしましょう。

WordPress はユーザーが wp-content ディレクトリを好きな位置に置けるようにしているのを忘れないことが重要です。プラグインが wp-content/plugins ディレクトリに存在することや、アップロードファイルが wp-content/uploads に置かれていることや、テーマファイルが wp-content/themes の中にあることは絶対に前提にすべきではありません。

上記に関連しますが、PHP の __FILE__ マジック定数は symlink を自動的に解決するため、もし wp-contentwp-content/plugins、または個別のプラグインディレクトリが symlink で参照されている場合、これらの関数は正しく動作しません。

よくある使い方

If your plugin includes JavaScript files, CSS files or other external files, then it's likely you'll need the URL to these files so you can load them into the page. To do this you should use the plugins_url() function like so:

plugins_url( 'myscript.js', __FILE__ );

This will return the full URL to myscript.js, such as example.com/wp-content/plugins/myplugin/myscript.js.

To load your plugins' JavaScript or CSS into the page you should use wp_enqueue_script() or wp_enqueue_style() respectively, passing the result of plugins_url() as the file URL.

利用可能な関数

WordPress includes many other functions for determining paths and URLs to files or directories within plugins, themes, and WordPress itself. See the individual Codex pages for each function for complete information on their use.

プラグイン

plugins_url()
plugin_dir_url()
plugin_dir_path()
plugin_basename()

テーマ

get_template_directory_uri()
get_stylesheet_directory_uri()
get_stylesheet_uri()
get_theme_root_uri()
get_theme_root()
get_theme_roots()
get_stylesheet_directory()
get_template_directory()

サイトホーム

home_url()

WordPress

admin_url()
site_url()
content_url()
includes_url()
wp_upload_dir()

マルチサイト

get_admin_url()
get_home_url()
get_site_url()
network_admin_url()
network_site_url()
network_home_url()

定数

WordPress はコンテンツやプラグインディレクトリのへのパスを判定するために以下の定数を使います。これらはプラグインやテーマ内で直接使うべきではありませんが、情報の完全性を期するためにここへ記載します。

WP_CONTENT_DIR  // 最後のスラッシュなし、フルパスのみ
WP_CONTENT_URL  // フル URL
WP_PLUGIN_DIR  // フルパス、最後のスラッシュなし
WP_PLUGIN_URL  // フル URL、最後のスラッシュなし

// Available per default in MS, not set in single site install
// Can be used in single site installs (as usual: at your own risk)
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() /en インクルードディレクトリ URL http://www.example.com/wp-includes
content_url() /en コンテンツディレクトリ URL http://www.example.com/wp-content
plugins_url() /en プラグインディレクトリ URL http://www.example.com/wp-content/plugins
wp_upload_dir() /en アップロードディレクトリ URL (配列を返す) http://www.example.com/wp-content/uploads


最新英語版: WordPress Codex » Determining_Plugin_and_Content_Directories最新版との差分