当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「プラグイン API/アクションフック一覧」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(2008年2月末の翻訳をen:Plugin_API/Action_Reference 2008年3月27日 21:06 Azaozz 版と比較し最新版として更新)
 
(save_post の説明を修正。)
 
(9人の利用者による、間の24版が非表示)
1行目: 1行目:
この記事は(おそらくほぼ完全な)アクションフックの一覧です。アクションフックは[[Version 2.1|バージョン2.1]] 以降から、プラグインおよびテーマ開発時に利用できるようになっています。詳しい情報については下記もご覧下さい。
+
WordPress [[Version 2.1|バージョン2.1]]以上で利用できるアクションフックの完全(だといいのですが)なリストです。詳しい情報については下記もご覧ください。
  
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧下さい。
+
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧ください。
* プラグインの書き方については、[[Writing a Plugin|プラグインの書き方]]/[[:en:Writing a Plugin|en]] をご覧下さい。
+
* プラグインの書き方については、[[プラグインの作成]] をご覧ください。
* フィルターフックの一覧リファレンスは、[[プラグイン API/フィルターフック一覧]]をご覧下さい。
+
* フィルターフックの一覧リファレンスは、[[プラグイン API/フィルターフック一覧]]をご覧ください。
* 他のバージョンのプラグインフックについては、[[:en:Plugin API/Hooks 2.0.x|Plugin API/Hooks 2.0.x]](en)をご覧下さい。
+
* 他のバージョンのプラグインフックについては、[[:en:Plugin API/Hooks 2.0.x|Plugin API/Hooks 2.0.x]](英語)をご覧ください。
  
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
 +
 +
== 一般的リクエスト中に実行されるアクション ==
 +
 +
以下は[[Version 3.3.1|バージョン 3.3.1]]でログインしているユーザーがホームページを表示したときに呼びだされるアクションです。この一覧には、各アクションが最初に呼び出される際のみの情報が含まれている可能性があり、多くの場合ではアクションにフックされている関数がない場合もあります。テーマやプラグインによってさらに違ったタイミングで何度かアクションが呼び出されることもあります。その証拠に、[http://wordpress.org/extend/themes/twentyeleven Twenty Eleven] テーマ特有のアクションコールも以下に見ることができます。また、Cron タスクもユーザーがサイトを訪問した際にアクションを実行することがあります。以下の一覧は明確なスペックではなくガイドラインまたは WordPress がアクションを実行する順序の大体の目安として参照してください。
 +
 +
アクションは <tt>[[関数リファレンス/do_action|do_action()]]</tt> 関数 で呼び出されます。ただし (参照配列) と書かれたものは <tt>[[関数リファレンス/do_action_ref_array|do_action_ref_array()]]</tt> 関数で呼び出されます。
 +
 +
{| class="widefat" style="border-spacing: 2em 0; vertical-align: top !important;"
 +
|-
 +
|style="width: 20em"|[[プラグイン_API/アクションフック一覧/muplugins_loaded|muplugins_loaded]] /[[:en:Plugin_API/Action_Reference/muplugins_loaded|en]]||must-use プラグインが読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/registered_taxonomy|registered_taxonomy]] /[[:en:Plugin_API/Action_Reference/registered_taxonomy|en]]||カテゴリー、post_tag など用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/registered_post_type|registered_post_type]] /[[:en:Plugin_API/Action_Reference/registered_post_type|en]]||投稿、固定ページなど用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/plugins_loaded|plugins_loaded]] /[[:en:Plugin_API/Action_Reference/plugins_loaded|en]]||有効なプラグインとプラガブルな関数が読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/sanitize_comment_cookies|sanitize_comment_cookies]] /[[:en:Plugin_API/Action_Reference/sanitize_comment_cookies|en]]||HTTPリクエストからCookieが読み取られた後に実行する
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/setup_theme|setup_theme]] /[[:en:Plugin_API/Action_Reference/setup_theme|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/load_textdomain|load_textdomain]] /[[:en:Plugin_API/Action_Reference/load_textdomain|en]]||<tt>default</tt> ドメイン用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/after_setup_theme|after_setup_theme]] /[[:en:Plugin_API/Action_Reference/after_setup_theme|en]]||通常、テーマ設定・オプションを初期化するために使われる。これは<strong>テーマで最初に使えるアクションフック</strong>であり、有効なテーマの ''functions.php'' ファイルが読み込まれた直後にトリガーされる。<tt>init</tt> アクションフックは一部の機能には遅すぎるため、<tt>add_theme_support()</tt> はここで呼び出されるべきである。この段階では、現在のユーザーに対する認証は行われていない。
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/auth_cookie_malformed|auth_cookie_malformed]] /[[:en:Plugin_API/Action_Reference/auth_cookie_malformed|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/auth_cookie_valid|auth_cookie_valid]] /[[:en:Plugin_API/Action_Reference/auth_cookie_valid|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/set_current_user|set_current_user]] /[[:en:Plugin_API/Action_Reference/set_current_user|en]]||デフォルトの wp_set_current_user 関数でユーザーが変更された後に実行する
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/init|init]] /[[:en:Plugin_API/Action_Reference/init|en]]||通常プラグインの初期化に使われる。この段階で現在のユーザーに対する認証は完了している。
 +
|-
 +
||└─ [[Plugin_API/Action_Reference/widgets_init|widgets_init]] /[[:en:Plugin_API/Action_Reference/widgets_init|en]]||サイドバーの登録に使われる。'init' の際に、優先順位「1」で、したがって優先順位「1」以上の他の 'init' アクションよりも前に、実行される。
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/register_sidebar|register_sidebar]] /[[:en:Plugin_API/Action_Reference/register_sidebar|en]]||各サイドバー、フッターエリア用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_register_sidebar_widget|wp_register_sidebar_widget]] /[[:en:Plugin_API/Action_Reference/wp_register_sidebar_widget|en]]||各ウィジェット用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_default_scripts|wp_default_scripts]] /[[:en:Plugin_API/Action_Reference/wp_default_scripts|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_default_styles|wp_default_styles]] /[[:en:Plugin_API/Action_Reference/wp_default_styles|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_bar_init|admin_bar_init]] /[[:en:Plugin_API/Action_Reference/admin_bar_init|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/add_admin_bar_menus|add_admin_bar_menus]] /[[:en:Plugin_API/Action_Reference/add_admin_bar_menus|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_loaded|wp_loaded]] /[[:en:Plugin_API/Action_Reference/wp_loaded|en]]||WordPress が完全に読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/parse_request|parse_request]] /[[:en:Plugin_API/Action_Reference/parse_request|en]]||リクエスト処理を変更できるようにする (参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/send_headers|send_headers]] /[[:en:Plugin_API/Action_Reference/send_headers|en]]||ヘッダーを変更できるようにする (参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/parse_query|parse_query]] /[[:en:Plugin_API/Action_Reference/parse_query|en]]||クエリ変数が設定された後 (参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/pre_get_posts|pre_get_posts]]||クエリが実行される前にクエリ変数オブジェクトを露出する (参照配列) 。
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/posts_selection|posts_selection]] /[[:en:Plugin_API/Action_Reference/posts_selection|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp|wp]] /[[:en:Plugin_API/Action_Reference/wp|en]]||WP オブジェクトが設定された後 (参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/template_redirect|template_redirect]] /[[:en:Plugin_API/Action_Reference/template_redirect|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_header|get_header]] /[[:en:Plugin_API/Action_Reference/get_header|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_enqueue_scripts|wp_enqueue_scripts]] /[[:en:Plugin_API/Action_Reference/wp_enqueue_scripts|en]]||
 +
|-
 +
|colspan="2"|twentyeleven_enqueue_color_scheme (Twenty Eleven 特有)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_head|wp_head]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_print_styles|wp_print_styles]] /[[:en:Plugin_API/Action_Reference/wp_print_styles|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_print_scripts|wp_print_scripts]] /[[:en:Plugin_API/Action_Reference/wp_print_scripts|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_search_form|get_search_form]] /[[:en:Plugin_API/Action_Reference/get_search_form|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/loop_start|loop_start]] /[[:en:Plugin_API/Action_Reference/loop_start|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/the_post|the_post]]||(参照配列) クエリの直後に投稿オブジェクトを変更できるようにする
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_template_part|get_template_part_content]] /[[:en:Plugin_API/Action_Reference/get_template_part_content|en]]||コンテンツのテンプレート部分
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/loop_end|loop_end]] /[[:en:Plugin_API/Action_Reference/loop_end|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_sidebar|get_sidebar]] /[[:en:Plugin_API/Action_Reference/get_sidebar|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/dynamic_sidebar|dynamic_sidebar]] /[[:en:Plugin_API/Action_Reference/dynamic_sidebar|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_search_form|get_search_form]] /[[:en:Plugin_API/Action_Reference/get_search_form|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/pre_get_comments|pre_get_comments]] /[[:en:Plugin_API/Action_Reference/pre_get_comments|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_meta|wp_meta]] /[[:en:Plugin_API/Action_Reference/wp_meta|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_footer|get_footer]] /[[:en:Plugin_API/Action_Reference/get_footer|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/get_sidebar|get_sidebar]] /[[:en:Plugin_API/Action_Reference/get_sidebar|en]]||
 +
|-
 +
||twentyeleven_credits||(Twenty Eleven 特有)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_footer|wp_footer]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_print_footer_scripts|wp_print_footer_scripts]] /[[:en:Plugin_API/Action_Reference/wp_print_footer_scripts|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_bar_menu|admin_bar_menu]] /[[:en:Plugin_API/Action_Reference/admin_bar_menu|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_before_admin_bar_render|wp_before_admin_bar_render]] /[[:en:Plugin_API/Action_Reference/wp_before_admin_bar_render|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_after_admin_bar_render|wp_after_admin_bar_render]] /[[:en:Plugin_API/Action_Reference/wp_after_admin_bar_render|en]]||
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/shutdown|shutdown]] /[[:en:Plugin_API/Action_Reference/shutdown|en]]||PHP の実行が終わりかけの時点
 +
|}
 +
 +
== 管理画面リクエスト中に実行されるアクション ==
 +
 +
以下は[[Version 3.3.1|バージョン 3.3.1]]でログインしているユーザーが管理画面の[[管理画面/投稿/投稿|投稿]]ページを表示したときに実行されるアクションです。この一覧には、アクションが最初に呼び出される際のみの情報が含まれています。表示している管理画面ページや使っているプラグインによって違ったアクションが呼び出されます。以下の一覧は明確なスペックではなく大体の目安として参照してください。
 +
 +
以下のアクションの <tt>(hookname)</tt> はページによって異なります。投稿ページでは ''edit.php''、テーマの背景ページでは <tt>appearance_page_custom-background</tt> になります。
 +
 +
アクションは <tt>[[関数リファレンス/do_action|do_action()]]</tt> 関数 で呼び出されます。ただし (参照配列) と書かれたものは <tt>[[関数リファレンス/do_action_ref_array|do_action_ref_array()]]</tt> 関数で呼び出されます。
 +
 +
{|style="border-spacing: 2em 0;"
 +
|-
 +
|style="width: 20em"|[[プラグイン_API/アクションフック一覧/muplugins_loaded|muplugins_loaded]] /[[:en:Plugin_API/Action_Reference/muplugins_loaded|en]]||must-use プラグインが読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/registered_taxonomy|registered_taxonomy]] /[[:en:Plugin_API/Action_Reference/registered_taxonomy|en]]||カテゴリー、post_tag など用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/registered_post_type|registered_post_type]] /[[:en:Plugin_API/Action_Reference/registered_post_type|en]]||投稿、固定ページなど用
 +
|-
 +
|valign="top"|[[Plugin_API/Action_Reference/plugins_loaded|plugins_loaded]] /[[:en:Plugin_API/Action_Reference/plugins_loaded|en]]||有効なプラグインとプラガブルな関数が読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/sanitize_comment_cookies|sanitize_comment_cookies]] /[[:en:Plugin_API/Action_Reference/sanitize_comment_cookies|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/setup_theme|setup_theme]] /[[:en:Plugin_API/Action_Reference/setup_theme|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/load_textdomain|load_textdomain]] /[[:en:Plugin_API/Action_Reference/load_textdomain|en]]||<tt>default</tt> ドメイン用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/after_setup_theme|after_setup_theme]] /[[:en:Plugin_API/Action_Reference/after_setup_theme|en]]||この段階では現在のユーザーに対する認証は行われていない
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/load_textdomain|load_textdomain]] /[[:en:Plugin_API/Action_Reference/load_textdomain|en]]||<tt>twentyeleven</tt> ドメイン用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/auth_cookie_valid|auth_cookie_valid]] /[[:en:Plugin_API/Action_Reference/auth_cookie_valid|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/set_current_user|set_current_user]] /[[:en:Plugin_API/Action_Reference/set_current_user|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/init|init]] /[[:en:Plugin_API/Action_Reference/init|en]]||通常プラグインの初期化に使われる。この段階で現在のユーザーに対する認証は完了している。
 +
|-
 +
||└─ [[Plugin_API/Action_Reference/widgets_init|widgets_init]] /[[:en:Plugin_API/Action_Reference/widgets_init|en]]||サイドバーの登録に使われる。'init' の際に、優先順位「1」で実行される。
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/register_sidebar|register_sidebar]] /[[:en:Plugin_API/Action_Reference/register_sidebar|en]]||各サイドバー用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_register_sidebar_widget|wp_register_sidebar_widget]] /[[:en:Plugin_API/Action_Reference/wp_register_sidebar_widget|en]]||各ウィジェット用
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_default_scripts|wp_default_scripts]] /[[:en:Plugin_API/Action_Reference/wp_default_scripts|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_default_styles|wp_default_styles]] /[[:en:Plugin_API/Action_Reference/wp_default_styles|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_bar_init|admin_bar_init]] /[[:en:Plugin_API/Action_Reference/admin_bar_init|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/add_admin_bar_menus|add_admin_bar_menus]] /[[:en:Plugin_API/Action_Reference/add_admin_bar_menus|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_loaded|wp_loaded]] /[[:en:Plugin_API/Action_Reference/wp_loaded|en]]||WordPress が完全に読み込まれた後
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/auth_cookie_valid|auth_cookie_valid]] /[[:en:Plugin_API/Action_Reference/auth_cookie_valid|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/auth_redirect|auth_redirect]] /[[:en:Plugin_API/Action_Reference/auth_redirect|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/_admin_menu|_admin_menu]] /[[:en:Plugin_API/Action_Reference/_admin_menu|en]]||[[プラグイン_API/アクションフック一覧/_user_admin_menu|_user_admin_menu]] /[[:en:Plugin_API/Action_Reference/_user_admin_menu|en]], [[プラグイン_API/アクションフック一覧/_network_admin_menu|_network_admin_menu]] /[[:en:Plugin_API/Action_Reference/_network_admin_menu|en]] も参照
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_menu|admin_menu]] /[[:en:Plugin_API/Action_Reference/admin_menu|en]]||[[プラグイン_API/アクションフック一覧/user_admin_menu|user_admin_menu]] /[[:en:Plugin_API/Action_Reference/user_admin_menu|en]], [[プラグイン_API/アクションフック一覧/network_admin_menu|network_admin_menu]] /[[:en:Plugin_API/Action_Reference/network_admin_menu|en]] も参照
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_init|admin_init]] /[[:en:Plugin_API/Action_Reference/admin_init|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/current_screen|current_screen]] /[[:en:Plugin_API/Action_Reference/current_screen|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/load-(page)|load-(page)]] /[[:en:Plugin_API/Action_Reference/load-(page)|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/send_headers|send_headers]] /[[:en:Plugin_API/Action_Reference/send_headers|en]]||カスタム HTTP ヘッダーを追加できる部分
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/pre_get_posts|pre_get_posts]]||クエリが実行される前にクエリ変数オブジェクトを露出する (参照配列) 。
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/posts_selection|posts_selection]] /[[:en:Plugin_API/Action_Reference/posts_selection|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp|wp]] /[[:en:Plugin_API/Action_Reference/wp|en]]||WP オブジェクトが設定された後 (参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_xml_ns|admin_xml_ns]] /[[:en:Plugin_API/Action_Reference/admin_xml_ns|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_enqueue_scripts|admin_enqueue_scripts]] /[[:en:Plugin_API/Action_Reference/admin_enqueue_scripts|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_print_styles-(hookname)|admin_print_styles-(hookname)]] /[[:en:Plugin_API/Action_Reference/admin_print_styles-(hookname)|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_print_styles|admin_print_styles]] /[[:en:Plugin_API/Action_Reference/admin_print_styles|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_print_scripts-(hookname)|admin_print_scripts-(hookname)]] /[[:en:Plugin_API/Action_Reference/admin_print_scripts-(hookname)|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_print_scripts|admin_print_scripts]] /[[:en:Plugin_API/Action_Reference/admin_print_scripts|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_print_scripts|wp_print_scripts]] /[[:en:Plugin_API/Action_Reference/wp_print_scripts|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_head-(hookname)|admin_head-(hookname)]] /[[:en:Plugin_API/Action_Reference/admin_head-(hookname)|en]]||管理画面の任意のページが開かれたとき
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_head|admin_head]] /[[:en:Plugin_API/Action_Reference/admin_head|en]]||管理画面を開いたとき
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/adminmenu|adminmenu]] /[[:en:Plugin_API/Action_Reference/adminmenu|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/in_admin_header|in_admin_header]] /[[:en:Plugin_API/Action_Reference/in_admin_header|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_notices|admin_notices]] /[[:en:Plugin_API/Action_Reference/admin_notices|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/all_admin_notices|all_admin_notices]] /[[:en:Plugin_API/Action_Reference/all_admin_notices|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/(hookname)|(hookname)]] /[[:en:Plugin_API/Action_Reference/(hookname)|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/restrict_manage_posts|restrict_manage_posts]] /[[:en:Plugin_API/Action_Reference/restrict_manage_posts|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/the_post|the_post]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/pre_user_query|pre_user_query]] /[[:en:Plugin_API/Action_Reference/pre_user_query|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/in_admin_footer|in_admin_footer]] /[[:en:Plugin_API/Action_Reference/in_admin_footer|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_footer|admin_footer]] /[[:en:Plugin_API/Action_Reference/admin_footer|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_bar_menu|admin_bar_menu]] /[[:en:Plugin_API/Action_Reference/admin_bar_menu|en]]||(参照配列)
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_before_admin_bar_render|wp_before_admin_bar_render]] /[[:en:Plugin_API/Action_Reference/wp_before_admin_bar_render|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_after_admin_bar_render|wp_after_admin_bar_render]] /[[:en:Plugin_API/Action_Reference/wp_after_admin_bar_render|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_print_footer_scripts|admin_print_footer_scripts]] /[[:en:Plugin_API/Action_Reference/admin_print_footer_scripts|en]]
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/admin_footer-(hookname)|admin_footer-(hookname)]] /[[:en:Plugin_API/Action_Reference/admin_footer-(hookname)|en]]||管理画面フッター
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/shutdown|shutdown]] /[[:en:Plugin_API/Action_Reference/shutdown|en]]||PHP の実行が終わりかけの時点
 +
|-
 +
||[[プラグイン_API/アクションフック一覧/wp_dashboard_setup|wp_dashboard_setup]] /[[:en:Plugin_API/Action_Reference/wp_dashboard_setup|en]]||管理画面のカスタマイズができるようにする
 +
|}
 +
 +
 +
=== タクソノミーとターム ===
 +
 +
;[[Plugin_API/アクションフック一覧/edit_terms|edit_terms]] : (actually an action, but often used like a filter) hooked in prior to saving taxonomy/category change in the database
 +
 +
;[[Plugin_API/アクションフック一覧/edited_terms|edited_terms]] : applied after saving taxonomy/category change in the database.
 +
 +
;[[Plugin_API/アクションフック一覧/edited_$taxonomy|edited_$taxonomy]] : applied after saving specific taxonomy change in the database
  
 
== 投稿、ページ、添付ファイル、カテゴリー関連のアクション ==
 
== 投稿、ページ、添付ファイル、カテゴリー関連のアクション ==
  
; add_attachment
+
;[[プラグイン_API/アクションフック一覧/post_submitbox_misc_actions|post_submitbox_misc_actions]] / [[:en:Plugin_API/Action_Reference/post_submitbox_misc_actions|en]]
: アクション関数引数: 添付ファイルID
+
: 「公開」ボタンのある Submit ボックスにフィールドなどのコンテンツの追加のため、編集ページが生成される際に実行する。
 +
: アクション関数引数: なし
 +
 
 +
;[[プラグイン_API/アクションフック一覧/add_attachment|add_attachment]]  / [[:en:Plugin_API/Action_Reference/add_attachment|en]]
 
: データベースに添付ファイルが新規追加された際に実行する。
 
: データベースに添付ファイルが新規追加された際に実行する。
+
: アクション関数引数: 添付ファイル ID
; add_category<br />create_category
+
 
: アクション関数引数: カテゴリーID
+
;[[プラグイン_API/アクションフック一覧/add_category|add_category]](非推奨)
 +
: <tt>create_category</tt> と同様。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/category_add_form_fields|category_add_form_fields]]
 +
: 管理画面でカテゴリー追加フォームが作成される際に実行する。このフォーム の Submit ボタンの前にフィールドを追加する場合に有用。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/category_edit_form|category_edit_form]]
 +
: 管理画面でカテゴリー編集フォームが作成される際に実行する。このフォームに新しいフィールドを追加する場合に有用。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/clean_post_cache|clean_post_cache]] / [[:en:Function_Reference/clean_post_cache|en]]
 +
: 投稿キャッシュのクリア後に実行する。[[関数リファレンス/clean_post_cache|<tt>clean_post_cache()</tt>]] /[[:en:Function_Reference/clean_post_cache|en]] を参照。
 +
: アクション関数引数: 投稿 ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧/create_category|create_category]]
 
: カテゴリーが新規作成された際に実行する。
 
: カテゴリーが新規作成された際に実行する。
 +
: アクション関数引数: カテゴリー ID
  
; delete_attachment
+
;[[プラグイン_API/アクションフック一覧/delete_attachment|delete_attachment]] / [[:en:Plugin_API/Action_Reference/delete_attachment|en]]
: アクション関数引数: 添付ファイルID
+
: データベースから添付ファイルが削除される直前に実行する。
: データベースから添付ファイルが削除された直後に実行する。
+
: アクション関数引数: 添付ファイル ID
  
; delete_category
+
;[[プラグイン_API/アクションフック一覧/delete_category|delete_category]]
: アクション関数引数: カテゴリーID
+
: データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除される前に実行する(バージョン 2.8 以前では、このフックは添付ファイルが削除された後に実行されていた) 。
: データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除された後に実行する。
+
: アクション関数引数: カテゴリー ID
  
; delete_post
+
;[[プラグイン_API/アクションフック一覧/trash_post|trash_post]] / [[:en:Plugin_API/Action_Reference/trash_post|en]]
: 投稿記事またはページが削除される直前に実行する。
+
: 投稿またはページがゴミ箱に移動されようとする際に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID
  
; edit_attachment
+
;[[プラグイン_API/アクションフック一覧/trashed_post|trashed_post]] / [https://developer.wordpress.org/reference/hooks/trashed_post/ en]
: アクション関数引数: 添付ファイルID
+
: 投稿またはページがゴミ箱に移動された後に実行する。
 +
: アクション関数引数: 投稿 ID またはページ
 +
 
 +
;[[プラグイン_API/アクションフック一覧/untrash_post|untrash_post]] / [[:en:Plugin_API/Action_Reference/untrash_post|en]]
 +
: 投稿またはページがゴミ箱から復元される前に実行する。
 +
: アクション関数引数: 投稿 ID またはページ
 +
 
 +
;[[プラグイン_API/アクションフック一覧/untrashed_post|untrashed_post]] / [https://developer.wordpress.org/reference/hooks/untrashed_post/ en]
 +
: 投稿またはページがゴミ箱から復元された後に実行する。
 +
: アクション関数引数: 投稿 ID またはページ
 +
 
 +
;[[プラグイン_API/アクションフック一覧/before_delete_post|before_delete_post]] / [[:en:Plugin_API/Action_Reference/before_delete_post|en]]
 +
: 投稿またはページが削除されようとする際に実行する。コメント、添付ファイル、メタ情報はまだ利用できる。
 +
: アクション関数引数: 投稿 ID またはページ
 +
 
 +
;[[プラグイン_API/アクションフック一覧/delete_post|delete_post]] / [[:en:Plugin_API/Action_Reference/delete_post|en]]
 +
: 投稿またはページが削除されようとする際に実行する。コメント、添付ファイル、メタ情報はすでに削除されている。
 +
: アクション関数引数: 投稿 ID またはページ
 +
 
 +
;[[プラグイン_API/アクションフック一覧/deleted_post|deleted_post]] / [https://developer.wordpress.org/reference/hooks/deleted_post/ en]
 +
: 投稿またはページが削除された直後に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧/edit_attachment|edit_attachment]] / [https://developer.wordpress.org/reference/hooks/edit_attachment-4/ en]
 
: データベースで添付ファイル情報が編集・更新された際に実行する。
 
: データベースで添付ファイル情報が編集・更新された際に実行する。
 +
: アクション関数引数: 添付ファイル ID
 +
 +
;[[プラグイン_API/アクションフック一覧/edit_category|edit_category]]
 +
: カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する投稿やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
 +
: アクション関数引数: カテゴリー ID
 +
 +
;[[プラグイン_API/アクションフック一覧/edit_post|edit_post]] / [[:en:Function_Reference/edit_post|en]]
 +
: 投稿またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
 +
: アクション関数引数: 投稿 ID またはページ ID
 +
 +
;[[プラグイン_API/アクションフック一覧/pre_post_update|pre_post_update]] / [[:en:Plugin_API/Action_Reference/pre_post_update|en]]
 +
: 投稿またはページが更新される直前に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID
 +
 +
;[[プラグイン_API/アクションフック一覧/post_updated|post_updated]] / [[:en:Plugin_API/Action_Reference/post_updated|en]]
 +
: 投稿または固定ページが更新された後に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID、変更前、および変更後の投稿の [[クラスリファレンス/WP_Post|WP_Post]] オブジェクト
 +
 +
;[[プラグイン_API/アクションフック一覧/transition_post_status|transition_post_status ]] /[[:en:Function_Reference/_transition_post_status|en ]]
 +
: 投稿ステータスの遷移が発生する際に実行する。
 +
: アクション関数引数: <tt>$new_status</tt>、<tt>$old_status</tt>、<tt>$post</tt> オブジェクト ([[Post Status Transitions]]参照)。
 +
 +
;[[プラグイン_API/アクションフック一覧/(old_status)_to_(new_status)|(old status)_to_(new status)]]
 +
: 投稿ステータスが <tt>$old_status</tt> から <tt>$new_status</tt> に変わる際に実行する。
 +
: アクション関数引数: <tt>$post</tt> オブジェクト ([[Post Status Transitions]]参照)。
  
; edit_category
+
;[[プラグイン_API/アクションフック一覧/(status)_(post_type)|(status)_(post_type)]]
: アクション関数引数: カテゴリーID
+
: タイプ <tt>$post_type</tt> の投稿が、<tt>$status</tt> に他のステータスから遷移した際に実行する。
: カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する記事やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
+
: アクション関数引数: 投稿 ID、<tt>$post</tt> オブジェクト ([[Post Status Transitions]]参照)。
  
; edit_post
+
;[[プラグイン_API/アクションフック一覧/publish_post|publish_post]]  / [[:en:Plugin_API/Action_Reference/publish_post|en]] (非推奨ではない)
: アクション関数引数: 投稿記事IDまたはページID
+
: 投稿が公開された際、または編集されてステータスが「公開済み」に変わった際に実行する。このアクションフックは [[プラグイン_API/アクションフック一覧/(status)_(post_type)|(status)_(post_type)]] アクションフックタイプと同じ。
: 投稿記事またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
+
: アクション関数引数: 投稿 ID、<tt>$post</tt> オブジェクト ([[Post Status Transitions]]参照)。
  
; private_to_published
+
;[[プラグイン_API/アクションフック一覧/publish_page|publish_page]] / [[:en:Plugin_API/Action_Reference/publish_page|en]]
: アクション関数引数: 投稿記事ID
+
: 固定ページが公開された際、または編集されてステータスが「公開済み」に変わった際に実行する。このアクションフックは[[プラグイン_API/アクションフック一覧/(status)_(post_type)|(status)_(post_type)]] アクションフックタイプと同じ。
: 投稿記事のステータスが非公開か公開へ変更された際に実行する。
+
: アクション関数引数: 投稿 ID、<tt>$post</tt> オブジェクト ([[Post Status Transitions]]参照)。
  
; publish_page
+
;[[プラグイン_API/アクションフック一覧/publish_phone|publish_phone]] / [https://developer.wordpress.org/reference/hooks/publish_phone/ en]
: アクション関数引数: ページID
+
: メールから投稿が公開された直後に実行する。
: 記事・ページが公開された際、またはステータスが「公開」に変更された場合に実行する。
+
: アクション関数引数: 投稿 ID
: 注:バージョン2.3以上ではこのフックの代わりにtransition_post_statusを使用する。
+
  
; publish_phone
+
;[[プラグイン_API/アクションフック一覧/publish_future_post|publish_future_post]] / [[:en:Plugin_API/Action_Reference/publish_future_post|en]]
: アクション関数引数: 投稿記事ID
+
: 予約投稿またはページが公開された際に実行する。
: メールから記事が投稿された直後に実行する。
+
: アクション関数引数: 投稿 ID
  
; publish_post
+
;[[プラグイン_API/アクションフック一覧/save_post|save_post]] / [[:en:Plugin_API/Action_Reference/save_post|en]]
: アクション関数引数: 投稿記事ID
+
: インポート機能の利用、投稿・ページ編集フォームの利用、XMLRPC での投稿、メールでの投稿のうちいずれかの方法で投稿・ページが作成・更新された際に実行する。実行されるタイミングはデータがデータベースに保存された後。
: 投稿記事が公開された際、または公開済みの記事の情報が編集された際に実行する。
+
: アクション関数引数: 投稿 ID, WP_Post オブジェクト, 真偽値(更新かどうか)
 +
: 投稿 ID は最後に保存した投稿ではなく投稿履歴を参照していることもある。実際の投稿の ID を取得するには、<tt>[[関数リファレンス/wp_is_post_revision()|wp_is_post_revision]]</tt> /[[:en:Function Reference/wp_is_post_revision|en]] を使う。
  
; save_post
+
;[[プラグイン_API/アクションフック一覧/updated_postmeta|updated_postmeta]] / [https://developer.wordpress.org/reference/hooks/updated_postmeta/ en]
: アクション関数引数: 投稿記事ID
+
: メタ情報が更新された際に実行する。
: インポート機能の利用、記事・ページ編集フォームの利用、XMLRPCでの投稿、メールでの投稿のうちいずれかの方法で記事・ページが作成・更新された際に実行する。
+
  
; wp_insert_post  
+
;[[プラグイン_API/アクションフック一覧/wp_insert_post|wp_insert_post]] / [[:en:Plugin_API/Action_Reference/wp_insert_post|en]]
: 動作はsave_postと同じ。save_postの直後に実行する。
+
: 動作はsave_postと同じ。<code>save_post</code> の直後に実行する。
  
; xmlrpc_publish_post
+
;[[プラグイン_API/アクションフック一覧/xmlrpc_publish_post|xmlrpc_publish_post]] / [https://developer.wordpress.org/reference/hooks/xmlrpc_publish_post/ en]
: アクション関数引数: 投稿記事ID
+
: XMLRPC リクエストによる投稿が作成された際、または XMLRPC を通してステータスが「公開」に変更された際に実行する。
: XMLRPCリクエストによる記事が投稿された際、またはXMLRPCを通してステータスが「公開」に変更された際に実行する。
+
: アクション関数引数: 投稿 ID
  
 
== コメント、ピンバック、トラックバック関連のアクション ==
 
== コメント、ピンバック、トラックバック関連のアクション ==
  
; comment_closed
+
;[[プラグイン_API/アクションフック一覧/comment_closed|comment_closed]]
: アクション関数引数: 投稿記事ID
+
: コメントを受け付けない指定をした投稿で、コメント送信フォームを表示しようとする際に実行する。
: コメントを受け付けない指定をした記事で、コメント送信フォームを表示しようとする際に実行する。
+
: アクション関数引数: 投稿 ID
  
; comment_id_not_found  
+
;[[プラグイン_API/アクションフック一覧/comment_id_not_found|comment_id_not_found]]
: アクション関数引数: 投稿記事ID
+
: コメント送信フォームを表示しようとする際、投稿 ID が見つからなかった場合に実行する。
: コメント送信フォームを表示しようとする際、投稿記事IDが見つからなかった場合に実行する。
+
: アクション関数引数: 投稿 ID
  
; comment_flood_trigger
+
;[[プラグイン_API/アクションフック一覧/comment_flood_trigger|comment_flood_trigger]]
: アクション関数引数: 前回のコメント送信日時、今回のコメント送信日時
+
 
: 連続コメントエラーが検出された際、wp_dieが呼び出されてコメントを拒否する直前に実行する。  
 
: 連続コメントエラーが検出された際、wp_dieが呼び出されてコメントを拒否する直前に実行する。  
 +
: アクション関数引数: 前回のコメント送信日時、今回のコメント送信日時
  
; comment_on_draft
+
;[[プラグイン_API/アクションフック一覧/comment_(old status)_to_(new status)|comment_(old status)_to_(new status)]] / [[:en:Plugin_API/Action_Reference/comment_(old status)_to_(new status)|en]]
: アクション関数引数: 投稿記事ID
+
: コメントステータスの遷移が発生した際に実行する。
: コメント投稿フォームまたはコメントを表示しようとしている際、記事が非公開状態の場合に実行する。
+
: アクション関数引数: コメントオブジェクト
  
; comment_post
+
;[[プラグイン_API/アクションフック一覧/comment_on_draft|comment_on_draft]]
: アクション関数引数: コメントID、承認ステータス(spam/スパム、0/未承認、1/承認済み)
+
: コメント投稿フォームまたはコメントを表示しようとしている際、投稿が非公開状態の場合に実行する。
 +
: アクション関数引数: 投稿 ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧/comment_post|comment_post]] / [[:en:Plugin_API/Action_Reference/comment_post|en]]
 
: コメントがデータベースに保存される直前に実行する。
 
: コメントがデータベースに保存される直前に実行する。
 +
: アクション関数引数: コメント ID、承認ステータス(spam/スパム、0/未承認、1/承認済み)
  
; edit_comment
+
;[[プラグイン_API/アクションフック一覧/edit_comment|edit_comment]]
: アクション関数引数: コメントID
+
 
: データベース内でコメントが編集・更新された後に実行する。
 
: データベース内でコメントが編集・更新された後に実行する。
 +
: アクション関数引数: コメント ID
  
; delete_comment
+
;[[プラグイン_API/アクションフック一覧/delete_comment|delete_comment]]
: アクション関数引数: コメントID
+
 
: コメントが削除される直前に実行する。
 
: コメントが削除される直前に実行する。
 +
: アクション関数引数: コメント ID
  
; pingback_post
+
;[[プラグイン_API/アクションフック一覧deleted_comment|deleted_comment]]
: アクション関数引数: コメントID
+
: コメントが削除された直後に実行する。
: ピンバックが投稿記事に追加された際に実行する。
+
: アクション関数引数: コメント ID
  
; pre_ping
+
;[[プラグイン_API/アクションフック一覧trash_comment|trash_comment]]
: アクション関数引数: 処理する投稿記事リンクの配列、記事のピンバック受け付け設定
+
: コメントがゴミ箱に移動される直前に実行する。
 +
: アクション関数引数: コメント ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧trashed_comment|trashed_comment]]
 +
: コメントがゴミ箱に移動された直後に実行する。
 +
: アクション関数引数: コメント ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧unspam_comment|comment_closed]]
 +
: コメントが非スパムとしてマークされた際に実行する。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/pingback_post|pingback_post]]
 +
: ピンバックが投稿に追加された際に実行する。
 +
: アクション関数引数: コメント ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧/pre_ping|pre_ping]]
 
: ピンバックが完全に処理される前に実行する。
 
: ピンバックが完全に処理される前に実行する。
 +
: アクション関数引数: 処理する投稿リンクの配列、投稿のピンバック受け付け設定
  
; trackback_post
+
;[[プラグイン_API/アクションフック一覧/trackback_post|trackback_post]]
: アクション関数引数: コメントID
+
: 投稿にトラックバックが追加された際に実行する。
: 投稿記事にトラックバックが追加された際に実行する。
+
: アクション関数引数: コメント ID
  
; wp_blacklist_check
+
;[[プラグイン_API/アクションフック一覧/wp_blacklist_check|wp_blacklist_check]]
: アクション関数引数: 投稿者名、投稿者メールアドレス、投稿者URL、コメント本文、投稿者のIPアドレス、投稿者のユーザーエージェント情報
+
 
: コメントをブラックリストに分類するかどうかチェックするために実行する。コメントを拒否するには、関数内でwp_dieを実行するか、入力引数に設定したブラックリストキーワードが含まれるように変更することができる。
 
: コメントをブラックリストに分類するかどうかチェックするために実行する。コメントを拒否するには、関数内でwp_dieを実行するか、入力引数に設定したブラックリストキーワードが含まれるように変更することができる。
 +
: アクション関数引数: 投稿者名、投稿者メールアドレス、投稿者URL、コメント本文、投稿者のIPアドレス、投稿者のユーザーエージェント情報
 +
 +
;[[プラグイン_API/アクションフック一覧/wp_insert_comment|wp_insert_comment]] / [[:en:Plugin_API/Action_Reference/wp_insert_comment|en]]
 +
: コメントが作成された際に実行する。
  
; wp_set_comment_status
+
;[[プラグイン_API/アクションフック一覧/wp_set_comment_status|wp_set_comment_status]]
: アクション関数引数: コメントID、変更後のステータスを表す文字列(delete/approve/spam/hold)
+
 
: コメントのステータスが変更された際に実行する。
 
: コメントのステータスが変更された際に実行する。
 +
: アクション関数引数: コメント ID、変更後のステータスを表す文字列(delete/approve/spam/hold)
  
 
== リンク集関連のアクション ==
 
== リンク集関連のアクション ==
  
; add_link
+
; [[プラグイン_API/アクションフック一覧/add_link|add_link]]
: アクション関数引数: リンクID
+
 
: リンク集にリンク項目が新規追加された際に実行する。
 
: リンク集にリンク項目が新規追加された際に実行する。
 +
: アクション関数引数: リンク ID
  
; delete_link
+
; [[プラグイン_API/アクションフック一覧/delete_link|delete_link]]
: アクション関数引数: リンクID
+
 
: リンク集からリンク項目が削除された際に実行する。
 
: リンク集からリンク項目が削除された際に実行する。
 +
: アクション関数引数: リンク ID
  
; edit_link
+
; [[プラグイン_API/アクションフック一覧/edit_link|edit_link]]
: アクション関数引数: リンクID
+
 
: リンク集のリンク項目が編集された際に実行する。
 
: リンク集のリンク項目が編集された際に実行する。
 +
: アクション関数引数: リンク ID
  
 
== フィード関連のアクション ==
 
== フィード関連のアクション ==
  
; atom_entry(Atomフィード)
+
; [[プラグイン_API/アクションフック一覧/atom_entry|atom_entry]] (Atom フィード)
; rdf_item(RDFフィード)
+
; [[プラグイン_API/アクションフック一覧/rdf_item|rdf_item]](RDF フィード)
; rss_item (RSSフィード)
+
; [[プラグイン_API/アクションフック一覧/rss_item|rss_item]](RSS フィード)
; rss2_item (RSS2フィード)
+
; [[プラグイン_API/アクションフック一覧/rss2_item|rss2_item]](RSS2 フィード)
: 各フィードで投稿記事情報が表示された直後、entryタグを閉じる前に実行する。
+
: 各フィードで投稿情報が表示された直後、entry または item タグを閉じる前に実行する。
  
; atom_head(Atomフィード)
+
; [[プラグイン_API/アクションフック一覧/atom_head|atom_head]] (Atom フィード)
; rdf_header(RDFフィード)
+
; [[プラグイン_API/アクションフック一覧/rdf_header|rdf_header]](RDF フィード)
; rss_head(RSSフィード)
+
; [[プラグイン_API/アクションフック一覧/rss_head|rss_head]](RSS フィード)
: 各フィードでブログの情報が表示された直後、一つ目の記事の直前で実行する。
+
: 各フィードでブログの情報が表示された直後、一つ目の投稿の直前で実行する。
  
; atom_ns(Atomフィード)
+
; [[プラグイン_API/アクションフック一覧/atom_ns|atom_ns]] (Atom フィード)
; rdf_ns(RDFフィード)
+
; [[プラグイン_API/アクションフック一覧/rdf_ns|rdf_ns]](RDF フィード)
; rss2_ns(RSS2フィード)
+
; [[プラグイン_API/アクションフック一覧/rss2_ns|rss2_ns]](RSS フィード)
: AtomフィードのXML要素ルート内で名前空間を追加する際に実行する。
+
: 各フィードの XML 要素ルート内で名前空間を追加する際に実行する。
  
; commentrss2_item
+
; [[プラグイン_API/アクションフック一覧/commentrss2_item|commentrss2_item]] / [[:en:Plugin_API/Action_Reference/rss2_item|en]]
: アクション関数引数: コメントID、投稿記事ID
+
 
: コメントフィードにコメント情報が表示された直後、<nowiki><item></nowiki>タグを閉じる前に実行する。
 
: コメントフィードにコメント情報が表示された直後、<nowiki><item></nowiki>タグを閉じる前に実行する。
 +
: アクション関数引数: コメント ID、投稿 ID
  
; do_feed_フィード名
+
; [[プラグイン_API/アクションフック一覧/do_feed_(feed)|do_feed_フィード名]]
: アクション関数引数: フィードの種類(コメントフィードならtrue、投稿記事フィードならfalse)
+
: RSS2、Atom、RDFなどのフィードが生成される直前に実行する。フィード名には rss2、atom などフィードの種類を入れる。フィードが表示される前に実行するには、10以下の<var>プライオリティ</var>を指定すること。
: RSS2、Atom、RDFなどのフィードが生成される直前に実行する。フィード名には rss2、atom などフィードの種類を入れる。
+
: アクション関数引数: フィードの種類(コメントフィードなら true、投稿フィードなら false)
  
 
== テンプレート関連のアクション ==
 
== テンプレート関連のアクション ==
  
; comment_form
+
; [[プラグイン_API/アクションフック一覧/after_setup_theme|after_setup_theme]] / [[:en:Plugin_API/Action_Reference/after_setup_theme|en]]
: アクション関数引数: 投稿記事ID
+
: テーマ初期化中に実行する。通常、基本設定、登録、テーマの init アクションに使われる。
: 標準のテーマにコメントを挿入するために実行する。
+
  
; do_robots
+
; [[プラグイン_API/アクションフック一覧/comment_form|comment_form]] / [[:en:Plugin_API/Action_Reference/comment_form|en]]
: テンプレートファイルを選択する際、リクエストがrobots.txtに対するものの場合に実行する。
+
: [[テンプレートタグ/comment_form|comment_form()]] がコメントフォームを出力する際、最後に終了タグ<tt>&lt;/form&gt;</tt>を出力する直前で実行する。
 +
: アクション関数引数: 投稿 ID
  
; do_robotstxt
+
; [[プラグイン_API/アクションフック一覧/do_robots|do_robots]] / [[:en:Function_Reference/do_robots|en]]
: do_robots関数内でrobots.txtファイルにDisallowリストを表示する際に実行する。
+
: テンプレートファイルを選択する際、リクエストが <code>robots.txt</code> に対するものの場合に実行する。
  
; get_footer
+
; [[プラグイン_API/アクションフック一覧/do_robotstxt|do_robotstxt]] / [[:en:Plugin_API/Action_Reference/do_robotstxt|en]]
: テンプレートがget_footer関数を呼び出した際、footer.phpファイルが読み込まれる直前に実行する。
+
: <code>do_robots()</code> 関数内で <code>robots.txt</code> ファイルに Disallow リストを表示する際に実行する。
  
; get_header
+
; [[プラグイン_API/アクションフック一覧/get_footer|get_footer]] / [[:en:Plugin_API/Action_Reference/get_footer|en]]
: テンプレートがget_header関数を呼び出した際、header.phpファイルが読み込まれる直前に実行する。
+
: テンプレートが [[関数リファレンス/get_footer|<tt>get_footer()</tt> 関数]]を呼び出した際、<code>footer.php</code> ファイルが読み込まれる直前に実行する。
  
; switch_theme  
+
; [[プラグイン_API/アクションフック一覧/get_header|get_header]] / [[:en:Plugin_API/Action_Reference/get_header|en]]
 +
: テンプレートが [[関数リファレンス/get_header|<tt>get_header()</tt> 関数]]を呼び出した際、<code>header.php</code>ファイルが読み込まれる直前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/switch_theme|switch_theme]] / [[:en:Plugin_API/Action_Reference/switch_theme|en]]
 +
: ブログのテーマが変更された際に実行する。テーマ内で使われた場合、このアクションを追加するテーマが無効化される際にのみ動作する。
 
: アクション関数引数: 変更されたテーマの名称
 
: アクション関数引数: 変更されたテーマの名称
: ブログのテーマが変更された際に実行する。
 
  
; template_redirect
+
; [[プラグイン_API/アクションフック一覧/after_switch_theme|after_switch_theme]] / [[:en:Plugin_API/Action_Reference/after_switch_theme|en]]
: リクエストされたページの表示に使用するテンプレートファイルを判断する前に実行し、プラグインがテンプレートファイルの選択を上書きできるようにする。
+
: ブログのテーマが変更された際に実行する。テーマ内で使われた場合、このアクションを追加するテーマが有効化される際にのみ動作する。テーマを有効化する際に特定のコードを実行するために使える。
: 以下は(実用的ではない)例で、すべてのリクエストを現在のテーマディレクトリ内にある all.php ファイルにリダイレクトする。
+
: アクション関数引数: 新テーマの名称
<pre><nowiki>function all_on_one () {
+
include(TEMPLATEPATH . '/all.php');
+
exit;
+
}
+
add_action('template_redirect', 'all_on_one');</nowiki></pre>
+
  
; wp_footer
+
; [[プラグイン_API/アクションフック一覧/load-themes.php|load-themes.php]] / [[:en:Plugin_API/Action_Reference/load-themes.php|en]]
: テンプレートがwp_footer関数を呼び出す際に実行する。wp_footer関数は通常、ブログページの最後付近で使われる。
+
: テーマが有効化された際、または(他のテーマの有効化によって)無効化された際に実行する。
  
; [[:en:Hook_Reference/wp_head|wp_head]]  
+
; [[プラグイン_API/アクションフック一覧/template_redirect|template_redirect]] / [[:en:Plugin_API/Action_Reference/template_redirect|en]]
: テンプレートがwp_head関数を呼び出す際に実行する。wp_head関数は通常、ブログページの先頭付近の<nowiki><head></nowiki>要素内で使われる。
+
: リクエストされたページを表示するのに使うため、テンプレートファイルを判断する前に実行する。
  
; wp_meta
+
; [[プラグイン_API/アクションフック一覧/wp_footer|wp_footer]] / [[:en:Plugin_API/Action_Reference/wp_footer|en]]
: sidebar.phpテンプレートがwp_meta関数を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入することができるようにする。
+
: テンプレートが [[関数リファレンス/wp_footer|wp_footer 関数]]を呼び出す際に実行する。<code>wp_footer</code> 関数は通常、ブログページの最後付近で使われる。
  
; wp_print_scripts
+
; [[プラグイン_API/アクションフック一覧/wp_head|wp_head]] / [[:en:Plugin_API/Action_Reference/wp_head|en]]
: ページの<nowiki><head></nowiki>要素に、登録されたJavaScriptを出力する直前に実行する。
+
: テンプレートが [[関数リファレンス/wp_head|wp_head 関数]]を呼び出す際に実行する。wp_head 関数は通常、ブログページの先頭付近の <code><nowiki><head></nowiki></code> 要素内で使われる。
 +
: アクション関数引数: なし
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wp_meta|wp_meta]] / [[:en:Plugin_API/Action_Reference/wp_meta|en]]
 +
: <code>sidebar.php</code>テンプレートが [[関数リファレンス/wp_meta|wp_meta 関数]] を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入できるようにする。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wp_print_scripts|wp_print_scripts]] / [[:en:Plugin_API/Action_Reference/wp_print_scripts|en]]
 +
: ページの <code><nowiki><head></nowiki></code> 要素に、登録された JavaScript を出力する直前に実行する。
  
 
== 管理画面関連のアクション ==
 
== 管理画面関連のアクション ==
  
; activate_プラグインファイル名
+
; [[プラグイン_API/アクションフック一覧/activate_(plugin_file_name)|activate_プラグインファイル名]] / [[:en:Plugin_API/Action_Reference/activate_(plugin_file_name)|en]]
: プラグインを初めて有効化する際に実行する。
+
: プラグインを初めて有効化する際に実行する。[[関数リファレンス/register_activation_hook|register_activation_hook()]] を参照。
  
; activity_box_end
+
; [[プラグイン_API/アクションフック一覧/activity_box_end|activity_box_end]] / [[:en:Plugin_API/Action_Reference/activity_box_end|en]]
 
: 管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
 
: 管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
  
; add_category_form_pre
+
; [[プラグイン_API/アクションフック一覧/add_category_form_pre|add_category_form_pre]] / [[:en:Plugin_API/Action_Reference/add_category_form_pre|en]]
 
: 管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
 
: 管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
  
; admin_head
+
; [[プラグイン_API/アクションフック一覧/add_option_(option_name)|add_option_(option_name)]] / [[:en:Plugin_API/Action_Reference/add_option_(option_name)|en]]
: 管理画面各ページの<nowiki><head></nowiki>要素内で実行する。
+
: WordPress オプションが [[関数リファレンス/add_option|add_option()]] 関数で追加された後に実行する。例えばオプション "foo" が追加された際に反応させたい場合は、'add_option_foo' などのように、特定のオプションへのアクションを追加する必要がある。
 +
: アクション関数引数: オプション名、オプション値
  
; admin_head-ページフック名
+
;[[プラグイン_API/アクションフック一覧/add_option|add_option]] / [[:en:Plugin_API/Action_Reference/add_option|en]]
; admin_head-プラグイン管理ページ名
+
: オプションがデータベースに追加される前に実行する。
: プラグインが生成した管理画面ページの <nowiki><head></nowiki> 要素内で実行する。
+
  
; admin_footer
+
;[[プラグイン_API/アクションフック一覧/added_option|added_option]] / [[:en:Plugin_API/Action_Reference/added_option|en]]
: 管理画面各ページの<nowiki><body></nowiki>要素の終盤で実行する。
+
: オプションが追加された後に実行する。
  
; admin_print_scripts
+
; [[プラグイン_API/アクションフック一覧/admin_head|admin_head]] / [[:en:Plugin_API/Action_Reference/admin_head|en]]
: 管理画面各ページの<nowiki><head></nowiki>要素にJavaScriptを追加するために実行する。
+
: 管理画面各ページ HTML の <code><nowiki><head></nowiki></code> 要素内で実行する。
  
; admin_print_scripts-ページフック名
+
; [[プラグイン_API/アクションフック一覧/admin_head-(page_hook)|admin_head-ページフック名]] / [[:en:Plugin_API/Action_Reference/admin_head-(page_hook)|en]]
; admin_print_scripts-プラグイン管理ページ名
+
; [[プラグイン_API/アクションフック一覧/admin_head-(plugin_page)|admin_head-プラグイン管理ページ名]] / [[:en:Plugin_API/Action_Reference/admin_head-(plugin_page)|en]]
: プラグインが生成した管理画面ページの<nowiki><head></nowiki>要素にJavaScriptを追加するために実行する。
+
: プラグインが生成した管理画面ページ、またはプラグインが作成した管理画面の  <code><nowiki><head></nowiki></code> 要素内で実行する。
  
; check_passwords
+
;[[プラグイン_API/アクションフック一覧/admin_init|admin_init]] / [[:en:Plugin_API/Action_Reference/admin_init|en]]
: アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
+
: 管理画面各ページの最初、ページがレンダリングされる前に実行する。"wp-admin/admin.php"、"wp-admin/admin-post.php"、"wp-admin/admin-ajax.php" を参照。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/admin_footer-(plugin_page)|admin_footer-(plugin_page)]] / [[:en:Plugin_API/Action_Reference/admin_footer-(plugin_page)|en]]
 +
: プラグインが生成した管理画面ページの  <code><nowiki><body></nowiki></code> 要素の最後で実行する。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/admin_post_(action)|admin_post_(action)]] / [[:en:Plugin_API/Action_Reference/admin_post_(action)|en]]
 +
: 汎用 GET または POST リクエストのハンドラを実行する。<tt>admin_post_nopriv_(action)</tt> も同じ。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_footer|admin_footer]] / [[:en:Plugin_API/Action_Reference/admin_footer|en]]
 +
: 管理画面各ページの <code><nowiki><body></nowiki></code> 要素の終盤で実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_enqueue_scripts|admin_enqueue_scripts]] / [[:en:Plugin_API/Action_Reference/admin_enqueue_scripts|en]]
 +
: HTML ヘッダーで実行し、プラグインまたはテーマが JavaScript および CSS をすべての管理画面で enqueue できるようにする。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_scripts|admin_print_scripts]] / [[:en:Plugin_API/Action_Reference/admin_print_scripts|en]]
 +
: 管理画面各ページの <code><nowiki><head></nowiki></code> 要素に JavaScript を追加するために実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_scripts-(page_hook)|admin_print_scripts-ページフック名]] / [[:en:Plugin_API/Action_Reference/admin_print_scripts-(page_hook)|en]]
 +
; [[プラグイン_API/アクションフック一覧/admin_print_scripts-(plugin_page)|admin_print_scripts-プラグイン管理ページ名]] / [[:en:Plugin_API/Action_Reference/admin_print_scripts-(plugin_page)|en]]
 +
: プラグインが生成した管理画面ページの <code><nowiki><head></nowiki></code> 要素に JavaScript を追加するために実行する。「ページフック名」は add_management_page()、add_options_page() などのプラグインメニュー項目を追加する関数を使った場合に返される。例は以下のとおり。
 +
 
 +
<pre>
 +
function myplugin_menu() {
 +
  if ( function_exists('add_management_page') ) {
 +
    $page = add_management_page( 'myplugin', 'myplugin', 'manage_options', 'myplugin_slug', 'myplugin_admin_page' );
 +
    add_action( "admin_print_scripts-$page", 'myplugin_admin_head' );
 +
  }
 +
}
 +
</pre>
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_styles|admin_print_styles]] / [[:en:Plugin_API/Action_Reference/admin_print_styles|en]]
 +
: HTML ヘッダーで実行する。プラグインはすべての管理画面に CSS / スタイルシートを追加できる。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_styles-(page_hook) or admin_print_style-(plugin_page)|admin_print_styles-(page_hook) または admin_print_style-(plugin_page)]]  / [[:en:Plugin_API/Action_Reference/admin_print_styles-(page_hook) or admin_print_style-(plugin_page)|en]]
 +
: 特定の管理画面用にスタイルが <tt>[[関数リファレンス/wp_enqueue_style|wp_enqueue_style()]]</tt> で enqueue される際に実行する。''(page_hook)'' の値を決定するには <tt>[[関数リファレンス/add_submenu_page|add_submenu_page()]]</tt> などの関数の戻り値を使用する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/check_passwords|check_passwords]] / [[:en:Plugin_API/Action_Reference/check_passwords|en]]
 
: 新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
 
: 新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
 +
: アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
  
; dbx_page_advanced(ページ)
+
; [[プラグイン_API/アクションフック一覧/dbx_post_advanced|dbx_post_advanced]] / [[:en:Plugin_API/Action_Reference/dbx_post_advanced|en]](投稿)
; dbx_post_advanced(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/dbx_page_advanced|dbx_page_advanced]] / [[:en:Plugin_API/Action_Reference/dbx_page_advanced|en]](ページ)
 
: 各編集管理画面の、詳細オプション部分の最後に実行する。
 
: 各編集管理画面の、詳細オプション部分の最後に実行する。
  
; dbx_page_sidebar(ページ)
+
; [[プラグイン_API/アクションフック一覧/dbx_post_sidebar|dbx_post_sidebar]] / [[:en:Plugin_API/Action_Reference/dbx_post_sidebar|en]](投稿)
; dbx_post_sidebar(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/dbx_page_sidebar|dbx_page_sidebar]] / [[:en:Plugin_API/Action_Reference/dbx_page_sidebar|en]](ページ)
: 各編集管理画面の、サイドバー部分の最後に実行する。
+
: 各編集管理画面のサイドバー部分の最後に実行する。WordPress 2.5以上では [[関数リファレンス/add_meta_box|<tt>add_meta_box</tt>()]] を使用すること。
  
; deactivate_(プラグインファイル名)
+
; [[プラグイン_API/アクションフック一覧/deactivate_(plugin file name)|deactivate_プラグインファイル名]] / [[:en:Plugin_API/Action_Reference/deactivate_(plugin file name)|en]]
 
: プラグインが無効化された際に実行する。
 
: プラグインが無効化された際に実行する。
  
; delete_user
+
; [[プラグイン_API/アクションフック一覧/delete_option_(option_name)|delete_option_(option_name)]] / [[:en:Plugin_API/Action_Reference/delete_option_(option_name)|en]]
: アクション関数引数: ユーザーID
+
: [[関数リファレンス/delete_option|delete_option()]] 関数によって WordPress オプションが削除された後に実行する。例えばオプション "foo" が追加された際に反応させたい場合は、'delete_option_foo' などのように、特定のオプションへのアクションを追加する必要がある。
 +
: アクション関数引数: オプション名
 +
 
 +
; [[プラグイン_API/アクションフック一覧/delete_option|delete_option]] / [[:en:Plugin_API/Action_Reference/delete_option|en]]
 +
: オプションがデータベースから削除される前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/deleted_option|deleted_option]] / [[:en:Plugin_API/Action_Reference/deleted_option|en]]
 +
: オプションがデータベースから削除された後に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/delete_user|delete_user]] / [[:en:Plugin_API/Action_Reference/delete_user|en]]
 
: ユーザーが削除された際に実行する。
 
: ユーザーが削除された際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; edit_category_form
+
; [[プラグイン_API/アクションフック一覧/edit_category_form|edit_category_form]] / [[:en:Plugin_API/Action_Reference/edit_category_form|en]]
: カテゴリー追加・編集フォームが管理画面に表示された後、<nowiki><form></nowiki>要素の閉じタグの前に実行する。
+
: カテゴリー追加・編集フォームが管理画面に表示された後、<nowiki><form></nowiki> 要素の閉じタグの前に実行する。
  
; edit_category_form_pre
+
; [[プラグイン_API/アクションフック一覧/edit_category_form_pre|edit_category_form_pre]] / [[:en:Plugin_API/Action_Reference/edit_category_form_pre|en]]
 
: カテゴリー編集フォームが管理画面に表示される前に実行する。
 
: カテゴリー編集フォームが管理画面に表示される前に実行する。
  
; edit_form_advanced(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/edit_tag_form|edit_tag_form]]  / [[:en:Plugin_API/Action_Reference/edit_tag_form|en]]
; edit_page_form(ページ)
+
: タグ編集フォームが管理画面メニューに表示される前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_tag_form_pre|edit_tag_form_pre]]  / [[:en:Plugin_API/Action_Reference/edit_tag_form_pre|en]]
 +
: タグ追加・編集フォームが管理画面に表示された後、HTML フォームタグの最後よりも前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_form_top|edit_form_top]] / [[:en:Plugin_API/Action_Reference/edit_form_top|en]]
 +
: フォームの内部で、WordPress 投稿編集画面 (およびカスタム投稿タイプ) のタイトルの前、かつ、最初の隠しフィールド (user_ID、アクション 等) の後で実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_form_after_title|edit_form_after_title]] / [[:en:Plugin_API/Action_Reference/edit_form_after_title|en]]
 +
: WordPress 投稿編集画面 (およびカスタム投稿タイプ) のタイトルの後、かつ、ビルトインの WordPress コンテンツ領域の前で実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_form_after_editor|edit_form_after_editor]] / [[:en:Plugin_API/Action_Reference/edit_form_after_editor|en]]
 +
: WordPress 投稿編集画面の後、かつ、すべての他のメタボックスの前で実行する。カスタム投稿タイプでも同じ。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_form_advanced|edit_form_advanced]] / [[:en:Plugin_API/Action_Reference/edit_form_advanced|en]](投稿)
 +
; [[プラグイン_API/アクションフック一覧/edit_page_form|edit_page_form]] / [[:en:Plugin_API/Action_Reference/edit_page_form|en]](ページ)
 
: 編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
 
: 編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
  
; edit_user_profile
+
; [[プラグイン_API/アクションフック一覧/edit_user_profile|edit_user_profile]] / [[:en:Plugin_API/Action_Reference/edit_user_profile|en]]
 
: 管理画面のユーザープロフィール編集ページ終盤で実行する。
 
: 管理画面のユーザープロフィール編集ページ終盤で実行する。
  
; load-ページ名
+
; [[プラグイン_API/アクションフック一覧/load-(page)|load-ページ名]] / [[:en:Plugin_API/Action_Reference/load-(page)|en]]
: 管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加される。[[:en:Adding Administration Menus|管理画面のカスタマイズ]] (en) を参照。
+
: 管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加されることはない。
 
+
管理メニューに追加するための詳細は[[Adding Administration Menus|管理画面のカスタマイズ]]を参照。
; login_form
+
直接使いたい場合は <tt>add_options_page()</tt> やこれに似た関数の返り値としてアクション名の「ページ名」の部分が返される。
: ログインフォームが読み込まれる終盤で実行する。
+
 +
; [[プラグイン_API/アクションフック一覧/login_form|login_form]] / [[:en:Plugin_API/Action_Reference/login_form|en]]
 +
: ログインフォームが読み込みが完了する直前に実行する。
  
; login_head
+
; [[プラグイン_API/アクションフック一覧/login_head|login_head]] / [[:en:Plugin_API/Action_Reference/login_head|en]]
: ログインページの<nowiki><head></nowiki>要素終盤で実行する。
+
: ログインページの <code><nowiki><head></nowiki></code> 要素の読み込みが完了する直前に実行する。
  
; lost_password
+
; [[プラグイン_API/アクションフック一覧/lost_password|lost_password]] / [[:en:Plugin_API/Action_Reference/lost_password|en]]
 
: ログイン画面のパスワード紛失フォームが表示される直前に実行する。
 
: ログイン画面のパスワード紛失フォームが表示される直前に実行する。
  
; lostpassword_form
+
; [[プラグイン_API/アクションフック一覧/lostpassword_form|lostpassword_form]] / [[:en:Plugin_API/Action_Reference/lostpassword_form|en]]
 
: パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
 
: パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
  
; lostpassword_post
+
; [[プラグイン_API/アクションフック一覧/lostpassword_post|lostpassword_post]] / [[:en:Plugin_API/Action_Reference/ostpassword_post|en]]
: ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前にPHPの$_POST変数を修正できるようになる。
+
: ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前に PHP の $_POST 変数を修正できるようになる。
  
; manage_link_custom_column
+
; [[プラグイン_API/アクションフック一覧/manage_link_custom_column|manage_link_custom_column]] / [[:en:Plugin_API/Action_Reference/manage_link_custom_column|en]]
: アクション関数引数: カラム名、リンクID
+
: リンク管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、[[プラグイン_API/アクションフック一覧/manage_posts_columns|<code>manage_posts_columns</code>]] の項を参照。
: リンク管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、manage_posts_columnsの項を参照。
+
: アクション関数引数: カラム名、リンク ID
  
; mce_options
+
; [[プラグイン_API/アクションフック一覧/manage_posts_custom_column|manage_posts_custom_column]] / [[:en:Plugin_API/Action_Reference/manage_posts_custom_column|en]]
: リッチテキストエディター用に出力された、JavaScript設定リストの最後で実行する。
+
: 投稿管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、[[プラグイン_API/アクションフック一覧/manage_posts_columns|manage_posts_columns]] フィルター(カスタムカラムの追加)の項を参照(例と使い方については [http://scompt.com/archives/2007/10/20/adding-custom-columns-to-the-wordpress-manage-posts-screen Scompt のチュートリアル]を参照)。
 +
: アクション関数引数: カラム名、投稿 ID
  
; password_reset
+
; [[プラグイン_API/アクションフック一覧/manage_pages_custom_column|manage_pages_custom_column]] / [[:en:Plugin_API/Action_Reference/manage_pages_custom_column|en]]
 +
: 固定ページ管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、[[プラグイン_API/アクションフック一覧/manage_pages_columns|manage_pages_columns]] フィルター(カスタムカラムの追加)の項を参照。
 +
: アクション関数引数: カラム名、ページ ID
 +
 
 +
; [[プラグイン_API/アクションフック一覧/manage_media_custom_column|manage_media_custom_column]] / [[:en:Plugin_API/Action_Reference/manage_media_custom_column|en]]
 +
: メディア管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、[[プラグイン_API/アクションフック一覧/manage_media_columns|manage_media_columns]] フィルター(カスタムカラムの追加)の項を参照。
 +
: アクション関数引数: カラム名、ページ ID
 +
 
 +
;[[Plugin_API/Action_Reference/manage_$post_type_posts_custom_column|manage_{$post_type}_posts_custom_column]] / [[:en:Plugin_API/Action_Reference/manage_$post_type_posts_custom_column|en]]
 +
: カスタム投稿タイプ管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、[[プラグイン_API/アクションフック一覧/manage_$post_type_posts_columns|manage_$post_type_posts_columns]] フィルター(カスタム投稿タイプ用カスタムカラムの追加)の項を参照。
 +
: アクション関数引数: カラム名、投稿 ID
 +
 
 +
; [[プラグイン_API/アクションフック一覧/mce_options|mce_options]] / [[:en:Plugin_API/Action_Reference/mce_options|en]]
 +
: リッチテキストエディター用に出力された、JavaScript 設定リストの最後で実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/password_reset|password_reset]] / [[:en:Plugin_API/Action_Reference/password_reset|en]]
 
: ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
 
: ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
  
; personal_options_update
+
; [[プラグイン_API/アクションフック一覧/personal_options_update|personal_options_update]] / [[:en:Plugin_API/Action_Reference/personal_options_update|en]]
 
: ユーザーが管理画面から個人設定を更新した際に実行する。
 
: ユーザーが管理画面から個人設定を更新した際に実行する。
  
; plugins_loaded
+
; [[プラグイン_API/アクションフック一覧/plugins_loaded|plugins_loaded]] / [[:en:Plugin_API/Action_Reference/plugins_loaded|en]]
 
: すべてのプラグインが読み込まれた後に実行する。
 
: すべてのプラグインが読み込まれた後に実行する。
  
; profile_personal_options
+
; [[プラグイン_API/アクションフック一覧/profile_personal_options|profile_personal_options]] / [[:en:Plugin_API/Action_Reference/profile_personal_options|en]]
 
: ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
 
: ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
  
; profile_update
+
; [[プラグイン_API/アクションフック一覧/profile_update|profile_update]] / [[:en:Plugin_API/Action_Reference/profile_update|en]]
: アクション関数引数: ユーザーID
+
 
: ユーザープロフィールが更新された際に実行する。
 
: ユーザープロフィールが更新された際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; register_form
+
; [[プラグイン_API/アクションフック一覧/quick_edit_custom_box|quick_edit_custom_box]] / [[:en:Plugin_API/Action_Reference/quick_edit_custom_box|en]]
 +
: クイック編集エディターを作成する際に不明なカラム名が存在する際に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/register_form|register_form]] / [[:en:Plugin_API/Action_Reference/register_form|en]]
 
: 新規ユーザー登録フォームの終わり直前で実行する。
 
: 新規ユーザー登録フォームの終わり直前で実行する。
  
; register_post
+
; [[プラグイン_API/アクションフック一覧/register_post|register_post]] / [[:en:Plugin_API/Action_Reference/register_post|en]]
 
: 新規ユーザー登録リクエストが処理される前に実行する。
 
: 新規ユーザー登録リクエストが処理される前に実行する。
  
; restrict_manage_posts
+
; [[プラグイン_API/アクションフック一覧/restrict_manage_posts|restrict_manage_posts]] / [[:en:Plugin_API/Action_Reference/restrict_manage_posts|en]]
: 管理画面で編集する記事の一覧が出力される前に実行する。
+
: 管理画面で編集する投稿の一覧が出力される前に実行する。
  
; retrieve_password
+
; [[プラグイン_API/アクションフック一覧/retrieve_password|retrieve_password]] / [[:en:Plugin_API/Action_Reference/retrieve_password|en]]
: アクション関数引数: ユーザーのログイン名
+
 
: リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
 
: リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
 +
: アクション関数引数: ユーザーのログイン名
  
; set_current_user
+
; [[プラグイン_API/アクションフック一覧/set_current_user|set_current_user]] / [[:en:Plugin_API/Action_Reference/set_current_user|en]]
: デフォルトのwp_set_current_user関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: デフォルトの <tt>wp_set_current_user()</tt> 関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; show_user_profile
+
; [[プラグイン_API/アクションフック一覧/show_user_profile|show_user_profile]] / [[:en:Plugin_API/Action_Reference/show_user_profile|en]]
 
: ユーザープロフィール編集画面が読み込まれる終盤で実行する。
 
: ユーザープロフィール編集画面が読み込まれる終盤で実行する。
  
; simple_edit_form
+
; [[プラグイン_API/アクションフック一覧/sidebar_admin_page|sidebar_admin_page]] / [[:en:Plugin_API/Action_Reference/sidebar_admin_page|en]]
 +
: ウィジェット管理画面のメインコンテンツの後で実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/sidebar_admin_setup|sidebar_admin_setup]] / [[:en:Plugin_API/Action_Reference/sidebar_admin_setup|en]]
 +
: 編集しているウィジェットがサイドバーに表示された際に最初に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/simple_edit_form|simple_edit_form]] / [[:en:Plugin_API/Action_Reference/simple_edit_form|en]]
 
: 詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
 
: 詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
  
; update_option_オプション名
+
; [[プラグイン_API/アクションフック一覧/update_option_(option_name)|update_option_オプション名]] / [[:en:Plugin_API/Action_Reference/update_option_(option_name)|en]]
 +
: <tt>update_option()</tt> 関数でブログの設定を更新した後に実行する。例えば "foo" という設定が更新された場合にアクションを加えたい場合は、'update_option_foo' というアクションフックを定義する。
 
: アクション関数引数: 古い設定値、新しい設定値
 
: アクション関数引数: 古い設定値、新しい設定値
: update_option関数でブログの設定を更新した後に実行する。例えばfooという設定が更新された場合にアクションを加えたい場合は、update_option_fooというアクションフックを定義する。
 
  
; upload_files_タブ名
+
; [[プラグイン_API/アクションフック一覧/update_option|update_option]] / [[:en:Plugin_API/Action_Reference/update_option|en]]
: アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabsフィルターでカスタムタブを定義する。詳しくは[[プラグイン API/フィルターフック一覧]]、wp_upload_tabsの項を参照。
+
: オプションがデータベースで更新される前に実行する。
  
; user_register
+
; [[プラグイン_API/アクションフック一覧/updated_option|updated_option]] / [[:en:Plugin_API/Action_Reference/updated_option|en]]
: アクション関数引数: ユーザーID
+
: オプションが更新された後に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/upload_files_(tab)|upload_files_タブ]] / [[:en:Plugin_API/Action_Reference/upload_files_(tab)|en]]
 +
: アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabs フィルターでカスタムタブを定義する。詳しくは[[プラグイン API/フィルターフック一覧]]、wp_upload_tabs の項を参照。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/user_new_form|user_new_form]] / [[:en:Plugin_API/Action_Reference/user_new_form|en]]
 +
: ユーザー新規追加画面の最後に実行する。
 +
: アクション関数引数: マルチサイトでは "add-existing-user" という文字列を、シングルサイトまたは特権管理者に対しては "add-new-user" という文字列を渡す。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/user_profile_update_errors|user_profile_update_errors]] / [[:en:Plugin_API/Action_Reference/user_profile_update_errors|en]]
 +
: 更新されたユーザー情報の詳細がデータベースにコミットされる直前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wpmu_new_user|wpmu_new_user]] / [[:en:Plugin_API/Action_Reference/wpmu_new_user|en]]
 +
: マルチサイト環境で最初にユーザーのプロフィールが作成された際に実行する。マルチサイトではない場合、<tt>user_register</tt> を使うこと。
 +
: アクション関数引数: ユーザー ID
 +
 
 +
; [[プラグイン_API/アクションフック一覧/user_register|user_register]] / [[:en:Plugin_API/Action_Reference/user_register|en]]
 
: ユーザーのプロフィールを新規追加する際に実行する。
 
: ユーザーのプロフィールを新規追加する際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; wp_ajax_アクション名
+
;[[Plugin_API/Action_Reference/welcome_panel|welcome_panel]] / [[:en:Plugin_API/Action_Reference/welcome_panel|en]]
: 管理画面で、不明なタイプのAJAXアクションを行うために実行する。
+
: ダッシュボードの「ウェルカム」画面を非表示にする。これはスマートなフィルタでもあり、関連する表示オプションも非表示にしてくれる。
  
; wp_authenticate
+
; [[プラグイン_API/アクションフック一覧/wp_ajax_(action)|wp_ajax_アクション名]] / [[:en:Plugin_API/Action_Reference/wp_ajax_(action)|en]]
: アクション関数引数: ユーザー名とパスワードの配列
+
: 不明なタイプの AJAX リクエストハンドラを行うために実行する。wp_ajax_nopriv_(action) も参照。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wp_authenticate|wp_authenticate]] / [[:en:Plugin_API/Action_Reference/wp_authenticate|en]]
 
: ユーザーのログイン認証時に実行する。
 
: ユーザーのログイン認証時に実行する。
 +
: アクション関数引数: ユーザー名とパスワードの配列
  
; wp_login
+
; [[プラグイン_API/アクションフック一覧/wp_login|wp_login]] / [[:en:Plugin_API/Action_Reference/wp_login|en]]
 
: ユーザーがログインした際に実行する。
 
: ユーザーがログインした際に実行する。
  
; wp_logout
+
; [[プラグイン_API/アクションフック一覧/wp_logout|wp_logout]] / [[:en:Plugin_API/Action_Reference/wp_logout|en]]
 
: ユーザーがログアウトした際に実行する。
 
: ユーザーがログアウトした際に実行する。
 +
 +
== ダッシュボード「現在の状況」ウィジェットアクション ==
 +
 +
; [[プラグイン_API/アクションフック一覧/right_now_content_table_end|right_now_content_table_end]]  / [[:en:Plugin_API/Action_Reference/right_now_content_table_end|en]]
 +
: 「現在の状況」ダッシュボードウィジェットの下にテーブル行を追加する。
 +
 +
; [[プラグイン_API/アクションフック一覧/right_now_table_end|right_now_table_end]]
 +
: スパムコメント数が「現在の状況」ウィジェットのディスカッションカラムに表示された後に呼び出される。
 +
 +
; [[プラグイン_API/アクションフック一覧/right_now_discussion_table_end|right_now_discussion_table_end]]
 +
: スパムコメント数が表示された後、さらに「現在の状況」ウィジェットのディスカッションカラムで right_now_table_end アクションの後に呼び出される。
 +
 +
; [[プラグイン_API/アクションフック一覧/right_now_end|right_now_end]]
 +
: 現在のバージョン情報が「現在の状況」ウィジェット上に表示された直後に呼び出される。注: バージョン3.4で、<tt>rightnow_end</tt> になっている。チケット [http://core.trac.wordpress.org/ticket/21046 #21046] を参照。
 +
 +
; [[プラグイン_API/アクションフック一覧/activity_box_end|activity_box_end]] / [[:en:Plugin_API/Action_Reference/activity_box_end|en]]
 +
: 「現在の状況」ウィジェットで呼び出される最後のアクション。
  
 
== その他の高度なアクション ==
 
== その他の高度なアクション ==
このセクションでは、表示する記事を判断するクエリ、WordPressループ、プラグインの有効化など、WordPressの基本的なコードに関連する高度なアクションを紹介しています。
+
このセクションでは、表示する投稿を判断するクエリ、WordPressループ、プラグインの有効化など、WordPressの基本的なコードに関連する高度なアクションを紹介しています。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/activated_plugin|activated_plugin]] / [[:en:Plugin_API/Action_Reference/activated_plugin|en]]
 +
: プラグインの有効化に成功した際に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/add_meta_boxes|add_meta_boxes]] / [[:en:Plugin_API/Action_Reference/add_meta_boxes|en]]
 +
: 投稿編集画面が読み込まれた際に実行する(バージョン3.0以降)。
  
; admin_menu
+
; [[プラグイン_API/アクションフック一覧/admin_menu|admin_menu]] / [[:en:Plugin_API/Action_Reference/admin_menu|en]]
 
: 管理画面メニューの基本構造が配置された後に実行する。
 
: 管理画面メニューの基本構造が配置された後に実行する。
  
; admin_notices
+
; [[プラグイン_API/アクションフック一覧/network_admin_notices|network_admin_notices]] / [[:en:Plugin_API/Action_Reference/network_admin_notices|en]]
: 管理画面メニューがページに出力された後に実行する。
+
: 管理メニューがネットワーク管理画面に出力された後に実効する。
  
; blog_privacy_selector
+
; [[プラグイン_API/アクションフック一覧/user_admin_notices|user_admin_notices]] / [[:en:Plugin_API/Action_Reference/user_admin_notices|en]]
 +
: 管理メニューがユーザー管理画面に出力された後に実効する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_notices|admin_notices]] / [[:en:Plugin_API/Action_Reference/admin_notices|en]]
 +
: ネットワーク管理画面・ユーザー管理画面を除く管理画面メニューがページに出力された後に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/all_admin_notices|all_admin_notices]] / [[:en:Plugin_API/Action_Reference/all_admin_notices|en]]
 +
: 管理メニューがすべての画面に出力された後に実効する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/blog_privacy_selector|blog_privacy_selector]] / [[:en:Plugin_API/Action_Reference/blog_privacy_selector|en]]
 
: デフォルトのブログプライバシー設定がページに出力された後に実行する。
 
: デフォルトのブログプライバシー設定がページに出力された後に実行する。
  
; check_admin_referer
+
; [[プラグイン_API/アクションフック一覧/check_admin_referer|check_admin_referer]] / [[:en:Plugin_API/Action_Reference/check_admin_referer|en]]
: デフォルトのcheck_admin_referrer関数内で、セキュリティ用にナンス(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: デフォルトの <tt>check_admin_referrer()</tt> 関数内で、セキュリティ用に nonce(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; check_ajax_referer
+
; [[プラグイン_API/アクションフック一覧/check_ajax_referer|check_ajax_referer]] / [[:en:Plugin_API/Action_Reference/check_ajax_referer|en]]
: ユーザーのログインIDとパスワードがCookieによって認証された後、デフォルトのcheck_ajax_referer関数内で実行する。これを使い、認証ができなかった場合のセキュリティを高めることができる。check_ajax_referer関数はwp-admin/admin-ajax.phpスクリプトに対してAJAXリクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: ユーザーのログイン IDとパスワードが Cookie によって認証された後、デフォルトの <tt>check_ajax_referer()</tt>  関数は wp-admin/admin-ajax.php スクリプトに対して AJAX リクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; generate_rewrite_rules
+
; [[プラグイン_API/アクションフック一覧/customize_register|customize_register]] / [[:en:Plugin_API/Action_Reference/customize_register|en]]
: アクション関数引数: WP_Rewriteクラスの変数リスト
+
: すべてのリクエストで実行する。開発者は新規のテーマのオプションを登録し、[[Theme Customization API]] を使用して制御できる ([[Version 3.4]])。
: URLリライトルールが生成された後に実行する。
+
: 注:リライトルールを修正するには、このアクションよりもrewrite_rules_arrayフィルターの方が使いやすい。
+
  
; init
+
; [[プラグイン_API/アクションフック一覧/deactivated_plugin|deactivated_plugin]] / [[:en:Plugin_API/Action_Reference/deactivated_plugin|en]]
: WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GETや$_POSTトリガーを妨害するために使える。
+
: プラグインの無効化に成功した際に実行する。
  
; loop_end
+
; [[プラグイン_API/アクションフック一覧/generate_rewrite_rules|generate_rewrite_rules]] / [[:en:Plugin_API/Action_Reference/generate_rewrite_rules|en]]
 +
: URL リライトルールが生成された後に実行する。
 +
: アクション関数引数: WP_Rewrite クラスの変数リスト
 +
: 注: リライトルールを修正するには、このアクションよりも <tt>rewrite_rules_array</tt> フィルターの方が使いやすい。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/init|init]] / [[:en:Plugin_API/Action_Reference/init|en]]
 +
: WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GET や $_POST トリガーを妨害するために使える。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/loop_end|loop_end]] / [[:en:Plugin_API/Action_Reference/loop_end|en]]
 
: 最後のWordPressループが処理された後に実行する。
 
: 最後のWordPressループが処理された後に実行する。
  
; loop_start
+
; [[プラグイン_API/アクションフック一覧/loop_start|loop_start]] / [[:en:Plugin_API/Action_Reference/loop_start|en]]
: 最初のWordPressループが処理される前に実行する。
+
: 最初の WordPress ループが処理される前に実行する。
  
; parse_query
+
; [[プラグイン_API/アクションフック一覧/network_admin_menu|network_admin_menu]] / [[:en:Plugin_API/Action_Reference/network_admin_menu|en]]
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
+
: [[Create_A_Network|ネットワーク]]管理画面で基本的なメニュー構造の用意ができた際に実行する([[管理メニューの追加|管理メニュー]])。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/parse_query|parse_query]] / [[:en:Plugin_API/Action_Reference/parse_query|en]]
 
: クエリ解析の終盤で実行する。
 
: クエリ解析の終盤で実行する。
 +
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
  
; parse_request
+
; [[プラグイン_API/アクションフック一覧/parse_request|parse_request]] / [[:en:Plugin_API/Action_Reference/parse_request|en]]
: アクション関数引数: $wpオブジェクトへの参照を含む配列
+
: クエリリクエストが wp 関数内で解析された後に実行する。
: クエリリクエストがwp関数内で解析された後に実行する。
+
: アクション関数引数: $wp オブジェクトへの参照を含む配列
  
; pre_get_posts
+
; [[プラグイン_API/アクションフック一覧/pre_get_posts|pre_get_posts]] / [[:en:Plugin_API/Action_Reference/pre_get_posts|en]]
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
+
: [[Query_Overview|the main query]] /[[:en:Query_Overview|the main query|en]] または <tt>[[関数リファレンス|WP_Query]]</tt>, such as <tt>[[テンプレートタグ/query_posts|query_posts()]]</tt>、<tt>[[テンプレートタグ/get_posts|get_posts()]]</tt>、<tt>[[関数リファレンス/get_children|get_children()]]</tt>などのようなインスタンス内でクエリが実行される前に実行する。このフックはクエリ変数オブジェクトが生成された後、クエリが実際に実行される前に実行される。プライマリクエリが実行される前に変更するのに使える。<tt>[[関数リファレンス/is_main_query|is_main_query()]]</tt> も参照。
: get_posts関数クエリの前に実行する。
+
: アクション関数引数: <tt>$wp_query</tt> オブジェクトの内容(リスト形式)
  
; sanitize_comment_cookies
+
; [[プラグイン_API/アクションフック一覧/sanitize_comment_cookies|sanitize_comment_cookies]] / [[:en:Plugin_API/Action_Reference/sanitize_comment_cookies|en]]
 
: HTTPリクエストからCookieが読み取られた後に実行する。
 
: HTTPリクエストからCookieが読み取られた後に実行する。
  
; send_headers
+
; [[プラグイン_API/アクションフック一覧/send_headers|send_headers]] / [[:en:Plugin_API/Action_Reference/send_headers|en]]
: アクション関数引数: グローバル$wpオブジェクトへの参照がある配列
+
: <tt>wp</tt> 関数内でHTTPヘッダーが送信された後に実行する。
: wp関数内でHTTPヘッダーが送信された後に実行する。
+
: アクション関数引数: グローバル $wp オブジェクトへの参照がある配列
  
; shutdown
+
; [[プラグイン_API/アクションフック一覧/shutdown|shutdown]] / [[:en:Plugin_API/Action_Reference/shutdown|en]]
 
: ページの出力が完全に終了した際に実行する。
 
: ページの出力が完全に終了した際に実行する。
  
; wp
+
; [[プラグイン_API/アクションフック一覧/update_(meta_type)_meta|update_(meta_type)_meta]] / [[:en:Plugin_API/Action_Reference/update_(meta_type)_meta|en]]
: アクション関数引数: $wpオブジェクトへの参照を含む配列
+
: メタ情報が保存される際に実行する。
: wp関数内でクエリが解析されて記事が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
+
 
 +
; [[プラグイン_API/アクションフック一覧/updated_(meta_type)_meta|updated_(meta_type)_meta]] / [[:en:Plugin_API/Action_Reference/updated_(meta_type)_meta|en]]
 +
: メタ情報が更新される際に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/upgrader_process_complete|upgrader_process_complete]] / [[:en:Plugin_API/Action_Reference/upgrader_process_complete|en]]
 +
: プラグインダウンロード・アップグレードツールの動作が終了した際に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wp_loaded|wp_loaded]] / [[:en:Plugin_API/Action_Reference/wp_loaded|en]]
 +
: WordPress、すべてのプラグイン、テーマが完全に読み込まれ、インスタント化されたタイミングで実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/wp|wp]] / [[:en:Plugin_API/Action_Reference/wp|en]]
 +
: <tt>wp</tt> 関数内でクエリが解析されて投稿が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
 +
: アクション関数引数: $wp オブジェクトへの参照を含む配列
 +
 
 +
== これも読んでみよう ==
 +
 
 +
* [[プラグインの作成]] - プラグイン作成方法の説明
 +
* [[プラグイン API]] - フィルターやアクションの使い方に関する記事
 +
* [[プラグイン・リソース]] - プラグインに関するリソースの総合的な一覧
 +
* [http://adambrown.info/p/wp_hooks WordPress Hooks Database] WordPress フックすべてのデータベース。どのバージョンから存在するかや、フックが使われる部分のソースコードへのリンク。
  
<!-- ここから以下は未翻訳
+
{{NeedTrans| 一部}}
== Further Reading ==
+
  
* [[Writing a Plugin]] - description of how to write a plugin
+
{{原文|Plugin API/Action Reference|152488}}<!-- 07:59, 2 July 2015‎ GaryJ 版 -->
* [[Plugin API]] - article on how to use filters and actions
+
* [[Plugin API/Filter Reference]] - reference list for filter hooks
+
* [[Plugin Resources]] - comprehensive list of plugin-related resources
+
* [http://codex.wordpress.org/User:Skippy Skippy's list] of actions and filters
+
* [http://wphooks.flatearth.org WordPress Hooks], a work in progress directory of all of WordPress’ hooks.
+
* [http://adambrown.info/p/wp_hooks WordPress Hooks Database], a database of all WordPress' hooks, showing which version they come from, and linking to the source code spots that use them
+
* [http://blog.taragana.com/index.php/archive/wordpress-2x-hooks-for-action-comprehensive-list-for-plugin-and-theme-developers/ Angsuman's list], a comprehensive listing of WordPress action hooks with documentation and source code location information. It contains all documented and undocumented action hooks in WordPress 2.0. -->
+
  
 +
[[Category:アクションフック]]
 
[[Category:プラグイン]]
 
[[Category:プラグイン]]
[[Category:上級トピック]]
 
[[Category:WordPress の開発]]
 
  
 
[[en:Plugin API/Action Reference]]
 
[[en:Plugin API/Action Reference]]
 +
[[pt-br:Plugin API/Referencia das Acoes]]<!-- 赤リンクでもコメントアウトしないこと -->

2018年4月27日 (金) 16:37時点における最新版

WordPress バージョン2.1以上で利用できるアクションフックの完全(だといいのですが)なリストです。詳しい情報については下記もご覧ください。

注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。

一般的リクエスト中に実行されるアクション

以下はバージョン 3.3.1でログインしているユーザーがホームページを表示したときに呼びだされるアクションです。この一覧には、各アクションが最初に呼び出される際のみの情報が含まれている可能性があり、多くの場合ではアクションにフックされている関数がない場合もあります。テーマやプラグインによってさらに違ったタイミングで何度かアクションが呼び出されることもあります。その証拠に、Twenty Eleven テーマ特有のアクションコールも以下に見ることができます。また、Cron タスクもユーザーがサイトを訪問した際にアクションを実行することがあります。以下の一覧は明確なスペックではなくガイドラインまたは WordPress がアクションを実行する順序の大体の目安として参照してください。

アクションは do_action() 関数 で呼び出されます。ただし (参照配列) と書かれたものは do_action_ref_array() 関数で呼び出されます。

muplugins_loaded /en must-use プラグインが読み込まれた後
registered_taxonomy /en カテゴリー、post_tag など用
registered_post_type /en 投稿、固定ページなど用
plugins_loaded /en 有効なプラグインとプラガブルな関数が読み込まれた後
sanitize_comment_cookies /en HTTPリクエストからCookieが読み取られた後に実行する
setup_theme /en
load_textdomain /en default ドメイン用
after_setup_theme /en 通常、テーマ設定・オプションを初期化するために使われる。これはテーマで最初に使えるアクションフックであり、有効なテーマの functions.php ファイルが読み込まれた直後にトリガーされる。init アクションフックは一部の機能には遅すぎるため、add_theme_support() はここで呼び出されるべきである。この段階では、現在のユーザーに対する認証は行われていない。
auth_cookie_malformed /en
auth_cookie_valid /en
set_current_user /en デフォルトの wp_set_current_user 関数でユーザーが変更された後に実行する
init /en 通常プラグインの初期化に使われる。この段階で現在のユーザーに対する認証は完了している。
└─ widgets_init /en サイドバーの登録に使われる。'init' の際に、優先順位「1」で、したがって優先順位「1」以上の他の 'init' アクションよりも前に、実行される。
register_sidebar /en 各サイドバー、フッターエリア用
wp_register_sidebar_widget /en 各ウィジェット用
wp_default_scripts /en (参照配列)
wp_default_styles /en (参照配列)
admin_bar_init /en
add_admin_bar_menus /en
wp_loaded /en WordPress が完全に読み込まれた後
parse_request /en リクエスト処理を変更できるようにする (参照配列)
send_headers /en ヘッダーを変更できるようにする (参照配列)
parse_query /en クエリ変数が設定された後 (参照配列)
pre_get_posts クエリが実行される前にクエリ変数オブジェクトを露出する (参照配列) 。
posts_selection /en
wp /en WP オブジェクトが設定された後 (参照配列)
template_redirect /en
get_header /en
wp_enqueue_scripts /en
twentyeleven_enqueue_color_scheme (Twenty Eleven 特有)
wp_head
wp_print_styles /en
wp_print_scripts /en
get_search_form /en
loop_start /en (参照配列)
the_post (参照配列) クエリの直後に投稿オブジェクトを変更できるようにする
get_template_part_content /en コンテンツのテンプレート部分
loop_end /en (参照配列)
get_sidebar /en
dynamic_sidebar /en
get_search_form /en
pre_get_comments /en (参照配列)
wp_meta /en
get_footer /en
get_sidebar /en
twentyeleven_credits (Twenty Eleven 特有)
wp_footer
wp_print_footer_scripts /en
admin_bar_menu /en (参照配列)
wp_before_admin_bar_render /en
wp_after_admin_bar_render /en
shutdown /en PHP の実行が終わりかけの時点

管理画面リクエスト中に実行されるアクション

以下はバージョン 3.3.1でログインしているユーザーが管理画面の投稿ページを表示したときに実行されるアクションです。この一覧には、アクションが最初に呼び出される際のみの情報が含まれています。表示している管理画面ページや使っているプラグインによって違ったアクションが呼び出されます。以下の一覧は明確なスペックではなく大体の目安として参照してください。

以下のアクションの (hookname) はページによって異なります。投稿ページでは edit.php、テーマの背景ページでは appearance_page_custom-background になります。

アクションは do_action() 関数 で呼び出されます。ただし (参照配列) と書かれたものは do_action_ref_array() 関数で呼び出されます。

muplugins_loaded /en must-use プラグインが読み込まれた後
registered_taxonomy /en カテゴリー、post_tag など用
registered_post_type /en 投稿、固定ページなど用
plugins_loaded /en 有効なプラグインとプラガブルな関数が読み込まれた後
sanitize_comment_cookies /en
setup_theme /en
load_textdomain /en default ドメイン用
after_setup_theme /en この段階では現在のユーザーに対する認証は行われていない
load_textdomain /en twentyeleven ドメイン用
auth_cookie_valid /en
set_current_user /en
init /en 通常プラグインの初期化に使われる。この段階で現在のユーザーに対する認証は完了している。
└─ widgets_init /en サイドバーの登録に使われる。'init' の際に、優先順位「1」で実行される。
register_sidebar /en 各サイドバー用
wp_register_sidebar_widget /en 各ウィジェット用
wp_default_scripts /en (参照配列)
wp_default_styles /en (参照配列)
admin_bar_init /en
add_admin_bar_menus /en
wp_loaded /en WordPress が完全に読み込まれた後
auth_cookie_valid /en
auth_redirect /en
_admin_menu /en _user_admin_menu /en, _network_admin_menu /en も参照
admin_menu /en user_admin_menu /en, network_admin_menu /en も参照
admin_init /en
current_screen /en
load-(page) /en
send_headers /en カスタム HTTP ヘッダーを追加できる部分
pre_get_posts クエリが実行される前にクエリ変数オブジェクトを露出する (参照配列) 。
posts_selection /en
wp /en WP オブジェクトが設定された後 (参照配列)
admin_xml_ns /en
admin_enqueue_scripts /en
admin_print_styles-(hookname) /en
admin_print_styles /en
admin_print_scripts-(hookname) /en
admin_print_scripts /en
wp_print_scripts /en
admin_head-(hookname) /en 管理画面の任意のページが開かれたとき
admin_head /en 管理画面を開いたとき
adminmenu /en
in_admin_header /en
admin_notices /en
all_admin_notices /en
(hookname) /en
restrict_manage_posts /en
the_post (参照配列)
pre_user_query /en (参照配列)
in_admin_footer /en
admin_footer /en
admin_bar_menu /en (参照配列)
wp_before_admin_bar_render /en
wp_after_admin_bar_render /en
admin_print_footer_scripts /en
admin_footer-(hookname) /en 管理画面フッター
shutdown /en PHP の実行が終わりかけの時点
wp_dashboard_setup /en 管理画面のカスタマイズができるようにする


タクソノミーとターム

edit_terms 
(actually an action, but often used like a filter) hooked in prior to saving taxonomy/category change in the database
edited_terms 
applied after saving taxonomy/category change in the database.
edited_$taxonomy 
applied after saving specific taxonomy change in the database

投稿、ページ、添付ファイル、カテゴリー関連のアクション

post_submitbox_misc_actions / en
「公開」ボタンのある Submit ボックスにフィールドなどのコンテンツの追加のため、編集ページが生成される際に実行する。
アクション関数引数: なし
add_attachment / en
データベースに添付ファイルが新規追加された際に実行する。
アクション関数引数: 添付ファイル ID
add_category(非推奨)
create_category と同様。
category_add_form_fields
管理画面でカテゴリー追加フォームが作成される際に実行する。このフォーム の Submit ボタンの前にフィールドを追加する場合に有用。
category_edit_form
管理画面でカテゴリー編集フォームが作成される際に実行する。このフォームに新しいフィールドを追加する場合に有用。
clean_post_cache / en
投稿キャッシュのクリア後に実行する。clean_post_cache() /en を参照。
アクション関数引数: 投稿 ID
create_category
カテゴリーが新規作成された際に実行する。
アクション関数引数: カテゴリー ID
delete_attachment / en
データベースから添付ファイルが削除される直前に実行する。
アクション関数引数: 添付ファイル ID
delete_category
データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除される前に実行する(バージョン 2.8 以前では、このフックは添付ファイルが削除された後に実行されていた) 。
アクション関数引数: カテゴリー ID
trash_post / en
投稿またはページがゴミ箱に移動されようとする際に実行する。
アクション関数引数: 投稿 ID またはページ ID
trashed_post / en
投稿またはページがゴミ箱に移動された後に実行する。
アクション関数引数: 投稿 ID またはページ
untrash_post / en
投稿またはページがゴミ箱から復元される前に実行する。
アクション関数引数: 投稿 ID またはページ
untrashed_post / en
投稿またはページがゴミ箱から復元された後に実行する。
アクション関数引数: 投稿 ID またはページ
before_delete_post / en
投稿またはページが削除されようとする際に実行する。コメント、添付ファイル、メタ情報はまだ利用できる。
アクション関数引数: 投稿 ID またはページ
delete_post / en
投稿またはページが削除されようとする際に実行する。コメント、添付ファイル、メタ情報はすでに削除されている。
アクション関数引数: 投稿 ID またはページ
deleted_post / en
投稿またはページが削除された直後に実行する。
アクション関数引数: 投稿 ID またはページ ID
edit_attachment / en
データベースで添付ファイル情報が編集・更新された際に実行する。
アクション関数引数: 添付ファイル ID
edit_category
カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する投稿やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
アクション関数引数: カテゴリー ID
edit_post / en
投稿またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
アクション関数引数: 投稿 ID またはページ ID
pre_post_update / en
投稿またはページが更新される直前に実行する。
アクション関数引数: 投稿 ID またはページ ID
post_updated / en
投稿または固定ページが更新された後に実行する。
アクション関数引数: 投稿 ID またはページ ID、変更前、および変更後の投稿の WP_Post オブジェクト
transition_post_status /en
投稿ステータスの遷移が発生する際に実行する。
アクション関数引数: $new_status$old_status$post オブジェクト (Post Status Transitions参照)。
(old status)_to_(new status)
投稿ステータスが $old_status から $new_status に変わる際に実行する。
アクション関数引数: $post オブジェクト (Post Status Transitions参照)。
(status)_(post_type)
タイプ $post_type の投稿が、$status に他のステータスから遷移した際に実行する。
アクション関数引数: 投稿 ID、$post オブジェクト (Post Status Transitions参照)。
publish_post / en (非推奨ではない)
投稿が公開された際、または編集されてステータスが「公開済み」に変わった際に実行する。このアクションフックは (status)_(post_type) アクションフックタイプと同じ。
アクション関数引数: 投稿 ID、$post オブジェクト (Post Status Transitions参照)。
publish_page / en
固定ページが公開された際、または編集されてステータスが「公開済み」に変わった際に実行する。このアクションフックは(status)_(post_type) アクションフックタイプと同じ。
アクション関数引数: 投稿 ID、$post オブジェクト (Post Status Transitions参照)。
publish_phone / en
メールから投稿が公開された直後に実行する。
アクション関数引数: 投稿 ID
publish_future_post / en
予約投稿またはページが公開された際に実行する。
アクション関数引数: 投稿 ID
save_post / en
インポート機能の利用、投稿・ページ編集フォームの利用、XMLRPC での投稿、メールでの投稿のうちいずれかの方法で投稿・ページが作成・更新された際に実行する。実行されるタイミングはデータがデータベースに保存された後。
アクション関数引数: 投稿 ID, WP_Post オブジェクト, 真偽値(更新かどうか)
投稿 ID は最後に保存した投稿ではなく投稿履歴を参照していることもある。実際の投稿の ID を取得するには、wp_is_post_revision /en を使う。
updated_postmeta / en
メタ情報が更新された際に実行する。
wp_insert_post / en
動作はsave_postと同じ。save_post の直後に実行する。
xmlrpc_publish_post / en
XMLRPC リクエストによる投稿が作成された際、または XMLRPC を通してステータスが「公開」に変更された際に実行する。
アクション関数引数: 投稿 ID

コメント、ピンバック、トラックバック関連のアクション

comment_closed
コメントを受け付けない指定をした投稿で、コメント送信フォームを表示しようとする際に実行する。
アクション関数引数: 投稿 ID
comment_id_not_found
コメント送信フォームを表示しようとする際、投稿 ID が見つからなかった場合に実行する。
アクション関数引数: 投稿 ID
comment_flood_trigger
連続コメントエラーが検出された際、wp_dieが呼び出されてコメントを拒否する直前に実行する。
アクション関数引数: 前回のコメント送信日時、今回のコメント送信日時
comment_(old status)_to_(new status) / en
コメントステータスの遷移が発生した際に実行する。
アクション関数引数: コメントオブジェクト
comment_on_draft
コメント投稿フォームまたはコメントを表示しようとしている際、投稿が非公開状態の場合に実行する。
アクション関数引数: 投稿 ID
comment_post / en
コメントがデータベースに保存される直前に実行する。
アクション関数引数: コメント ID、承認ステータス(spam/スパム、0/未承認、1/承認済み)
edit_comment
データベース内でコメントが編集・更新された後に実行する。
アクション関数引数: コメント ID
delete_comment
コメントが削除される直前に実行する。
アクション関数引数: コメント ID
deleted_comment
コメントが削除された直後に実行する。
アクション関数引数: コメント ID
trash_comment
コメントがゴミ箱に移動される直前に実行する。
アクション関数引数: コメント ID
trashed_comment
コメントがゴミ箱に移動された直後に実行する。
アクション関数引数: コメント ID
comment_closed
コメントが非スパムとしてマークされた際に実行する。
pingback_post
ピンバックが投稿に追加された際に実行する。
アクション関数引数: コメント ID
pre_ping
ピンバックが完全に処理される前に実行する。
アクション関数引数: 処理する投稿リンクの配列、投稿のピンバック受け付け設定
trackback_post
投稿にトラックバックが追加された際に実行する。
アクション関数引数: コメント ID
wp_blacklist_check
コメントをブラックリストに分類するかどうかチェックするために実行する。コメントを拒否するには、関数内でwp_dieを実行するか、入力引数に設定したブラックリストキーワードが含まれるように変更することができる。
アクション関数引数: 投稿者名、投稿者メールアドレス、投稿者URL、コメント本文、投稿者のIPアドレス、投稿者のユーザーエージェント情報
wp_insert_comment / en
コメントが作成された際に実行する。
wp_set_comment_status
コメントのステータスが変更された際に実行する。
アクション関数引数: コメント ID、変更後のステータスを表す文字列(delete/approve/spam/hold)

リンク集関連のアクション

add_link
リンク集にリンク項目が新規追加された際に実行する。
アクション関数引数: リンク ID
delete_link
リンク集からリンク項目が削除された際に実行する。
アクション関数引数: リンク ID
edit_link
リンク集のリンク項目が編集された際に実行する。
アクション関数引数: リンク ID

フィード関連のアクション

atom_entry (Atom フィード)
rdf_item(RDF フィード)
rss_item(RSS フィード)
rss2_item(RSS2 フィード)
各フィードで投稿情報が表示された直後、entry または item タグを閉じる前に実行する。
atom_head (Atom フィード)
rdf_header(RDF フィード)
rss_head(RSS フィード)
各フィードでブログの情報が表示された直後、一つ目の投稿の直前で実行する。
atom_ns (Atom フィード)
rdf_ns(RDF フィード)
rss2_ns(RSS フィード)
各フィードの XML 要素ルート内で名前空間を追加する際に実行する。
commentrss2_item / en
コメントフィードにコメント情報が表示された直後、<item>タグを閉じる前に実行する。
アクション関数引数: コメント ID、投稿 ID
do_feed_フィード名
RSS2、Atom、RDFなどのフィードが生成される直前に実行する。フィード名には rss2、atom などフィードの種類を入れる。フィードが表示される前に実行するには、10以下のプライオリティを指定すること。
アクション関数引数: フィードの種類(コメントフィードなら true、投稿フィードなら false)

テンプレート関連のアクション

after_setup_theme / en
テーマ初期化中に実行する。通常、基本設定、登録、テーマの init アクションに使われる。
comment_form / en
comment_form() がコメントフォームを出力する際、最後に終了タグ</form>を出力する直前で実行する。
アクション関数引数: 投稿 ID
do_robots / en
テンプレートファイルを選択する際、リクエストが robots.txt に対するものの場合に実行する。
do_robotstxt / en
do_robots() 関数内で robots.txt ファイルに Disallow リストを表示する際に実行する。
get_footer / en
テンプレートが get_footer() 関数を呼び出した際、footer.php ファイルが読み込まれる直前に実行する。
get_header / en
テンプレートが get_header() 関数を呼び出した際、header.phpファイルが読み込まれる直前に実行する。
switch_theme / en
ブログのテーマが変更された際に実行する。テーマ内で使われた場合、このアクションを追加するテーマが無効化される際にのみ動作する。
アクション関数引数: 変更されたテーマの名称
after_switch_theme / en
ブログのテーマが変更された際に実行する。テーマ内で使われた場合、このアクションを追加するテーマが有効化される際にのみ動作する。テーマを有効化する際に特定のコードを実行するために使える。
アクション関数引数: 新テーマの名称
load-themes.php / en
テーマが有効化された際、または(他のテーマの有効化によって)無効化された際に実行する。
template_redirect / en
リクエストされたページを表示するのに使うため、テンプレートファイルを判断する前に実行する。
wp_footer / en
テンプレートが wp_footer 関数を呼び出す際に実行する。wp_footer 関数は通常、ブログページの最後付近で使われる。
wp_head / en
テンプレートが wp_head 関数を呼び出す際に実行する。wp_head 関数は通常、ブログページの先頭付近の <head> 要素内で使われる。
アクション関数引数: なし
wp_meta / en
sidebar.phpテンプレートが wp_meta 関数 を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入できるようにする。
wp_print_scripts / en
ページの <head> 要素に、登録された JavaScript を出力する直前に実行する。

管理画面関連のアクション

activate_プラグインファイル名 / en
プラグインを初めて有効化する際に実行する。register_activation_hook() を参照。
activity_box_end / en
管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
add_category_form_pre / en
管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
add_option_(option_name) / en
WordPress オプションが add_option() 関数で追加された後に実行する。例えばオプション "foo" が追加された際に反応させたい場合は、'add_option_foo' などのように、特定のオプションへのアクションを追加する必要がある。
アクション関数引数: オプション名、オプション値
add_option / en
オプションがデータベースに追加される前に実行する。
added_option / en
オプションが追加された後に実行する。
admin_head / en
管理画面各ページ HTML の <head> 要素内で実行する。
admin_head-ページフック名 / en
admin_head-プラグイン管理ページ名 / en
プラグインが生成した管理画面ページ、またはプラグインが作成した管理画面の <head> 要素内で実行する。
admin_init / en
管理画面各ページの最初、ページがレンダリングされる前に実行する。"wp-admin/admin.php"、"wp-admin/admin-post.php"、"wp-admin/admin-ajax.php" を参照。
admin_footer-(plugin_page) / en
プラグインが生成した管理画面ページの <body> 要素の最後で実行する。
admin_post_(action) / en
汎用 GET または POST リクエストのハンドラを実行する。admin_post_nopriv_(action) も同じ。
admin_footer / en
管理画面各ページの <body> 要素の終盤で実行する。
admin_enqueue_scripts / en
HTML ヘッダーで実行し、プラグインまたはテーマが JavaScript および CSS をすべての管理画面で enqueue できるようにする。
admin_print_scripts / en
管理画面各ページの <head> 要素に JavaScript を追加するために実行する。
admin_print_scripts-ページフック名 / en
admin_print_scripts-プラグイン管理ページ名 / en
プラグインが生成した管理画面ページの <head> 要素に JavaScript を追加するために実行する。「ページフック名」は add_management_page()、add_options_page() などのプラグインメニュー項目を追加する関数を使った場合に返される。例は以下のとおり。
function myplugin_menu() {
  if ( function_exists('add_management_page') ) {
    $page = add_management_page( 'myplugin', 'myplugin', 'manage_options', 'myplugin_slug', 'myplugin_admin_page' );
    add_action( "admin_print_scripts-$page", 'myplugin_admin_head' );
  }
}
admin_print_styles / en
HTML ヘッダーで実行する。プラグインはすべての管理画面に CSS / スタイルシートを追加できる。
admin_print_styles-(page_hook) または admin_print_style-(plugin_page) / en
特定の管理画面用にスタイルが wp_enqueue_style() で enqueue される際に実行する。(page_hook) の値を決定するには add_submenu_page() などの関数の戻り値を使用する。
check_passwords / en
新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
dbx_post_advanced / en(投稿)
dbx_page_advanced / en(ページ)
各編集管理画面の、詳細オプション部分の最後に実行する。
dbx_post_sidebar / en(投稿)
dbx_page_sidebar / en(ページ)
各編集管理画面のサイドバー部分の最後に実行する。WordPress 2.5以上では add_meta_box() を使用すること。
deactivate_プラグインファイル名 / en
プラグインが無効化された際に実行する。
delete_option_(option_name) / en
delete_option() 関数によって WordPress オプションが削除された後に実行する。例えばオプション "foo" が追加された際に反応させたい場合は、'delete_option_foo' などのように、特定のオプションへのアクションを追加する必要がある。
アクション関数引数: オプション名
delete_option / en
オプションがデータベースから削除される前に実行する。
deleted_option / en
オプションがデータベースから削除された後に実行する。
delete_user / en
ユーザーが削除された際に実行する。
アクション関数引数: ユーザー ID
edit_category_form / en
カテゴリー追加・編集フォームが管理画面に表示された後、<form> 要素の閉じタグの前に実行する。
edit_category_form_pre / en
カテゴリー編集フォームが管理画面に表示される前に実行する。
edit_tag_form / en
タグ編集フォームが管理画面メニューに表示される前に実行する。
edit_tag_form_pre / en
タグ追加・編集フォームが管理画面に表示された後、HTML フォームタグの最後よりも前に実行する。
edit_form_top / en
フォームの内部で、WordPress 投稿編集画面 (およびカスタム投稿タイプ) のタイトルの前、かつ、最初の隠しフィールド (user_ID、アクション 等) の後で実行する。
edit_form_after_title / en
WordPress 投稿編集画面 (およびカスタム投稿タイプ) のタイトルの後、かつ、ビルトインの WordPress コンテンツ領域の前で実行する。
edit_form_after_editor / en
WordPress 投稿編集画面の後、かつ、すべての他のメタボックスの前で実行する。カスタム投稿タイプでも同じ。
edit_form_advanced / en(投稿)
edit_page_form / en(ページ)
編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
edit_user_profile / en
管理画面のユーザープロフィール編集ページ終盤で実行する。
load-ページ名 / en
管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加されることはない。

管理メニューに追加するための詳細は管理画面のカスタマイズを参照。 直接使いたい場合は add_options_page() やこれに似た関数の返り値としてアクション名の「ページ名」の部分が返される。

login_form / en
ログインフォームが読み込みが完了する直前に実行する。
login_head / en
ログインページの <head> 要素の読み込みが完了する直前に実行する。
lost_password / en
ログイン画面のパスワード紛失フォームが表示される直前に実行する。
lostpassword_form / en
パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
lostpassword_post / en
ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前に PHP の $_POST 変数を修正できるようになる。
manage_link_custom_column / en
リンク管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_posts_columns の項を参照。
アクション関数引数: カラム名、リンク ID
manage_posts_custom_column / en
投稿管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_posts_columns フィルター(カスタムカラムの追加)の項を参照(例と使い方については Scompt のチュートリアルを参照)。
アクション関数引数: カラム名、投稿 ID
manage_pages_custom_column / en
固定ページ管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_pages_columns フィルター(カスタムカラムの追加)の項を参照。
アクション関数引数: カラム名、ページ ID
manage_media_custom_column / en
メディア管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_media_columns フィルター(カスタムカラムの追加)の項を参照。
アクション関数引数: カラム名、ページ ID
manage_{$post_type}_posts_custom_column / en
カスタム投稿タイプ管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_$post_type_posts_columns フィルター(カスタム投稿タイプ用カスタムカラムの追加)の項を参照。
アクション関数引数: カラム名、投稿 ID
mce_options / en
リッチテキストエディター用に出力された、JavaScript 設定リストの最後で実行する。
password_reset / en
ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
personal_options_update / en
ユーザーが管理画面から個人設定を更新した際に実行する。
plugins_loaded / en
すべてのプラグインが読み込まれた後に実行する。
profile_personal_options / en
ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
profile_update / en
ユーザープロフィールが更新された際に実行する。
アクション関数引数: ユーザー ID
quick_edit_custom_box / en
クイック編集エディターを作成する際に不明なカラム名が存在する際に実行する。
register_form / en
新規ユーザー登録フォームの終わり直前で実行する。
register_post / en
新規ユーザー登録リクエストが処理される前に実行する。
restrict_manage_posts / en
管理画面で編集する投稿の一覧が出力される前に実行する。
retrieve_password / en
リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
アクション関数引数: ユーザーのログイン名
set_current_user / en
デフォルトの wp_set_current_user() 関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
show_user_profile / en
ユーザープロフィール編集画面が読み込まれる終盤で実行する。
sidebar_admin_page / en
ウィジェット管理画面のメインコンテンツの後で実行する。
sidebar_admin_setup / en
編集しているウィジェットがサイドバーに表示された際に最初に実行する。
simple_edit_form / en
詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
update_option_オプション名 / en
update_option() 関数でブログの設定を更新した後に実行する。例えば "foo" という設定が更新された場合にアクションを加えたい場合は、'update_option_foo' というアクションフックを定義する。
アクション関数引数: 古い設定値、新しい設定値
update_option / en
オプションがデータベースで更新される前に実行する。
updated_option / en
オプションが更新された後に実行する。
upload_files_タブ / en
アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabs フィルターでカスタムタブを定義する。詳しくはプラグイン API/フィルターフック一覧、wp_upload_tabs の項を参照。
user_new_form / en
ユーザー新規追加画面の最後に実行する。
アクション関数引数: マルチサイトでは "add-existing-user" という文字列を、シングルサイトまたは特権管理者に対しては "add-new-user" という文字列を渡す。
user_profile_update_errors / en
更新されたユーザー情報の詳細がデータベースにコミットされる直前に実行する。
wpmu_new_user / en
マルチサイト環境で最初にユーザーのプロフィールが作成された際に実行する。マルチサイトではない場合、user_register を使うこと。
アクション関数引数: ユーザー ID
user_register / en
ユーザーのプロフィールを新規追加する際に実行する。
アクション関数引数: ユーザー ID
welcome_panel / en
ダッシュボードの「ウェルカム」画面を非表示にする。これはスマートなフィルタでもあり、関連する表示オプションも非表示にしてくれる。
wp_ajax_アクション名 / en
不明なタイプの AJAX リクエストハンドラを行うために実行する。wp_ajax_nopriv_(action) も参照。
wp_authenticate / en
ユーザーのログイン認証時に実行する。
アクション関数引数: ユーザー名とパスワードの配列
wp_login / en
ユーザーがログインした際に実行する。
wp_logout / en
ユーザーがログアウトした際に実行する。

ダッシュボード「現在の状況」ウィジェットアクション

right_now_content_table_end / en
「現在の状況」ダッシュボードウィジェットの下にテーブル行を追加する。
right_now_table_end
スパムコメント数が「現在の状況」ウィジェットのディスカッションカラムに表示された後に呼び出される。
right_now_discussion_table_end
スパムコメント数が表示された後、さらに「現在の状況」ウィジェットのディスカッションカラムで right_now_table_end アクションの後に呼び出される。
right_now_end
現在のバージョン情報が「現在の状況」ウィジェット上に表示された直後に呼び出される。注: バージョン3.4で、rightnow_end になっている。チケット #21046 を参照。
activity_box_end / en
「現在の状況」ウィジェットで呼び出される最後のアクション。

その他の高度なアクション

このセクションでは、表示する投稿を判断するクエリ、WordPressループ、プラグインの有効化など、WordPressの基本的なコードに関連する高度なアクションを紹介しています。

activated_plugin / en
プラグインの有効化に成功した際に実行する。
add_meta_boxes / en
投稿編集画面が読み込まれた際に実行する(バージョン3.0以降)。
admin_menu / en
管理画面メニューの基本構造が配置された後に実行する。
network_admin_notices / en
管理メニューがネットワーク管理画面に出力された後に実効する。
user_admin_notices / en
管理メニューがユーザー管理画面に出力された後に実効する。
admin_notices / en
ネットワーク管理画面・ユーザー管理画面を除く管理画面メニューがページに出力された後に実行する。
all_admin_notices / en
管理メニューがすべての画面に出力された後に実効する。
blog_privacy_selector / en
デフォルトのブログプライバシー設定がページに出力された後に実行する。
check_admin_referer / en
デフォルトの check_admin_referrer() 関数内で、セキュリティ用に nonce(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
check_ajax_referer / en
ユーザーのログイン IDとパスワードが Cookie によって認証された後、デフォルトの check_ajax_referer() 関数は wp-admin/admin-ajax.php スクリプトに対して AJAX リクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
customize_register / en
すべてのリクエストで実行する。開発者は新規のテーマのオプションを登録し、Theme Customization API を使用して制御できる (Version 3.4)。
deactivated_plugin / en
プラグインの無効化に成功した際に実行する。
generate_rewrite_rules / en
URL リライトルールが生成された後に実行する。
アクション関数引数: WP_Rewrite クラスの変数リスト
注: リライトルールを修正するには、このアクションよりも rewrite_rules_array フィルターの方が使いやすい。
init / en
WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GET や $_POST トリガーを妨害するために使える。
loop_end / en
最後のWordPressループが処理された後に実行する。
loop_start / en
最初の WordPress ループが処理される前に実行する。
network_admin_menu / en
ネットワーク管理画面で基本的なメニュー構造の用意ができた際に実行する(管理メニュー)。
parse_query / en
クエリ解析の終盤で実行する。
アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
parse_request / en
クエリリクエストが wp 関数内で解析された後に実行する。
アクション関数引数: $wp オブジェクトへの参照を含む配列
pre_get_posts / en
the main query /the main query|en または WP_Query, such as query_posts()get_posts()get_children()などのようなインスタンス内でクエリが実行される前に実行する。このフックはクエリ変数オブジェクトが生成された後、クエリが実際に実行される前に実行される。プライマリクエリが実行される前に変更するのに使える。is_main_query() も参照。
アクション関数引数: $wp_query オブジェクトの内容(リスト形式)
sanitize_comment_cookies / en
HTTPリクエストからCookieが読み取られた後に実行する。
send_headers / en
wp 関数内でHTTPヘッダーが送信された後に実行する。
アクション関数引数: グローバル $wp オブジェクトへの参照がある配列
shutdown / en
ページの出力が完全に終了した際に実行する。
update_(meta_type)_meta / en
メタ情報が保存される際に実行する。
updated_(meta_type)_meta / en
メタ情報が更新される際に実行する。
upgrader_process_complete / en
プラグインダウンロード・アップグレードツールの動作が終了した際に実行する。
wp_loaded / en
WordPress、すべてのプラグイン、テーマが完全に読み込まれ、インスタント化されたタイミングで実行する。
wp / en
wp 関数内でクエリが解析されて投稿が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
アクション関数引数: $wp オブジェクトへの参照を含む配列

これも読んでみよう

このページ「プラグイン API/アクションフック一覧」は 一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

最新英語版: WordPress Codex » Plugin API/Action Reference最新版との差分