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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(編集履歴に基づき最新版との差分リンクを挿入、pt-br版への言語間リンク追加。要更新)
(最新版に更新。赤リンクの英語ページへのリンクがまだありません。)
1行目: 1行目:
{{Old}}
+
この記事は(おそらくほぼ完全な)アクションフックの一覧です。アクションフックは[[Version 2.1|バージョン2.1]]以降から、プラグインおよびテーマ開発時に利用できるようになっています。詳しい情報については下記もご覧下さい。
 
+
この記事は(おそらくほぼ完全な)アクションフックの一覧です。アクションフックは[[Version 2.1|バージョン2.1]] 以降から、プラグインおよびテーマ開発時に利用できるようになっています。詳しい情報については下記もご覧下さい。
+
  
 
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧下さい。
 
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧下さい。
9行目: 7行目:
  
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
 +
 +
== 一般的リクエスト中に実行されるアクション ==
 +
 +
以下は[[Version 3.0.1|バージョン 3.0.1]]でログインしているユーザーがホームページを表示したときに実行されるアクションです。この一覧には、アクションが最初に呼び出される際のみの情報が含まれています。テーマやプラグインによってさらに違ったタイミングで何度かアクションが呼び出されることもあります。その証拠に、Twenty Ten テーマ特有のアクションコールも以下に見ることができます。また、Cron タスクもサイト訪問の際にアクションを実行することがあります。以下の一覧は明確なスペックではなく大体の目安として参照してください。
 +
 +
#  muplugins_loaded
 +
#  plugins_loaded
 +
#  sanitize_comment_cookies
 +
#  setup_theme
 +
#  load_textdomain
 +
#  after_setup_theme
 +
#  auth_cookie_malformed
 +
#  set_current_user
 +
#  init
 +
#  widgets_init
 +
#  register_sidebar
 +
#  wp_register_sidebar_widget
 +
#  wp_loaded
 +
#  parse_request*
 +
#  send_headers*
 +
#  pre_get_posts*
 +
#  posts_selection
 +
#  wp*
 +
#  template_redirect
 +
#  get_header
 +
#  wp_head
 +
#  wp_enqueue_scripts
 +
#  wp_print_styles
 +
#  wp_print_scripts
 +
#  get_template_part_loop
 +
#  loop_start*
 +
#  the_post*
 +
#  loop_end*
 +
#  get_sidebar
 +
#  dynamic_sidebar
 +
#  get_search_form
 +
#  parse_query*
 +
#  wp_meta
 +
#  get_footer
 +
#  twentyten_credits
 +
#  wp_footer
 +
#  wp_print_footer_scripts
 +
#  shutdown
 +
 +
アクション名のあとにアスタリスク(*) が付いているものは配列参照アクションであることを意味します。
 +
 +
== 管理画面リクエスト中に実行されるアクション ==
 +
 +
以下は[[Version 3.0.1|バージョン 3.0.1]]でログインしているユーザーが管理画面の投稿ページを表示したときに実行されるアクションです。この一覧には、アクションが最初に呼び出される際のみの情報が含まれています。表示している管理画面ページや使っているプラグインよって違ったアクションが呼び出されます。以下の一覧は明確なスペックではなく大体の目安として参照してください。
 +
 +
 +
#  muplugins_loaded
 +
#  plugins_loaded
 +
#  sanitize_comment_cookies
 +
#  setup_theme
 +
#  load_textdomain
 +
#  after_setup_theme
 +
#  auth_cookie_valid
 +
#  set_current_user
 +
#  init
 +
#  widgets_init
 +
#  register_sidebar
 +
#  wp_register_sidebar_widget
 +
#  wp_loaded
 +
#  auth_redirect
 +
#  wp_default_scripts*
 +
#  _admin_menu
 +
#  admin_menu
 +
#  admin_init
 +
#  load-edit.php
 +
#  parse_request*
 +
#  send_headers*
 +
#  parse_query*
 +
#  pre_get_posts*
 +
#  posts_selection
 +
#  wp*
 +
#  admin_xml_ns
 +
#  wp_default_styles*
 +
#  admin_enqueue_scripts
 +
#  admin_print_styles-edit.php
 +
#  admin_print_styles
 +
#  admin_print_scripts-edit.php
 +
#  admin_print_scripts
 +
#  wp_print_scripts
 +
#  admin_head-edit.php
 +
#  admin_head
 +
#  in_admin_header
 +
#  adminmenu
 +
#  admin_notices
 +
#  restrict_manage_posts
 +
#  the_post*
 +
#  in_admin_footer
 +
#  admin_footer
 +
#  admin_print_footer_scripts
 +
#  wp_print_footer_scripts
 +
#  admin_footer-edit.php
 +
#  shutdown
 +
 +
アクション名のあとにアスタリスク(*) が付いているものは配列参照アクションであることを意味します。
  
 
== 投稿、ページ、添付ファイル、カテゴリー関連のアクション ==
 
== 投稿、ページ、添付ファイル、カテゴリー関連のアクション ==
  
; add_attachment
+
;[[プラグイン_API/アクションフック一覧/add_attachment|add_attachment]]
: アクション関数引数: 添付ファイルID
+
 
: データベースに添付ファイルが新規追加された際に実行する。
 
: データベースに添付ファイルが新規追加された際に実行する。
+
: アクション関数引数: 添付ファイル ID
; add_category<br />create_category
+
 
: アクション関数引数: カテゴリーID
+
;[[プラグイン_API/アクションフック一覧/add_category|add_category]]
 +
: <tt>create_category</tt> と同様。
 +
 
 +
;[[プラグイン_API/アクションフック一覧/clean_post_cache|clean_post_cache]]
 +
: 投稿キャッシュのクリア後に実行する。[[関数リファレンス/clean_post_cache|<tt>clean_post_cache()</tt>]] を参照。
 +
: アクション関数引数: 投稿 ID
 +
 
 +
;[[プラグイン_API/アクションフック一覧/create_category|create_category]]
 
: カテゴリーが新規作成された際に実行する。
 
: カテゴリーが新規作成された際に実行する。
 +
: アクション関数引数: カテゴリー ID
  
; delete_attachment
+
;[[プラグイン_API/アクションフック一覧/delete_attachment|delete_attachment]]
: アクション関数引数: 添付ファイルID
+
 
: データベースから添付ファイルが削除された直後に実行する。
 
: データベースから添付ファイルが削除された直後に実行する。
 +
: アクション関数引数: 添付ファイル ID
  
; delete_category
+
;[[プラグイン_API/アクションフック一覧/delete_category|delete_category]]
: アクション関数引数: カテゴリーID
+
 
: データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除された後に実行する。
 
: データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除された後に実行する。
 +
: アクション関数引数: カテゴリー ID
 +
 +
;[[プラグイン_API/アクションフック一覧/delete_post|delete_post]]
 +
: 投稿またはページが削除される直前に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID
  
; delete_post
+
;[[プラグイン_API/アクションフック一覧/deleted_post|deleted_post]]
: 投稿記事またはページが削除される直前に実行する。
+
: 投稿またはページが削除された直後に実行する。
 +
: アクション関数引数: 投稿 ID またはページ ID
  
; edit_attachment
+
;[[プラグイン_API/アクションフック一覧/edit_attachment|edit_attachment]]
: アクション関数引数: 添付ファイルID
+
 
: データベースで添付ファイル情報が編集・更新された際に実行する。
 
: データベースで添付ファイル情報が編集・更新された際に実行する。
 +
: アクション関数引数: 添付ファイル ID
  
; edit_category
+
;[[プラグイン_API/アクションフック一覧/edit_category|edit_category]]
: アクション関数引数: カテゴリーID
+
: カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する投稿やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
: カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する記事やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
+
: アクション関数引数: カテゴリー ID
  
; edit_post
+
;[[プラグイン_API/アクションフック一覧/edit_post|edit_post]]
: アクション関数引数: 投稿記事IDまたはページID
+
: 投稿またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
: 投稿記事またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
+
: アクション関数引数: 投稿 ID またはページ ID
  
; private_to_published
+
;[[プラグイン_API/アクションフック一覧/pre_post_update|pre_post_update]]
: アクション関数引数: 投稿記事ID
+
: 投稿またはページが更新される直前に実行する。
: 投稿記事のステータスが非公開か公開へ変更された際に実行する。
+
: アクション関数引数: 投稿 ID
  
; publish_page
+
;[[プラグイン_API/アクションフック一覧/private_to_publish|private_to_publish]]
: アクション関数引数: ページID
+
: ([[Post Status Transitions|投稿ステータス遷移]]も参照)投稿のステータスが非公開から公開へ変更された際に実行する。
: 記事・ページが公開された際、またはステータスが「公開」に変更された場合に実行する。
+
: アクション関数引数: 投稿オブジェクト(すべてのステータス変更に実行するアクションもある。[[関数リファレンス/transition_post_status|wp_transition_post_status()]] を参照)
: 注:バージョン2.3以上ではこのフックの代わりにtransition_post_statusを使用する。
+
  
; publish_phone
+
;[[プラグイン_API/アクションフック一覧/publish_page|publish_page]]
: アクション関数引数: 投稿記事ID
+
: 投稿・ページが公開された際、またはステータスが「公開」に変更された場合に実行する。
: メールから記事が投稿された直後に実行する。
+
: アクション関数引数: ページ ID
 +
: 注: バージョン2.3以上ではこのフックの代わり に[[関数リファレンス/transition_post_status|wp_transition_post_status()]] を使用する。
  
; publish_post
+
;[[プラグイン_API/アクションフック一覧/publish_phone|publish_phone]]
: アクション関数引数: 投稿記事ID
+
: メールから投稿が公開された直後に実行する。
: 投稿記事が公開された際、または公開済みの記事の情報が編集された際に実行する。
+
: アクション関数引数: 投稿 ID
  
; save_post
+
;[[プラグイン_API/アクションフック一覧/publish_post|publish_post]]
: アクション関数引数: 投稿記事ID
+
: 投稿が公開された際、または公開済み投稿の情報が編集された際に実行する。
: インポート機能の利用、記事・ページ編集フォームの利用、XMLRPCでの投稿、メールでの投稿のうちいずれかの方法で記事・ページが作成・更新された際に実行する。
+
: アクション関数引数: 投稿 ID
  
; wp_insert_post
+
;[[プラグイン_API/アクションフック一覧/save_post|save_post]]
: 動作はsave_postと同じ。save_postの直後に実行する。
+
: インポート機能の利用、投稿・ページ編集フォームの利用、XMLRPCでの投稿、メールでの投稿のうちいずれかの方法で投稿・ページが作成・更新された際に実行する。実行されるタイミングはデータがデータベースに保存された後。
 +
: アクション関数引数: 投稿 ID
 +
: 投稿 ID は最後に保存した投稿ではなく投稿履歴を参照していることもある。実際の投稿の ID を取得するには、wp_is_post_revision を使う。
  
; xmlrpc_publish_post
+
;[[プラグイン_API/アクションフック一覧/wp_insert_post|wp_insert_post]]
: アクション関数引数: 投稿記事ID
+
: 動作はsave_postと同じ。<code>save_post</code> の直後に実行する。
: XMLRPCリクエストによる記事が投稿された際、またはXMLRPCを通してステータスが「公開」に変更された際に実行する。
+
 
 +
;[[プラグイン_API/アクションフック一覧/xmlrpc_publish_post|xmlrpc_publish_post]]
 +
: 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_on_draft|comment_on_draft]]
: アクション関数引数: 投稿記事ID
+
: コメント投稿フォームまたはコメントを表示しようとしている際、投稿が非公開状態の場合に実行する。
: コメント投稿フォームまたはコメントを表示しようとしている際、記事が非公開状態の場合に実行する。
+
: アクション関数引数: 投稿 ID
  
; comment_post
+
;[[プラグイン_API/アクションフック一覧/comment_post|comment_post]]
: アクション関数引数: コメントID、承認ステータス(spam/スパム、0/未承認、1/承認済み)
+
 
: コメントがデータベースに保存される直前に実行する。
 
: コメントがデータベースに保存される直前に実行する。
 +
: アクション関数引数: コメント 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/アクションフック一覧/pingback_post|pingback_post]]
: アクション関数引数: コメントID
+
: ピンバックが投稿に追加された際に実行する。
: ピンバックが投稿記事に追加された際に実行する。
+
: アクション関数引数: コメント ID
  
; pre_ping
+
;[[プラグイン_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アドレス、投稿者のユーザーエージェント情報
  
; 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]]
: アクション関数引数: コメント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 などフィードの種類を入れる。フィードが表示さsれる前に実行するには、10以下の<var>プライオリティ</var>を指定すること。
: RSS2、Atom、RDFなどのフィードが生成される直前に実行する。フィード名には rss2、atom などフィードの種類を入れる。
+
: アクション関数引数: フィードの種類(コメントフィードなら true、投稿フィードなら false)
  
 
== テンプレート関連のアクション ==
 
== テンプレート関連のアクション ==
  
; comment_form
+
; [[プラグイン_API/アクションフック一覧/comment_form|comment_form]]
: アクション関数引数: 投稿記事ID
+
 
: 標準のテーマにコメントを挿入するために実行する。
 
: 標準のテーマにコメントを挿入するために実行する。
 +
: アクション関数引数: 投稿 ID
  
; do_robots
+
; [[プラグイン_API/アクションフック一覧/do_robots|do_robots]]
: テンプレートファイルを選択する際、リクエストがrobots.txtに対するものの場合に実行する。
+
: テンプレートファイルを選択する際、リクエストが <code>robots.txt</code> に対するものの場合に実行する。
  
; do_robotstxt
+
; [[プラグイン_API/アクションフック一覧/do_robotstxt|do_robotstxt]]
: do_robots関数内でrobots.txtファイルにDisallowリストを表示する際に実行する。
+
: <code>do_robots</code> 関数内で <code>robots.txt</code> ファイルに Disallow リストを表示する際に実行する。
  
; get_footer
+
; [[プラグイン_API/アクションフック一覧/get_footer|get_footer]]
: テンプレートがget_footer関数を呼び出した際、footer.phpファイルが読み込まれる直前に実行する。
+
: テンプレートが [[関数リファレンス/get_footer|get_footer 関数]]を呼び出した際、<code>footer.php</code> ファイルが読み込まれる直前に実行する。
  
; get_header
+
; [[プラグイン_API/アクションフック一覧/get_header|get_header]]
: テンプレートがget_header関数を呼び出した際、header.phpファイルが読み込まれる直前に実行する。
+
: テンプレートが [[関数リファレンス/get_header|get_header 関数]]を呼び出した際、<code>header.php</code>ファイルが読み込まれる直前に実行する。
  
; switch_theme  
+
; [[プラグイン_API/アクションフック一覧/switch_theme|switch_theme]]
: アクション関数引数: 変更されたテーマの名称
+
 
: ブログのテーマが変更された際に実行する。
 
: ブログのテーマが変更された際に実行する。
 +
: アクション関数引数: 変更されたテーマの名称
  
; template_redirect
+
; [[プラグイン_API/アクションフック一覧/template_redirect|template_redirect]]
 
: リクエストされたページの表示に使用するテンプレートファイルを判断する前に実行し、プラグインがテンプレートファイルの選択を上書きできるようにする。
 
: リクエストされたページの表示に使用するテンプレートファイルを判断する前に実行し、プラグインがテンプレートファイルの選択を上書きできるようにする。
: 以下は(実用的ではない)例で、すべてのリクエストを現在のテーマディレクトリ内にある all.php ファイルにリダイレクトする。
+
: 以下は(実用的ではない)例で、すべてのリクエストを現在のテーマディレクトリ内にある <code>all.php</code> ファイルにリダイレクトする。
 
<pre><nowiki>function all_on_one () {
 
<pre><nowiki>function all_on_one () {
 
include(TEMPLATEPATH . '/all.php');
 
include(TEMPLATEPATH . '/all.php');
192行目: 306行目:
 
add_action('template_redirect', 'all_on_one');</nowiki></pre>
 
add_action('template_redirect', 'all_on_one');</nowiki></pre>
  
; wp_footer  
+
; [[プラグイン_API/アクションフック一覧/wp_footer|wp_footer]]
: テンプレートがwp_footer関数を呼び出す際に実行する。wp_footer関数は通常、ブログページの最後付近で使われる。
+
: テンプレートが [[関数リファレンス/wp_footer|wp_footer 関数]]を呼び出す際に実行する。<code>wp_footer</code> 関数は通常、ブログページの最後付近で使われる。
  
; [[:en:Hook_Reference/wp_head|wp_head]]  
+
; [[プラグイン_API/アクションフック一覧/wp_head|wp_head]]
: テンプレートがwp_head関数を呼び出す際に実行する。wp_head関数は通常、ブログページの先頭付近の<nowiki><head></nowiki>要素内で使われる。
+
: テンプレートが [[関数リファレンス/wp_head|wp_head 関数]]を呼び出す際に実行する。wp_head 関数は通常、ブログページの先頭付近の <code><nowiki><head></nowiki></code> 要素内で使われる。
  
; wp_meta
+
; [[プラグイン_API/アクションフック一覧/wp_meta|wp_meta]]
: sidebar.phpテンプレートがwp_meta関数を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入することができるようにする。
+
: <code>sidebar.php</code>テンプレートが [[関数リファレンス/wp_meta|wp_meta 関数]]を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入することができるようにする。
  
; wp_print_scripts
+
; [[プラグイン_API/アクションフック一覧/wp_print_scripts|wp_print_scripts]]
: ページの<nowiki><head></nowiki>要素に、登録されたJavaScriptを出力する直前に実行する。
+
: ページの <code><nowiki><head></nowiki></code> 要素に、登録された JavaScript を出力する直前に実行する。
  
 
== 管理画面関連のアクション ==
 
== 管理画面関連のアクション ==
  
; activate_プラグインファイル名
+
; [[プラグイン_API/アクションフック一覧/activate_(plugin_file_name)|activate_プラグインファイル名]]
: プラグインを初めて有効化する際に実行する。
+
: プラグインを初めて有効化する際に実行する。[[関数リファレンス/register_activation_hook|register_activation_hook()]] /[[:en:Function_Reference/register_activation_hook|en]] を参照。
  
; activity_box_end
+
; [[プラグイン_API/アクションフック一覧/activity_box_end|activity_box_end]]
 
: 管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
 
: 管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
  
; add_category_form_pre
+
; [[プラグイン_API/アクションフック一覧/add_category_form_pre|add_category_form_pre]]
 
: 管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
 
: 管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
  
; admin_head  
+
; [[プラグイン_API/アクションフック一覧/admin_head|admin_head]]
: 管理画面各ページの<nowiki><head></nowiki>要素内で実行する。
+
: 管理画面各ページ HTML の <code><nowiki><head></nowiki></code> 要素内で実行する。
  
; admin_head-ページフック名
+
; [[プラグイン_API/アクションフック一覧/admin_head-(page_hook)|admin_head-ページフック名]]
; admin_head-プラグイン管理ページ名
+
; [[プラグイン_API/アクションフック一覧/admin_head-(plugin_page)|admin_head-プラグイン管理ページ名]]
: プラグインが生成した管理画面ページの <nowiki><head></nowiki> 要素内で実行する。
+
: プラグインが生成した管理画面ページの <code><nowiki><head></nowiki></code> 要素内で実行する。
  
; admin_footer
+
;[[プラグイン_API/アクションフック一覧/admin_init|admin_init]]
: 管理画面各ページの<nowiki><body></nowiki>要素の終盤で実行する。
+
: 管理画面各ページの最初、ページがレンダリングされる前に実行する。<tt>wp-admin/admin.php</tt>、<tt>wp-admin/admin-post.php</tt>、<tt>wp-admin/admin-ajax.php</tt> を参照。
  
; admin_print_scripts
+
;[[プラグイン_API/アクションフック一覧/admin_footer-(plugin_page)|admin_footer-(plugin_page)]]
: 管理画面各ページの<nowiki><head></nowiki>要素にJavaScriptを追加するために実行する。
+
: プラグインが生成した管理画面ページの  <code><nowiki><body></nowiki></code> 要素の最後で実行する。
  
; admin_print_scripts-ページフック名
+
; [[プラグイン_API/アクションフック一覧/admin_footer|admin_footer]]
; admin_print_scripts-プラグイン管理ページ名
+
: 管理画面各ページの <code><nowiki><body></nowiki></code> 要素の終盤で実行する。
: プラグインが生成した管理画面ページの<nowiki><head></nowiki>要素にJavaScriptを追加するために実行する。
+
  
; check_passwords
+
; [[プラグイン_API/アクションフック一覧/admin_print_scripts|admin_print_scripts]]
: アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
+
: 管理画面各ページの <code><nowiki><head></nowiki></code> 要素に JavaScript を追加するために実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_styles|admin_print_styles]]
 +
: 管理画面各ページの <code><nowiki><head></nowiki></code> 要素に CSS を追加するために実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/admin_print_scripts-(page_hook)|admin_print_scripts-ページフック名]]
 +
; [[プラグイン_API/アクションフック一覧/admin_print_scripts-(plugin_page)|admin_print_scripts-プラグイン管理ページ名]]
 +
: プラグインが生成した管理画面ページの <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', 9, __FILE__, 'myplugin_admin_page' );
 +
    add_action( "admin_print_scripts-$page", 'myplugin_admin_head' );
 +
  }
 +
}
 +
</pre>
 +
 
 +
; [[プラグイン_API/アクションフック一覧/check_passwords|check_passwords]]
 
: 新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
 
: 新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
 +
: アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
  
; dbx_page_advanced(ページ)
+
; [[プラグイン_API/アクションフック一覧/dbx_post_advanced|dbx_post_advanced]](投稿)
; dbx_post_advanced(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/dbx_page_advanced|dbx_page_advanced]](ページ)
 
: 各編集管理画面の、詳細オプション部分の最後に実行する。
 
: 各編集管理画面の、詳細オプション部分の最後に実行する。
  
; dbx_page_sidebar(ページ)
+
; [[プラグイン_API/アクションフック一覧/dbx_post_sidebar|dbx_post_sidebar]](投稿)
; dbx_post_sidebar(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/dbx_page_sidebar|dbx_page_sidebar]](ページ)
: 各編集管理画面の、サイドバー部分の最後に実行する。
+
: 各編集管理画面のサイドバー部分の最後に実行する。WordPress 2.5以上では [[関数リファレンス/add_meta_box|add_meta_box()]] を使用すること。
  
; deactivate_(プラグインファイル名)
+
; [[プラグイン_API/アクションフック一覧/deactivate_(plugin file name)|deactivate_プラグインファイル名]]
 
: プラグインが無効化された際に実行する。
 
: プラグインが無効化された際に実行する。
  
; delete_user
+
; [[プラグイン_API/アクションフック一覧/delete_user|delete_user]]
: アクション関数引数: ユーザーID
+
 
: ユーザーが削除された際に実行する。
 
: ユーザーが削除された際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; edit_category_form
+
; [[プラグイン_API/アクションフック一覧/edit_category_form|edit_category_form]]
 
: カテゴリー追加・編集フォームが管理画面に表示された後、<nowiki><form></nowiki>要素の閉じタグの前に実行する。
 
: カテゴリー追加・編集フォームが管理画面に表示された後、<nowiki><form></nowiki>要素の閉じタグの前に実行する。
  
; edit_category_form_pre
+
; [[プラグイン_API/アクションフック一覧/edit_category_form_pre|edit_category_form_pre]]
 
: カテゴリー編集フォームが管理画面に表示される前に実行する。
 
: カテゴリー編集フォームが管理画面に表示される前に実行する。
  
; edit_form_advanced(投稿記事)
+
; [[プラグイン_API/アクションフック一覧/edit_tag_form|edit_tag_form]]
; edit_page_form(ページ)
+
: タグ編集フォームが管理画面メニューに表示される前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_tag_form_pre|edit_tag_form_pre]]
 +
: タグ追加・編集フォームが管理画面に表示された後、HTML フォームタグの最後よりも前に実行する。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/edit_form_advanced|edit_form_advanced]](投稿)
 +
; [[プラグイン_API/アクションフック一覧/edit_page_form|edit_page_form]](ページ)
 
: 編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
 
: 編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
  
; edit_user_profile
+
; [[プラグイン_API/アクションフック一覧/edit_user_profile|edit_user_profile]]
 
: 管理画面のユーザープロフィール編集ページ終盤で実行する。
 
: 管理画面のユーザープロフィール編集ページ終盤で実行する。
  
; load-ページ名
+
; [[プラグイン_API/アクションフック一覧/oad-(page)|load-ページ名]]
: 管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加される。[[:en:Adding Administration Menus|管理画面のカスタマイズ]] (en) を参照。
+
: 管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加されることはない。
 +
管理メニューに追加するための詳細は[[Adding Administration Menus|管理画面のカスタマイズ]]を参照。
 +
直接使いたい場合は <tt>add_options_page</tt> やこれに似た関数の返り値としてアクション名の「ページ名」の部分が返される。
 +
 +
; [[プラグイン_API/アクションフック一覧/login_form|login_form]]
 +
: ログインフォームが読み込みが完了する直前に実行する。
  
; login_form
+
; [[プラグイン_API/アクションフック一覧/login_head|login_head]]
: ログインフォームが読み込まれる終盤で実行する。
+
: ログインページの <code><nowiki><head></nowiki></code> 要素の読み込みが完了する直前に実行する。
  
; login_head
+
; [[プラグイン_API/アクションフック一覧/lost_password|lost_password]]
: ログインページの<nowiki><head></nowiki>要素終盤で実行する。
+
 
+
; lost_password
+
 
: ログイン画面のパスワード紛失フォームが表示される直前に実行する。
 
: ログイン画面のパスワード紛失フォームが表示される直前に実行する。
  
; lostpassword_form
+
; [[プラグイン_API/アクションフック一覧/lostpassword_form|lostpassword_form]]
 
: パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
 
: パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
  
; lostpassword_post
+
; [[プラグイン_API/アクションフック一覧/lostpassword_post|lostpassword_post]]
: ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前にPHPの$_POST変数を修正できるようになる。
+
: ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前に PHP の $_POST 変数を修正できるようになる。
 +
 
 +
; [[プラグイン_API/アクションフック一覧/manage_link_custom_column|manage_link_custom_column]]
 +
: リンク管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、<code>manage_posts_columns</code> の項を参照。
 +
: アクション関数引数: カラム名、リンク ID
  
; manage_link_custom_column
+
; [[プラグイン_API/アクションフック一覧/manage_posts_custom_column|manage_posts_custom_column]]
: アクション関数引数: カラム名、リンクID
+
: 投稿管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、<code>manage_posts_columns</code>(カスタムカラムを追加する)の項を参照。
: リンク管理画面で不明なカラム名が存在する際に実行する。詳しくは[[プラグイン API/フィルターフック一覧]]、manage_posts_columnsの項を参照。
+
: アクション関数引数: カラム名、リンク ID
  
; mce_options
+
; [[プラグイン_API/アクションフック一覧/mce_options|mce_options]]
 
: リッチテキストエディター用に出力された、JavaScript設定リストの最後で実行する。
 
: リッチテキストエディター用に出力された、JavaScript設定リストの最後で実行する。
  
; password_reset
+
; [[プラグイン_API/アクションフック一覧/password_reset|password_reset]]
 
: ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
 
: ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
  
; personal_options_update
+
; [[プラグイン_API/アクションフック一覧/personal_options_update|personal_options_update]]
 
: ユーザーが管理画面から個人設定を更新した際に実行する。
 
: ユーザーが管理画面から個人設定を更新した際に実行する。
  
; plugins_loaded
+
; [[プラグイン_API/アクションフック一覧/plugins_loaded|plugins_loaded]]
 
: すべてのプラグインが読み込まれた後に実行する。
 
: すべてのプラグインが読み込まれた後に実行する。
  
; profile_personal_options
+
; [[プラグイン_API/アクションフック一覧/profile_personal_options|profile_personal_options]]
 
: ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
 
: ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
  
; profile_update
+
; [[プラグイン_API/アクションフック一覧/profile_update|profile_update]]
: アクション関数引数: ユーザーID
+
 
: ユーザープロフィールが更新された際に実行する。
 
: ユーザープロフィールが更新された際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; register_form
+
; [[プラグイン_API/アクションフック一覧/register_form|register_form]]
 
: 新規ユーザー登録フォームの終わり直前で実行する。
 
: 新規ユーザー登録フォームの終わり直前で実行する。
  
; register_post
+
; [[プラグイン_API/アクションフック一覧/register_post|register_post]]
 
: 新規ユーザー登録リクエストが処理される前に実行する。
 
: 新規ユーザー登録リクエストが処理される前に実行する。
  
; restrict_manage_posts
+
; [[プラグイン_API/アクションフック一覧/restrict_manage_posts|restrict_manage_posts]]
: 管理画面で編集する記事の一覧が出力される前に実行する。
+
: 管理画面で編集する投稿の一覧が出力される前に実行する。
  
; retrieve_password
+
; [[プラグイン_API/アクションフック一覧/retrieve_password|retrieve_password]]
: アクション関数引数: ユーザーのログイン名
+
 
: リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
 
: リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
 +
: アクション関数引数: ユーザーのログイン名
  
; set_current_user
+
; [[プラグイン_API/アクションフック一覧/set_current_user|set_current_user]]
: デフォルトのwp_set_current_user関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: デフォルトの wp_set_current_user 関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; show_user_profile
+
; [[プラグイン_API/アクションフック一覧/show_user_profile|show_user_profile]]
 
: ユーザープロフィール編集画面が読み込まれる終盤で実行する。
 
: ユーザープロフィール編集画面が読み込まれる終盤で実行する。
  
; simple_edit_form
+
; [[プラグイン_API/アクションフック一覧/simple_edit_form|simple_edit_form]]
 
: 詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
 
: 詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
  
; update_option_オプション名
+
; [[プラグイン_API/アクションフック一覧/update_option_(option_name)|update_option_オプション名]]
 +
: update_option 関数でブログの設定を更新した後に実行する。例えばfooという設定が更新された場合にアクションを加えたい場合は、update_option_foo というアクションフックを定義する。
 
: アクション関数引数: 古い設定値、新しい設定値
 
: アクション関数引数: 古い設定値、新しい設定値
: update_option関数でブログの設定を更新した後に実行する。例えばfooという設定が更新された場合にアクションを加えたい場合は、update_option_fooというアクションフックを定義する。
 
  
; upload_files_タブ名
+
; [[プラグイン_API/アクションフック一覧/upload_files_(tab)|upload_files_タブ]]
: アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabsフィルターでカスタムタブを定義する。詳しくは[[プラグイン API/フィルターフック一覧]]、wp_upload_tabsの項を参照。
+
: アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabs フィルターでカスタムタブを定義する。詳しくは[[プラグイン API/フィルターフック一覧]]、wp_upload_tabs の項を参照。
  
; user_register
+
; [[プラグイン_API/アクションフック一覧/user_register|user_register]]
: アクション関数引数: ユーザーID
+
 
: ユーザーのプロフィールを新規追加する際に実行する。
 
: ユーザーのプロフィールを新規追加する際に実行する。
 +
: アクション関数引数: ユーザー ID
  
; wp_ajax_アクション名
+
; [[プラグイン_API/アクションフック一覧/wp_ajax_(action)|wp_ajax_アクション名]]
 
: 管理画面で、不明なタイプのAJAXアクションを行うために実行する。
 
: 管理画面で、不明なタイプのAJAXアクションを行うために実行する。
  
; wp_authenticate
+
; [[プラグイン_API/アクションフック一覧/wp_authenticate|wp_authenticate]]
: アクション関数引数: ユーザー名とパスワードの配列
+
 
: ユーザーのログイン認証時に実行する。
 
: ユーザーのログイン認証時に実行する。
 +
: アクション関数引数: ユーザー名とパスワードの配列
  
; wp_login
+
; [[プラグイン_API/アクションフック一覧/wp_login|wp_login]]
 
: ユーザーがログインした際に実行する。
 
: ユーザーがログインした際に実行する。
  
; wp_logout
+
; [[プラグイン_API/アクションフック一覧/wp_logout|wp_logout]]
 
: ユーザーがログアウトした際に実行する。
 
: ユーザーがログアウトした際に実行する。
 +
 +
== ダッシュボード「現在の状況」ウィジェットアクション ==
 +
 +
; [[プラグイン_API/アクションフック一覧/right_now_content_table_end|right_now_content_table_end]]
 +
: 「現在の状況」ダッシュボードウィジェットの下にテーブル行を追加する。
 +
 +
; [[プラグイン_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]]
 +
: 現在のバージョン情報が「現在の状況」ウィジェット上に表示された直後に呼び出される。
 +
 +
; [[プラグイン_API/アクションフック一覧/activity_box_end|activity_box_end]]
 +
: 「現在の状況」ウィジェットで呼び出される最後のアクション。
  
 
== その他の高度なアクション ==
 
== その他の高度なアクション ==
このセクションでは、表示する記事を判断するクエリ、WordPressループ、プラグインの有効化など、WordPressの基本的なコードに関連する高度なアクションを紹介しています。
+
このセクションでは、表示する投稿を判断するクエリ、WordPressループ、プラグインの有効化など、WordPressの基本的なコードに関連する高度なアクションを紹介しています。
  
; admin_menu
+
; [[プラグイン_API/アクションフック一覧/admin_menu|admin_menu]]
 
: 管理画面メニューの基本構造が配置された後に実行する。
 
: 管理画面メニューの基本構造が配置された後に実行する。
  
; admin_notices
+
; [[プラグイン_API/アクションフック一覧/admin_notices|admin_notices]]
 
: 管理画面メニューがページに出力された後に実行する。
 
: 管理画面メニューがページに出力された後に実行する。
  
; blog_privacy_selector
+
; [[プラグイン_API/アクションフック一覧/blog_privacy_selector|blog_privacy_selector]]
 
: デフォルトのブログプライバシー設定がページに出力された後に実行する。
 
: デフォルトのブログプライバシー設定がページに出力された後に実行する。
  
; check_admin_referer
+
; [[プラグイン_API/アクションフック一覧/check_admin_referer|check_admin_referer]]
: デフォルトのcheck_admin_referrer関数内で、セキュリティ用にナンス(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: デフォルトのcheck_admin_referrer 関数内で、セキュリティ用に nonce(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; check_ajax_referer
+
; [[プラグイン_API/アクションフック一覧/check_ajax_referer|check_ajax_referer]]
: ユーザーのログインIDとパスワードがCookieによって認証された後、デフォルトのcheck_ajax_referer関数内で実行する。これを使い、認証ができなかった場合のセキュリティを高めることができる。check_ajax_referer関数はwp-admin/admin-ajax.phpスクリプトに対してAJAXリクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: ユーザーのログイン IDとパスワードが Cookie によって認証された後、デフォルトの check_ajax_referer 関数内で実行する。これを使い、認証ができなかった場合のセキュリティを高めることができる。check_ajax_referer 関数は wp-admin/admin-ajax.php スクリプトに対して AJAX リクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; generate_rewrite_rules  
+
; [[プラグイン_API/アクションフック一覧/generate_rewrite_rules|generate_rewrite_rules]]
: アクション関数引数: WP_Rewriteクラスの変数リスト
+
: URL リライトルールが生成された後に実行する。
: URLリライトルールが生成された後に実行する。
+
: アクション関数引数: WP_Rewrite クラスの変数リスト
: 注:リライトルールを修正するには、このアクションよりもrewrite_rules_arrayフィルターの方が使いやすい。
+
: : リライトルールを修正するには、このアクションよりも rewrite_rules_array フィルターの方が使いやすい。
  
; init
+
; [[プラグイン_API/アクションフック一覧/loop_end|init]]
: WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GETや$_POSTトリガーを妨害するために使える。
+
: WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GET や $_POST トリガーを妨害するために使える。
  
; loop_end
+
; [[プラグイン_API/アクションフック一覧/loop_end|loop_end]]
 
: 最後のWordPressループが処理された後に実行する。
 
: 最後のWordPressループが処理された後に実行する。
  
; loop_start
+
; [[プラグイン_API/アクションフック一覧/loop_start|loop_start]]
: 最初のWordPressループが処理される前に実行する。
+
: 最初の WordPress ループが処理される前に実行する。
  
; parse_query
+
; [[プラグイン_API/アクションフック一覧/parse_query|parse_query]]
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
+
 
: クエリ解析の終盤で実行する。
 
: クエリ解析の終盤で実行する。
 +
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
  
; parse_request
+
; [[プラグイン_API/アクションフック一覧/parse_request|parse_request]]
: アクション関数引数: $wpオブジェクトへの参照を含む配列
+
: クエリリクエストが wp 関数内で解析された後に実行する。
: クエリリクエストがwp関数内で解析された後に実行する。
+
: アクション関数引数: $wp オブジェクトへの参照を含む配列
  
; pre_get_posts
+
; [[プラグイン_API/アクションフック一覧/pre_get_posts|pre_get_posts]]
: アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
+
 
: get_posts関数クエリの前に実行する。
 
: get_posts関数クエリの前に実行する。
 +
: アクション関数引数: $wp_query オブジェクトの内容(リスト形式)
  
; sanitize_comment_cookies
+
; [[プラグイン_API/アクションフック一覧/sanitize_comment_cookies|sanitize_comment_cookies]]
 
: HTTPリクエストからCookieが読み取られた後に実行する。
 
: HTTPリクエストからCookieが読み取られた後に実行する。
  
; send_headers
+
; [[プラグイン_API/アクションフック一覧/send_headers|send_headers]]
: アクション関数引数: グローバル$wpオブジェクトへの参照がある配列
+
 
: wp関数内でHTTPヘッダーが送信された後に実行する。
 
: wp関数内でHTTPヘッダーが送信された後に実行する。
 +
: アクション関数引数: グローバル $wp オブジェクトへの参照がある配列
  
; shutdown
+
; [[プラグイン_API/アクションフック一覧/shutdown|shutdown]]
 
: ページの出力が完全に終了した際に実行する。
 
: ページの出力が完全に終了した際に実行する。
  
; wp
+
; [[プラグイン_API/アクションフック一覧/wp|wp]]
 +
: wp 関数内でクエリが解析されて投稿が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
 
: アクション関数引数: $wpオブジェクトへの参照を含む配列
 
: アクション関数引数: $wpオブジェクトへの参照を含む配列
: wp関数内でクエリが解析されて記事が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
 
  
 
== これも読んでみよう ==
 
== これも読んでみよう ==
413行目: 573行目:
 
* [[プラグインの作成]] - プラグイン作成方法の説明
 
* [[プラグインの作成]] - プラグイン作成方法の説明
 
* [[プラグイン API]] - フィルターやアクションの使い方に関する記事
 
* [[プラグイン API]] - フィルターやアクションの使い方に関する記事
* [[プラグイン API/アクションフック一覧]] - アクションフックのリファフェンス
 
 
* [[プラグイン・リソース]] - プラグインに関するリソースの総合的な一覧
 
* [[プラグイン・リソース]] - プラグインに関するリソースの総合的な一覧
 
* [http://codex.wordpress.org/User:Skippy Skippy's list] アクションとフィルターの一覧
 
* [http://codex.wordpress.org/User:Skippy Skippy's list] アクションとフィルターの一覧
420行目: 579行目:
 
* [http://blog.taragana.com/index.php/archive/wordpress-2x-hooks-for-action-comprehensive-list-for-plugin-and-theme-developers/ Angsuman's list]ドキュメントとソースコード付きの WordPress アクションフックの総合的なリスト。WordPress 2.0 におけるアクションフックで明文化されているものと、されていないものの両方を含む。
 
* [http://blog.taragana.com/index.php/archive/wordpress-2x-hooks-for-action-comprehensive-list-for-plugin-and-theme-developers/ Angsuman's list]ドキュメントとソースコード付きの WordPress アクションフックの総合的なリスト。WordPress 2.0 におけるアクションフックで明文化されているものと、されていないものの両方を含む。
  
{{原文|Plugin API/Action Reference|55176}}<!-- 01:06, 28 March 2008 Azaozz 版 -->
+
{{原文|Plugin API/Action Reference|93122}}<!-- 2010-09-20T10:32:34 BrianLayman 版 -->
  
 
[[Category:プラグイン]]
 
[[Category:プラグイン]]
[[Category:上級トピック]]
 
[[Category:WordPress の開発]]
 
  
 
[[en:Plugin API/Action Reference]]
 
[[en:Plugin API/Action Reference]]
 
[[pt-br:Plugin API/Referencia das Acoes]]<!-- 赤リンクでもコメントアウトしないこと -->
 
[[pt-br:Plugin API/Referencia das Acoes]]<!-- 赤リンクでもコメントアウトしないこと -->

2010年11月13日 (土) 23:11時点における版

この記事は(おそらくほぼ完全な)アクションフックの一覧です。アクションフックはバージョン2.1以降から、プラグインおよびテーマ開発時に利用できるようになっています。詳しい情報については下記もご覧下さい。

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

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

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

  1. muplugins_loaded
  2. plugins_loaded
  3. sanitize_comment_cookies
  4. setup_theme
  5. load_textdomain
  6. after_setup_theme
  7. auth_cookie_malformed
  8. set_current_user
  9. init
  10. widgets_init
  11. register_sidebar
  12. wp_register_sidebar_widget
  13. wp_loaded
  14. parse_request*
  15. send_headers*
  16. pre_get_posts*
  17. posts_selection
  18. wp*
  19. template_redirect
  20. get_header
  21. wp_head
  22. wp_enqueue_scripts
  23. wp_print_styles
  24. wp_print_scripts
  25. get_template_part_loop
  26. loop_start*
  27. the_post*
  28. loop_end*
  29. get_sidebar
  30. dynamic_sidebar
  31. get_search_form
  32. parse_query*
  33. wp_meta
  34. get_footer
  35. twentyten_credits
  36. wp_footer
  37. wp_print_footer_scripts
  38. shutdown

アクション名のあとにアスタリスク(*) が付いているものは配列参照アクションであることを意味します。

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

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


  1. muplugins_loaded
  2. plugins_loaded
  3. sanitize_comment_cookies
  4. setup_theme
  5. load_textdomain
  6. after_setup_theme
  7. auth_cookie_valid
  8. set_current_user
  9. init
  10. widgets_init
  11. register_sidebar
  12. wp_register_sidebar_widget
  13. wp_loaded
  14. auth_redirect
  15. wp_default_scripts*
  16. _admin_menu
  17. admin_menu
  18. admin_init
  19. load-edit.php
  20. parse_request*
  21. send_headers*
  22. parse_query*
  23. pre_get_posts*
  24. posts_selection
  25. wp*
  26. admin_xml_ns
  27. wp_default_styles*
  28. admin_enqueue_scripts
  29. admin_print_styles-edit.php
  30. admin_print_styles
  31. admin_print_scripts-edit.php
  32. admin_print_scripts
  33. wp_print_scripts
  34. admin_head-edit.php
  35. admin_head
  36. in_admin_header
  37. adminmenu
  38. admin_notices
  39. restrict_manage_posts
  40. the_post*
  41. in_admin_footer
  42. admin_footer
  43. admin_print_footer_scripts
  44. wp_print_footer_scripts
  45. admin_footer-edit.php
  46. shutdown

アクション名のあとにアスタリスク(*) が付いているものは配列参照アクションであることを意味します。

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

add_attachment
データベースに添付ファイルが新規追加された際に実行する。
アクション関数引数: 添付ファイル ID
add_category
create_category と同様。
clean_post_cache
投稿キャッシュのクリア後に実行する。clean_post_cache() を参照。
アクション関数引数: 投稿 ID
create_category
カテゴリーが新規作成された際に実行する。
アクション関数引数: カテゴリー ID
delete_attachment
データベースから添付ファイルが削除された直後に実行する。
アクション関数引数: 添付ファイル ID
delete_category
データベースからカテゴリーが削除され、属していたリンク項目や投稿などからそのカテゴリー情報が削除された後に実行する。
アクション関数引数: カテゴリー ID
delete_post
投稿またはページが削除される直前に実行する。
アクション関数引数: 投稿 ID またはページ ID
deleted_post
投稿またはページが削除された直後に実行する。
アクション関数引数: 投稿 ID またはページ ID
edit_attachment
データベースで添付ファイル情報が編集・更新された際に実行する。
アクション関数引数: 添付ファイル ID
edit_category
カテゴリーが更新・編集する際に実行する。これには、そのカテゴリーに属する投稿やリンクが追加・削除された場合(カテゴリー内の項目数が更新される)も含む。
アクション関数引数: カテゴリー ID
edit_post
投稿またはページが更新・編集された際に実行する。これには、コメントが追加・更新された場合(投稿またはページのコメント数が更新される)も含む。
アクション関数引数: 投稿 ID またはページ ID
pre_post_update
投稿またはページが更新される直前に実行する。
アクション関数引数: 投稿 ID
private_to_publish
投稿ステータス遷移も参照)投稿のステータスが非公開から公開へ変更された際に実行する。
アクション関数引数: 投稿オブジェクト(すべてのステータス変更に実行するアクションもある。wp_transition_post_status() を参照)
publish_page
投稿・ページが公開された際、またはステータスが「公開」に変更された場合に実行する。
アクション関数引数: ページ ID
注: バージョン2.3以上ではこのフックの代わり にwp_transition_post_status() を使用する。
publish_phone
メールから投稿が公開された直後に実行する。
アクション関数引数: 投稿 ID
publish_post
投稿が公開された際、または公開済み投稿の情報が編集された際に実行する。
アクション関数引数: 投稿 ID
save_post
インポート機能の利用、投稿・ページ編集フォームの利用、XMLRPCでの投稿、メールでの投稿のうちいずれかの方法で投稿・ページが作成・更新された際に実行する。実行されるタイミングはデータがデータベースに保存された後。
アクション関数引数: 投稿 ID
投稿 ID は最後に保存した投稿ではなく投稿履歴を参照していることもある。実際の投稿の ID を取得するには、wp_is_post_revision を使う。
wp_insert_post
動作はsave_postと同じ。save_post の直後に実行する。
xmlrpc_publish_post
XMLRPC リクエストによる投稿が作成された際、または XMLRPC を通してステータスが「公開」に変更された際に実行する。
アクション関数引数: 投稿 ID

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

comment_closed
コメントを受け付けない指定をした投稿で、コメント送信フォームを表示しようとする際に実行する。
アクション関数引数: 投稿 ID
comment_id_not_found
コメント送信フォームを表示しようとする際、投稿 ID が見つからなかった場合に実行する。
アクション関数引数: 投稿 ID
comment_flood_trigger
連続コメントエラーが検出された際、wp_dieが呼び出されてコメントを拒否する直前に実行する。
アクション関数引数: 前回のコメント送信日時、今回のコメント送信日時
comment_on_draft
コメント投稿フォームまたはコメントを表示しようとしている際、投稿が非公開状態の場合に実行する。
アクション関数引数: 投稿 ID
comment_post
コメントがデータベースに保存される直前に実行する。
アクション関数引数: コメント ID、承認ステータス(spam/スパム、0/未承認、1/承認済み)
edit_comment
データベース内でコメントが編集・更新された後に実行する。
アクション関数引数: コメント ID
delete_comment
コメントが削除される直前に実行する。
アクション関数引数: コメント ID
pingback_post
ピンバックが投稿に追加された際に実行する。
アクション関数引数: コメント ID
pre_ping
ピンバックが完全に処理される前に実行する。
アクション関数引数: 処理する投稿リンクの配列、投稿のピンバック受け付け設定
trackback_post
投稿にトラックバックが追加された際に実行する。
アクション関数引数: コメント ID
wp_blacklist_check
コメントをブラックリストに分類するかどうかチェックするために実行する。コメントを拒否するには、関数内でwp_dieを実行するか、入力引数に設定したブラックリストキーワードが含まれるように変更することができる。
アクション関数引数: 投稿者名、投稿者メールアドレス、投稿者URL、コメント本文、投稿者のIPアドレス、投稿者のユーザーエージェント情報
 ;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
コメントフィードにコメント情報が表示された直後、<item>タグを閉じる前に実行する。
アクション関数引数: コメント ID、投稿 ID
do_feed_フィード名
RSS2、Atom、RDFなどのフィードが生成される直前に実行する。フィード名には rss2、atom などフィードの種類を入れる。フィードが表示さsれる前に実行するには、10以下のプライオリティを指定すること。
アクション関数引数: フィードの種類(コメントフィードなら true、投稿フィードなら false)

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

comment_form
標準のテーマにコメントを挿入するために実行する。
アクション関数引数: 投稿 ID
do_robots
テンプレートファイルを選択する際、リクエストが robots.txt に対するものの場合に実行する。
do_robotstxt
do_robots 関数内で robots.txt ファイルに Disallow リストを表示する際に実行する。
get_footer
テンプレートが get_footer 関数を呼び出した際、footer.php ファイルが読み込まれる直前に実行する。
get_header
テンプレートが get_header 関数を呼び出した際、header.phpファイルが読み込まれる直前に実行する。
switch_theme
ブログのテーマが変更された際に実行する。
アクション関数引数: 変更されたテーマの名称
template_redirect
リクエストされたページの表示に使用するテンプレートファイルを判断する前に実行し、プラグインがテンプレートファイルの選択を上書きできるようにする。
以下は(実用的ではない)例で、すべてのリクエストを現在のテーマディレクトリ内にある all.php ファイルにリダイレクトする。
function all_on_one () {
	include(TEMPLATEPATH . '/all.php');
	exit;
}
add_action('template_redirect', 'all_on_one');
wp_footer
テンプレートが wp_footer 関数を呼び出す際に実行する。wp_footer 関数は通常、ブログページの最後付近で使われる。
wp_head
テンプレートが wp_head 関数を呼び出す際に実行する。wp_head 関数は通常、ブログページの先頭付近の <head> 要素内で使われる。
wp_meta
sidebar.phpテンプレートが wp_meta 関数を呼び出す際に実行し、プラグインがサイドバーにコンテンツを挿入することができるようにする。
wp_print_scripts
ページの <head> 要素に、登録された JavaScript を出力する直前に実行する。

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

activate_プラグインファイル名
プラグインを初めて有効化する際に実行する。register_activation_hook() /en を参照。
activity_box_end
管理画面ダッシュボードページで、「ブログの最新状況/現在の状況」ボックス部分の最後に実行する。
add_category_form_pre
管理画面で、カテゴリー追加フォームがページに表示される前に実行する。
admin_head
管理画面各ページ HTML の <head> 要素内で実行する。
admin_head-ページフック名
admin_head-プラグイン管理ページ名
プラグインが生成した管理画面ページの <head> 要素内で実行する。
admin_init
管理画面各ページの最初、ページがレンダリングされる前に実行する。wp-admin/admin.phpwp-admin/admin-post.phpwp-admin/admin-ajax.php を参照。
admin_footer-(plugin_page)
プラグインが生成した管理画面ページの <body> 要素の最後で実行する。
admin_footer
管理画面各ページの <body> 要素の終盤で実行する。
admin_print_scripts
管理画面各ページの <head> 要素に JavaScript を追加するために実行する。
admin_print_styles
管理画面各ページの <head> 要素に CSS を追加するために実行する。
admin_print_scripts-ページフック名
admin_print_scripts-プラグイン管理ページ名
プラグインが生成した管理画面ページの <head> 要素に JavaScript を追加するために実行する。「ページフック名」は add_management_page()、add_options_page() などのプラグインメニュー項目を追加する関数を使った場合に返される。例は以下のとおり。
function myplugin_menu() {
  if ( function_exists('add_management_page') ) {
    $page = add_management_page( 'myplugin', 'myplugin', 9, __FILE__, 'myplugin_admin_page' );
    add_action( "admin_print_scripts-$page", 'myplugin_admin_head' );
  }
}
check_passwords
新規ユーザー登録の際、パスワードの二重入力がマッチするか確認するために実行する。
アクション関数引数: ログイン名配列、1度目に入力されたパスワード、2度目に入力されたパスワード
dbx_post_advanced(投稿)
dbx_page_advanced(ページ)
各編集管理画面の、詳細オプション部分の最後に実行する。
dbx_post_sidebar(投稿)
dbx_page_sidebar(ページ)
各編集管理画面のサイドバー部分の最後に実行する。WordPress 2.5以上では add_meta_box() を使用すること。
deactivate_プラグインファイル名
プラグインが無効化された際に実行する。
delete_user
ユーザーが削除された際に実行する。
アクション関数引数: ユーザー ID
edit_category_form
カテゴリー追加・編集フォームが管理画面に表示された後、<form>要素の閉じタグの前に実行する。
edit_category_form_pre
カテゴリー編集フォームが管理画面に表示される前に実行する。
edit_tag_form
タグ編集フォームが管理画面メニューに表示される前に実行する。
edit_tag_form_pre
タグ追加・編集フォームが管理画面に表示された後、HTML フォームタグの最後よりも前に実行する。
edit_form_advanced(投稿)
edit_page_form(ページ)
編集画面で、詳細設定のセクションが読み込まれる直前に実行する。
edit_user_profile
管理画面のユーザープロフィール編集ページ終盤で実行する。
load-ページ名
管理メニューページが読み込まれる際に実行する。このアクションは通常、直接追加されることはない。

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

login_form
ログインフォームが読み込みが完了する直前に実行する。
login_head
ログインページの <head> 要素の読み込みが完了する直前に実行する。
lost_password
ログイン画面のパスワード紛失フォームが表示される直前に実行する。
lostpassword_form
パスワード紛失フォームの終盤で実行され、プラグインがフォームにフィールドを追加できるようにする。
lostpassword_post
ユーザーがパスワードの再発行をリクエストした際に実行する。これにより、処理の前に PHP の $_POST 変数を修正できるようになる。
manage_link_custom_column
リンク管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_posts_columns の項を参照。
アクション関数引数: カラム名、リンク ID
manage_posts_custom_column
投稿管理画面で不明なカラム名が存在する際に実行する。詳しくはプラグイン API/フィルターフック一覧manage_posts_columns(カスタムカラムを追加する)の項を参照。
アクション関数引数: カラム名、リンク ID
mce_options
リッチテキストエディター用に出力された、JavaScript設定リストの最後で実行する。
password_reset
ユーザーのパスワードがランダムな新パスワードにリセットされる前に実行する。
personal_options_update
ユーザーが管理画面から個人設定を更新した際に実行する。
plugins_loaded
すべてのプラグインが読み込まれた後に実行する。
profile_personal_options
ユーザープロフィールページの個人設定編集部分が読み込まれる終盤で実行する。
profile_update
ユーザープロフィールが更新された際に実行する。
アクション関数引数: ユーザー ID
register_form
新規ユーザー登録フォームの終わり直前で実行する。
register_post
新規ユーザー登録リクエストが処理される前に実行する。
restrict_manage_posts
管理画面で編集する投稿の一覧が出力される前に実行する。
retrieve_password
リマインダーメールを送信するためにユーザーのパスワードを取得した際に実行する。
アクション関数引数: ユーザーのログイン名
set_current_user
デフォルトの wp_set_current_user 関数で、ユーザーが変更された後に実行する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
show_user_profile
ユーザープロフィール編集画面が読み込まれる終盤で実行する。
simple_edit_form
詳細設定のセクションが含まれない「シンプルモード」記事投稿フォームの終盤で実行する。デフォルトではシンプルモードフォームが使われるのはブックマークレットからの投稿のみ。
update_option_オプション名
update_option 関数でブログの設定を更新した後に実行する。例えばfooという設定が更新された場合にアクションを加えたい場合は、update_option_foo というアクションフックを定義する。
アクション関数引数: 古い設定値、新しい設定値
upload_files_タブ
アップロードファイル管理画面を出力する際に実行する。タブ名にはカスタムアクションのタブ名を入れ、wp_upload_tabs フィルターでカスタムタブを定義する。詳しくはプラグイン API/フィルターフック一覧、wp_upload_tabs の項を参照。
user_register
ユーザーのプロフィールを新規追加する際に実行する。
アクション関数引数: ユーザー ID
wp_ajax_アクション名
管理画面で、不明なタイプのAJAXアクションを行うために実行する。
wp_authenticate
ユーザーのログイン認証時に実行する。
アクション関数引数: ユーザー名とパスワードの配列
wp_login
ユーザーがログインした際に実行する。
wp_logout
ユーザーがログアウトした際に実行する。

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

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

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

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

admin_menu
管理画面メニューの基本構造が配置された後に実行する。
admin_notices
管理画面メニューがページに出力された後に実行する。
blog_privacy_selector
デフォルトのブログプライバシー設定がページに出力された後に実行する。
check_admin_referer
デフォルトのcheck_admin_referrer 関数内で、セキュリティ用に nonce(セッションをユニークにするための暗号化に使われる乱数)を確認した後に実行する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
check_ajax_referer
ユーザーのログイン IDとパスワードが Cookie によって認証された後、デフォルトの check_ajax_referer 関数内で実行する。これを使い、認証ができなかった場合のセキュリティを高めることができる。check_ajax_referer 関数は wp-admin/admin-ajax.php スクリプトに対して AJAX リクエストがあった場合に呼び出される(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
generate_rewrite_rules
URL リライトルールが生成された後に実行する。
アクション関数引数: WP_Rewrite クラスの変数リスト
注: リライトルールを修正するには、このアクションよりも rewrite_rules_array フィルターの方が使いやすい。
init
WordPressの読み込みが完了し、ヘッダーが送信される前に実行する。$_GET や $_POST トリガーを妨害するために使える。
loop_end
最後のWordPressループが処理された後に実行する。
loop_start
最初の WordPress ループが処理される前に実行する。
parse_query
クエリ解析の終盤で実行する。
アクション関数引数: $wp_queryオブジェクトの内容(リスト形式)
parse_request
クエリリクエストが wp 関数内で解析された後に実行する。
アクション関数引数: $wp オブジェクトへの参照を含む配列
pre_get_posts
get_posts関数クエリの前に実行する。
アクション関数引数: $wp_query オブジェクトの内容(リスト形式)
sanitize_comment_cookies
HTTPリクエストからCookieが読み取られた後に実行する。
send_headers
wp関数内でHTTPヘッダーが送信された後に実行する。
アクション関数引数: グローバル $wp オブジェクトへの参照がある配列
shutdown
ページの出力が完全に終了した際に実行する。
wp
wp 関数内でクエリが解析されて投稿が読み込まれ、テンプレートが実行されるまでの間に実行する。出力にテンプレートを必要しないデータにアクセスする場合に活用できる。
アクション関数引数: $wpオブジェクトへの参照を含む配列

これも読んでみよう

  • プラグインの作成 - プラグイン作成方法の説明
  • プラグイン API - フィルターやアクションの使い方に関する記事
  • プラグイン・リソース - プラグインに関するリソースの総合的な一覧
  • Skippy's list アクションとフィルターの一覧
  • WordPress Hooks, WordPress の全フックに関する要覧
  • WordPress Hooks Database WordPress フックすべてのデータベース。どのバージョンから存在するかや、フックが使われる部分のソースコードへのリンク。
  • Angsuman's listドキュメントとソースコード付きの WordPress アクションフックの総合的なリスト。WordPress 2.0 におけるアクションフックで明文化されているものと、されていないものの両方を含む。

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