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

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

「プラグイン API/フィルターフック一覧」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(2008年2月末に作成した翻訳データの流し込み(暫定版。英語最新版との比較が必要))
 
(管理画面関連のフィルター: 英語版へのリンクの書き方を修正)
 
(10人の利用者による、間の24版が非表示)
1行目: 1行目:
この記事は(おそらくほぼ完全な)アクションフックの一覧です。アクションフックは[[Version 2.1|バージョン2.1]] 以降から、プラグインおよびテーマ開発時に利用できるようになっています。詳しい情報については下記もご覧下さい。
+
このページには、WordPress 2.1 以降のプラグイン開発で使える広範囲のフィルターフック一覧が含まれています(ただし、100%包括的なものではありません)。さらに詳しい情報については下記をご覧ください。
  
 
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧下さい。
 
* フィルターフック、アクションフックについてもっと詳しく知るには、[[プラグイン API]] をご覧下さい。
* プラグインの書き方については、[[: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]] (en) をご覧下さい。
 +
* 自動的に生成されたすべての WordPress フック一覧については [http://adambrown.info/p/wp_hooks WordPress Hooks Database] をご覧ください。
  
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
 
注: もしこの文書に情報を追加したり、内容をより分かりやすく書き換えたい場合は、現在のスタイルに従って編集を行ってください。
  
 
== 投稿、ページ、添付ファイル(アップロード)関連のフィルタ ==
 
== 投稿、ページ、添付ファイル(アップロード)関連のフィルタ ==
 +
 +
以下の[[#Category_and_Term_Filters|カテゴリー・タクソノミー項目関連のフィルター]]、[[#投稿者・ユーザー関連のフィルター|投稿者・ユーザー関連のフィルター]]、[[#リンク関連のフィルター|リンク関連のフィルター]]、[[#日付・時間関連のフィルター|日付・時間関連のフィルター]]、[[#管理画面関連のフィルター|管理画面関連のフィルター]]もご覧ください。
  
 
=== データベース読み出し ===
 
=== データベース読み出し ===
  
; attachment_icon
+
このセクションのフィルターは、データベースから読み出される情報に対してページや編集画面に表示される前に適用されます。
: フィルター関数引数: アイコンファイルのimg要素情報、添付ファイルID.
+
: get_attachment_icon関数で取得した添付ファイルのアイコンに適用される。
+
  
; attachment_innerHTML
+
; [[プラグイン API/フィルターフック一覧/attachment_fields_to_edit|attachment_fields_to_edit]] /[[:en:Plugin_API/Filter_Reference/attachment_fields_to_edit|en]]
: フィルター関数引数: innerHTML(デフォルトはタイトル)、添付ファイルID.
+
: フィルター関数引数: フォーム欄の配列、投稿オブジェクト
: get_attachment_innerHTML関数内で、添付ファイルにアイコンがない場合タイトルに使われる文字列に適用される。
+
: 添付ファイルを編集する際に表示されるフォームに適用される。<tt>get_attachment_fields_to_edit</tt> 関数で呼び出される。
  
; content_edit_pre(投稿記事本文)
+
; [[プラグイン API/フィルターフック一覧/attachment_icon|attachment_icon]] /[[:en:Plugin_API/Filter_Reference/attachment_icon|en]]
; excerpt_edit_pre(記事概要)
+
: フィルター関数引数: HTML img タグとしてのアイコンファイル、添付ファイル ID
; title_edit_pre(記事タイトル)
+
: <tt>get_attachment_icon</tt> 関数内で添付ファイルのアイコンに対して適用される。
: 各データが編集画面に表示される前に適用される。
+
  
; get_attached_file
+
; [[プラグイン API/フィルターフック一覧/attachment_innerHTML|attachment_innerHTML]] /[[:en:Plugin_API/Filter_Reference/attachment_innerHTML|en]]
: フィルター関数引数: ファイル情報、添付ファイルID
+
: フィルター関数引数: innerHTML(デフォルトはタイトル)、添付ファイル ID
: get_attached_file関数で取得した添付ファイル情報に適用される。
+
: <tt>get_attachment_innerHTML</tt> 関数内で、添付ファイルにアイコンがない場合タイトルに使われる文字列に適用される。
  
; get_enclosed
+
; [[プラグイン API/フィルターフック一覧/author_edit_pre|author_edit_pre]] /[[:en:Plugin_API/Filter_Reference/author_edit_pre|en]]
: get_enclosed関数で取得した記事のエンクロージャーリストに適用される。
+
: 投稿者が編集画面に表示される前に適用される。
  
; get_pages
+
; [[プラグイン API/フィルターフック一覧/body_class|body_class]] /[[:en:Plugin_API/Filter_Reference/body_class|en]]
: フィルター関数引数: ページリスト(各項目にはページのデータ配列が含まれる)、リクエストされたページを指定するget_pages関数の引数リスト
+
: フィルター関数引数: クラス名の配列、最初の配列に追加されたクラス名の配列
: get_pages関数で取得したページのリストに適用される。
+
: HTML <code>&lt;body&gt;</code> 要素のクラスに適用される。<code>[[関数リファレンス/get_body_class|get_body_class]] /[[:en:Function_Reference/get_body_class|en]]</code> 関数で呼び出される。
  
; get_pung
+
; [[プラグイン API/フィルターフック一覧/content_edit_pre|content_edit_pre]] /[[:en:Plugin_API/Filter_Reference/content_edit_pre|en]]
: get_pung関数で取得したピンバック受信URLのリストに適用される。
+
: 投稿コンテンツが編集画面に表示される前に適用される。
  
; get_the_excerpt
+
; [[プラグイン API/フィルターフック一覧/content_filtered_edit_pre|content_filtered_edit_pre]] /[[:en:Plugin_API/Filter_Reference/content_filtered_edit_pre|en]]
: get_the_excerpt関数で取得した記事の概要に適用される。
+
: フィルターされた投稿コンテンツが編集画面に表示される前に適用される。
  
; get_the_guid
+
; [[プラグイン API/フィルターフック一覧/excerpt_edit_pre|excerpt_edit_pre]] /[[:en:Plugin_API/Filter_Reference/excerpt_edit_pre|en]]
: get_the_guid関数で取得した記事のGUIDに適用される。
+
: 抜粋が編集画面に表示される前に適用される。
  
; get_to_ping
+
; [[プラグイン API/フィルターフック一覧/date_edit_pre|date_edit_pre]] /[[:en:Plugin_API/Filter_Reference/date_edit_pre|en]]
: get_to_ping関数で取得したピンバック先のURLリストに適用される。
+
: 投稿の日付が編集画面に表示される前に適用される。
  
; icon_dir
+
; [[プラグイン API/フィルターフック一覧/date_gmt_edit_pre|date_gmt_edit_pre]] /[[:en:Plugin_API/Filter_Reference/date_gmt_edit_pre|en]]
: テンプレートの画像ディレクトリに適用される。MIMEタイプアイコンの置き場所をプラグインを使って変更したいときに使える。
+
: 投稿の日付が編集画面に表示される前に適用される。
  
; icon_dir_uri
+
; [[プラグイン API/フィルターフック一覧/get_attached_file|get_attached_file]] /[[:en:Plugin_API/Filter_Reference/get_attached_file|en]]
: テンプレートの画像ディレクトリURLに適用される。MIMEタイプアイコンの置き場所をプラグインを使って変更したいときに使える。
+
: フィルター関数引数: ファイル情報、添付ファイル ID
 +
: <tt>get_attached_file</tt> 関数で取得した添付ファイル情報に適用される。
  
; prepend_attachment
+
; [[プラグイン API/フィルターフック一覧/get_enclosed|get_enclosed]] /[[:en:Plugin_API/Filter_Reference/get_enclosed|en]]
: prepend_attachment関数で先頭に追加するHTMLに適用される。
+
: <tt>get_enclosed</tt> 関数で取得した投稿のエンクロージャーリストに適用される。
  
; sanitize_title
+
; [[プラグイン API/フィルターフック一覧/get_pages|get_pages]] /[[:en:Plugin_API/Filter_Reference/get_pages|en]]
: sanitize_title関数でHTMLタグを除去した記事タイトル名に適用される。
+
: フィルター関数引数: ページのリスト(各項目にはページのデータ配列が含まれる)、リクエストされたページを指定する <tt>get_pages</tt> 関数の引数リスト
 +
: <tt>[[関数リファレンス/get_pages|get_pages]]</tt> 関数で取得したページのリストに適用される。
  
; single_post_title
+
; [[プラグイン API/フィルターフック一覧/get_pung|get_pung]] /[[:en:Plugin_API/Filter_Reference/get_pung|en]]
: wp_title関数およびsingle_post_title関数で記事タイトルを生成する際に適用される。
+
: <tt>get_pung</tt> 関数で取得したピンバック受信 URL のリストに適用される。
  
; the_content(記事本文)
+
; [[プラグイン API/フィルターフック一覧/get_the_archive_title|get_the_archive_title]] /[[:en:Plugin_API/Filter_Reference/get_the_archive_title|en]]
; the_excerpt(記事概要)
+
: <tt>get_the_archive_title</tt>関数でアーカイブのタイトルに適用される。
; the_tags(タグ)
+
; the_title(記事タイトル)
+
: データベースから取得したデータを画面に出力する前に適用される。the_tags以外はトラックバックなど他の操作でも使われる。
+
  
; the_content_rss(記事本文)
+
; [[プラグイン API/フィルターフック一覧/get_the_excerpt|get_the_excerpt]]
; the_excerpt_rss(記事概要)
+
: <tt>get_the_excerpt</tt> 関数で取得した投稿の抜粋に適用される。
; the_title_rss(the_titleでフィルターされた記事タイトル)
+
: 各データをRSSフィードに挿入する前に適用される。
+
  
; the_editor_content
+
; [[プラグイン API/フィルターフック一覧/get_the_guid|get_the_guid]] /[[:en:Plugin_API/Filter_Reference/get_the_guid|en]]
: 記事本文をリッチテキストエディター内に表示する前に適用される。
+
: <tt>get_the_guid</tt> 関数で取得した投稿の GUID に適用される。
  
; wp_dropdown_pages
+
; [[プラグイン API/フィルターフック一覧/get_to_ping|get_to_ping]] /[[:en:Plugin_API/Filter_Reference/get_to_ping|en]]
: wp_dropdown_pages関数が生成したページのドロップダウンリストHTMlに適用される。
+
: <tt>get_to_ping</tt> 関数で取得したピンバック先の URL リストに適用される。
  
; wp_list_pages
+
; [[プラグイン API/フィルターフック一覧/icon_dir|icon_dir]] /[[:en:Plugin_API/Filter_Reference/icon_dir|en]]
: wp_list_pages関数が生成したページのリストHTMLに適用される。
+
: 複数の関数で、テンプレートの画像ディレクトリに適用される。MIME タイプアイコンの置き場所をプラグインを使って変更したいときに使える。
  
; wp_list_pages_excludes
+
; [[プラグイン API/フィルターフック一覧/icon_dir_uri|icon_dir_uri]] /[[:en:Plugin_API/Filter_Reference/icon_dir_uri|en]]
: wp_list_pages関数内で、除外ページIDの配列に適用される。
+
: 複数の関数で、テンプレートの画像ディレクトリ URL に適用される。MIME タイプアイコンの置き場所をプラグインを使って変更したいときに使える。
  
; wp_get_attachment_metadata
+
; [[プラグイン API/フィルターフック一覧/image_size_names_choose|image_size_names_choose]] /[[:en:Plugin_API/Filter_Reference/image_size_names_choose|en]]
: フィルター関数引数: メタ情報、添付ファイルID
+
: メディアライブラリで選択できる画像サイズのリストに適用される。[[関数リファレンス/add_image_size|カスタム画像サイズ]]を選択できるようにしたい時によく使われる。
: wp_get_attachment_metadata関数で取得した、添付ファイルのメタ情報に適用される。
+
  
; wp_get_attachment_thumb_file
+
; [[プラグイン API/フィルターフック一覧/mime_type_edit_pre|mime_type_edit_pre]] /[[:en:Plugin_API/Filter_Reference/mime_type_edit_pre|en]]
: フィルター関数引数: サムネールファイル、添付ファイルID
+
: 編集画面に表示される前に投稿 MIME タイプに適用される。
: wp_get_attachment_thumb_file関数で取得した、添付ファイルのサムネールファイルに適用される。
+
  
; wp_get_attachment_thumb_url
+
; [[プラグイン API/フィルターフック一覧/modified_edit_pre|modified_edit_pre]] /[[:en:Plugin_API/Filter_Reference/modified_edit_pre|en]]
: フィルター関数引数: サムネールURL、添付ファイルID
+
: 編集画面に表示される前に、投稿が変更された日付に適用される。
: wp_get_attachment_thumb_URL関数で取得した、添付ファイルのサムネールURLに適用される。
+
  
; wp_get_attachment_url
+
; [[プラグイン API/フィルターフック一覧/modified_gmt_edit_pre|modified_gmt_edit_pre]] /[[:en:Plugin_API/Filter_Reference/modified_gmt_edit_pre|en]]
: フィルター関数引数: URL、添付ファイルID
+
: 編集画面に表示される前に、投稿が変更された日付の GMT 版に適用される。
: wp_get_attachment_url関数で取得した、添付ファイルURLに適用される。
+
  
; wp_mime_type_icon
+
; [[プラグイン API/フィルターフック一覧/no_texturize_shortcodes|no_texturize_shortcodes]] /[[:en:Plugin_API/Filter_Reference/no_texturize_shortcodes|en]]
: フィルター関数引数: アイコンのURL、MIMEタイプ情報、投稿記事ID
+
: 登録されたショートコードに適用される。texturize 関数の自動適用範囲からショートコードを除外するために使える。
: wp_mime_type_icon関数で算出した、添付ファイルのMIMEタイプアイコンに適用される。
+
  
; wp_title
+
; [[プラグイン API/フィルターフック一覧/parent_edit_pre|parent_edit_pre]] /[[:en:Plugin_API/Filter_Reference/parent_edit_pre|en]]
: wp_title関数が生成したページ名がブラウザに送信される前に適用される。
+
: 編集画面に表示される前に、投稿の親 ID に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/password_edit_pre|password_edit_pre]] /[[:en:Plugin_API/Filter_Reference/password_edit_pre|en]]
 +
: 編集画面に表示される前に、投稿パスワードに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/post_class|post_class]] /[[:en:Plugin_API/Filter_Reference/post_class|en]]
 +
: フィルター関数引数: クラス名の配列、最初の配列に追加された追加クラス名の配列、投稿 ID
 +
: 投稿の一番外側にある HTML 要素に適用される。<tt>[[関数リファレンス/get_post_class|get_post_class]] /[[:en:Function_Reference/get_post_class|en]]</tt> 関数内で呼び出される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/prepend_attachment|prepend_attachment]] /[[:en:Plugin_API/Filter_Reference/prepend_attachment|en]]
 +
: <tt>prepend_attachment</tt> 関数で先頭に追加する HTML に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/protected_title_format|protected_title_format]] /[[:en:Plugin_API/Filter_Reference/protected_title_format|en]]
 +
: 投稿がパスワード保護されている場合の投稿タイトルを編集するために使う。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/private_title_format|private_title_format]] /[[:en:Plugin_API/Filter_Reference/private_title_format|en]]
 +
: 投稿が非公開状態になっている場合の投稿タイトルを編集するために使う。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/sanitize_title|sanitize_title]] /[[:en:Plugin_API/Filter_Reference/sanitize_title|en]]
 +
: <tt>sanitize_title</tt> 関数で HTML タグを除去した投稿タイトル名に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/single_post_title|single_post_title]] /[[:en:Plugin_API/Filter_Reference/single_post_title|en]]
 +
: <tt>wp_title</tt> 関数および <tt>single_post_title</tt> 関数でブログページタイトルを生成する際に投稿タイトルに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/status_edit_pre|status_edit_pre]] /[[:en:Plugin_API/Filter_Reference/status_edit_pre|en]]
 +
: 編集画面に表示される前に投稿ステータスに対し適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_content|the_content]] /[[:en:Plugin_API/Filter_Reference/the_content|en]]
 +
: データベースから取得した投稿コンテンツを画面に出力する前に適用される(トラックバックなどの他の操作にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_content_rss|the_content_rss]] /[[:en:Plugin_API/Filter_Reference/the_content_rss|en]]
 +
: データベースから取得した投稿コンテンツを RSS フィードに含める前に適用される。このフィルターは 2.7 以降機能していない。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_content_feed|the_content_feed]] /[[:en:Plugin_API/Filter_Reference/the_content_feed|en]]
 +
: データベースから取得した投稿コンテンツを RSS フィードに含める前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_editor_content|the_editor_content]] /[[:en:Plugin_API/Filter_Reference/the_editor_content|en]]
 +
: 投稿本文をリッチテキストエディター内に表示する前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_excerpt|the_excerpt]] /[[:en:Plugin_API/Filter_Reference/the_excerpt|en]]
 +
: 画面を表示する前にデータベースから取得した記事の抜粋(または投稿、抜粋がない場合)に適用する。(またトラックバックなどの他の操作で使用)
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_excerpt_rss|the_excerpt_rss]] /[[:en:Plugin_API/Filter_Reference/the_excerpt_rss|en]]
 +
: 投稿の抜粋を RSS フィードに含める前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_password_form|the_password_form]] /[[:en:Plugin_API/Filter_Reference/the_password_form|en]]
 +
: 保護された投稿のパスワードフォームに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_tags|the_tags]] /[[:en:Plugin_API/Filter_Reference/the_tags|en]]
 +
: 画面を表示する前に、データベースから取得したタグに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_title|the_title]] /[[:en:Plugin_API/Filter_Reference/the_title|en]]
 +
: 画面を表示する前にデータベースから取得した投稿タイトルに適用される。(トラックバックなどの他の操作でも使用)
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_title_rss|the_title_rss]] / [[:en:Plugin_API/Filter_Reference/the_title_rss|en]]
 +
: <tt>the_title</tt> でフィルターした後、投稿タイトルをRSS フィードに含める前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/title_edit_pre|title_edit_pre]] /[[:en:Plugin_API/Filter_Reference/title_edit_pre|en]]
 +
: 投稿タイトルが編集画面に表示される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/type_edit_pre|type_edit_pre]] /[[:en:Plugin_API/Filter_Reference/type_edit_pre|en]]
 +
: 投稿タイプが編集画面に表示される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_dropdown_pages|wp_dropdown_pages]] /[[:en:Plugin_API/Filter_Reference/wp_dropdown_pages|en]]
 +
: <tt>wp_dropdown_pages</tt> 関数が生成したページのドロップダウンリスト HTML に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_list_pages|wp_list_pages]] /[[:en:Plugin_API/Filter_Reference/wp_list_pages|en]]
 +
: <tt>wp_list_pages</tt> 関数が生成したページのリスト HTML に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_list_pages_excludes|wp_list_pages_excludes]] /[[:en:Plugin_API/Filter_Reference/wp_list_pages_excludes|en]]
 +
: <tt>wp_list_pages</tt> 関数内で、除外ページ ID の配列に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_get_attachment_metadata|wp_get_attachment_metadata]] /[[:en:Plugin_API/Filter_Reference/wp_get_attachment_metadata|en]]
 +
: フィルター関数引数: メタ情報、添付ファイル ID
 +
: <tt>wp_get_attachment_metadata</tt> 関数で取得した、添付ファイルのメタ情報に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_get_attachment_thumb_file|wp_get_attachment_thumb_file]] /[[:en:Plugin_API/Filter_Reference/wp_get_attachment_thumb_file|en]]
 +
: フィルター関数引数: サムネイルファイル、添付ファイル ID
 +
: <tt>wp_get_attachment_thumb_file</tt> 関数で取得した、添付ファイルのサムネイルファイルに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_get_attachment_thumb_url|wp_get_attachment_thumb_url]] /[[:en:Plugin_API/Filter_Reference/wp_get_attachment_thumb_url|en]]
 +
: フィルター関数引数: サムネイル URL、添付ファイル ID
 +
: <tt>wp_get_attachment_thumb_URL</tt>関数によってサムネイルに適用するURLを取得する。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_get_attachment_url|wp_get_attachment_url]] /[[:en:Plugin_API/Filter_Reference/wp_get_attachment_url|en]]
 +
: フィルター関数引数: URL、添付ファイル ID
 +
: <tt>wp_get_attachment_url</tt> 関数で取得した、添付ファイル URL に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_mime_type_icon|wp_mime_type_icon]] /[[:en:Plugin_API/Filter_Reference/wp_mime_type_icon|en]]
 +
: フィルター関数引数: 算出した アイコン URL、MIME タイプ情報、投稿投稿 ID
 +
: <tt>wp_mime_type_icon</tt> 関数で算出した、添付ファイルの MIME タイプアイコンに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_title|wp_title]] /[[:en:Plugin_API/Filter_Reference/wp_title|en]]
 +
: <tt>wp_title</tt> 関数が生成したページ名がブラウザに送信される前に適用される。
  
 
=== データベース書き込み ===
 
=== データベース書き込み ===
  
; add_ping
+
このセクションのフィルターは、情報をデータベースに保存する前にその情報に対して適用されます。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/add_ping|add_ping]] /[[:en:Plugin_API/Filter_Reference/add_ping|en]]
 
: ピンバックが追加された際、ピンバック欄に新規追加する値をデータベースに保存する前に適用される。
 
: ピンバックが追加された際、ピンバック欄に新規追加する値をデータベースに保存する前に適用される。
  
; attachment_max_dims
+
; [[プラグイン API/フィルターフック一覧/attachment_fields_to_save|attachment_fields_to_save]] /[[:en:Plugin_API/Filter_Reference/attachment_fields_to_save|en]]
 +
: フィルタ関数の引数:投稿の配列属性、フォームから送信された変更を含む添付ファイルフィールドの配列。
 +
: データベースに保存する前に添付ファイルに関連付けられたフィールドに適用される。<tt>media_upload_form_handler</tt>関数と呼ぶ。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/attachment_max_dims|attachment_max_dims]] /[[:en:Plugin_API/Filter_Reference/attachment_max_dims|en]]
 
: 画像を縮小する前に、画像の最大寸法の値に適用される。フィルター関数の入力値と戻り値は、false(最大寸法が指定されていない場合)または2つの数字のリスト(幅、高さ)。
 
: 画像を縮小する前に、画像の最大寸法の値に適用される。フィルター関数の入力値と戻り値は、false(最大寸法が指定されていない場合)または2つの数字のリスト(幅、高さ)。
  
; category_save_pre(記事のカテゴリーリスト・コンマ区切り)
+
; [[プラグイン API/フィルターフック一覧/category_save_pre|category_save_pre]] /[[:en:Plugin_API/Filter_Reference/category_save_pre|en]]
; comment_status_pre(コメントのステータス)
+
: 投稿カテゴリーのコンマ区切りリストをデータベースに保存する前に適用される(添付にも使われる)。
; content_filtered_save_pre(フィルタ済みの記事本文)
+
; content_save_pre(記事本文)
+
; excerpt_save_pre(記事概要)
+
; excerpt_save_pre(記事名)
+
; ping_status_pre(ピンバックステータス)
+
; title_save_pre(記事タイトル)
+
; post_mime_type_pre(添付ファイルのMIMEタイプ)
+
; status_save_pre (記事のステータス)
+
: 各情報がデータベースに保存される前に適用する(添付ファイルの情報に対しても適用される)。
+
  
; phone_content
+
; [[プラグイン API/フィルターフック一覧/comment_status_pre|comment_status_pre]] /[[:en:Plugin_API/Filter_Reference/comment_status_pre|en]]
: 記事がメールで投稿された際、内容をデータベースに保存する前に実行する。
+
: コメントステータスをデータベースに保存する前に適用される(添付にも使われる)。
  
; thumbnail_filename
+
; [[プラグイン API/フィルターフック一覧/content_filtered_save_pre|content_filtered_save_pre]] /[[:en:Plugin_API/Filter_Reference/content_filtered_save_pre|en]]
 +
: フィルターされた投稿コンテンツをデータベースに保存する前に適用される(添付にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/content_save_pre|content_save_pre]] /[[:en:Plugin_API/Filter_Reference/content_save_pre|en]]
 +
: 投稿コンテンツをデータベースに保存する前に適用される(添付にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/excerpt_save_pre|excerpt_save_pre]] /[[:en:Plugin_API/Filter_Reference/excerpt_save_pre|en]]
 +
: 投稿の抜粋をデータベースに保存する前に適用される(添付にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/image_save_pre|image_save_pre]] /[[:en:Plugin_API/Filter_Reference/image_save_pre|en]] - 非推奨
 +
: 代わりに [[プラグイン API/フィルターフック一覧/image_editor_save_pre|<tt>image_editor_save_pre</tt>]] /[[:en:Plugin_API/Filter_Reference/image_editor_save_pre|en]] を使うこと。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/jpeg_quality|jpeg_quality]] /[[:en:Plugin_API/Filter_Reference/jpeg_quality|en]] - 非推奨
 +
: 代わりに [[プラグイン API/フィルターフック一覧/wp_editor_set_quality|<tt>wp_editor_set_quality</tt>]] /[[:en:Plugin_API/Filter_Reference/wp_editor_set_quality|en]] または <tt>WP_Image_Editor::set_quality()</tt> を使うこと。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/name_save_pre|name_save_pre]] /[[:en:Plugin_API/Filter_Reference/name_save_pre|en]]
 +
: 投稿の名前をデータベースに保存する前に適用される(添付にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/phone_content|phone_content]] /[[:en:Plugin_API/Filter_Reference/phone_content|en]]
 +
: 投稿がメールで投稿された際、内容をデータベースに保存する前に実行する。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/ping_status_pre|ping_status_pre]] /[[:en:Plugin_API/Filter_Reference/ping_status_pre|en]]
 +
: 投稿のピンバックステータスをデータベースに保存する前に適用される(添付にも使われる)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/post_mime_type_pre|post_mime_type_pre]] /[[:en:Plugin_API/Filter_Reference/post_mime_type_pre|en]]
 +
: 添付の MIMEタイプをデータベースに保存する前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/status_save_pre|status_save_pre]] /[[:en:Plugin_API/Filter_Reference/status_save_pre|en]]
 +
: 投稿ステータスをデータベースに保存する前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/thumbnail_filename|thumbnail_filename]] /[[:en:Plugin_API/Filter_Reference/thumbnail_filename|en]]
 
: 画像をアップロードする際、サムネイルのファイル名に適用される。
 
: 画像をアップロードする際、サムネイルのファイル名に適用される。
  
; wp_thumbnail_creation_size_limit
+
; [[プラグイン API/フィルターフック一覧/title_save_pre|title_save_pre]] /[[:en:Plugin_API/Filter_Reference/title_save_pre|en]]
: フィルター関数引数: ファイルの最大ファイルサイズ、添付ファイルID、添付ファイル名
+
: 投稿のタイトルをデータベースに保存する前に適用される(添付にも使われる)。
: 画像をアップロードする際、サムネイルのファイルサイズに適用される。
+
  
; wp_thumbnail_max_side_length
+
; [[プラグイン API/フィルターフック一覧/update_attached_file|update_attached_file]] /[[:en:Plugin_API/Filter_Reference/update_attached_file|en]]
: フィルター関数引数: 画像の最大横幅、添付ファイルID、添付ファイル名
+
: フィルター関数引数: 添付ファイル情報、添付ファイル ID
: 画像をアップロードする際、サムネイルの寸法に適用される。
+
: 添付ファイル情報を <tt>update_attached_file</tt> 関数で投稿のメタデータとして保存する前に適用される。
  
; update_attached_file
+
; [[プラグイン API/フィルターフック一覧/wp_create_thumbnail|wp_create_thumbnail]] /[[:en:Plugin_API/Filter_Reference/wp_create_thumbnail|en]] - 非推奨
: フィルター関数引数: 添付ファイル情報、添付ファイルID
+
: 添付ファイル情報をupdate_attached_file関数で記事のメタデータとして保存する前に適用される。
+
  
; wp_delete_file
+
; [[プラグイン API/フィルターフック一覧/wp_delete_file|wp_delete_file]] /[[:en:Plugin_API/Filter_Reference/wp_delete_file|en]]
 
: ファイルを削除する直前、添付ファイル名に適用される。
 
: ファイルを削除する直前、添付ファイル名に適用される。
  
; wp_generate_attachment_metadata
+
; [[プラグイン API/フィルターフック一覧/wp_generate_attachment_metadata|wp_generate_attachment_metadata]] /[[:en:Plugin_API/Filter_Reference/wp_generate_attachment_metadata|en]]
 
: 添付ファイルのメタ情報配列がデータベースに保存される前に適用される。
 
: 添付ファイルのメタ情報配列がデータベースに保存される前に適用される。
  
; wp_update_attachment_metadata
+
; [[プラグイン API/フィルターフック一覧/wp_save_image_file|wp_save_image_file]] /[[:en:Plugin_API/Filter_Reference/wp_save_image_file|en]] - 非推奨
: フィルター関数引数: メタ情報、添付ファイルID
+
: 代わりに [[プラグイン API/フィルターフック一覧/wp_save_image_editor_file|<tt>wp_save_image_editor_file</tt>]] /[[:en:Plugin_API/Filter_Reference/wp_save_image_editor_file|en]] を使うこと。
: wp_update_attachment_metadata関数で、添付ファイルのメタ情報配列が保存される前に適用される。
+
 
 +
; [[プラグイン API/フィルターフック一覧/wp_thumbnail_creation_size_limit|wp_thumbnail_creation_size_limit]] /[[:en:Plugin_API/Filter_Reference/wp_thumbnail_creation_size_limit|en]]
 +
: フィルター関数引数: ファイルの最大サイズ、添付ファイル ID、添付ファイル名
 +
: 画像をアップロードする際、サムネイルのファイルサイズに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_thumbnail_max_side_length|wp_thumbnail_max_side_length]] /[[:en:Plugin_API/Filter_Reference/wp_thumbnail_max_side_length|en]]
 +
: フィルター関数引数: 画像の最大横幅、添付ファイル ID、添付ファイル名
 +
: 画像をアップロードする際、サムネイルの寸法に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_update_attachment_metadata|wp_update_attachment_metadata]] /[[:en:Plugin_API/Filter_Reference/wp_update_attachment_metadata|en]]
 +
: フィルター関数引数: メタ情報、添付ファイル ID
 +
: <tt>wp_update_attachment_metadata</tt> 関数で、添付ファイルのメタ情報配列が保存される前に適用される。
  
 
== コメント・トラックバック・ピンバック関連のフィルター ==
 
== コメント・トラックバック・ピンバック関連のフィルター ==
  
=== データベース書き込み ===
+
[[#投稿者・ユーザー関連のフィルター|投稿者・ユーザー関連のフィルター]]、[[#リンク関連のフィルター|リンク関連のフィルター]]、[[#日付・時間関連のフィルター|日付・時間関連のフィルター]]、[[#管理画面関連のフィルター|管理画面関連のフィルター]]も参照。
  
; comment_excerpt
+
=== データベース読み出し ===
: comment_excerpt関数を使ってデータベースから取得したコメント概要に適用される。
+
 
 +
このセクションのフィルターは、データベースから読み出される情報に対してページや編集画面に表示される前に適用されます。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/comment_excerpt|comment_excerpt]] /[[:en:Plugin_API/Filter_Reference/comment_excerpt|en]]
 +
: <tt>comment_excerpt</tt> 関数を使ってデータベースから取得したコメント抜粋に適用される。
  
; comment_flood_filter
+
; [[プラグイン API/フィルターフック一覧/comment_flood_filter|comment_flood_filter]] /[[:en:Plugin_API/Filter_Reference/comment_flood_filter|en]]
: フィルター関数引数: 他のフィルタープラグインがコメントをすでにブロック済みかどうかの判別情報(true/false、プラグインでコメントをブロックする際、trueに設定し、値を戻す)、前回のコメント送信日時、今回のコメント送信日時
+
: フィルター関数引数: 他のフィルタープラグインがコメントをすでにブロック済みかどうかの判別情報(true/false、プラグインでコメントをブロックする際 true に設定し、値を戻す)、前回のコメント送信日時、今回のコメント送信日時
: 連続コメントエラーが検出された際に適用される。  
+
: 連続コメントエラーが検出された際に適用される。
  
; comment_post_redirect
+
; [[プラグイン API/フィルターフック一覧/comment_post_redirect|comment_post_redirect]] /[[:en:Plugin_API/Filter_Reference/comment_post_redirect|en]]
 
: フィルター関数引数: リダイレクト先情報、コメント情報の配列
 
: フィルター関数引数: リダイレクト先情報、コメント情報の配列
 
: コメントを追加した後のリダイレクト先情報に適用される。
 
: コメントを追加した後のリダイレクト先情報に適用される。
  
; comment_text  
+
; [[プラグイン API/フィルターフック一覧/comment_text|comment_text]] /[[:en:Plugin_API/Filter_Reference/comment_text|en]]
: comment_text関数で取得したコメント本文を画面に出力する前に適用される。
+
: <tt>comment_text</tt> 関数で取得したコメント本文を画面に出力する前に適用される。
  
; comment_text_rss
+
; [[プラグイン API/フィルターフック一覧/comment_text_rss|comment_text_rss]] /[[:en:Plugin_API/Filter_Reference/comment_text_rss|en]]
: コメント本文がRSSフィードに挿入される前に適用される。
+
: コメント本文が RSS フィードに挿入される前に適用される。
  
; comments_array
+
; [[プラグイン API/フィルターフック一覧/comments_array|comments_array]] /[[:en:Plugin_API/Filter_Reference/comments_array|en]]
: フィルター関数引数: コメント情報構造の配列、投稿記事ID
+
: フィルター関数引数: コメント情報構造の配列、投稿投稿 ID
: comments_template関数内で、投稿記事へのコメントの配列に適用される。
+
: <tt>comments_template</tt> 関数内で、投稿投稿へのコメントの配列に適用される。
  
; comments_number
+
; [[プラグイン API/フィルターフック一覧/comments_number|comments_number]] /[[:en:Plugin_API/Filter_Reference/comments_number|en]]
: comments_number関数が生成したコメント数表示用のフォーマット済みテキストに適用される。
+
: <tt>comments_number</tt> 関数が生成したコメント数表示用のフォーマット済みテキストに適用される。
  
; get_comment_excerpt
+
; [[プラグイン API/フィルターフック一覧/get_comment_excerpt|get_comment_excerpt]] /[[:en:Plugin_API/Filter_Reference/get_comment_excerpt|en]]
: get_comment_excerpt関数を使ってデータベースから取得したコメント概要に適用される。
+
: <tt>get_comment_excerpt</tt> 関数を使ってデータベースから取得したコメント抜粋に適用される。
 +
 +
; [[プラグイン API/フィルターフック一覧/get_comment_ID|get_comment_ID]] /[[:en:Plugin_API/Filter_Reference/get_comment_ID|en]]
 +
: <tt>get_comment_ID</tt> 関数を使ってグローバル変数 <tt>$comments</tt> から読み出したコメント ID に適用される。
  
; get_comment_ID
+
; [[プラグイン API/フィルターフック一覧/get_comment_text|get_comment_text]] /[[:en:Plugin_API/Filter_Reference/get_comment_text|en]]
: get_comment_ID関数を使ってグローバル変数$commentsから読み出したコメントIDに適用される。
+
: <tt>get_comment_text</tt> 関数内でコメント本文に適用される。
  
; get_comment_text
+
; [[プラグイン API/フィルターフック一覧/get_comment_type|get_comment_type]] /[[:en:Plugin_API/Filter_Reference/get_comment_type|en]]
: get_comment_text関数内でコメント本文に適用される。
+
: <tt>get_comment_type</tt> 関数内で取得したコメントの種類(comment/trackback/pingback、= <tt>comment_type</tt>)に適用される。
  
; get_comment_type
+
; [[プラグイン API/フィルターフック一覧/get_comments_number|get_comments_number]] /[[:en:Plugin_API/Filter_Reference/get_comments_number|en]]
: get_comment_type関数内で取得したコメントの種類(comment/trackback/pingback)に適用される。
+
: <tt>get_comments_number</tt> 関数を使ってグローバル変数 <tt>$comments</tt> から読み出したコメント数に適用される。<tt>comments_number</tt> も参照。
  
; get_comments_number
+
; [[プラグイン API/フィルターフック一覧/post_comments_feed_link|post_comments_feed_link]] /[[:en:Plugin_API/Filter_Reference/post_comments_feed_link|en]]
: get_comments_number関数を使ってグローバル変数$commentsから読み出したコメント数に適用される。
+
: <tt>comments_rss</tt> 関数が生成したコメントフィード URL に適用される。
 
+
; post_comments_feed_link
+
: comments_rss関数が生成したコメントフィードURLに適用される。
+
  
 
=== データベース書き込み ===
 
=== データベース書き込み ===
  
; comment_save_pre
+
このセクションのフィルターは、情報がデータベースに保存される前に適用されます。
: フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_IDのインデックスを含むコメントデータ配列
+
 
 +
; [[プラグイン API/フィルターフック一覧/comment_save_pre|comment_save_pre]] /[[:en:Plugin_API/Filter_Reference/comment_save_pre|en]]
 +
: フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_ID のインデックスを含むコメントデータ配列
 
: コメントを更新・編集する直前に、コメントデータに適用される。
 
: コメントを更新・編集する直前に、コメントデータに適用される。
  
; pre_comment_approved  
+
; [[プラグイン API/フィルターフック一覧/pre_comment_approved|pre_comment_approved]] /[[:en:Plugin_API/Filter_Reference/pre_comment_approved|en]]
: コメントの承認ステータス(true/false)に適用される。
+
: 現在のコメント承認ステータス(true/false)をプラグインが上書きできるように適用される。true/false を返し、最初の変数を true/false に設定してコメントを承認または非承認にする。また、このコメントにアクセスできるように <tt>$comment_ID</tt> のようなグローバル変数を使う。
  
; pre_comment_content(コメント本文)
+
; [[プラグイン API/フィルターフック一覧/pre_comment_content|pre_comment_content]] /[[:en:Plugin_API/Filter_Reference/pre_comment_content|en]]
 
: コメント本文がデータベースに保存される前に適用される。
 
: コメント本文がデータベースに保存される前に適用される。
  
; preprocess_comment
+
; [[プラグイン API/フィルターフック一覧/preprocess_comment|preprocess_comment]] /[[:en:Plugin_API/Filter_Reference/preprocess_comment|en]]
: フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_IDのインデックスを含むコメントデータ配列
+
: フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_ID のインデックスを含むコメントデータ配列
 
: 新しいコメントをデータベースに保存する際、他の処理がまだ施されていないコメントデータに適用される。
 
: 新しいコメントをデータベースに保存する際、他の処理がまだ施されていないコメントデータに適用される。
  
== カテゴリー関連のフィルター ==
+
; [[プラグイン API/フィルターフック一覧/wp_insert_post_data|wp_insert_post_data]] /[[:en:Plugin_API/Filter_Reference/wp_insert_post_data|en]]
 +
: フィルター関数引数: 編集され、拡張された投稿の配列とサニタイズ済みの投稿配列
 +
: <tt>wp_insert_post()</tt> 内の修正済みまたは未修正の投稿データに対し、更新前または投稿のデータベースへの挿入前に適用される。
  
=== データベース書き込み ===
+
<div id="Category_and_Term_Filters">
 +
== カテゴリー・タクソノミー項目関連のフィルター ==
 +
</div>
  
; category_description
+
[[#管理画面関連のフィルター|管理画面関連のフィルター]]も参照。
: category_description関数でのフィルター関数引数: カテゴリーの説明、カテゴリーID
+
: wp_list_categories関数でのフィルター関数引数: カテゴリーの説明、全カテゴリー情報の配列
+
: category_description関数およびwp_list_categories関数のカテゴリー情報に適用される。
+
  
; category_feed_link
+
=== データベース読み出し ===
: get_category_rss_link関数が生成したカテゴリーフィードURLに適用される。
+
  
; category_link
+
このセクションのフィルターは、データベースから読み出された情報がページまたは編集画面に表示される前に適用されます。
: フィルター関数引数: リンクURL、カテゴリーID
+
: get_category_link関数が生成したカテゴリーのURLに適用される。
+
  
; get_categories
+
; [[プラグイン API/フィルターフック一覧/category_description|category_description]] /[[:en:Plugin_API/Filter_Reference/category_description|en]]
: フィルター関数引数: カテゴリーリスト、get_categoriesオプションリスト
+
: <tt>category_description</tt> 関数でのフィルター関数引数: カテゴリーの説明、カテゴリー ID
: get_categories関数が生成したカテゴリーのリストに適用される。
+
: <tt>[[テンプレートタグ/wp list categories|wp_list_categories]]</tt> 関数でのフィルター関数引数: カテゴリーの説明、全カテゴリー情報の配列
 +
: <tt>category_description</tt> 関数および <tt>[[テンプレートタグ/wp list categories|wp_list_categories]]</tt> 関数のカテゴリー情報に適用される。
  
; get_category
+
; [[プラグイン API/フィルターフック一覧/category_feed_link|category_feed_link]] /[[:en:Plugin_API/Filter_Reference/category_feed_link|en]]
: get_category関数で取得した、特定のカテゴリーIDに関する全情報の配列に適用される。
+
: <tt>[[関数リファレンス/get_category_rss_link|get_category_rss_link]]</tt> 関数が生成したカテゴリーフィード URL に適用される。
  
; list_cats
+
; [[プラグイン API/フィルターフック一覧/category_link|category_link]] /[[:en:Plugin_API/Filter_Reference/category_link|en]]
 +
: フィルター関数引数: リンク URL、カテゴリー ID
 +
: <tt>[[関数リファレンス/get_category_link|get_category_link]]</tt> 関数が生成したカテゴリーの URL に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/get_ancestors|get_ancestors]] /[[:en:Plugin_API/Filter_Reference/get_ancestors|en]]
 +
: フィルター関数引数: 祖先オブジェクトIDの配列、指定されたオブジェクトID、指定されたオブジェクトタイプ
 +
: <tt>[[関数リファレンス/get_ancestors|get_ancestors]]</tt>から返された祖先オブジェクト ID リストに適用される(そして多くの他の関数によって順に使用される)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/get_categories|get_categories]] /[[:en:Plugin_API/Filter_Reference/get_categories|en]]
 +
: フィルター関数引数: カテゴリーリスト、<tt>[[関数リファレンス/get_categories|get_categories]]</tt> オプションリスト
 +
: <tt>[[関数リファレンス/get_categories|get_categories]]</tt> 関数が生成したカテゴリーのリストに適用される(そして多くの他の関数によって順に使用される)。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/get_category|get_category]] /[[:en:Plugin_API/Filter_Reference/get_category|en]]
 +
: <tt>[[関数リファレンス/get_category|get_category]]</tt> が検索するカテゴリー情報に適用される。基本的にはWordPressのカテゴリーテーブル内で、特定のカテゴリーIDに関するすべてのフィールドの配列。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/list_cats|list_cats]] /[[:en:Plugin_API/Filter_Reference/list_cats|en]]
 
: フィルター関数引数: カテゴリー名、カテゴリー情報リスト(指定したカテゴリーテーブル内の全フィールド)
 
: フィルター関数引数: カテゴリー名、カテゴリー情報リスト(指定したカテゴリーテーブル内の全フィールド)
 
: このフィルターは2種類の目的で使用される。
 
: このフィルターは2種類の目的で使用される。
: 1. wp_dropdown_categories関数では、show_option_allおよびshow_option_none引数をフィルターするために適用される。この場合、追加のフィルター関数引数はなし。
+
: 1. <tt>[[関数リファレンス/wp_dropdown_categories|wp_dropdown_categories]]</tt> 関数では、<tt>show_option_all</tt> および <tt>show_option_none</tt> 引数をフィルターするために適用される。この場合、追加のフィルター関数引数はなし。
: 2. wp_list_categories関数でカテゴリー名に対して適用する。
+
: 2. <tt>[[テンプレートタグ/wp_list_categories|wp_list_categories]]</tt> 関数でカテゴリー名に対して適用する。
  
; list_cats_exclusions
+
; [[プラグイン API/フィルターフック一覧/list_cats_exclusions|list_cats_exclusions]] /[[:en:Plugin_API/Filter_Reference/list_cats_exclusions|en]]
: フィルター関数引数: SQL文の WHERE 節で除外されたカテゴリー、get_categoriesオプションのリスト
+
: フィルター関数引数: SQL 文の <tt>WHERE</tt> 節で除外されたカテゴリー、<tt>[[関数リファレンス/get_categories|get_categories]]</tt> オプションのリスト
: get_categories関数で、除外カテゴリーを決定するSQL文の WHERE 節に適用される。
+
: <tt>[[関数リファレンス/get_categories|get_categories]]</tt> 関数で、除外カテゴリーを決定する SQL 文の <tt>WHERE</tt> 節に適用される。
  
; single_cat_title
+
; [[プラグイン API/フィルターフック一覧/single_cat_title|single_cat_title]] /[[:en:Plugin_API/Filter_Reference/single_cat_title|en]]
: wp_title関数およびsingle_cat_title関数内でカテゴリーページのタイトルに利用するカテゴリー名に適用される。
+
: [[テンプレートタグ/wp title|wp_title]] 関数および [[テンプレートタグ/single_cat_title|single_cat_title]] 関数内でカテゴリーページのタイトルに利用するカテゴリー名に適用される。
  
; the_category
+
; [[プラグイン API/フィルターフック一覧/the_category|the_category]] /[[:en:Plugin_API/Filter_Reference/the_category|en]]
: フィルター関数引数: 生成HTML、リスト区切り設定(空の場合はデフォルトの<nowiki><li></nowiki>)、get_the_category_listの親変数
+
: フィルター関数引数: 生成 HTML、リスト区切り設定(空の場合はデフォルトの <nowiki><li></nowiki>)、<tt>get_the_category_list</tt> の親変数
: get_the_category_list関数が生成したリンク付きのカテゴリーリストHTMLに適用される。
+
: <tt>get_the_category_list</tt> 関数が生成したカテゴリーリスト(リンクを含む HTML リスト)に適用される。
  
; the_category_rss
+
; [[プラグイン API/フィルターフック一覧/the_category_rss|the_category_rss]] /[[:en:Plugin_API/Filter_Reference/the_category_rss|en]]
: フィルター関数引数: リストテキストおよびフィードの種類(通常rdfまたはrss)
+
: フィルター関数引数: リストテキストおよびフィードの種類(通常 rdf または rss)
: get_the_category_rss関数内で、記事のカテゴリーリスト(カテゴリーXML要素のリスト)がRSSフィードに挿入される前に適用される。
+
: <tt>[[関数リファレンス/get_the_category_rss|get_the_category_rss]]</tt> 関数内で、投稿のカテゴリーリスト(カテゴリー XML 要素のリスト)が RSS フィードに挿入される前に適用される。
  
; wp_dropdown_cats
+
; [[プラグイン API/フィルターフック一覧/wp_dropdown_cats|wp_dropdown_cats]] /[[:en:Plugin_API/Filter_Reference/wp_dropdown_cats|en]]
: wp_dropdown_categories関数が生成したカテゴリードロップダウンリストHTMLに適用される。
+
: <tt>[[関数リファレンス/wp_dropdown_categories|wp_dropdown_categories]]</tt> 関数が生成したカテゴリードロップダウンリスト HTML に適用される。
  
; wp_list_categories
+
; [[プラグイン API/フィルターフック一覧/wp_list_categories|wp_list_categories]] /[[:en:Plugin_API/Filter_Reference/wp_list_categories|en]]
: wp_list_categories関数が生成したカテゴリーリストHTMLに適用される。
+
: <tt>[[テンプレートタグ/wp_list_categories|wp_list_categories]]</tt> 関数で生成されたカテゴリーリスト(HTML リスト)に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/wp_get_object_terms|wp_get_object_terms]] /[[:en:Plugin_API/Filter_Reference/wp_get_object_terms|en]]
 +
: <tt>[[関数リファレンス/get_the_terms|get_the_terms]]</tt> や <tt>[[テンプレートタグ/get_the_category|get_the_category]]</tt> などの複数のカテゴリーまたはタクソノミー関連の関数によって呼び出される、<tt>[[関数リファレンス/wp_get_object_terms|wp_get_object_terms]]</tt> 関数で生成された項目リスト(オブジェクトの配列)に適用される。
  
 
=== データベース書き込み ===
 
=== データベース書き込み ===
  
; pre_category_description(カテゴリーの説明)
+
このセクションのフィルターは、情報がデータベースに保存される前に適用される。
; pre_category_name(カテゴリー名)
+
 
; pre_category_nicename(カテゴリースラッグ)
+
; [[プラグイン API/フィルターフック一覧/pre_category_description|pre_category_description]] /[[:en:Plugin_API/Filter_Reference/pre_category_description|en]]
: 各情報がデータベースに保存される前に適用される。
+
: カテゴリーの説明がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/edited_terms|edited_terms]] /[[:en:Plugin_API/Filter_Reference/edited_terms|en]]
 +
: カテゴリー・タクソノミーの変更がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_category_name|pre_category_name]] /[[:en:Plugin_API/Filter_Reference/pre_category_name|en]]
 +
: カテゴリー名がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_category_nicename(カテゴリースラッグ)|pre_category_nicename(カテゴリースラッグ)]] /[[:en:Plugin_API/Filter_Reference/pre_category_nicename(カテゴリースラッグ)|en]]
 +
: カテゴリーの nicename がデータベースに保存される前に適用される。
  
 
== リンク関連のフィルター ==
 
== リンク関連のフィルター ==
  
; attachment_link
+
注: このセクションでは投稿・ページ・アーカイブ・フィードなどのリンクに関するフィルターを紹介しています。リンク集(ブログロールリンク)については[[#リンク集関連のフィルター|リンク集関連のフィルター]]セクションを参照。
: フィルター関数引数: リンクURL、添付ファイルID
+
 
: get_attachment_link関数が生成した添付ファイルの固定リンクに適用される。
+
; [[プラグイン API/フィルターフック一覧/attachment_link|attachment_link]] /[[:en:Plugin_API/Filter_Reference/attachment_link|en]]
 +
: フィルター関数引数: リンク URL、添付ファイル ID
 +
: <tt>get_attachment_link</tt> 関数が生成した添付ファイルの固定リンクに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/author_feed_link|author_feed_link]] /[[:en:Plugin_API/Filter_Reference/author_feed_link|en]]
 +
: <tt>get_author_rss_link</tt> 関数が生成した投稿者フィードのURLに適用される。
  
; author_feed_link
+
; [[プラグイン API/フィルターフック一覧/author_link|author_link]] /[[:en:Plugin_API/Filter_Reference/author_link|en]]
: get_author_rss_link関数が生成した投稿者フィードのURLに適用される。
+
: フィルター関数引数: リンク URL、投稿者名スラッグ、投稿者 ID
 +
: <tt>get_author_posts_url</tt> 関数が生成した投稿者別アーカイブのリンク URL に適用される。
  
; author_link
+
; [[プラグイン API/フィルターフック一覧/comment_reply_link|comment_reply_link]] /[[:en:Plugin_API/Filter_Reference/comment_reply_link|en]]
: フィルター関数引数: リンクURL、投稿者名スラッグ、投稿者ID
+
: フィルター関数引数: リンク(文字列)、カスタムオプション(配列)、現在のコメント(オブジェクト)、現在の投稿(オブジェクト)
: get_author_posts_url関数が生成した投稿者別アーカイブのリンクURLに適用される。
+
: 関数 <tt>comments_template</tt> 内で呼ばれる<tt>get_comment_reply_link</tt> によって、特定のコメントへの応答のため生成されたリンクに適用される。
  
; day_link
+
; [[プラグイン API/フィルターフック一覧/day_link|day_link]] /[[:en:Plugin_API/Filter_Reference/day_link|en]]
 
: フィルター関数引数: URL、年、月(数字)、日(数字)
 
: フィルター関数引数: URL、年、月(数字)、日(数字)
: get_day_link関数が生成した日付別アーカイブのリンクURLに適用される。
+
: <tt>get_day_link</tt> 関数が生成した日付別アーカイブのリンク URL に適用される。
  
; feed_link
+
; [[プラグイン API/フィルターフック一覧/feed_link|feed_link]] /[[:en:Plugin_API/Filter_Reference/feed_link|en]]
: フィルター関数引数: URL、フィードの種類(例:rss2、atomなど)
+
: フィルター関数引数: URL、フィードの種類(例:rss2、atom など)
: get_feed_link関数が生成したフィードのリンクURLに適用される。
+
: <tt>get_feed_link</tt> 関数が生成したフィードのリンク URL に適用される。
  
; get_comment_author_link  
+
; [[プラグイン API/フィルターフック一覧/get_comment_author_link|get_comment_author_link]] /[[:en:Plugin_API/Filter_Reference/get_comment_author_link|en]]
: get_comment_author_link関数が生成したコメント投稿者のリンクHTMLに適用される。
+
: フィルター関数引数: ユーザー名
 +
: <tt>get_comment_author_link</tt> 関数が生成したコメント投稿者のリンク HTML に適用される(これは <tt>comment_author_link</tt> で呼び出されるものと同じ)。
  
; get_comment_author_url_link
+
; [[プラグイン API/フィルターフック一覧/get_comment_author_url_link|get_comment_author_url_link]] /[[:en:Plugin_API/Filter_Reference/get_comment_author_url_link|en]]
: get_comment_author_url_link関数が生成したコメント投稿者のリンクHTMLに適用される。
+
: <tt>get_comment_author_url_link</tt> 関数が生成したコメント投稿者のリンク HTML に適用される(これは <tt>comment_author_link</tt> で呼び出されるものと同じ)。
  
; month_link
+
; [[プラグイン API/フィルターフック一覧/month_link|month_link]] /[[:en:Plugin_API/Filter_Reference/month_link|en]]
 
: フィルター関数引数: URL、年、月(数字)
 
: フィルター関数引数: URL、年、月(数字)
: get_month_link関数が生成した月別アーカイブのリンクURLに適用される。
+
: <tt>get_month_link</tt> 関数が生成した月別アーカイブのリンク URL に適用される。
  
; page_link
+
; [[プラグイン API/フィルターフック一覧/page_link|page_link]] /[[:en:Plugin_API/Filter_Reference/page_link|en]]
: フィルター関数引数: URL、ページID
+
: フィルター関数引数: URL、ページ ID
: get_page_link関数が生成したページURLに適用される。
+
: <tt>get_page_link</tt> 関数が生成したページURLに適用される。
  
; post_link
+
; [[プラグイン API/フィルターフック一覧/post_link|post_link]] /[[:en:Plugin_API/Filter_Reference/post_link|en]]
: フィルター関数引数: 固定リンクURL、投稿記事データのリスト
+
: フィルター関数引数: 固定リンク URL、投稿投稿データのリスト
: get_permalink関数が生成した投稿記事の固定リンクに適用される。
+
: <tt>get_permalink</tt> 関数が生成した投稿投稿の固定リンクに適用される(これは <tt>the_permalink</tt>、post_permalink</tt>、previous_post_link</tt>、<tt>next_post_link</tt> 関数で呼び出されるものと同じ)。
  
; the_permalink
+
; [[プラグイン API/フィルターフック一覧/post_type_link|post_type_link]] /[[:en:Plugin_API/Filter_Reference/post_type_link|en]]
: the_permalink関数が投稿記事の固定リンクを出力する前に適用される。
+
: <tt>get_post_permalink</tt> 関数によって算出されたカスタム投稿タイプパーマリンクに適用される。
  
; year_link
+
; [[プラグイン API/フィルターフック一覧/the_permalink|the_permalink]] /[[:en:Plugin_API/Filter_Reference/the_permalink|en]]
 +
: <tt>the_permalink</tt> 関数が投稿投稿のパーマリンク URL を出力する前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/year_link|year_link]] /[[:en:Plugin_API/Filter_Reference/year_link|en]]
 
: フィルター関数引数: URL、年
 
: フィルター関数引数: URL、年
: get_year_link関数が生成した年別アーカイブのリンクURLに適用される。
+
: <tt>get_year_link</tt> 関数が生成した年別アーカイブのリンク URL に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/tag_link|tag_link]] /[[:en:Plugin_API/Filter_Reference/tag_link|en]]
 +
: フィルター関数引数: リンク URL、タグ ID
 +
: <tt>get_tag_link</tt> 関数が生成したタグの URL に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/term_link|term_link]] /[[:en:Plugin_API/Filter_Reference/term_link|en]]
 +
: フィルター関数引数: 項目リンク URL、項目オブジェクト、タクソノミースラッグ
 +
: <tt>get_term_link</tt> 関数が生成したタクソノミー項目の URL に適用される。
  
 
== 日付・時間関連のフィルター ==
 
== 日付・時間関連のフィルター ==
  
; get_comment_date
+
[[#リンク関連のフィルター|リンク関連のフィルター]]も参照。
: get_comment_date関数引数フォーマット済みのコメント投稿日に適用される。
+
  
; get_comment_time
+
; [[プラグイン API/フィルターフック一覧/get_comment_date|get_comment_date]] /[[:en:Plugin_API/Filter_Reference/get_comment_date|en]]
: get_comment_time関数が生成したフォーマット済みのコメント投稿時間に適用される。
+
: <tt>get_comment_date</tt> 関数で呼び出されたフォーマット済みのコメント投稿日に適用される(<tt>comment_date</tt> でも呼び出される)。
  
; get_the_modified_date
+
; [[プラグイン API/フィルターフック一覧/get_comment_time|get_comment_time]] /[[:en:Plugin_API/Filter_Reference/get_comment_time|en]]
: get_the_modified_date関数が生成したフォーマット済みの投稿修正年月日に適用される(この関数はthe_modified_date関数内でも呼び出される)。
+
: <tt>get_comment_time</tt> 関数が生成したフォーマット済みのコメント投稿時間に適用される。
  
; get_the_modified_time
+
; [[プラグイン API/フィルターフック一覧/get_the_modified_date|get_the_modified_date]] /[[:en:Plugin_API/Filter_Reference/get_the_modified_date|en]]
: get_the_modified_time関数またはget_post_modified_time関数が生成したフォーマット済みの投稿修正時間に適用される(これらの関数はthe_modified_time関数内でも呼び出される)。
+
: <tt>get_the_modified_date</tt> 関数が生成したフォーマット済みの投稿修正年月日に適用される(この関数は <tt>the_modified_date</tt> 関数内でも呼び出される)。
  
; get_the_time
+
; [[プラグイン API/フィルターフック一覧/get_the_modified_time|get_the_modified_time]] /[[:en:Plugin_API/Filter_Reference/get_the_modified_time|en]]
: get_the_time関数またはget_post_time関数が生成したフォーマット済みの投稿年月日に適用される(これらの関数はthe_time関数内でも呼び出される)。
+
: <tt>get_the_modified_time</tt> 関数または <tt>get_post_modified_time</tt> 関数が生成したフォーマット済みの投稿修正時間に適用される(これらの関数は <tt>the_modified_time</tt> 関数内でも呼び出される)。
  
; the_date
+
; [[プラグイン API/フィルターフック一覧/get_the_time|get_the_time]] /[[:en:Plugin_API/Filter_Reference/get_the_time|en]]
: the_date関数が生成したフォーマット済みの投稿年月日に適用される。
+
: <tt>get_the_time</tt> 関数または <tt>get_post_time</tt> 関数が生成したフォーマット済みの投稿年月日に適用される(これらの関数は <tt>the_time</tt> 関数内でも呼び出される)。
  
; the_modified_date(投稿修正年月日)
+
; [[プラグイン API/フィルターフック一覧/the_date|the_date]] /[[:en:Plugin_API/Filter_Reference/the_date|en]]
; the_modified_time(投稿修正時間)
+
: <tt>the_date</tt> 関数が生成したフォーマット済みの投稿年月日に適用される。
: the_modified_time関数が生成したそれぞれのフォーマット済み情報に適用される。
+
  
; the_time
+
; [[プラグイン API/フィルターフック一覧/the_modified_date|the_modified_date]] /[[:en:Plugin_API/Filter_Reference/the_modified_date|en]]
: the_time関数が生成したフォーマット済みの投稿時間に適用される。
+
: <tt>the_modified_time</tt> 関数が生成したフォーマット済みの投稿修正年月日に適用される。
  
; the_weekday
+
; [[プラグイン API/フィルターフック一覧/the_modified_time|the_modified_time]] /[[:en:Plugin_API/Filter_Reference/the_modified_time|en]]
: the_weekday関数が生成した投稿の曜日名に適用される。
+
: <tt>the_modified_time</tt> 関数が生成したフォーマット済みの投稿修正時間に適用される。
  
; the_weekday_date
+
; [[プラグイン API/フィルターフック一覧/the_time|the_time]] /[[:en:Plugin_API/Filter_Reference/the_time|en]]
 +
: <tt>the_time</tt> 関数が生成したフォーマット済みの投稿時間に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_weekday|the_weekday]] /[[:en:Plugin_API/Filter_Reference/the_weekday|en]]
 +
: <tt>the_weekday</tt> 関数が生成したフォーマット済みの曜日名に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/the_weekday_date|the_weekday_date]] /[[:en:Plugin_API/Filter_Reference/the_weekday_date|en]]
 
: フィルター関数引数: 曜日名、曜日名の前に出力する文字列、曜日名の後に出力する文字列
 
: フィルター関数引数: 曜日名、曜日名の前に出力する文字列、曜日名の後に出力する文字列
: the_weekday_date関数が生成した投稿の曜日名に適用される。
+
: <tt>the_weekday_date</tt> 関数が生成した投稿の曜日名に適用される。
  
 
== 投稿者・ユーザー関連のフィルター ==
 
== 投稿者・ユーザー関連のフィルター ==
 +
 +
[[#リンク関連のフィルター|リンク関連のフィルター]]、[[#管理画面関連のフィルター|管理画面関連のフィルター]]セクションも参照
 +
 +
; [[プラグイン API/フィルターフック一覧/login_body_class|login_body_class]] /[[:en:Plugin_API/Filter_Reference/login_body_class|en]]
 +
: <tt>[[関数リファレンス/login_header|login_header()]] /[[:en:Function_Reference/login_header|en]]</tt>の出力となるログイン画面のbody要素のclass属性に適用される。
 +
 +
; [[プラグイン API/フィルターフック一覧/login_redirect|login_redirect]] /[[:en:Plugin_API/Filter_Reference/login_redirect|en]]
 +
: ログイン処理の実行中に <tt>redirect_to</tt> post/get 変数に適用される。
 +
 +
; [[プラグイン API/フィルターフック一覧/user_contactmethods|user_contactmethods]] /[[:en:Plugin_API/Filter_Reference/user_contactmethods|en]]
 +
: 「あなたのプロフィール」画面の連絡先情報に適用される (古いページは  [[:en:Plugin_API/Filter_Reference/contactmethods|contactmethods]] 参照)。
 +
 +
; [[プラグイン API/フィルターフック一覧/update_(meta_type)_metadata|update_(meta_type)_metadata]] /[[:en:Plugin_API/Filter_Reference/update_(meta_type)_metadata|en]]
 +
: (ユーザーの)メタデータが更新される前に適用される。
  
 
=== データベース読み出し ===
 
=== データベース読み出し ===
  
; author_email
+
このセクションのフィルターは、データベースから読み出された情報がページまたは編集画面に表示される前に適用されます。
: comment_author_email関数で取得したコメント投稿者のメールアドレスに適用される。
+
  
; comment_author
+
; [[プラグイン API/フィルターフック一覧/author_email|author_email]] /[[:en:Plugin_API/Filter_Reference/author_email|en]]
: comment_author関数で取得したコメント投稿者名に適用される。
+
: <tt>comment_author_email</tt> 関数で取得したコメント投稿者のメールアドレスに適用される。
  
; comment_author_rss
+
; [[プラグイン API/フィルターフック一覧/comment_author|comment_author]] /[[:en:Plugin_API/Filter_Reference/comment_author|en]]
: コメント投稿者名がRSSフィードに挿入される前に適用される。
+
: <tt>comment_author</tt> 関数で取得したコメント投稿者名に適用される。 <tt>get_comment_author</tt> も参照。
  
; comment_email
+
; [[プラグイン API/フィルターフック一覧/comment_author_rss|comment_author_rss]] /[[:en:Plugin_API/Filter_Reference/comment_author_rss|en]]
: comment_author_email_link関数で取得したコメント投稿者のメールアドレスに適用される。
+
: コメント投稿者名が RSS フィードに挿入される前に適用される。
  
; comment_url
+
; [[プラグイン API/フィルターフック一覧/comment_email|comment_email]] /[[:en:Plugin_API/Filter_Reference/comment_email|en]]
: comment_author_url関数で取得したコメント投稿者のサイトURLに適用される。
+
: <tt>comment_author_email_link</tt> 関数で取得したコメント投稿者のメールアドレスに適用される。
  
; get_comment_author
+
; [[プラグイン API/フィルターフック一覧/comment_url|comment_url]] /[[:en:Plugin_API/Filter_Reference/comment_url|en]]
: get_comment_author関数で取得したコメント投稿者名に適用される。
+
: <tt>comment_author_url</tt> 関数で取得したコメント投稿者のサイトURLに適用される(<tt>get_comment_author_url</tt> も参照)。
  
; get_comment_author_email
+
; [[プラグイン API/フィルターフック一覧/get_comment_author|get_comment_author]] /[[:en:Plugin_API/Filter_Reference/get_comment_author|en]]
: get_comment_author_email関数で取得したコメント投稿者のメールアドレスに適用される。
+
: <tt>get_comment_author</tt> 関数で取得したコメント投稿者名に適用される。これは <tt>comment_author</tt> で呼び出されるものと同じ。<tt>comment_author</tt> も参照。
  
; get_comment_author_IP
+
; [[プラグイン API/フィルターフック一覧/get_comment_author_email|get_comment_author_email]] /[[:en:Plugin_API/Filter_Reference/get_comment_author_email|en]]
: get_comment_author_IP関数で取得したコメント投稿者のIPアドレスに適用される。
+
: <tt>get_comment_author_email</tt> 関数で取得したコメント投稿者のメールアドレスに適用される。これは <tt>comment_author_email</tt> で呼び出されるものと同じ。<tt>author_email</tt> も参照。
  
; get_comment_author_url
+
; [[プラグイン API/フィルターフック一覧/get_comment_author_IP|get_comment_author_IP]] /[[:en:Plugin_API/Filter_Reference/get_comment_author_IP|en]]
: get_comment_author_url関数で取得したコメント投稿者のサイトURLに適用される。
+
: <tt>get_comment_author_IP</tt> 関数で取得したコメント投稿者の IP アドレスに適用される。これは <tt>comment_author_IP</tt> で呼び出されるものと同じ。
  
; login_errors(エラーメッセージ)
+
; [[プラグイン API/フィルターフック一覧/get_comment_author_url|get_comment_author_url]] /[[:en:Plugin_API/Filter_Reference/get_comment_author_url|en]]
; login_headertitle(ログインヘッダーのリンクのtitle属性。デフォルトではPowered by WordPress)
+
: <tt>get_comment_author_url</tt> 関数で取得したコメント投稿者の URL に適用される。これは <tt>comment_url</tt> で呼び出されるものと同じ。<tt>comment_author</tt> も参照。
; login_headerurl(ログインヘッダーのリンク先。デフォルトではwordpress.org)
+
; login_message(ログインメッセージ)
+
: ログイン画面に表示される各情報に適用される。
+
  
; role_has_cap
+
; [[プラグイン API/フィルターフック一覧/login_errors|login_errors]] /[[:en:Plugin_API/Filter_Reference/login_errors|en]]
 +
: ログイン画面に表示されるエラーメッセージに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/login_headertitle|login_headertitle]] /[[:en:Plugin_API/Filter_Reference/login_headertitle|en]]
 +
: ログインヘッダー URL の title 属性(デフォルトでは "Powered by WordPress")に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/login_headerurl|login_headerurl]] /[[:en:Plugin_API/Filter_Reference/login_headerurl|en]]
 +
: ログインヘッダー URL のリンク先(デフォルトでは wordpress.org)に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/login_message|login_message]] /[[:en:Plugin_API/Filter_Reference/login_message|en]]
 +
: ログイン画面に表示されるメッセージに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/role_has_cap|role_has_cap]] /[[:en:Plugin_API/Filter_Reference/role_has_cap|en]]
 
: フィルター関数引数: フィルターする権限のリスト、チェックする権限、ユーザー権限グループ名
 
: フィルター関数引数: フィルターする権限のリスト、チェックする権限、ユーザー権限グループ名
: wP_Role->has_cap関数内で、ユーザー権限グループの権限リストに適用される。
+
: <tt>WP_Role->has_cap</tt> 関数内で、ユーザー権限グループの権限リストに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/sanitize_user|sanitize_user]] /[[:en:Plugin_API/Filter_Reference/sanitize_user|en]]
 +
: フィルター関数引数: サニタイズ済みのユーザー名、サニタイズされていないユーザー名、厳格な ASCII 文字を使うかどうか(true/false)
 +
: <tt>sanitize_user</tt> 関数で返されるユーザー名に適用される。
  
; sanitize_user
+
; [[プラグイン API/フィルターフック一覧/the_author|the_author]] /[[:en:Plugin_API/Filter_Reference/the_author|en]]
: フィルター関数引数: サニタイズ済みのユーザー名、サニタイズされていないユーザー名、厳格なASCII文字を使うかどうか(true/false)
+
: <tt>get_the_author</tt> 関数で返されるユーザーの表示名に適用される。これは <tt>the_author</tt> で呼び出されるものと同じ。
: sanitize_user関数で返されるユーザー名に適用される。
+
  
; the_author
+
; [[プラグイン API/フィルターフック一覧/the_author_email|the_author_email]] /[[:en:Plugin_API/Filter_Reference/the_author_email|en]]
: get_the_author関数で返されるユーザーの表示名に適用される。
+
: <tt>the_author_email</tt> 関数で返されるユーザーのメールアドレスに適用される。
  
; the_author_email
+
; [[プラグイン API/フィルターフック一覧/user_search_columns|user_search_columns]] /[[:en:Plugin_API/Filter_Reference/user_search_columns|en]]
: the_author_email関数で返されるユーザーのメールアドレスに適用される。
+
: <tt>wp_users</tt> テーブル内のカラム一覧に [[Class_Reference/WP_User_Query|WP_User_Query]] 内の <tt>WHERE</tt> 節を含めるために適用される。
  
 
=== データベース書き込み ===
 
=== データベース書き込み ===
  
; pre_comment_author_email(コメント投稿者のメールアドレス)
+
このセクションのフィルターは、情報がデータベースに保存される前に適用されます。
; pre_comment_author_name(コメント投稿者のユーザー名)
+
; pre_comment_author_url(コメント投稿者のUR)
+
; pre_comment_user_agent(コメント投稿者のユーザーエージェント情報)
+
; pre_comment_user_ip(コメント投稿者のIPアドレス情報)
+
; pre_user_id(コメント投稿者のユーザーID)
+
; pre_user_description(コメント投稿者の説明文)
+
; pre_user_display_name(コメント投稿者のブログ上の表示名)
+
: コメントをデータベースに保存する前に、各情報に適用される。
+
  
; pre_user_email(ユーザーのメールアドレス)
+
; [[プラグイン API/フィルターフック一覧/pre_comment_author_email|pre_comment_author_email]] /[[:en:Plugin_API/Filter_Reference/pre_comment_author_email|en]]
; pre_user_first_name(ユーザーの名前)
+
: コメントをデータベースに保存する前に、コメント投稿者のメールアドレスに対して適用される。
; pre_user_last_name(ユーザーの名字)
+
; pre_user_login(ユーザーのログイン名)
+
; pre_user_nickname(ユーザーのニックネーム)
+
; pre_user_url(ユーザーのURL)
+
: 各情報がデータベースに保存される前に適用される。
+
  
; registration_errors
+
; [[プラグイン API/フィルターフック一覧/pre_comment_author_name|pre_comment_author_name]] /[[:en:Plugin_API/Filter_Reference/pre_comment_author_name|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者のユーザー名に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_comment_author_url|pre_comment_author_url]] /[[:en:Plugin_API/Filter_Reference/pre_comment_author_url|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者の URL に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_comment_user_agent|pre_comment_user_agent]] /[[:en:Plugin_API/Filter_Reference/pre_comment_user_agent|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者のユーザーエージェント情報に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_comment_user_ip|pre_comment_user_ip]] /[[:en:Plugin_API/Filter_Reference/pre_comment_user_ip|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者の IP アドレス情報に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_id|pre_user_id]] /[[:en:Plugin_API/Filter_Reference/pre_user_id|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者のユーザー ID に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_description|pre_user_description]] /[[:en:Plugin_API/Filter_Reference/pre_user_description|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者の説明文に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_display_name|pre_user_display_name]] /[[:en:Plugin_API/Filter_Reference/pre_user_display_name|en]]
 +
: コメントをデータベースに保存する前に、コメント投稿者のブログ上の表示名に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_email|pre_user_email]] /[[:en:Plugin_API/Filter_Reference/pre_user_email|en]]
 +
: データベースに保存する前に、ユーザーのメールアドレスに対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_first_name|pre_user_first_name]] /[[:en:Plugin_API/Filter_Reference/pre_user_first_name|en]]
 +
: データベースに保存する前に、ユーザーの名前(ファーストネーム)に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_last_name|pre_user_last_name]] /[[:en:Plugin_API/Filter_Reference/pre_user_last_name|en]]
 +
: データベースに保存する前に、ユーザーの苗字に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_login|pre_user_login]] /[[:en:Plugin_API/Filter_Reference/pre_user_login|en]]
 +
: データベースに保存する前に、ユーザーのログイン名に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_nicename|pre_user_nicename]] /[[:en:Plugin_API/Filter_Reference/pre_user_nicename|en]]
 +
: データベースに保存する前に、ユーザー名のスラッグ("nice name")に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_nickname|pre_user_nickname]] /[[:en:Plugin_API/Filter_Reference/pre_user_nickname|en]]
 +
: データベースに保存する前に、ユーザーのニックネームに対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_user_url|pre_user_url]] /[[:en:Plugin_API/Filter_Reference/pre_user_url|en]]
 +
: データベースに保存する前に、ユーザーの URL に対して適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/registration_errors|registration_errors]] /[[:en:Plugin_API/Filter_Reference/registration_errors|en]]
 
: 新規アカウント登録の際に発生した登録エラーのリストに適用される。
 
: 新規アカウント登録の際に発生した登録エラーのリストに適用される。
  
; user_registration_email
+
; [[プラグイン API/フィルターフック一覧/user_registration_email|user_registration_email]] /[[:en:Plugin_API/Filter_Reference/user_registration_email|en]]
 
: 新規ユーザーを登録する前に、登録ページから読み取ったユーザーのメールアドレスに適用される。
 
: 新規ユーザーを登録する前に、登録ページから読み取ったユーザーのメールアドレスに適用される。
  
; validate_username
+
; [[プラグイン API/フィルターフック一覧/validate_username|validate_username]] /[[:en:Plugin_API/Filter_Reference/validate_username|en]]
: フィルター関数引数: ユーザー名が有効かどうかの確認結果(true/false)
+
: フィルター関数引数: ユーザー名が有効かどうかの確認結果(true/false)、確認されたユーザー名
 
: 新規ユーザー名が有効かどうかの確認結果に適用される。
 
: 新規ユーザー名が有効かどうかの確認結果に適用される。
  
 
== リンク集関連のフィルター ==
 
== リンク集関連のフィルター ==
  
; get_bookmarks
+
: このセクションではリンク集(ブログロール)関連のフィルターを紹介しています。投稿、ページ、カテゴリーなどに関連するリンクのフィルターについては、[[#リンク関連のフィルター|リンク関連のフィルター]]を参照。
: フィルター関数引数: データベースクエリ結果のリスト、get_bookmarks引数のリスト
+
: get_bookmarks関数で取得した、リンク集のデータベースクエリ結果に適用される。
+
  
; link_category
+
; [[プラグイン API/フィルターフック一覧/get_bookmarks|get_bookmarks]] /[[:en:Plugin_API/Filter_Reference/get_bookmarks|en]]
: get_links_list関数およびwp_list_bookmarks関数で取得した、リンクカテゴリー情報に適用される。
+
: フィルター関数引数: データベースクエリ結果のリスト、<tt>get_bookmarks</tt> 引数のリスト
 +
: <tt>get_bookmarks</tt> 関数で取得した、リンク集のデータベースクエリ結果に適用される。
  
; link_description(リンク説明)
+
; [[プラグイン API/フィルターフック一覧/link_category|link_category]] /[[:en:Plugin_API/Filter_Reference/link_category|en]]
; link_title(リンク名)
+
: <tt>get_links_list</tt> 関数および <tt>wp_list_bookmarks</tt> 関数で取得したリンクカテゴリー情報に適用される(WordPress 2.2 以降)。
: get_links関数およびwp_list_bookmarks関数で取得した各情報に適用される。
+
  
; link_rating
+
; [[プラグイン API/フィルターフック一覧/link_description|link_description]] /[[:en:Plugin_API/Filter_Reference/link_description|en]]
: get_linkrating関数のリンク評価(数字)に適用される。
+
: <tt>get_links_list</tt> 関数および <tt>wp_list_bookmarks</tt> 関数で取得したリンク説明文に適用される(WordPress 2.2 以降)。
  
; pre_link_description(リンク説明)
+
; [[プラグイン API/フィルターフック一覧/link_rating|link_rating]] /[[:en:Plugin_API/Filter_Reference/link_rating|en]]
; pre_link_image(リンク画像)
+
: <tt>get_links_list</tt> 関数および <tt>wp_list_bookmarks</tt> 関数で取得したリンク名に適用される(WordPress 2.2 以降)。
; pre_link_name(リンク名)
+
 
; pre_link_notes(リンクのメモ)
+
; [[プラグイン API/フィルターフック一覧/link_title|link_title]] /[[:en:Plugin_API/Filter_Reference/link_title|en]]
; pre_link_rel(リンク先の関係/間柄 [XFN情報]
+
: <tt>get_linkrating</tt> 関数で取得したリンク評価(数字)に適用される。
; pre_link_rss(リンク先のRSS)
+
 
; pre_link_target(リンクターゲット)
+
; [[プラグイン API/フィルターフック一覧/pre_link_description|pre_link_description]] /[[:en:Plugin_API/Filter_Reference/pre_link_description|en]]
; pre_link_url(リンクURL)
+
: リンク説明がデータベースに保存される前に適用される。
: 各情報がデータベースに保存される前に適用される。
+
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_image|pre_link_image]] /[[:en:Plugin_API/Filter_Reference/pre_link_image|en]]
 +
: リンク画像がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_name|pre_link_name]] /[[:en:Plugin_API/Filter_Reference/pre_link_name|en]]
 +
: リンク名がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_notes|pre_link_notes]] /[[:en:Plugin_API/Filter_Reference/pre_link_notes|en]]
 +
: リンクのメモがデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_rel|pre_link_rel]] /[[:en:Plugin_API/Filter_Reference/pre_link_rel|en]]
 +
: リンク先の関係/間柄(XFN)情報がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_rss|pre_link_rss]] /[[:en:Plugin_API/Filter_Reference/pre_link_rss|en]]
 +
: リンク先の RSS URL がデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_target|pre_link_target]] /[[:en:Plugin_API/Filter_Reference/pre_link_target|en]]
 +
: リンクターゲットがデータベースに保存される前に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/pre_link_url|pre_link_url]] /[[:en:Plugin_API/Filter_Reference/pre_link_url|en]]
 +
: リンク URL がデータベースに保存される前に適用される。
  
 
== ブログ情報・設定関連のフィルター ==
 
== ブログ情報・設定関連のフィルター ==
  
; all_options
+
; [[プラグイン API/フィルターフック一覧/all_options|all_options]] /[[:en:Plugin_API/Filter_Reference/all_options|en]]
: get_alloptions関数で取得した、ブログ設定情報のリストに適用される。
+
: <tt>get_alloptions</tt> 関数で取得した、ブログ設定情報のリストに適用される。
  
; bloginfo
+
; [[プラグイン API/フィルターフック一覧/bloginfo|bloginfo]] /[[:en:Plugin_API/Filter_Reference/bloginfo|en]]
: bloginfo関数で取得した、ブログ設定情報に適用される。
+
: <tt>get_bloginfo</tt> 関数で情報を取得した後、<tt>bloginfo</tt> 関数で取得したブログ設定情報に適用される。2つ目の引数 <tt>$show</tt> は、要求された bloginfo の設定名。<tt>bloginfo("url")</tt>、<tt>bloginfo("directory")</tt>、<tt>bloginfo("home")</tt> はこのフィルターに影響されないことに注意する(<tt>bloginfo_url</tt> フィルターの項を参照)。
: ※注:bloginfo("url")、bloginfo("directory")、bloginfo("home")はこのフィルターに影響されない(bloginfo_urlフィルターの項を参照)。
+
  
; bloginfo_rss
+
; [[プラグイン API/フィルターフック一覧/bloginfo_rss|bloginfo_rss]] /[[:en:Plugin_API/Filter_Reference/bloginfo_rss|en]]
: get_bloginfo_rss関数内でget_bloginfo関数を使ってブログ設定情報を取得し、HTMLタグを除去して特殊文字を変換した後に適用される。2つ目の引数$showは、要求されたbloginfoの設定名。
+
: <tt>get_bloginfo_rss</tt> 関数内で <tt>get_bloginfo</tt> 関数を使ってブログ設定情報を取得し、 HTML タグを除去して特殊文字を変換した後に適用される。2つ目の引数 <tt>$show</tt> は、要求された bloginfo の設定名。
  
; bloginfo_url
+
; [[プラグイン API/フィルターフック一覧/bloginfo_url|bloginfo_url]] /[[:en:Plugin_API/Filter_Reference/bloginfo_url|en]]
: bloginfo("url")、bloginfo("directory")、bloginfo("home")の出力値を返す前に適用される。
+
: <tt>bloginfo("url")</tt>、<tt>bloginfo("directory")</tt>、<tt>bloginfo("home")</tt> の出力値を返す前に適用される。
  
; loginout  
+
; [[プラグイン API/フィルターフック一覧/loginout|loginout]] /[[:en:Plugin_API/Filter_Reference/loginout|en]]
: wp_loginout関数でログイン・ログアウト用のリンクを生成する際に適用される。
+
: <tt>wp_loginout</tt> 関数で(通常サイドバーに配置される)ログイン・ログアウト用の HTML リンクを生成する際に適用される。
  
; option_設定名
+
; [[プラグイン API/フィルターフック一覧/option_(option name)|option_(option name)]] /[[:en:Plugin_API/Filter_Reference/option_(option name)|en]]
: get_option関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えばfooという設定についてget_option("foo")の出力値をフィルターする場合、option_fooという名前のフィルターを追加して使用する。
+
: <tt>get_option</tt> 関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えば foo という設定について <tt>get_option("foo")</tt> の出力値をフィルターする場合、"option_foo" という名前のフィルターを追加して使用する。
  
; pre_option_設定名
+
; [[プラグイン API/フィルターフック一覧/pre_option_(option name)|pre_option_(option name)]] /[[:en:Plugin_API/Filter_Reference/pre_option_(option name)|en]]
: get_alloptions関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えばfooという設定をフィルターする場合、pre_option_fooという名前のフィルターを追加して使用する。
+
: <tt>get_alloptions</tt> 関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えば foo という設定をフィルターする場合、<tt>pre_option_foo</tt> という名前のフィルターを追加して使用する。
  
; register
+
; [[プラグイン API/フィルターフック一覧/pre_get_space_used|pre_get_space_used]] /[[:en:Plugin_API/Filter_Reference/pre_get_space_used|en]]
: wp_register関数で、ユーザー登録が許可されている場合に表示する登録リンク、またはログインしている場合に表示する管理画面へのリンクに適用される。
+
: <tt>[[関数リファレンス/get_space_used|get_space_used()]]</tt> 関数に適用され、使用中のディスク領域を表示する代替方法を提供する。このフィルターで false を返すと、デフォルトの表示方法に戻る (wp_upload_dir() が返すディレクトリの空き領域をメガバイト単位で)。
  
; upload_dir
+
; [[プラグイン API/フィルターフック一覧/pre_option_(option name)|pre_option_(option name)]] /[[:en:Plugin_API/Filter_Reference/pre_option_(option name)|en]]
: フィルター関数引数: dir(アップロードディレクトリへのパス)、url(アップロードディレクトリのURL)、error(エラーを出力する場合trueに設定)の値を含む配列
+
: <tt>get_alloptions</tt>関数によりデータベースから取得されるオプション値に適用される。配列のオプション値であればシリアライズ化される。このフィルターを使用するには、特定のオプション名を付けてフィルターを追加する必要がある。たとえば、オプション “foo” をフィルターするには “pre_option_foo”。
: wp_upload_dir関数で算出した、ファイルアップロードディレクトリに適用される。
+
  
; upload_mimes
+
; [[プラグイン API/フィルターフック一覧/pre_update_option_(option name)|pre_update_option_(option name)]] /[[:en:Plugin_API/Filter_Reference/pre_update_option_(option name)|en]]
: フィルター関数引数: "|"記号区切りのファイル拡張子と対応するMIMEタイプ情報を含むリスト
+
: オプション値がデータベースに保存される前に適用される。つまり、保存する値を上書きできる。このフィルターを使用するには、特定のオプション名を付けてフィルターを追加する必要がある。たとえば、オプション “foo” をフィルターするには “pre_update_option_foo”。
: wp_check_filetype関数でMIMEタイプリストの入力がない場合、アップロードファイル用のMIMEタイプリストを返すためのフィルター。
+
 
 +
; [[プラグイン API/フィルターフック一覧/register|register]] /[[:en:Plugin_API/Filter_Reference/register|en]]
 +
: <tt>wp_register</tt> 関数で、ユーザー登録が許可されている場合に表示する登録リンク、またはログインしている場合に表示する管理画面へのリンクに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/upload_dir|upload_dir]] /[[:en:Plugin_API/Filter_Reference/upload_dir|en]]
 +
: フィルター関数引数: dir(アップロードディレクトリへのパス)、url(アップロードディレクトリの URL)、error(エラーを出力する場合 true に設定)の値を含む配列
 +
: <tt>wp_upload_dir</tt> 関数で算出した、ファイルアップロードディレクトリに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/upload_mimes|upload_mimes]] /[[:en:Plugin_API/Filter_Reference/upload_mimes|en]]
 +
: フィルター関数引数: "|" 記号区切りのファイル拡張子と対応する MIME タイプ情報を含むリスト
 +
: <tt>wp_check_filetype</tt> 関数で MIME タイプリストの入力がない場合、アップロードファイル用の MIME タイプリストを返すためのフィルター。
  
 
== テキスト関連のフィルター ==
 
== テキスト関連のフィルター ==
  
; attribute_escape
+
; [[プラグイン API/フィルターフック一覧/attribute_escape|attribute_escape]] /[[:en:Plugin_API/Filter_Reference/attribute_escape|en]]
: 特殊文字をHTML文字実体参照に変換するための関数、attribute_escape関数内でテキストデータ(投稿記事本文など)に適用される。
+
: 特殊文字を HTML 文字実体参照に変換するための関数、<tt>attribute_escape</tt> 関数内でテキストデータ(投稿投稿本文など)に適用される。
  
; js_escape
+
; [[プラグイン API/フィルターフック一覧/js_escape|js_escape]] /[[:en:Plugin_API/Filter_Reference/js_escape|en]]
: js_escape関数で、JavaScriptコードをブラウザに送信する前に適用される。
+
: <tt>js_escape</tt> 関数で、JavaScript コードをブラウザに送信する前に適用される。
  
 
== 管理画面関連のフィルター ==
 
== 管理画面関連のフィルター ==
  
; autosave_interval
+
このセクションのフィルターは WordPress の管理画面に関連するものです。コンテンツ編集画面もこれに含まれます。
: 記事を自動保存する間隔の時間に適用される。
+
 
 +
; [[プラグイン API/フィルターフック一覧/admin_user_info_links|admin_user_info_links]] /[[:en:Plugin_API/Filter_Reference/admin_user_info_links|en]]
 +
: WordPress 管理画面クイックメニュー内のユーザープロフィール・情報リンクに適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/autosave_interval|autosave_interval]] /[[:en:Plugin_API/Filter_Reference/autosave_interval|en]]
 +
: 投稿を自動保存する間隔の時間に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/bulk_actions|bulk_actions]] /[[:en:Plugin_API/Filter_Reference/bulk_actions|en]]
 +
: 管理画面の一括操作ドロップダウンの操作対象項目配列に適用される。
 +
 
 +
; [[プラグイン API/フィルターフック一覧/bulk_post_updated_messages|bulk_post_updated_messages]] /[[:en:Plugin_API/Filter_Reference/bulk_post_updated_messages|en]]
 +
: 一括操作更新メッセージに適用される。
  
; cat_rows
+
; [[プラグイン API/フィルターフック一覧/cat_rows|cat_rows]] /[[:en:Plugin_API/Filter_Reference/cat_rows|en]]
: カテゴリー管理画面で生成される、カテゴリー行のHTMLに適用される。
+
: カテゴリー管理画面で生成される、カテゴリー行の HTML に適用される。
  
; comment_edit_pre
+
; [[プラグイン API/フィルターフック一覧/comment_edit_pre|comment_edit_pre]] /[[:en:Plugin_API/Filter_Reference/comment_edit_pre|en]]
 
: コメント本文が編集画面に表示される前に適用される。
 
: コメント本文が編集画面に表示される前に適用される。
  
; comment_edit_redirect
+
; [[プラグイン API/フィルターフック一覧/comment_edit_redirect|comment_edit_redirect]] /[[:en:Plugin_API/Filter_Reference/comment_edit_redirect|en]]
: フィルター関数引数: リダイレクト先情報、コメントID
+
: フィルター関数引数: リダイレクト先情報、コメント ID
 
: 管理画面でコメントを編集した後のリダイレクト先情報に適用される。
 
: 管理画面でコメントを編集した後のリダイレクト先情報に適用される。
  
; comment_moderation_subject
+
; [[プラグイン API/フィルターフック一覧/comment_moderation_subject|comment_moderation_subject]] /[[:en:Plugin_API/Filter_Reference/comment_moderation_subject|en]]
: フィルター関数引数: メール件名、コメントID
+
: フィルター関数引数: メール件名、コメント ID
 
: 管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
 
: 管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
: 注:この操作はデフォルトのwp_notify_moderator関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: 注:この操作はデフォルトの <tt>wp_notify_moderator</tt> 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; comment_moderation_text
+
; [[プラグイン API/フィルターフック一覧/comment_moderation_text|comment_moderation_text]] /[[:en:Plugin_API/Filter_Reference/comment_moderation_text|en]]
: フィルター関数引数: メール本文、コメントID
+
: フィルター関数引数: メール本文、コメント ID
 
: 管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
 
: 管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
: 注:この操作はデフォルトのwp_notify_moderator関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: 注:この操作はデフォルトの <tt>wp_notify_moderator</tt> 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; comment_notification_headers
+
; [[プラグイン API/フィルターフック一覧/comment_notification_headers|comment_notification_headers]] /[[:en:Plugin_API/Filter_Reference/comment_notification_headers|en]]
: フィルター関数引数: メールヘッダーのテキスト、コメントID
+
: フィルター関数引数: メールヘッダーのテキスト、コメント ID
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メールヘッダーに適用される。
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メールヘッダーに適用される。
: 注:この操作はデフォルトのwp_notify_postauthor関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: 注:この操作はデフォルトの <tt>wp_notify_moderator</tt> 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; comment_notification_subject
+
; [[プラグイン API/フィルターフック一覧/comment_notification_subject|comment_notification_subject]] /[[:en:Plugin_API/Filter_Reference/comment_notification_subject|en]]
: フィルター関数引数: メール件名、コメントID
+
: フィルター関数引数: メール件名、コメント ID
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
: 注:この操作はデフォルトのwp_notify_postauthor関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: 注:この操作はデフォルトの <tt>wp_notify_moderator</tt> 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; comment_notification_text
+
; [[プラグイン API/フィルターフック一覧/comment_notification_text|comment_notification_text]] /[[:en:Plugin_API/Filter_Reference/comment_notification_text|en]]
: フィルター関数引数: メール本文、コメントID
+
: フィルター関数引数: メール本文、コメント ID
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
 
: 投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
: 注:この操作はデフォルトのwp_notify_postauthor関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
: 注:この操作はデフォルトの <tt>wp_notify_moderator</tt> 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]] を参照)。
  
; cron_schedules
+
; [[プラグイン API/フィルターフック一覧/comment_row_actions|comment_row_actions]] /[[:en:Plugin_API/Filter_Reference/comment_row_actions|en]]
: wp_get_schedules関数でcronスケジュールを生成することができるよう、空の配列に適用される。
+
: コメント行の下の操作リンク(返信、クイック編集、編集)に適用される。
  
; default_content(記事本文)
+
; [[プラグイン API/フィルターフック一覧/cron_request|cron_request]] /[[:en:Plugin_API/Filter_Reference/cron_request|en]]
; default_excerpt(デフォルトの記事概要)
+
: [[関数リファレンス/spawn_cron|spawn_cron()]] で [[関数リファレンス/wp_remote_post|wp_remote_post()]] に渡す URL、キー、引数をフィルターできるようにする。
;  default_title(記事タイトル)
+
: 新規投稿の際、編集画面を開く前にそれぞれのデフォルト情報に対して適用される。
+
  
; format_to_edit
+
; [[プラグイン API/フィルターフック一覧/cron_schedules|cron_schedules]] /[[:en:Plugin_API/Filter_Reference/cron_schedules|en]]
: 管理画面でコメント編集ページを生成する際に呼び出されるformat_to_edit関数で、コメント本文、投稿者名、投稿者メールアドレス、投稿者URLに適用される。また、管理画面で記事を編集する際にも適用される。
+
: <tt>wp_get_schedules</tt> 関数で cron スケジュールを生成できるよう、空の配列に適用される。
  
; explain_nonce_動詞-名詞
+
; [[プラグイン API/フィルターフック一覧/custom_menu_order|custom_menu_order]] /[[:en:Plugin_API/Filter_Reference/custom_menu_order|en]]
: フィルター関数引数: 表示するテキスト(デフォルトは "Are you sure you want to do this?"メッセージ)およびアクションURLの最後にくる追加情報。
+
: 'menu_order' フィルターを有効化するために使われる。
: wordPressコアのコードにはないナンスを説明するメッセージを追加する。例えばプラグインでタグを更新するナンスを定義している場合、explain_nonce_update-tagというフィルターを定義すると、"Are you sure you want to update this tag?"というメッセージが表示されるようにする。
+
  
; format_to_edit
+
; [[プラグイン API/フィルターフック一覧/default_content|default_content]] /[[:en:Plugin_API/Filter_Reference/default_content|en]]
: format_to_edit関数内で記事本文、概要、タイトル、パスワードに適用される。また、管理画面でコメントを編集する際にも適用される。
+
: 新規投稿の際、編集画面を開く前にデフォルトの投稿本文に対して適用される。
  
; format_to_post
+
; [[プラグイン API/フィルターフック一覧/default_excerpt|default_excerpt]] /[[:en:Plugin_API/Filter_Reference/default_excerpt|en]]
: format_to_post関数(デフォルトでは使用されない)内の投稿記事本文に適用される。
+
: 新規投稿の際、編集画面を開く前にデフォルトの投稿抜粋に対して適用される。
  
; manage_link_columns
+
; [[プラグイン API/フィルターフック一覧/default_title|default_title]] /[[:en:Plugin_API/Filter_Reference/default_title|en]]
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている結合リスト
+
: 新規投稿の際、編集画面を開く前にデフォルトの投稿タイトルに対して適用される。
: リンク管理画面に出力するカラムのリストに適用される。
+
  
; manage_posts_columns
+
; [[プラグイン API/フィルターフック一覧/editable_slug|editable_slug]] /[[:en:Plugin_API/Filter_Reference/editable_slug|en]]
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている結合リスト
+
: <tt>get_sample_permalink</tt> 関数によって投稿、ページ、タグ、カテゴリースラッグに対して適用される。
: 記事管理画面に出力されるカラムのリストに適用される。
+
  
; postmeta_form_limit
+
; [[プラグイン API/フィルターフック一覧/explain_nonce_(verb)-(noun)|explain_nonce_(verb)-(noun)]] /[[:en:Plugin_API/Filter_Reference/explain_nonce_(verb)-(noun)|en]]
: 記事管理画面に表示する記事のメタ情報項目数に適用される。
+
: フィルター関数引数: 表示するテキスト(デフォルトは "Are you sure you want to do this?" メッセージ)およびアクション URL の最後にくる追加情報
 +
: フィルター関数が WordPress コアのコードにはないナンスを説明するメッセージを定義できるようにする。使うには、特定の動詞・名刺フィルターを定義する必要がある。例えばプラグインでタグを更新するナンスを定義している場合、explain_nonce_update-tag というフィルターを定義すると、"Are you sure you want to update this tag?" というメッセージが表示されるようにする。
  
; pre_upload_error
+
; [[プラグイン API/フィルターフック一覧/format_to_edit|format_to_edit]] /[[:en:Plugin_API/Filter_Reference/format_to_edit|en]]
: プラグインがファイルアップロード時にXMLRPCエラーを生成できるようするために適用される。
+
: 管理画面で編集するために投稿を設定する管理メニューによって呼び出される <tt>format_to_edit</tt> 関数で、投稿本文・抜粋・タイトル・パスワードに適用される。また、管理画面でコメントを編集する際にも適用される。
  
; preview_page_link(ページ)
+
; [[プラグイン API/フィルターフック一覧/format_to_edit|format_to_edit]] /[[:en:Plugin_API/Filter_Reference/format_to_edit|en]]
; preview_post_link(投稿記事)
+
: (デフォルトでは WordPress には使用されない)<tt>format_to_post</tt> 関数内の投稿本文に適用される。
: 各編集画面の「プレビュー」リンクに適用される。
+
  
; richedit_pre
+
; [[プラグイン API/フィルターフック一覧/manage_edit-post_type_columns|manage_edit-${post_type}_columns]] /[[:en:Plugin_API/Filter_Reference/manage_edit-post_type_columns|en]]
: wp_richedit_pre関数内でリッチテキストエディターに記事本文を表示する前に適用される。
+
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
 +
: カスタム投稿タイプに対して、投稿管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクション[[プラグイン API/フィルターフック一覧/manage_post_type_posts_custom_column|<tt>manage_${post_type}_posts_custom_column</tt>]] /[[:en:Plugin_API/Filter_Reference/manage_post_type_posts_custom_column|en]] も参照。
  
; show_password_fields
+
; [[プラグイン API/フィルターフック一覧/manage_link-manager_columns|manage_link-manager_columns]] /[[:en:Plugin_API/Filter_Reference/manage_link-manager_columns|en]]
: ユーザーがパスワードを変更できるかどうかの引数に適用される。自分で変更が可能な場合はtrue、変更できない場合はfalse。
+
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想リスト
 +
: WordPress 2.7 までは<tt>manage_link_columns</tt>。ブログロール管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクション[[プラグイン API/フィルターフック一覧/manage_posts_custom_column|<tt>manage_posts_custom_column</tt>]] /[[:en:Plugin_API/Filter_Reference/manage_posts_custom_column|en]] も参照。
  
; the_editor
+
; [[プラグイン API/フィルターフック一覧/manage_posts_columns|manage_posts_columns]] /[[:en:Plugin_API/Filter_Reference/manage_posts_columns|en]]
: リッチテキストエディターを囲むHTMLのdiv要素を生成し、画面に出力する前に適用される。
+
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
 +
: 投稿管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクション[[プラグイン API/フィルターフック一覧/manage_posts_custom_column|<tt>manage_posts_custom_column</tt>]] /[[:en:Plugin_API/Filter_Reference/manage_posts_custom_column|en]]も参照 (サンプルや使い方については [http://scompt.com/archives/2007/10/20/adding-custom-columns-to-the-wordpress-manage-posts-screen Scompt's tutorial] 参照(現在、リンク切れ))。
  
; user_can_richedit
+
; [[プラグイン API/フィルターフック一覧/manage_pages_columns|manage_pages_columns]] /[[:en:Plugin_API/Filter_Reference/manage_pages_columns|en]]
: フィルター関数引数および戻り値: 現在のユーザーがリッチテキストエディターを使用できるかどうかの判断(true/false)
+
: フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
: ユーザーのブラウザーがリッチテキストエディターに対応しているかどうかの評価、またはuser_can_richedit関数で設定された、リッチテキストエディターを使うかどうかの設定に適用される。
+
: 固定ページ管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクション[[プラグイン API/フィルターフック一覧/manage_pages_custom_column|<tt>manage_pages_custom_column</tt>]] /[[:en:Plugin_API/Filter_Reference/manage_pages_custom_column|en]]も参照
  
; user_has_cap
+
; [[プラグイン API/フィルターフック一覧/manage_users_columns|manage_users_columns]] /[[:en:Plugin_API/Filter_Reference/manage_users_columns|en]]
: フィルター関数引数: フィルターする権限のリスト、チェックする権限、引数リスト(例えば記事編集の権限の場合、記事IDなど)
+
: current_user_can関数で呼び出されるWP_User->has_cap関数内で、ユーザーの権限リストに適用される。
+
  
; wp_handle_upload
+
; [[プラグイン API/フィルターフック一覧/manage_users_custom_column|manage_users_custom_column]] /[[:en:Plugin_API/Filter_Reference/manage_users_custom_column|en]]
: フィルター関数引数: file(ファイル名)/url/type情報の配列
+
 
 +
; [[プラグイン API/フィルターフック一覧/manage_users_sortable_columns|manage_users_sortable_columns]] /[[:en:Plugin_API/Filter_Reference/manage_users_sortable_columns|en]]
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/media_row_actions|media_row_actions]] /[[:en:Plugin_API/Filter_Reference/media_row_actions|en]]
 +
: メディアライブラリーの各ファイルの下に表示されるアクションリンクのリスト(表示や編集など)に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/menu_order|menu_order]] /[[:en:Plugin_API/Filter_Reference/menu_order|en]]
 +
: 管理画面のメニューの順番の配列に適用される。事前に <tt> custom_menu_order</tt> フィルターで有効化される必要がある。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/nonce_life|nonce_life]] /[[:en:Plugin_API/Filter_Reference/nonce_life|en]]
 +
: [[用語集#Nonce|nonce]] の生成や検証などのライフスパンに適用される。通常より早く期限切れする nonce を生成できる。フィルターからの戻り値は秒単位。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/nonce_user_logged_out|nonce_user_logged_out]] /[[:en:Plugin_API/Filter_Reference/nonce_user_logged_out|en]]
 +
: ユーザーがログアウトした際の [[用語集#Nonce|nonce]] の生成や検証に利用される現行ユーザーID に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/plugin_row_meta | plugin_row_meta]] /[[:en:Plugin_API/Filter_Reference/plugin_row_meta|en]]
 +
: プラグインページの各プラグインの下にリンクを追加する。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/postmeta_form_limit|postmeta_form_limit]] /[[:en:Plugin_API/Filter_Reference/postmeta_form_limit|en]]
 +
: 投稿管理画面に表示する投稿のメタ情報項目数に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/post_row_actions|post_row_actions]] /[[:en:Plugin_API/Filter_Reference/post_row_actions|en]]
 +
: 管理画面の「投稿」 > 「投稿一覧」で表示される各投稿の下のアクションのリンク(クイック編集、編集、表示、プレビューなど)のリストに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/post_updated_messages|post_updated_messages]] /[[:en:Plugin_API/Filter_Reference/post_updated_messages|en]]
 +
: 投稿、固定ページ、カスタム投稿タイプの操作中にユーザーに表示される管理メッセージをもつ配列に適用される。このフィルターは出力メッセージを変更するだけで、メッセージの出力そのものは行わない。[[:en:Function_Reference/register_post_type#Example|register_post_type]] 文書内の "customizing the messages" 参照。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/pre_upload_error|pre_upload_error]] /[[:en:Plugin_API/Filter_Reference/pre_upload_error|en]]
 +
: プラグインがファイルアップロード時に XMLRPC エラーを生成できるようするために適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/preview_page_link|preview_page_link]] /[[:en:Plugin_API/Filter_Reference/preview_page_link|en]]
 +
: ページ編集画面の「プレビュー」リンクに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/preview_post_link|preview_post_link]] /[[:en:Plugin_API/Filter_Reference/preview_post_link|en]]
 +
: 投稿編集画面の「プレビュー」リンクに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/richedit_pre|richedit_pre]] /[[:en:Plugin_API/Filter_Reference/richedit_pre|en]]
 +
: <tt>wp_richedit_pre</tt> 関数内でリッチテキストエディターに投稿本文を表示する前に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/schedule_event|schedule_event]] /[[:en:Plugin_API/Filter_Reference/schedule_event|en]]
 +
: cron スケジュールに追加される、単一の繰り返される各イベントに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/show_password_fields|show_password_fields]] /[[:en:Plugin_API/Filter_Reference/show_password_fields|en]]
 +
: ユーザーがプロフィール画面からパスワードを変更できるかどうかの変数に適用される。自分で変更が可能な場合は true、変更できない場合は false。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/terms_to_edit|terms_to_edit]] /[[:en:Plugin_API/Filter_Reference/terms_to_edit|en]]
 +
: 各タクソノミーにおけるキーワードの CSV に適用される。CSV  は、投稿にどのキーワードが付けられているかの表示に使用される、
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/the_editor|the_editor]] /[[:en:Plugin_API/Filter_Reference/the_editor|en]]
 +
: フィルター関数引数および戻り値: 文字列
 +
: リッチテキストエディターを囲む HTML の div 要素を生成し、画面に出力する前に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/user_can_richedit|user_can_richedit]] /[[:en:Plugin_API/Filter_Reference/user_can_richedit|en]]
 +
ユーザーのブラウザーがリッチテキストエディターに対応しているかどうかの評価、または <tt>user_can_richedit</tt> 関数で設定されたリッチテキストエディターを使うかどうかの設定に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/user_has_cap|user_has_cap]] /[[:en:Plugin_API/Filter_Reference/user_has_cap|en]]
 +
: フィルター関数引数: フィルターする権限のリスト、チェックする権限、引数リスト(例えば投稿編集の権限の場合、投稿 ID など)
 +
: <tt>current_user_can</tt> 関数で呼び出される <tt>WP_User->has_cap</tt> 関数内で、ユーザーの権限リストに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_handle_upload_prefilter|wp_handle_upload_prefilter]] /[[:en:Plugin_API/Filter_Reference/wp_handle_upload_prefilter|en]]
 +
: フィルター関数引数: $_FILES の単一要素を表す配列
 +
: ファイルをアップロードする際のアップロード情報に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_handle_upload|wp_handle_upload]] /[[:en:Plugin_API/Filter_Reference/wp_handle_upload|en]]
 +
: フィルター関数引数: file(ファイル名)/url/type 情報の配列
 
: ファイルをアップロードする際、アップロード情報に適用される。
 
: ファイルをアップロードする際、アップロード情報に適用される。
  
; wp_upload_tabs
+
;[[プラグイン_API/フィルターフック一覧/wp_revisions_to_keep|wp_revisions_to_keep]] /[[:en:Plugin_API/Filter_Reference/wp_revisions_to_keep|en]]
: アップロードファイル管理画面でカスタムタブのリストを出力する際に実行する。カスタムタブ用のページを表示するには、action upload_files_タブ名フィルターを使用する。
+
: フィルター関数引数: 保持するリビジョンの数(デフォルトは無限)、投稿オブジェクト
 +
: ある投稿に対して保持するリビジョン数を変更する。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_terms_checklist_args|wp_terms_checklist_args]] /[[:en:Plugin_API/Filter_Reference/wp_terms_checklist_args|en]]
 +
: フィルター関数引数: チェックボックスのリストの引数の配列、投稿ID
 +
: wp_terms_checklist() 関数の引数に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_upload_tabs|wp_upload_tabs]] /[[:en:Plugin_API/Filter_Reference/wp_upload_tabs|en]]
 +
: アップロードファイル管理画面でカスタムタブのリストを出力する際に実行する。カスタムタブ用のページを表示するには、<tt>upload_files_タブ名</tt> アクションフィルターを使用する([[プラグイン_API/アクションフック一覧]]を参照)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/media_upload_tabs|media_upload_tabs]] /[[:en:Plugin_API/Filter_Reference/media_upload_tabs|en]]
 +
: アップロードファイル管理画面でカスタムタブのリストを出力する際に実行する。カスタムタブ用のページを表示するには、<tt>upload_files_タブ名</tt> アクションフィルターを使用する([[プラグイン_API/アクションフック一覧]]を参照)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/plugin_action_links_(plugin file name)|plugin_action_links_(plugin file name)]] /[[:en:Plugin_API/Filter_Reference/plugin_action_links_(plugin file name)|en]]
 +
: プラグイン画面に表示されるリンクのリストに適用される (有効化、無効化リンクのとなり)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/views_edit-post |views_edit-post]] / [[:en:Plugin_API/Filter_Reference/views_edit-post|en]]
 +
: 投稿一覧に適用される。例: すべて (30) | 公開済み (22) | 下書き (5) | 保留中 (2) | ゴミ箱 (1)
  
 
== リッチエディター関連のフィルター ==
 
== リッチエディター関連のフィルター ==
  
; mce_browsers
+
これらのフィルターはリッチテキストエディタ(TinyMCE)の設定を変更する。
: リッチテキストエディターに対応しているブラウザ名の配列に適用される。
+
 
 +
;[[プラグイン_API/フィルターフック一覧/mce_spellchecker_languages|mce_spellchecker_languages]] /[[:en:Plugin_API/Filter_Reference/mce_spellchecker_languages|en]]
 +
: スペルチェッカーで利用できる言語の選択肢に適用される。
  
; mce_buttons、mce_buttons_2、mce_buttons_3
+
;[[プラグイン_API/フィルターフック一覧/mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4|mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4]] /[[:en:Plugin_API/Filter_Reference/mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4|en]]
 
: それぞれのフィルターにはボタン名の配列が含まれる。リッチテキストエディターツールバーのボタン行に適用される。
 
: それぞれのフィルターにはボタン名の配列が含まれる。リッチテキストエディターツールバーのボタン行に適用される。
  
; mce_css
+
;[[プラグイン_API/フィルターフック一覧/mce_css|mce_css]] /[[:en:Plugin_API/Filter_Reference/mce_css|en]]
: リッチテキストエディター用のCSSファイルURLに適用される。
+
: リッチテキストエディター用の CSS ファイル URL に適用される。
  
; mce_plugins
+
;[[プラグイン_API/フィルターフック一覧/mce_external_plugins|mce_external_plugins]] /[[:en:Plugin_API/Filter_Reference/mce_external_plugins|en]]
: リッチテキストエディターが読み込むプラグインの配列に適用される。
+
: リッチテキストエディターが読み込む外部プラグインの配列に適用される。
  
; mce_valid_elements
+
;[[プラグイン_API/フィルターフック一覧/mce_external_languages|mce_external_languages]] /[[:en:Plugin_API/Filter_Reference/mce_external_languages|en]]
: リッチテキストエディターで有効なHTML要素のコンマ区切りリストに適用される。このリストに含まれない要素は、記事が投稿される前に自動的に除去される。
+
: 外部プラグインによって読み込まれた言語ファイルの配列に適用され、標準の翻訳メソッドが利用できるようにする(詳しくは wp-includes/js/tinymce/langs/wp-langs.php ファイルを参照)。
  
; tiny_mce_config_url
+
;[[プラグイン_API/フィルターフック一覧/tiny_mce_before_init|tiny_mce_before_init]] /[[:en:Plugin_API/Filter_Reference/tiny_mce_before_init|en]]
: TinyMCEの設定ファイルURLに適用される。
+
: リッチテキストエディターの init 配列全体に適用される。
  
 
== テンプレート関連のフィルター ==
 
== テンプレート関連のフィルター ==
  
=== デフォルトテーマ ===
+
このセクションではテーマ・テンプレート・スタイルファイル関連のリンクを紹介しています。
  
; kubrick_header_color(ヘッダー色)
+
;[[プラグイン_API/フィルターフック一覧/locale_stylesheet_uri|locale_stylesheet_uri]] /[[:en:Plugin_API/Filter_Reference/locale_stylesheet_uri|en]]
; kubrick_header_display(ヘッダー表示設定)
+
: フィルター関数引数: URL、スタイルシートディレクトリ URL
; kubrick_header_image(ヘッダー画像情報)
+
: <tt>get_locale_stylesheet_uri</tt> 関数で返されるロケール特有のスタイルシート情報に適用される。
: デフォルトテーマに関するそれぞれの情報に適用される。
+
  
=== スタイルシート ===
+
;[[プラグイン_API/フィルターフック一覧/stylesheet|stylesheet]] /[[:en:Plugin_API/Filter_Reference/stylesheet|en]]
 +
: <tt>get_stylesheet</tt> 関数で返されるスタイルシート情報に適用される。
  
; locale_stylesheet_uri
+
;[[プラグイン_API/フィルターフック一覧/stylesheet_directory|stylesheet_directory]] /[[:en:Plugin_API/Filter_Reference/stylesheet_directory|en]]
: フィルター関数引数: URL、スタイルシートディレクトリURL
+
: get_locale_stylesheet_uri関数で返されるロケール特有のスタイルシート情報に適用される。
+
 
+
; stylesheet
+
: get_stylesheet関数で返されるスタイルシート情報に適用される。
+
 
+
; stylesheet_directory
+
 
: フィルター関数引数: スタイルシートディレクトリ情報、スタイルシート情報
 
: フィルター関数引数: スタイルシートディレクトリ情報、スタイルシート情報
: get_stylesheet_directory関数で返されるスタイルシートディレクトリ情報に適用される。
+
: <tt>get_stylesheet_directory</tt> 関数で返されるスタイルシートディレクトリ情報に適用される。
  
; stylesheet_directory_uri
+
;[[プラグイン_API/フィルターフック一覧/stylesheet_directory_uri|stylesheet_directory_uri]] /[[:en:Plugin_API/Filter_Reference/stylesheet_directory_uri|en]]
: フィルター関数引数: スタイルシートディレクトリURL、スタイルシート情報
+
: フィルター関数引数: スタイルシートディレクトリ URL、スタイルシート情報
: get_stylesheet_directory_uri関数で返されるスタイルシートディレクトリURLに適用される。
+
: <tt>get_stylesheet_directory_uri</tt> 関数で返されるスタイルシートディレクトリ URL に適用される。
  
; stylesheet_uri
+
;[[プラグイン_API/フィルターフック一覧/stylesheet_uri|stylesheet_uri]] /[[:en:Plugin_API/Filter_Reference/stylesheet_uri|en]]
: フィルター関数引数: スタイルシートディレクトリURL、スタイルシート情報
+
: フィルター関数引数: スタイルシート URL、スタイルシート情報
: get_stylesheet_uri関数で返されるスタイルシートURLに適用される。
+
: <tt>get_stylesheet_uri</tt> 関数で返されるスタイルシート URL に適用される。
  
=== テンプレート ===
+
;[[プラグイン_API/フィルターフック一覧/template|template]] /[[:en:Plugin_API/Filter_Reference/template|en]]
 +
: <tt>get_template</tt> 関数で返されるテンプレート情報に適用される。
  
; template
+
;[[プラグイン_API/フィルターフック一覧/template_directory|template_directory]] /[[:en:Plugin_API/Filter_Reference/template_directory|en]]
: get_template関数で返されるテンプレート情報に適用される。
+
 
+
; template_directory
+
 
: フィルター関数引数: テンプレートディレクトリ情報、テンプレート情報
 
: フィルター関数引数: テンプレートディレクトリ情報、テンプレート情報
: get_template_directory関数で返されるテンプレートディレクトリ情報に適用される。
+
: <tt>get_template_directory</tt> 関数で返されるテンプレートディレクトリ情報に適用される。
  
; template_directory_uri
+
;[[プラグイン_API/フィルターフック一覧/template_directory_uri|template_directory_uri]] /[[:en:Plugin_API/Filter_Reference/template_directory_uri|en]]
: フィルター関数引数: テンプレートディレクトリURL、テンプレート情報
+
: フィルター関数引数: テンプレートディレクトリ URL、テンプレート情報
: get_template_directory_uri関数で返されるテンプレートディレクトリURLに適用される。
+
: <tt>get_template_directory_uri</tt> 関数で返されるテンプレートディレクトリ URL に適用される。
  
; theme_root
+
;[[プラグイン_API/フィルターフック一覧/theme_root|theme_root]] /[[:en:Plugin_API/Filter_Reference/theme_root|en]]
: get_theme_root関数で返されるテーマのルートディレクトリ情報(通常はwp-content/themes)に適用される。
+
: <tt>get_theme_root</tt> 関数で返されるテーマのルートディレクトリ情報(通常は wp-content/themes)に適用される。
  
; theme_root_uri
+
;[[プラグイン_API/フィルターフック一覧/theme_root_uri|theme_root_uri]] /[[:en:Plugin_API/Filter_Reference/theme_root_uri|en]]
 
: フィルター関数引数: URL、サイトURL
 
: フィルター関数引数: URL、サイトURL
: get_theme_root_uri関数で返されるテーマのルートディレクトリURL(通常はwp-content/themes)に適用される。
+
: <tt>get_theme_root_uri</tt> 関数で返されるテーマのルートディレクトリ URLに適用される。
: また、以下のフィルターフックを使用すれば、テーマ内の各テンプレートファイルの位置指定を変更することもできる(template_redirectアクションフックも参照)。
+
: また、以下のフィルターフックを使用すれば、テーマ内の各テンプレートファイルの位置指定を変更することもできる(<tt>template_redirect</tt> アクションフックも参照)。
: 404_template、archive_template、attachment_template、author_template、category_template、comments_popup_template、comments_template、date_template、home_template、page_template、paged_template、search_template、single_template
+
  
== その他の高度なフィルター ==
+
;[[プラグイン_API/フィルターフック一覧/404_template|404_template]] /[[:en:Plugin_API/Filter_Reference/404_template|en]]
このセクションでは、表示する記事を判断するクエリ、URLリライトルール、国際化など、WordPressの基本的なコードに関連する高度なフィルターを紹介しています。
+
:
  
=== URLリライトルール ===
+
;[[プラグイン_API/フィルターフック一覧/archive_template|archive_template]] /[[:en:Plugin_API/Filter_Reference/archive_template|en]]
 +
: このフィルターを使って例えば、カスタム投稿タイプのアーカイブに特定のテンプレートを強制できる。つまりすべてのコードをプラグイン内に保持できる。
  
; author_rewrite_rules(投稿者)
+
;[[プラグイン_API/フィルターフック一覧/attachment_template|attachment_template]] /[[:en:Plugin_API/Filter_Reference/attachment_template|en]]
; category_rewrite_rules(カテゴリー)
+
:
; comments_rewrite_rules(コメント)
+
; date_rewrite_rules(日付)
+
; post_rewrite_rules(投稿)
+
; page_rewrite_rules(ページ)
+
; search_rewrite_rules(検索)
+
; root_rewrite_rules(ルートレベル)
+
: それぞれのデータに関連するURLリライトルールが生成された後に適用される。
+
  
; mod_rewrite_rules
+
;[[プラグイン_API/フィルターフック一覧/author_template|author_template]] /[[:en:Plugin_API/Filter_Reference/author_template|en]]
: パーマリンク構造を変更した際、.htaccessファイルに挿入するURLリライトルールのリストに適用される。現バージョンでは廃止済みのrewrite_rulesを置き換えるフィルターでもある。
+
:
  
; rewrite_rules_array
+
;[[プラグイン_API/フィルターフック一覧/category_template|category_template]] /[[:en:Plugin_API/Filter_Reference/category_template|en]]
: URLリライトルールのが生成された後、その配列全体に適用される。
+
:
  
=== クエリ ===
+
;[[プラグイン_API/フィルターフック一覧/comments_popup_template|comments_popup_template]] /[[:en:Plugin_API/Filter_Reference/comments_popup_template|en]]
 +
:
  
; create_user_query
+
;[[プラグイン_API/フィルターフック一覧/comments_template|comments_template]] /[[:en:Plugin_API/Filter_Reference/comments_template|en]]
 +
: "comments_template"フィルターを使用すると、プラグインからカスタムテンプレートをロードし、デフォルトのコメントテンプレートを置換できる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/date_template|date_template]] /[[:en:Plugin_API/Filter_Reference/date_template|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/home_template|home_template]] /[[:en:Plugin_API/Filter_Reference/home_template|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/page_template|page_template]] /[[:en:Plugin_API/Filter_Reference/page_template|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/paged_template|paged_template]] /[[:en:Plugin_API/Filter_Reference/paged_template|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/search_template|search_template]] /[[:en:Plugin_API/Filter_Reference/search_template|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/single_template|single_template]] /[[:en:Plugin_API/Filter_Reference/single_template|en]]
 +
: このフィルターを使って例えば、カスタム投稿タイプに特定のテンプレートを強制できる。つまりすべてのコードをプラグイン内に保持できる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/shortcut_link|shortcut_link]] / [[:en:Plugin_API/Filter_Reference/shortcut_link|en]]
 +
: 「Press This」ブックマークレットに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/template_include|template_include]] /[[:en:Plugin_API/Filter_Reference/template_include|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_nav_menu_args|wp_nav_menu_args]] /[[:en:Plugin_API/Filter_Reference/wp_nav_menu_args|en]]
 +
: <tt>wp_nav_menu</tt> 関数の引数に適用される。
 +
 
 +
=== Kubrick フィルター ===
 +
 
 +
バージョン 3.0 以前のデフォルトテーマ kubric に存在したフィルター。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/kubrick_header_color|kubrick_header_color]]
 +
: kubrick テーマのヘッダーカラーに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/kubrick_header_display|kubrick_header_display]]
 +
: kubrick テーマのヘッダー表示オプションに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/kubrick_header_image |kubrick_header_image ]]
 +
: kubrick テーマのヘッダー画像ファイルに適用される。
 +
 
 +
== 登録・ログイン関連のフィルター ==
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/authenticate|authenticate]] /[[:en:Plugin_API/Filter_Reference/authenticate|en]]
 +
: ユーザー名とパスワードを使用したログインに対して、BASIC認証を実行できる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/registration_errors|registration_errors]] /[[:en:Plugin_API/Filter_Reference/registration_errors|en]]
 +
: 新規アカウントとしてユーザーを登録する際に生成された登録エラーに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/user_registration_email|user_registration_email]] /[[:en:Plugin_API/Filter_Reference/user_registration_email|en]]
 +
: 新規ユーザーとして登録する前に、登録ページから取得されたユーザーの電子メールアドレスに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/validate_username|validate_username]] /[[:en:Plugin_API/Filter_Reference/validate_username|en]]
 +
: フィルター関数引数: 検証結果が正しいかどうか (true または false)、検証されるユーザー名
 +
: 新規ユーザー名の検証結果に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_authenticate_user|wp_authenticate_user]] /[[:en:Plugin_API/Filter_Reference/wp_authenticate_user|en]]
 +
: ユーザーがログインし WordPress がユーザー名とパスワードを検証した後、かつ、検証エラーをチェックする前に適用される。
 +
 
 +
== リダイレクト・リライト関連のフィルター ==
 +
 
 +
これらの高度なフィルターは、WordPress のリライトルール処理に関連したものです。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/allowed_redirect_hosts|allowed_redirect_hosts]] /[[:en:Plugin_API/Filter_Reference/allowed_redirect_hosts|en]]
 +
: リダイレクトしても安全と思われるホスト名のリストに適用される。危険な 'redirect_to' リクエストパラメータを防ぐため wp-login.php が使用する。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/author_rewrite_rules|author_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/author_rewrite_rules|en]]
 +
: 投稿者に関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/category_rewrite_rules|category_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/category_rewrite_rules|en]]
 +
: カテゴリーに関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/comments_rewrite_rules|comments_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/comments_rewrite_rules|en]]
 +
: コメントに関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/date_rewrite_rules|date_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/date_rewrite_rules|en]]
 +
: 日付に関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/mod_rewrite_rules|mod_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/mod_rewrite_rules|en]]
 +
: パーマリンク構造を変更した際、.htaccess ファイルに挿入する URL リライトルールのリストに適用される。現バージョンでは廃止済みの <tt>rewrite_rules</tt> を置き換えるフィルターでもある。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/page_rewrite_rules|page_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/page_rewrite_rules|en]]
 +
: ページに関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/post_rewrite_rules|post_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/post_rewrite_rules|en]]
 +
: 投稿に関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/redirect_canonical|redirect_canonical]] /[[:en:Plugin_API/Filter_Reference/redirect_canonical|en]]
 +
: フィルター関数引数: <tt>$redirect_url</tt>、<tt>$requested_url</tt>
 +
: “canonical” URL リダイレクトのキャンセルに使用する。キャンセルには <tt><b>FALSE</b></tt>を返し、リダイレクトを許可するには <tt>$redirect_url</tt> を返す。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/rewrite_rules_array|rewrite_rules_array]] /[[:en:Plugin_API/Filter_Reference/rewrite_rules_array|en]]
 +
: URL リライトルールが生成された後、その配列全体に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/root_rewrite_rules|root_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/root_rewrite_rules|en]]
 +
: ルートレベル URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/search_rewrite_rules|search_rewrite_rules]] /[[:en:Plugin_API/Filter_Reference/search_rewrite_rules|en]]
 +
: 検索に関連する URL リライトルールが生成された後に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_redirect|wp_redirect]] /[[:en:Plugin_API/Filter_Reference/wp_redirect|en]]
 +
: フィルター関数引数: URL、HTTP ステータスコード
 +
: <tt>wp_redirect</tt> 関数内のリダイレクト URL に適用される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
 +
 
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_redirect_status|wp_redirect_status]] /[[:en:Plugin_API/Filter_Reference/wp_redirect_status|en]]
 +
: フィルター関数引数: URL、HTTP ステータスコード
 +
: デフォルトの <tt>wp_redirect</tt> 関数で転送が行われる際の HTTP ステータスコードに適用される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
 +
 
 +
=== WP_Query フィルター ===
 +
 
 +
以下は投稿を取得するためのクエリを構築・実行する間に [[Class_Reference/WP_Query|WP_Query object]] によって実行されるフィルターです。ユーザー、メタ情報、その他のより一般的なクエリについては[[#高度な WordPress フィルター|高度な WordPress フィルター]]も参照。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/found_posts|found_posts]]
 +
: 投稿のリストをデータベースから取得した直後に、このリストに対して適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/found_posts_query|found_posts_query]] /[[:en:Plugin_API/Filter_Reference/found_posts_query|en]]
 +
: 表示する投稿のリストが取得された後、WordPress はクエリ結果内の行を選択する。このフィルターを使い、その際に <tt>SELECT FOUND_ROWS()</tt> 以外の操作を加えることができる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/post_limits|post_limits]] /[[:en:Plugin_API/Filter_Reference/post_limits|en]]
 +
: post 配列を返すクエリの <tt>LIMIT</tt> 節に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_clauses|posts_clauses]] /[[:en:Plugin_API/Filter_Reference/posts_clauses|en]]
 +
: post配列を返す、節ごとにキー付きの配列に分割された SQLクエリ全体に適用される。<tt>posts_request</tt> よりも容易に処理できる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_distinct|posts_distinct]] /[[:en:Plugin_API/Filter_Reference/posts_distinct|en]]
 +
: post 配列を返すクエリに、プラグインが <tt>DISTINCTROW</tt> 節を追加できるようにする。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_fields|posts_fields]] /[[:en:Plugin_API/Filter_Reference/posts_fields|en]]
 +
: post 配列を返すクエリのフィールドリストに適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_groupby|posts_groupby]] /[[:en:Plugin_API/Filter_Reference/posts_groupby|en]]
 +
: post 配列を返すクエリの <tt>GROUP BY</tt> 節に適用される(通常は空データ)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_join|posts_join]] /[[:en:Plugin_API/Filter_Reference/posts_join|en]]
 +
: post 配列を返すクエリの <tt>JOIN</tt> 節に適用される。通常、<tt>JOIN</tt> にテーブルを追加する際に <tt>posts_where</tt> フィルターと一緒に使う。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_join_paged|posts_join_paged]] /[[:en:Plugin_API/Filter_Reference/posts_join_paged|en]]
 +
: post 配列を返すクエリの <tt>JOIN</tt> 節に対し、ページングが計算された後適用される(ページング自体は <tt>JOIN</tt> に影響しないので、このフィルターは <tt>posts_join</tt> と実質的には同一)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_orderby|posts_orderby]] /[[:en:Plugin_API/Filter_Reference/posts_orderby|en]]
 +
: post 配列を返すクエリの <tt>ORDER BY</tt> 節に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_request|posts_request]] /[[:en:Plugin_API/Filter_Reference/posts_request|en]]
 +
: post 配列を返す SQL クエリを実行する直前に、クエリ全体に対して適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_results|posts_results]] / [[:en:Plugin_API/Filter_Reference/posts_results|en]]
 +
: クエリから返された結果の配列を操作できる。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_search|posts_search]] /[[:en:Plugin_API/Filter_Reference/posts_search|en]]
 +
:  WP_Query の <tt>WHERE</tt> 節で使用される検索 SQL に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_where|posts_where]] /[[:en:Plugin_API/Filter_Reference/posts_where|en]]
 +
: post 配列を返すクエリの <tt>WHERE</tt> 節に適用される。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/posts_where_paged|posts_where_paged]] /[[:en:Plugin_API/Filter_Reference/posts_where_paged|en]]
 +
: post 配列を返すクエリの <tt>WHERE</tt> 節に対し、ページングが計算された後適用される(ページング自体は <tt>WHERE</tt> に影響しないので、このフィルターは <tt>posts_where</tt> と実質的には同一)。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/the_posts|the_posts]] /[[:en:Plugin_API/Filter_Reference/the_posts|en]]
 +
: 投稿の固定ページで、閲覧権限および投稿ステータスのチェックが行われた後、投稿のリストのクエリに適用される。
 +
 
 +
== メディア関連のフィルター ==
 +
 
 +
このセクションではさまざまな種類のメディアと連携して使われるメディアフィルターを紹介しています。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/editor_max_image_size|editor_max_image_size]] /[[:en:Plugin_API/Filter_Reference/editor_max_image_size|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/image_downsize|image_downsize]] /[[:en:Plugin_API/Filter_Reference/image_downsize|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/get_image_tag_class|get_image_tag_class]] /[[:en:Plugin_API/Filter_Reference/get_image_tag_class|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/get_image_tag|get_image_tag]] /[[:en:Plugin_API/Filter_Reference/get_image_tag|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/image_resize_dimensions|image_resize_dimensions]] /[[:en:Plugin_API/Filter_Reference/image_resize_dimensions|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/intermediate_image_sizes|intermediate_image_sizes]] /[[:en:Plugin_API/Filter_Reference/intermediate_image_sizes|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/icon_dir|icon_dir]] /[[:en:Plugin_API/Filter_Reference/icon_dir|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_get_attachment_image_attributes|wp_get_attachment_image_attributes]] /[[:en:Plugin_API/Filter_Reference/wp_get_attachment_image_attributes|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/img_caption_shortcode|img_caption_shortcode]] /[[:en:Plugin_API/Filter_Reference/img_caption_shortcode|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/post_gallery|post_gallery]] /[[:en:Plugin_API/Filter_Reference/post_gallery|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/use_default_gallery_style|use_default_gallery_style]] /[[:en:Plugin_API/Filter_Reference/use_default_gallery_style|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/gallery_style|gallery_style]] /[[:en:Plugin_API/Filter_Reference/gallery_style|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/(adjacent)_image_link|(adjacent)_image_link]] /[[:en:Plugin_API/Filter_Reference/(adjacent)_image_link|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/embed_defaults|embed_defaults]] /[[:en:Plugin_API/Filter_Reference/embed_defaults|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/load_default_embeds|load_default_embeds]] /[[:en:Plugin_API/Filter_Reference/load_default_embeds|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/embed_googlevideo|embed_googlevideo]] /[[:en:Plugin_API/Filter_Reference/embed_googlevideo|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/upload_size_limit|upload_size_limit]] /[[:en:Plugin_API/Filter_Reference/upload_size_limit|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_image_editors|wp_image_editors]] /[[:en:Plugin_API/Filter_Reference/wp_image_editors|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/plupload_default_settings|plupload_default_settings]] /[[:en:Plugin_API/Filter_Reference/plupload_default_settings|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/plupload_default_params|plupload_default_params]] /[[:en:Plugin_API/Filter_Reference/plupload_default_params|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/image_size_names_choose|image_size_names_choose]] /[[:en:Plugin_API/Filter_Reference/image_size_names_choose|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/wp_prepare_attachment_for_js|wp_prepare_attachment_for_js]] /[[:en:Plugin_API/Filter_Reference/wp_prepare_attachment_for_js|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/media_upload_tabs|media_upload_tabs]] /[[:en:Plugin_API/Filter_Reference/media_upload_tabs|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/disable_captions|disable_captions]] /[[:en:Plugin_API/Filter_Reference/disable_captions|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/media_view_settings|media_view_settings]] /[[:en:Plugin_API/Filter_Reference/media_view_settings|en]]
 +
:
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/media_view_strings|media_view_strings]] /[[:en:Plugin_API/Filter_Reference/media_view_strings|en]]
 +
:
 +
 
 +
;[[Plugin_API/Filter_Reference/wp_handle_upload_prefilter|wp_handle_upload_prefilter]] /[[:en:Plugin_API/Filter_Reference/wp_handle_upload_prefilter|en]]
 +
 
 +
== 高度な WordPress フィルター ==
 +
 
 +
このセクションでは、国際化やさまざまなクエリ、その他 WordPress 基本関数に関連する高度なフィルターを紹介しています。
 +
 
 +
;[[プラグイン_API/フィルターフック一覧/create_user_query|create_user_query]] /[[:en:Plugin_API/Filter_Reference/create_user_query|en]]
 
: 新規登録ユーザーの情報をデータベースに保存するクエリが実行される直前に、このクエリに対して適用される。
 
: 新規登録ユーザーの情報をデータベースに保存するクエリが実行される直前に、このクエリに対して適用される。
  
; found_posts_query
+
;[[プラグイン_API/フィルターフック一覧/get_editable_authors|get_editable_authors]] /[[:en:Plugin_API/Filter_Reference/get_editable_authors|en]]
: 表示する記事のリストが取得された後、WordPressはクエリ結果内の行を選択する。このフィルターを使い、その際にSELECT FOUND_ROWS()以外の操作を加えることができる。
+
: <tt>get_editable_authors</tt> 関数で、ユーザーが編集可能な投稿者のリストに適用される。
  
; query
+
;[[プラグイン_API/フィルターフック一覧/get_next_post_join|get_next_post_join]] /[[:en:Plugin_API/Filter_Reference/get_next_post_join|en]]
: プラグインが読み込まれた後に実行されるすべてのクエリに適用される。
+
: フィルター関数引数: <tt>JOIN</tt> 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
 +
: <tt>get_next_post</tt> 関数内で、SQL 文の <tt>JOIN</tt> 節に適用される。
  
; query_vars
+
;[[プラグイン_API/フィルターフック一覧/get_next_post_sort|get_next_post_sort]] /[[:en:Plugin_API/Filter_Reference/get_next_post_sort|en]]
: SQLが生成される前に、WordPressのパブリッククエリ変数のリストに対して適用される。プラグインが他の方法で扱った余分な固定リンク情報を削除するのに使える。現バージョンではすでに廃止されている、query_stringを置き換えるフィルターでもある。
+
: フィルター関数引数: <tt>ORDER BY</tt> 節
 +
: <tt>get_next_post</tt> 関数内で、SQL 文の <tt>ORDER BY</tt> 節に適用される。
  
; request
+
;[[プラグイン_API/フィルターフック一覧/get_next_post_where|get_next_post_where]] /[[:en:Plugin_API/Filter_Reference/get_next_post_where|en]]
: 動作はquery_varsと同じ。追加クエリ変数・プライベートクエリ変数が追加された後に適用される。
+
: フィルター関数引数: <tt>WHERE</tt> 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
 +
: <tt>get_next_post</tt> 関数内で、SQL 文の <tt>WHERE</tt> 節に適用される。
  
; update_user_query
+
;[[プラグイン_API/フィルターフック一覧/get_previous_post_join|get_previous_post_join]] /[[:en:Plugin_API/Filter_Reference/get_previous_post_join|en]]
: ユーザー情報を更新するクエリを実行する前に、このクエリに対して適用される。
+
: フィルター関数引数: <tt>JOIN</tt> 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
 +
: <tt>get_previous_post</tt> 関数内で、SQL 文の <tt>JOIN</tt> 節に適用される。
  
=== 投稿 ===
+
;[[プラグイン_API/フィルターフック一覧/get_previous_post_sort|get_previous_post_sort]] /[[:en:Plugin_API/Filter_Reference/get_previous_post_sort|en]]
 +
: フィルター関数引数: SQL文の <tt>ORDER BY</tt> 節
 +
: <tt>get_previous_post</tt> 関数内で、SQL 文の <tt>ORDER BY</tt> 節に適用される。
  
; found_posts
+
;[[プラグイン_API/フィルターフック一覧/get_previous_post_where|get_previous_post_where]] /[[:en:Plugin_API/Filter_Reference/get_previous_post_where|en]]
: 投稿記事のリストをデータベースから取得した直後に、このリストに対して適用される。
+
: フィルター関数引数: SQL文の <tt>WHERE</tt> 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリのリスト
 +
: <tt>get_previous_post</tt> 関数内で、SQL 文の <tt>WHERE</tt> 節に適用される。
  
; get_next_post_join
+
;[[プラグイン_API/フィルターフック一覧/gettext|gettext]] /[[:en:Plugin_API/Filter_Reference/gettext|en]]
: フィルター関数引数: JOIN 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
+
: フィルター関数引数: 翻訳済みおよび未翻訳のテキスト、テキストドメイン
: get_next_post関数内で、SQL文の JOIN 節に適用される。
+
: [[Function_Reference/translation|<tt>translation()</tt>]] 関数で翻訳されたテキスト([[関数リファレンス/_2|<tt>__()</tt>]] および [[関数リファレンス/_e|<tt>_e()</tt>]] などの国際化関数で呼び出される)に適用される。国際化の設定が有効になっていなかったり、テキストドメインが読み込まれていない場合にも適用。
  
; get_next_post_sort
+
;[[プラグイン_API/フィルターフック一覧/override_load_textdomain|override_load_textdomain]] /[[:en:Plugin_API/Filter_Reference/override_load_textdomain|en]]
: フィルター関数引数: ORDER BY 節
+
:
: get_next_post関数内で、SQL文の ORDER BY 節に適用される。
+
  
; get_next_post_where
+
;[[プラグイン_API/フィルターフック一覧/get_meta_sql|get_meta_sql]] /[[:en:Plugin_API/Filter_Reference/get_meta_sql|en]]
: フィルター関数引数: WHERE 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
+
: フィルター関数引数: array( compact( 'join', 'where' ), $this->queries, $type, $primary_table, $primary_id_column, $context )
: get_next_post関数内で、SQL文の WHERE 節に適用される。
+
: 関数 <tt>WP_Meta_Query::get_sql</tt> (高度なメタクエリ用にメインのクエリに追加される SQL 節を生成する) 内で、高度なメタクエリにより生成された SQL JOIN 節および WHERE 節に適用される。
  
; get_others_drafts
+
;[[プラグイン_API/フィルターフック一覧/get_others_drafts|get_others_drafts]] /[[:en:Plugin_API/Filter_Reference/get_others_drafts|en]]
 
: 管理画面で他のユーザーの下書き投稿を選択するクエリに適用される。
 
: 管理画面で他のユーザーの下書き投稿を選択するクエリに適用される。
  
; get_previous_post_join
+
;[[プラグイン_API/フィルターフック一覧/get_users_drafts|get_users_drafts]] /[[:en:Plugin_API/Filter_Reference/get_users_drafts|en]]
: フィルター関数引数: JOIN 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
+
: 管理画面で表示する自分の下書き投稿を選択するクエリに適用される。
: get_previous_post関数内で、SQL文の JOIN 節に適用される。
+
  
; get_previous_post_sort
+
;[[プラグイン_API/フィルターフック一覧/locale|locale]] /[[:en:Plugin_API/Filter_Reference/locale|en]]
: フィルター関数引数: SQL文の ORDER BY 節
+
: <tt>get_locale</tt> 関数で取得したロケール情報に適用される。
: get_previous_post関数内で、SQL文の ORDER BY 節に適用される。
+
  
; get_previous_post_where
+
;[[プラグイン_API/フィルターフック一覧/query|query]] /[[:en:Plugin_API/Filter_Reference/query|en]]
: フィルター関数引数: SQL文の WHERE 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリのリスト
+
: プラグインが読み込まれた後に実行されるすべてのクエリに適用される。
: get_previous_post関数内で、SQL文の WHERE 節に適用される。
+
  
; get_users_drafts
+
;<del>[[プラグイン_API/フィルターフック一覧/query_string|query_string]] /[[:en:Plugin_API/Filter_Reference/query_string|en]]</del>
: 管理画面で表示する公開前の記事を選択するクエリに適用される。
+
: 非推奨。代わりに <tt>query_vars</tt> または <tt>request</tt> を使うこと。
  
; post_limits
+
;[[プラグイン_API/フィルターフック一覧/query_vars|query_vars]] /[[:en:Plugin_API/Filter_Reference/query_vars|en]]
: post配列を返すクエリの LIMIT 節に適用される。
+
: SQL が生成される前に、WordPress のパブリッククエリ変数のリストに対して適用される。プラグインが他の方法で扱った余分な固定リンク情報を削除するのに使える。現バージョンではすでに廃止されている、<tt>query_string </tt>を置き換えるフィルターでもある。
  
; posts_distinct
+
;[[プラグイン_API/フィルターフック一覧/request|request]] /[[:en:Plugin_API/Filter_Reference/request|en]]
: post配列を返すクエリに、プラグインが DISTINCTROW 節を追加できるようにする。
+
: 動作は <tt>query_vars</tt> と同じ。追加クエリ変数・プライベートクエリ変数が追加された後に適用される。
  
; posts_fields
+
;[[プラグイン_API/フィルターフック一覧/excerpt_length|excerpt_length]] /[[:en:Plugin_API/Filter_Reference/excerpt_length|en]]
: post配列を返すクエリのフィールドリストに適用される。
+
: 個別投稿の抜粋の長さを定義する。
  
; posts_groupby
+
;[[プラグイン_API/フィルターフック一覧/excerpt_more|excerpt_more]] /[[:en:Plugin_API/Filter_Reference/excerpt_more|en]]
: post配列を返すクエリの GROUP BY 節に適用される(通常は空データ)。
+
: 抜粋の後に来る "more(続きを読む)" 文字列の長さを定義する。
  
; posts_join_paged
+
;[[プラグイン_API/フィルターフック一覧/post_edit_form_tag|post_edit_form_tag]] /[[:en:Plugin_API/Filter_Reference/post_edit_form_tag|en]]
: post配列を返すクエリの JOIN 節に対し、ページングが計算された後適用される(ページング自体は JOIN に影響しないので、このフィルターはposts_joinと実際的には同一)。
+
: デフォルト投稿・ページエディターのフォームタグの後にコードを付加できるようにする。
  
; posts_orderby
+
;[[プラグイン_API/フィルターフック一覧/update_user_query|update_user_query]] /[[:en:Plugin_API/Filter_Reference/update_user_query|en]]
: post配列を返すクエリの ORDER BY 節に適用される。
+
: ユーザー情報を更新するクエリを実行する前に、このクエリに対して適用される。
  
; posts_request
+
<del>;[[プラグイン_API/フィルターフック一覧/uploading_iframe_src|uploading_iframe_src]] /[[:en:Plugin_API/Filter_Reference/uploading_iframe_src|en]]</del>
: post配列を返すSQLクエリを実行する直前に、クエリ全体に対して適用される。
+
: (バージョン 2.5 で削除)投稿・ページ編集画面のファイルアップロード iframe の src 属性に適用される。
  
; posts_where_paged
+
;[[プラグイン_API/フィルターフック一覧/xmlrpc_methods|xmlrpc_methods]] /[[:en:Plugin_API/Filter_Reference/xmlrpc_methods|en]]
: post配列を返すクエリの WHERE 節に対し、ページングが計算された後適用される(ページング自体は WHERE に影響しないので、このフィルターはposts_whereと実際的には同一)。
+
: XMLRPC サーバー用に定義された XMLRPC メソッドに適用される。
  
; posts_join
+
;[[プラグイン_API/フィルターフック一覧/wp_mail_from|wp_mail_from]] /[[:en:Plugin_API/Filter_Reference/wp_mail_from|en]]
: post配列を返すクエリの JOIN 節に適用される。通常、JOINにテーブルを追加する際にposts_whereフィルターと一緒に使う。
+
: <tt>wp_mail</tt> 関数でメールが送信される前に、$_SERVER['SERVER_NAME'] で設定されたホスト名の値に適用される。フィルターを使ってメールアドレス(例:user@example.com)または氏名とメールアドレスの組み合わせ(例:Name <nowiki><user@example.com></nowiki>)を返すことができる。
  
; posts_where
+
;[[プラグイン_API/フィルターフック一覧/wp_mail_from_name|wp_mail_from_name]] /[[:en:Plugin_API/Filter_Reference/wp_mail_from_name|en]]
: post配列を返すクエリの WHERE 節に適用される。
+
: wp_mail 関数によりメールが送信される前に適用される。このフィルターはメールの From 欄の名前に使用される文字列を返す必要がある。
  
; the_posts
+
;[[プラグイン_API/フィルターフック一覧/update_(meta_type)_metadata|update_(meta_type)_metadata]] /[[:en:Plugin_API/Filter_Reference/update_(meta_type)_metadata|en]]
: 記事の固定ページで、閲覧権限および記事ステータスのチェックが行われた後、記事のリストのクエリに適用される。
+
: メタデータが更新される前に適用される。'user'メタデータが更新されるならフックは 'update_user_metadata'。
  
=== 国際化 ===
+
== ウィジェット ==
  
; gettext
+
このセクションでは WordPress コア内のウィジェットによって追加されたフィルターを紹介しています。
: フィルター関数引数: 翻訳済みおよび未翻訳のテキスト。国際化の設定が有効になっており、テキストドメインが読み込まれている場合のみに国際化関数(「__」および「_e」 )で取得した翻訳済みテキストに適用される。
+
  
; locale
+
;[[プラグイン_API/フィルターフック一覧/dynamic_sidebar_params|dynamic_sidebar_params]] /[[:en:Plugin_API/Filter_Reference/dynamic_sidebar_params|en]]
: get_locale関数で取得したロケール情報に適用される。
+
: WordPress ウィジェット内の  widgets_init 関数の引数に適用される。
  
=== その他 ===
+
;[[プラグイン_API/フィルターフック一覧/widget_archives_dropdown_args|widget_archives_dropdown_args]] /[[:en:Plugin_API/Filter_Reference/widget_archives_dropdown_args|en]]
 +
: WordPress アーカイブウィジェット内の [[テンプレートタグ/wp_get_archives|<tt>wp_get_archives()</tt>]] /[[:en:Function_Reference/wp_get_archives|en]] 関数の引数に適用される。
  
; get_editable_authors
+
;[[プラグイン_API/フィルターフック一覧/widget_categories_args|widget_categories_args]] /[[:en:Plugin_API/Filter_Reference/widget_categories_args|en]]
: get_editable_authors関数で、ユーザーが編集可能な投稿者のリストに適用される。
+
: WordPress カテゴリーウィジェット内の [[テンプレートタグ/wp_list_categories|<tt>wp_list_categories()</tt>]] 関数の引数に適用される。
  
; uploading_iframe_src
+
;[[プラグイン_API/フィルターフック一覧/widget_links_args|widget_links_args]] /[[:en:Plugin_API/Filter_Reference/widget_links_args|en]]
: 記事・ページ編集画面のファイルアップロードiframeのsrc属性に適用される。
+
: WordPress リンクウィジェット内の [[テンプレートタグ/wp_list_bookmarks|<tt>wp_list_bookmarks()</tt>]] 関数の引数に適用される。
  
; wp_redirect
+
;[[プラグイン_API/フィルターフック一覧/widget_pages_args|widget_pages_args]] /[[:en:Plugin_API/Filter_Reference/widget_pages_args|en]]
: フィルター関数引数: URL、HTTPステータスコード
+
: WordPress 固定ページウィジェット内の [[テンプレートタグ/wp_list_pages|<tt>wp_list_pages()</tt>]] 関数の引数に適用される。
: wp_redirect関数内のリダイレクトURLに適用される(この関数はプラグインによる上書きが可能。詳しくは[[プラグイン API]]を参照)。
+
  
; xmlrpc_methods
+
;[[プラグイン_API/フィルターフック一覧/widget_tag_cloud_args|widget_tag_cloud_args]] /[[:en:Plugin_API/Filter_Reference/widget_tag_cloud_args|en]]
: xMLRPCサーバー用に定義されたXMLRPCメソッドに適用される。
+
: WordPress 固定ページウィジェット内の [[テンプレートタグ/wp_tag_cloud|<tt>wp_tag_cloud()</tt>]] 関数の引数に適用される。
  
; wp_mail_from
+
;[[プラグイン_API/フィルターフック一覧/widget_text|widget_text]] /[[:en:Plugin_API/Filter_Reference/widget_text|en]]
: wp_mail関数でメールが送信される前に、$_SERVER['SERVER_NAME']で設定されたホスト名の値に適用される。フィルターを使ってメールアドレス(例:user@example.com)または氏名とメールアドレスの組み合わせ(例:Name <nowiki><user@example.com></nowiki>)を返すことができる。
+
: WordPress テキストウィジェットのウィジェットテキストに適用される。サードパーティ製ウィジェットに適用してもよい。
  
<!-- 未翻訳
+
;[[プラグイン_API/フィルターフック一覧/widget_title|widget_title]] /[[:en:Plugin_API/Filter_Reference/widget_title|en]]
== Further Reading ==
+
: ユーザーが編集可能な WordPress ウィジェットのウィジェットタイトルに適用される。サードパーティ製ウィジェットに適用してもよい。
  
* [[Writing a Plugin]] - description of how to write a plugin
+
== 管理バー ==
* [[Plugin API]] - article on how to use filters and actions
+
 
* [[Plugin API/Action Reference]] - reference list for Action hooks
+
このセクションでは WordPress 3.0 で追加された管理バー関連のフィルターを紹介しています。
* [[Plugin Resources]] - comprehensive list of plugin-related resources
+
 
* [http://codex.wordpress.org/User:Skippy Skippy's list] of actions and filters
+
;[[プラグイン_API/フィルターフック一覧/wp_admin_bar_class|wp_admin_bar_class]] / [[Plugin_API/Filter_Reference/wp_admin_bar_class|en]]
* [http://wphooks.flatearth.org WordPress Hooks], a work in progress directory of all of WordPress’ hooks.
+
: {{Trac|wp-includes/admin-bar.php}} 内の [[関数リファレンス/_wp_admin_bar_init|<tt>_wp_admin_bar_init()</tt>]] 関数のデフォルト 'WP_Admin_Bar' クラスを変更できる。
* [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. -->
+
== これも読んでみよう ==
 +
 
 +
* [[プラグインの作成]] - プラグイン作成方法の説明
 +
* [[プラグイン API]] - フィルターやアクションの使い方に関する投稿
 +
* [[プラグイン API/アクションフック一覧]] - アクションフックのリファレンス
 +
* [[プラグイン・リソース]] - プラグインに関するリソースの総合的な一覧
 +
* [http://wphooks.flatearth.org WordPress Hooks], WordPress の全フックに関する要覧
 +
* [http://adambrown.info/p/wp_hooks WordPress Hooks Database] WordPress フックすべてのデータベース。どのバージョンから存在するかや、フックが使われる部分のソースコードへのリンク。
 +
* [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/Filter Reference|149821}}<!-- 19:48, 25 February 2015‎ Ruud@joyo版 -->
  
 
[[Category:プラグイン]]
 
[[Category:プラグイン]]
[[Category:WordPress の開発]]
+
[[Category:フィルター]]
 +
 
 +
[[en:Plugin API/Filter Reference]]

2017年2月21日 (火) 16:11時点における最新版

このページには、WordPress 2.1 以降のプラグイン開発で使える広範囲のフィルターフック一覧が含まれています(ただし、100%包括的なものではありません)。さらに詳しい情報については下記をご覧ください。

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

投稿、ページ、添付ファイル(アップロード)関連のフィルタ

以下のカテゴリー・タクソノミー項目関連のフィルター投稿者・ユーザー関連のフィルターリンク関連のフィルター日付・時間関連のフィルター管理画面関連のフィルターもご覧ください。

データベース読み出し

このセクションのフィルターは、データベースから読み出される情報に対してページや編集画面に表示される前に適用されます。

attachment_fields_to_edit /en
フィルター関数引数: フォーム欄の配列、投稿オブジェクト
添付ファイルを編集する際に表示されるフォームに適用される。get_attachment_fields_to_edit 関数で呼び出される。
attachment_icon /en
フィルター関数引数: HTML img タグとしてのアイコンファイル、添付ファイル ID
get_attachment_icon 関数内で添付ファイルのアイコンに対して適用される。
attachment_innerHTML /en
フィルター関数引数: innerHTML(デフォルトはタイトル)、添付ファイル ID
get_attachment_innerHTML 関数内で、添付ファイルにアイコンがない場合タイトルに使われる文字列に適用される。
author_edit_pre /en
投稿者が編集画面に表示される前に適用される。
body_class /en
フィルター関数引数: クラス名の配列、最初の配列に追加されたクラス名の配列
HTML <body> 要素のクラスに適用される。get_body_class /en 関数で呼び出される。
content_edit_pre /en
投稿コンテンツが編集画面に表示される前に適用される。
content_filtered_edit_pre /en
フィルターされた投稿コンテンツが編集画面に表示される前に適用される。
excerpt_edit_pre /en
抜粋が編集画面に表示される前に適用される。
date_edit_pre /en
投稿の日付が編集画面に表示される前に適用される。
date_gmt_edit_pre /en
投稿の日付が編集画面に表示される前に適用される。
get_attached_file /en
フィルター関数引数: ファイル情報、添付ファイル ID
get_attached_file 関数で取得した添付ファイル情報に適用される。
get_enclosed /en
get_enclosed 関数で取得した投稿のエンクロージャーリストに適用される。
get_pages /en
フィルター関数引数: ページのリスト(各項目にはページのデータ配列が含まれる)、リクエストされたページを指定する get_pages 関数の引数リスト
get_pages 関数で取得したページのリストに適用される。
get_pung /en
get_pung 関数で取得したピンバック受信 URL のリストに適用される。
get_the_archive_title /en
get_the_archive_title関数でアーカイブのタイトルに適用される。
get_the_excerpt
get_the_excerpt 関数で取得した投稿の抜粋に適用される。
get_the_guid /en
get_the_guid 関数で取得した投稿の GUID に適用される。
get_to_ping /en
get_to_ping 関数で取得したピンバック先の URL リストに適用される。
icon_dir /en
複数の関数で、テンプレートの画像ディレクトリに適用される。MIME タイプアイコンの置き場所をプラグインを使って変更したいときに使える。
icon_dir_uri /en
複数の関数で、テンプレートの画像ディレクトリ URL に適用される。MIME タイプアイコンの置き場所をプラグインを使って変更したいときに使える。
image_size_names_choose /en
メディアライブラリで選択できる画像サイズのリストに適用される。カスタム画像サイズを選択できるようにしたい時によく使われる。
mime_type_edit_pre /en
編集画面に表示される前に投稿 MIME タイプに適用される。
modified_edit_pre /en
編集画面に表示される前に、投稿が変更された日付に適用される。
modified_gmt_edit_pre /en
編集画面に表示される前に、投稿が変更された日付の GMT 版に適用される。
no_texturize_shortcodes /en
登録されたショートコードに適用される。texturize 関数の自動適用範囲からショートコードを除外するために使える。
parent_edit_pre /en
編集画面に表示される前に、投稿の親 ID に適用される。
password_edit_pre /en
編集画面に表示される前に、投稿パスワードに適用される。
post_class /en
フィルター関数引数: クラス名の配列、最初の配列に追加された追加クラス名の配列、投稿 ID
投稿の一番外側にある HTML 要素に適用される。get_post_class /en 関数内で呼び出される。
prepend_attachment /en
prepend_attachment 関数で先頭に追加する HTML に適用される。
protected_title_format /en
投稿がパスワード保護されている場合の投稿タイトルを編集するために使う。
private_title_format /en
投稿が非公開状態になっている場合の投稿タイトルを編集するために使う。
sanitize_title /en
sanitize_title 関数で HTML タグを除去した投稿タイトル名に適用される。
single_post_title /en
wp_title 関数および single_post_title 関数でブログページタイトルを生成する際に投稿タイトルに適用される。
status_edit_pre /en
編集画面に表示される前に投稿ステータスに対し適用される。
the_content /en
データベースから取得した投稿コンテンツを画面に出力する前に適用される(トラックバックなどの他の操作にも使われる)。
the_content_rss /en
データベースから取得した投稿コンテンツを RSS フィードに含める前に適用される。このフィルターは 2.7 以降機能していない。
the_content_feed /en
データベースから取得した投稿コンテンツを RSS フィードに含める前に適用される。
the_editor_content /en
投稿本文をリッチテキストエディター内に表示する前に適用される。
the_excerpt /en
画面を表示する前にデータベースから取得した記事の抜粋(または投稿、抜粋がない場合)に適用する。(またトラックバックなどの他の操作で使用)
the_excerpt_rss /en
投稿の抜粋を RSS フィードに含める前に適用される。
the_password_form /en
保護された投稿のパスワードフォームに適用される。
the_tags /en
画面を表示する前に、データベースから取得したタグに適用される。
the_title /en
画面を表示する前にデータベースから取得した投稿タイトルに適用される。(トラックバックなどの他の操作でも使用)
the_title_rss / en
the_title でフィルターした後、投稿タイトルをRSS フィードに含める前に適用される。
title_edit_pre /en
投稿タイトルが編集画面に表示される前に適用される。
type_edit_pre /en
投稿タイプが編集画面に表示される前に適用される。
wp_dropdown_pages /en
wp_dropdown_pages 関数が生成したページのドロップダウンリスト HTML に適用される。
wp_list_pages /en
wp_list_pages 関数が生成したページのリスト HTML に適用される。
wp_list_pages_excludes /en
wp_list_pages 関数内で、除外ページ ID の配列に適用される。
wp_get_attachment_metadata /en
フィルター関数引数: メタ情報、添付ファイル ID
wp_get_attachment_metadata 関数で取得した、添付ファイルのメタ情報に適用される。
wp_get_attachment_thumb_file /en
フィルター関数引数: サムネイルファイル、添付ファイル ID
wp_get_attachment_thumb_file 関数で取得した、添付ファイルのサムネイルファイルに適用される。
wp_get_attachment_thumb_url /en
フィルター関数引数: サムネイル URL、添付ファイル ID
wp_get_attachment_thumb_URL関数によってサムネイルに適用するURLを取得する。
wp_get_attachment_url /en
フィルター関数引数: URL、添付ファイル ID
wp_get_attachment_url 関数で取得した、添付ファイル URL に適用される。
wp_mime_type_icon /en
フィルター関数引数: 算出した アイコン URL、MIME タイプ情報、投稿投稿 ID
wp_mime_type_icon 関数で算出した、添付ファイルの MIME タイプアイコンに適用される。
wp_title /en
wp_title 関数が生成したページ名がブラウザに送信される前に適用される。

データベース書き込み

このセクションのフィルターは、情報をデータベースに保存する前にその情報に対して適用されます。

add_ping /en
ピンバックが追加された際、ピンバック欄に新規追加する値をデータベースに保存する前に適用される。
attachment_fields_to_save /en
フィルタ関数の引数:投稿の配列属性、フォームから送信された変更を含む添付ファイルフィールドの配列。
データベースに保存する前に添付ファイルに関連付けられたフィールドに適用される。media_upload_form_handler関数と呼ぶ。
attachment_max_dims /en
画像を縮小する前に、画像の最大寸法の値に適用される。フィルター関数の入力値と戻り値は、false(最大寸法が指定されていない場合)または2つの数字のリスト(幅、高さ)。
category_save_pre /en
投稿カテゴリーのコンマ区切りリストをデータベースに保存する前に適用される(添付にも使われる)。
comment_status_pre /en
コメントステータスをデータベースに保存する前に適用される(添付にも使われる)。
content_filtered_save_pre /en
フィルターされた投稿コンテンツをデータベースに保存する前に適用される(添付にも使われる)。
content_save_pre /en
投稿コンテンツをデータベースに保存する前に適用される(添付にも使われる)。
excerpt_save_pre /en
投稿の抜粋をデータベースに保存する前に適用される(添付にも使われる)。
image_save_pre /en - 非推奨
代わりに image_editor_save_pre /en を使うこと。
jpeg_quality /en - 非推奨
代わりに wp_editor_set_quality /en または WP_Image_Editor::set_quality() を使うこと。
name_save_pre /en
投稿の名前をデータベースに保存する前に適用される(添付にも使われる)。
phone_content /en
投稿がメールで投稿された際、内容をデータベースに保存する前に実行する。
ping_status_pre /en
投稿のピンバックステータスをデータベースに保存する前に適用される(添付にも使われる)。
post_mime_type_pre /en
添付の MIMEタイプをデータベースに保存する前に適用される。
status_save_pre /en
投稿ステータスをデータベースに保存する前に適用される。
thumbnail_filename /en
画像をアップロードする際、サムネイルのファイル名に適用される。
title_save_pre /en
投稿のタイトルをデータベースに保存する前に適用される(添付にも使われる)。
update_attached_file /en
フィルター関数引数: 添付ファイル情報、添付ファイル ID
添付ファイル情報を update_attached_file 関数で投稿のメタデータとして保存する前に適用される。
wp_create_thumbnail /en - 非推奨
wp_delete_file /en
ファイルを削除する直前、添付ファイル名に適用される。
wp_generate_attachment_metadata /en
添付ファイルのメタ情報配列がデータベースに保存される前に適用される。
wp_save_image_file /en - 非推奨
代わりに wp_save_image_editor_file /en を使うこと。
wp_thumbnail_creation_size_limit /en
フィルター関数引数: ファイルの最大サイズ、添付ファイル ID、添付ファイル名
画像をアップロードする際、サムネイルのファイルサイズに適用される。
wp_thumbnail_max_side_length /en
フィルター関数引数: 画像の最大横幅、添付ファイル ID、添付ファイル名
画像をアップロードする際、サムネイルの寸法に適用される。
wp_update_attachment_metadata /en
フィルター関数引数: メタ情報、添付ファイル ID
wp_update_attachment_metadata 関数で、添付ファイルのメタ情報配列が保存される前に適用される。

コメント・トラックバック・ピンバック関連のフィルター

投稿者・ユーザー関連のフィルターリンク関連のフィルター日付・時間関連のフィルター管理画面関連のフィルターも参照。

データベース読み出し

このセクションのフィルターは、データベースから読み出される情報に対してページや編集画面に表示される前に適用されます。

comment_excerpt /en
comment_excerpt 関数を使ってデータベースから取得したコメント抜粋に適用される。
comment_flood_filter /en
フィルター関数引数: 他のフィルタープラグインがコメントをすでにブロック済みかどうかの判別情報(true/false、プラグインでコメントをブロックする際 true に設定し、値を戻す)、前回のコメント送信日時、今回のコメント送信日時
連続コメントエラーが検出された際に適用される。
comment_post_redirect /en
フィルター関数引数: リダイレクト先情報、コメント情報の配列
コメントを追加した後のリダイレクト先情報に適用される。
comment_text /en
comment_text 関数で取得したコメント本文を画面に出力する前に適用される。
comment_text_rss /en
コメント本文が RSS フィードに挿入される前に適用される。
comments_array /en
フィルター関数引数: コメント情報構造の配列、投稿投稿 ID
comments_template 関数内で、投稿投稿へのコメントの配列に適用される。
comments_number /en
comments_number 関数が生成したコメント数表示用のフォーマット済みテキストに適用される。
get_comment_excerpt /en
get_comment_excerpt 関数を使ってデータベースから取得したコメント抜粋に適用される。
get_comment_ID /en
get_comment_ID 関数を使ってグローバル変数 $comments から読み出したコメント ID に適用される。
get_comment_text /en
get_comment_text 関数内でコメント本文に適用される。
get_comment_type /en
get_comment_type 関数内で取得したコメントの種類(comment/trackback/pingback、= comment_type)に適用される。
get_comments_number /en
get_comments_number 関数を使ってグローバル変数 $comments から読み出したコメント数に適用される。comments_number も参照。
post_comments_feed_link /en
comments_rss 関数が生成したコメントフィード URL に適用される。

データベース書き込み

このセクションのフィルターは、情報がデータベースに保存される前に適用されます。

comment_save_pre /en
フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_ID のインデックスを含むコメントデータ配列
コメントを更新・編集する直前に、コメントデータに適用される。
pre_comment_approved /en
現在のコメント承認ステータス(true/false)をプラグインが上書きできるように適用される。true/false を返し、最初の変数を true/false に設定してコメントを承認または非承認にする。また、このコメントにアクセスできるように $comment_ID のようなグローバル変数を使う。
pre_comment_content /en
コメント本文がデータベースに保存される前に適用される。
preprocess_comment /en
フィルター関数引数: comment_post_ID、comment_author、comment_author_email、comment_author_url、comment_content、comment_type、user_ID のインデックスを含むコメントデータ配列
新しいコメントをデータベースに保存する際、他の処理がまだ施されていないコメントデータに適用される。
wp_insert_post_data /en
フィルター関数引数: 編集され、拡張された投稿の配列とサニタイズ済みの投稿配列
wp_insert_post() 内の修正済みまたは未修正の投稿データに対し、更新前または投稿のデータベースへの挿入前に適用される。

カテゴリー・タクソノミー項目関連のフィルター

管理画面関連のフィルターも参照。

データベース読み出し

このセクションのフィルターは、データベースから読み出された情報がページまたは編集画面に表示される前に適用されます。

category_description /en
category_description 関数でのフィルター関数引数: カテゴリーの説明、カテゴリー ID
wp_list_categories 関数でのフィルター関数引数: カテゴリーの説明、全カテゴリー情報の配列
category_description 関数および wp_list_categories 関数のカテゴリー情報に適用される。
category_feed_link /en
get_category_rss_link 関数が生成したカテゴリーフィード URL に適用される。
category_link /en
フィルター関数引数: リンク URL、カテゴリー ID
get_category_link 関数が生成したカテゴリーの URL に適用される。
get_ancestors /en
フィルター関数引数: 祖先オブジェクトIDの配列、指定されたオブジェクトID、指定されたオブジェクトタイプ
get_ancestorsから返された祖先オブジェクト ID リストに適用される(そして多くの他の関数によって順に使用される)。
get_categories /en
フィルター関数引数: カテゴリーリスト、get_categories オプションリスト
get_categories 関数が生成したカテゴリーのリストに適用される(そして多くの他の関数によって順に使用される)。
get_category /en
get_category が検索するカテゴリー情報に適用される。基本的にはWordPressのカテゴリーテーブル内で、特定のカテゴリーIDに関するすべてのフィールドの配列。
list_cats /en
フィルター関数引数: カテゴリー名、カテゴリー情報リスト(指定したカテゴリーテーブル内の全フィールド)
このフィルターは2種類の目的で使用される。
1. wp_dropdown_categories 関数では、show_option_all および show_option_none 引数をフィルターするために適用される。この場合、追加のフィルター関数引数はなし。
2. wp_list_categories 関数でカテゴリー名に対して適用する。
list_cats_exclusions /en
フィルター関数引数: SQL 文の WHERE 節で除外されたカテゴリー、get_categories オプションのリスト
get_categories 関数で、除外カテゴリーを決定する SQL 文の WHERE 節に適用される。
single_cat_title /en
wp_title 関数および single_cat_title 関数内でカテゴリーページのタイトルに利用するカテゴリー名に適用される。
the_category /en
フィルター関数引数: 生成 HTML、リスト区切り設定(空の場合はデフォルトの <li>)、get_the_category_list の親変数
get_the_category_list 関数が生成したカテゴリーリスト(リンクを含む HTML リスト)に適用される。
the_category_rss /en
フィルター関数引数: リストテキストおよびフィードの種類(通常 rdf または rss)
get_the_category_rss 関数内で、投稿のカテゴリーリスト(カテゴリー XML 要素のリスト)が RSS フィードに挿入される前に適用される。
wp_dropdown_cats /en
wp_dropdown_categories 関数が生成したカテゴリードロップダウンリスト HTML に適用される。
wp_list_categories /en
wp_list_categories 関数で生成されたカテゴリーリスト(HTML リスト)に適用される。
wp_get_object_terms /en
get_the_termsget_the_category などの複数のカテゴリーまたはタクソノミー関連の関数によって呼び出される、wp_get_object_terms 関数で生成された項目リスト(オブジェクトの配列)に適用される。

データベース書き込み

このセクションのフィルターは、情報がデータベースに保存される前に適用される。

pre_category_description /en
カテゴリーの説明がデータベースに保存される前に適用される。
edited_terms /en
カテゴリー・タクソノミーの変更がデータベースに保存される前に適用される。
pre_category_name /en
カテゴリー名がデータベースに保存される前に適用される。
pre_category_nicename(カテゴリースラッグ) /en
カテゴリーの nicename がデータベースに保存される前に適用される。

リンク関連のフィルター

注: このセクションでは投稿・ページ・アーカイブ・フィードなどのリンクに関するフィルターを紹介しています。リンク集(ブログロールリンク)についてはリンク集関連のフィルターセクションを参照。

attachment_link /en
フィルター関数引数: リンク URL、添付ファイル ID
get_attachment_link 関数が生成した添付ファイルの固定リンクに適用される。
author_feed_link /en
get_author_rss_link 関数が生成した投稿者フィードのURLに適用される。
author_link /en
フィルター関数引数: リンク URL、投稿者名スラッグ、投稿者 ID
get_author_posts_url 関数が生成した投稿者別アーカイブのリンク URL に適用される。
comment_reply_link /en
フィルター関数引数: リンク(文字列)、カスタムオプション(配列)、現在のコメント(オブジェクト)、現在の投稿(オブジェクト)
関数 comments_template 内で呼ばれるget_comment_reply_link によって、特定のコメントへの応答のため生成されたリンクに適用される。
day_link /en
フィルター関数引数: URL、年、月(数字)、日(数字)
get_day_link 関数が生成した日付別アーカイブのリンク URL に適用される。
feed_link /en
フィルター関数引数: URL、フィードの種類(例:rss2、atom など)
get_feed_link 関数が生成したフィードのリンク URL に適用される。
get_comment_author_link /en
フィルター関数引数: ユーザー名
get_comment_author_link 関数が生成したコメント投稿者のリンク HTML に適用される(これは comment_author_link で呼び出されるものと同じ)。
get_comment_author_url_link /en
get_comment_author_url_link 関数が生成したコメント投稿者のリンク HTML に適用される(これは comment_author_link で呼び出されるものと同じ)。
month_link /en
フィルター関数引数: URL、年、月(数字)
get_month_link 関数が生成した月別アーカイブのリンク URL に適用される。
page_link /en
フィルター関数引数: URL、ページ ID
get_page_link 関数が生成したページURLに適用される。
post_link /en
フィルター関数引数: 固定リンク URL、投稿投稿データのリスト
get_permalink 関数が生成した投稿投稿の固定リンクに適用される(これは the_permalink、post_permalink</tt>、previous_post_link</tt>、next_post_link 関数で呼び出されるものと同じ)。
post_type_link /en
get_post_permalink 関数によって算出されたカスタム投稿タイプパーマリンクに適用される。
the_permalink /en
the_permalink 関数が投稿投稿のパーマリンク URL を出力する前に適用される。
year_link /en
フィルター関数引数: URL、年
get_year_link 関数が生成した年別アーカイブのリンク URL に適用される。
tag_link /en
フィルター関数引数: リンク URL、タグ ID
get_tag_link 関数が生成したタグの URL に適用される。
term_link /en
フィルター関数引数: 項目リンク URL、項目オブジェクト、タクソノミースラッグ
get_term_link 関数が生成したタクソノミー項目の URL に適用される。

日付・時間関連のフィルター

リンク関連のフィルターも参照。

get_comment_date /en
get_comment_date 関数で呼び出されたフォーマット済みのコメント投稿日に適用される(comment_date でも呼び出される)。
get_comment_time /en
get_comment_time 関数が生成したフォーマット済みのコメント投稿時間に適用される。
get_the_modified_date /en
get_the_modified_date 関数が生成したフォーマット済みの投稿修正年月日に適用される(この関数は the_modified_date 関数内でも呼び出される)。
get_the_modified_time /en
get_the_modified_time 関数または get_post_modified_time 関数が生成したフォーマット済みの投稿修正時間に適用される(これらの関数は the_modified_time 関数内でも呼び出される)。
get_the_time /en
get_the_time 関数または get_post_time 関数が生成したフォーマット済みの投稿年月日に適用される(これらの関数は the_time 関数内でも呼び出される)。
the_date /en
the_date 関数が生成したフォーマット済みの投稿年月日に適用される。
the_modified_date /en
the_modified_time 関数が生成したフォーマット済みの投稿修正年月日に適用される。
the_modified_time /en
the_modified_time 関数が生成したフォーマット済みの投稿修正時間に適用される。
the_time /en
the_time 関数が生成したフォーマット済みの投稿時間に適用される。
the_weekday /en
the_weekday 関数が生成したフォーマット済みの曜日名に適用される。
the_weekday_date /en
フィルター関数引数: 曜日名、曜日名の前に出力する文字列、曜日名の後に出力する文字列
the_weekday_date 関数が生成した投稿の曜日名に適用される。

投稿者・ユーザー関連のフィルター

リンク関連のフィルター管理画面関連のフィルターセクションも参照

login_body_class /en
login_header() /enの出力となるログイン画面のbody要素のclass属性に適用される。
login_redirect /en
ログイン処理の実行中に redirect_to post/get 変数に適用される。
user_contactmethods /en
「あなたのプロフィール」画面の連絡先情報に適用される (古いページは contactmethods 参照)。
update_(meta_type)_metadata /en
(ユーザーの)メタデータが更新される前に適用される。

データベース読み出し

このセクションのフィルターは、データベースから読み出された情報がページまたは編集画面に表示される前に適用されます。

author_email /en
comment_author_email 関数で取得したコメント投稿者のメールアドレスに適用される。
comment_author /en
comment_author 関数で取得したコメント投稿者名に適用される。 get_comment_author も参照。
comment_author_rss /en
コメント投稿者名が RSS フィードに挿入される前に適用される。
comment_email /en
comment_author_email_link 関数で取得したコメント投稿者のメールアドレスに適用される。
comment_url /en
comment_author_url 関数で取得したコメント投稿者のサイトURLに適用される(get_comment_author_url も参照)。
get_comment_author /en
get_comment_author 関数で取得したコメント投稿者名に適用される。これは comment_author で呼び出されるものと同じ。comment_author も参照。
get_comment_author_email /en
get_comment_author_email 関数で取得したコメント投稿者のメールアドレスに適用される。これは comment_author_email で呼び出されるものと同じ。author_email も参照。
get_comment_author_IP /en
get_comment_author_IP 関数で取得したコメント投稿者の IP アドレスに適用される。これは comment_author_IP で呼び出されるものと同じ。
get_comment_author_url /en
get_comment_author_url 関数で取得したコメント投稿者の URL に適用される。これは comment_url で呼び出されるものと同じ。comment_author も参照。
login_errors /en
ログイン画面に表示されるエラーメッセージに適用される。
login_headertitle /en
ログインヘッダー URL の title 属性(デフォルトでは "Powered by WordPress")に適用される。
login_headerurl /en
ログインヘッダー URL のリンク先(デフォルトでは wordpress.org)に適用される。
login_message /en
ログイン画面に表示されるメッセージに適用される。
role_has_cap /en
フィルター関数引数: フィルターする権限のリスト、チェックする権限、ユーザー権限グループ名
WP_Role->has_cap 関数内で、ユーザー権限グループの権限リストに適用される。
sanitize_user /en
フィルター関数引数: サニタイズ済みのユーザー名、サニタイズされていないユーザー名、厳格な ASCII 文字を使うかどうか(true/false)
sanitize_user 関数で返されるユーザー名に適用される。
the_author /en
get_the_author 関数で返されるユーザーの表示名に適用される。これは the_author で呼び出されるものと同じ。
the_author_email /en
the_author_email 関数で返されるユーザーのメールアドレスに適用される。
user_search_columns /en
wp_users テーブル内のカラム一覧に WP_User_Query 内の WHERE 節を含めるために適用される。

データベース書き込み

このセクションのフィルターは、情報がデータベースに保存される前に適用されます。

pre_comment_author_email /en
コメントをデータベースに保存する前に、コメント投稿者のメールアドレスに対して適用される。
pre_comment_author_name /en
コメントをデータベースに保存する前に、コメント投稿者のユーザー名に対して適用される。
pre_comment_author_url /en
コメントをデータベースに保存する前に、コメント投稿者の URL に対して適用される。
pre_comment_user_agent /en
コメントをデータベースに保存する前に、コメント投稿者のユーザーエージェント情報に対して適用される。
pre_comment_user_ip /en
コメントをデータベースに保存する前に、コメント投稿者の IP アドレス情報に対して適用される。
pre_user_id /en
コメントをデータベースに保存する前に、コメント投稿者のユーザー ID に対して適用される。
pre_user_description /en
コメントをデータベースに保存する前に、コメント投稿者の説明文に対して適用される。
pre_user_display_name /en
コメントをデータベースに保存する前に、コメント投稿者のブログ上の表示名に対して適用される。
pre_user_email /en
データベースに保存する前に、ユーザーのメールアドレスに対して適用される。
pre_user_first_name /en
データベースに保存する前に、ユーザーの名前(ファーストネーム)に対して適用される。
pre_user_last_name /en
データベースに保存する前に、ユーザーの苗字に対して適用される。
pre_user_login /en
データベースに保存する前に、ユーザーのログイン名に対して適用される。
pre_user_nicename /en
データベースに保存する前に、ユーザー名のスラッグ("nice name")に対して適用される。
pre_user_nickname /en
データベースに保存する前に、ユーザーのニックネームに対して適用される。
pre_user_url /en
データベースに保存する前に、ユーザーの URL に対して適用される。
registration_errors /en
新規アカウント登録の際に発生した登録エラーのリストに適用される。
user_registration_email /en
新規ユーザーを登録する前に、登録ページから読み取ったユーザーのメールアドレスに適用される。
validate_username /en
フィルター関数引数: ユーザー名が有効かどうかの確認結果(true/false)、確認されたユーザー名
新規ユーザー名が有効かどうかの確認結果に適用される。

リンク集関連のフィルター

注: このセクションではリンク集(ブログロール)関連のフィルターを紹介しています。投稿、ページ、カテゴリーなどに関連するリンクのフィルターについては、リンク関連のフィルターを参照。

get_bookmarks /en
フィルター関数引数: データベースクエリ結果のリスト、get_bookmarks 引数のリスト
get_bookmarks 関数で取得した、リンク集のデータベースクエリ結果に適用される。
link_category /en
get_links_list 関数および wp_list_bookmarks 関数で取得したリンクカテゴリー情報に適用される(WordPress 2.2 以降)。
link_description /en
get_links_list 関数および wp_list_bookmarks 関数で取得したリンク説明文に適用される(WordPress 2.2 以降)。
link_rating /en
get_links_list 関数および wp_list_bookmarks 関数で取得したリンク名に適用される(WordPress 2.2 以降)。
link_title /en
get_linkrating 関数で取得したリンク評価(数字)に適用される。
pre_link_description /en
リンク説明がデータベースに保存される前に適用される。
pre_link_image /en
リンク画像がデータベースに保存される前に適用される。
pre_link_name /en
リンク名がデータベースに保存される前に適用される。
pre_link_notes /en
リンクのメモがデータベースに保存される前に適用される。
pre_link_rel /en
リンク先の関係/間柄(XFN)情報がデータベースに保存される前に適用される。
pre_link_rss /en
リンク先の RSS URL がデータベースに保存される前に適用される。
pre_link_target /en
リンクターゲットがデータベースに保存される前に適用される。
pre_link_url /en
リンク URL がデータベースに保存される前に適用される。

ブログ情報・設定関連のフィルター

all_options /en
get_alloptions 関数で取得した、ブログ設定情報のリストに適用される。
bloginfo /en
get_bloginfo 関数で情報を取得した後、bloginfo 関数で取得したブログ設定情報に適用される。2つ目の引数 $show は、要求された bloginfo の設定名。bloginfo("url")bloginfo("directory")bloginfo("home") はこのフィルターに影響されないことに注意する(bloginfo_url フィルターの項を参照)。
bloginfo_rss /en
get_bloginfo_rss 関数内で get_bloginfo 関数を使ってブログ設定情報を取得し、 HTML タグを除去して特殊文字を変換した後に適用される。2つ目の引数 $show は、要求された bloginfo の設定名。
bloginfo_url /en
bloginfo("url")bloginfo("directory")bloginfo("home") の出力値を返す前に適用される。
loginout /en
wp_loginout 関数で(通常サイドバーに配置される)ログイン・ログアウト用の HTML リンクを生成する際に適用される。
option_(option name) /en
get_option 関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えば foo という設定について get_option("foo") の出力値をフィルターする場合、"option_foo" という名前のフィルターを追加して使用する。
pre_option_(option name) /en
get_alloptions 関数で取得した設定値に対し、配列ベースの設定を解読した後に適用される。例えば foo という設定をフィルターする場合、pre_option_foo という名前のフィルターを追加して使用する。
pre_get_space_used /en
get_space_used() 関数に適用され、使用中のディスク領域を表示する代替方法を提供する。このフィルターで false を返すと、デフォルトの表示方法に戻る (wp_upload_dir() が返すディレクトリの空き領域をメガバイト単位で)。
pre_option_(option name) /en
get_alloptions関数によりデータベースから取得されるオプション値に適用される。配列のオプション値であればシリアライズ化される。このフィルターを使用するには、特定のオプション名を付けてフィルターを追加する必要がある。たとえば、オプション “foo” をフィルターするには “pre_option_foo”。
pre_update_option_(option name) /en
オプション値がデータベースに保存される前に適用される。つまり、保存する値を上書きできる。このフィルターを使用するには、特定のオプション名を付けてフィルターを追加する必要がある。たとえば、オプション “foo” をフィルターするには “pre_update_option_foo”。
register /en
wp_register 関数で、ユーザー登録が許可されている場合に表示する登録リンク、またはログインしている場合に表示する管理画面へのリンクに適用される。
upload_dir /en
フィルター関数引数: dir(アップロードディレクトリへのパス)、url(アップロードディレクトリの URL)、error(エラーを出力する場合 true に設定)の値を含む配列
wp_upload_dir 関数で算出した、ファイルアップロードディレクトリに適用される。
upload_mimes /en
フィルター関数引数: "|" 記号区切りのファイル拡張子と対応する MIME タイプ情報を含むリスト
wp_check_filetype 関数で MIME タイプリストの入力がない場合、アップロードファイル用の MIME タイプリストを返すためのフィルター。

テキスト関連のフィルター

attribute_escape /en
特殊文字を HTML 文字実体参照に変換するための関数、attribute_escape 関数内でテキストデータ(投稿投稿本文など)に適用される。
js_escape /en
js_escape 関数で、JavaScript コードをブラウザに送信する前に適用される。

管理画面関連のフィルター

このセクションのフィルターは WordPress の管理画面に関連するものです。コンテンツ編集画面もこれに含まれます。

admin_user_info_links /en
WordPress 管理画面クイックメニュー内のユーザープロフィール・情報リンクに適用される。
autosave_interval /en
投稿を自動保存する間隔の時間に適用される。
bulk_actions /en
管理画面の一括操作ドロップダウンの操作対象項目配列に適用される。
bulk_post_updated_messages /en
一括操作更新メッセージに適用される。
cat_rows /en
カテゴリー管理画面で生成される、カテゴリー行の HTML に適用される。
comment_edit_pre /en
コメント本文が編集画面に表示される前に適用される。
comment_edit_redirect /en
フィルター関数引数: リダイレクト先情報、コメント ID
管理画面でコメントを編集した後のリダイレクト先情報に適用される。
comment_moderation_subject /en
フィルター関数引数: メール件名、コメント ID
管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
注:この操作はデフォルトの wp_notify_moderator 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
comment_moderation_text /en
フィルター関数引数: メール本文、コメント ID
管理者に承認が必要な新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
注:この操作はデフォルトの wp_notify_moderator 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
comment_notification_headers /en
フィルター関数引数: メールヘッダーのテキスト、コメント ID
投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メールヘッダーに適用される。
注:この操作はデフォルトの wp_notify_moderator 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
comment_notification_subject /en
フィルター関数引数: メール件名、コメント ID
投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール件名に適用される。
注:この操作はデフォルトの wp_notify_moderator 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
comment_notification_text /en
フィルター関数引数: メール本文、コメント ID
投稿者に新しいコメントがつけられたことを知らせるメールを送信する前に、メール本文に適用される。
注:この操作はデフォルトの wp_notify_moderator 関数内で発生する(この関数はプラグインによる上書きが可能。詳しくはプラグイン API を参照)。
comment_row_actions /en
コメント行の下の操作リンク(返信、クイック編集、編集)に適用される。
cron_request /en
spawn_cron()wp_remote_post() に渡す URL、キー、引数をフィルターできるようにする。
cron_schedules /en
wp_get_schedules 関数で cron スケジュールを生成できるよう、空の配列に適用される。
custom_menu_order /en
'menu_order' フィルターを有効化するために使われる。
default_content /en
新規投稿の際、編集画面を開く前にデフォルトの投稿本文に対して適用される。
default_excerpt /en
新規投稿の際、編集画面を開く前にデフォルトの投稿抜粋に対して適用される。
default_title /en
新規投稿の際、編集画面を開く前にデフォルトの投稿タイトルに対して適用される。
editable_slug /en
get_sample_permalink 関数によって投稿、ページ、タグ、カテゴリースラッグに対して適用される。
explain_nonce_(verb)-(noun) /en
フィルター関数引数: 表示するテキスト(デフォルトは "Are you sure you want to do this?" メッセージ)およびアクション URL の最後にくる追加情報
フィルター関数が WordPress コアのコードにはないナンスを説明するメッセージを定義できるようにする。使うには、特定の動詞・名刺フィルターを定義する必要がある。例えばプラグインでタグを更新するナンスを定義している場合、explain_nonce_update-tag というフィルターを定義すると、"Are you sure you want to update this tag?" というメッセージが表示されるようにする。
format_to_edit /en
管理画面で編集するために投稿を設定する管理メニューによって呼び出される format_to_edit 関数で、投稿本文・抜粋・タイトル・パスワードに適用される。また、管理画面でコメントを編集する際にも適用される。
format_to_edit /en
(デフォルトでは WordPress には使用されない)format_to_post 関数内の投稿本文に適用される。
manage_edit-${post_type}_columns /en
フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
カスタム投稿タイプに対して、投稿管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクションmanage_${post_type}_posts_custom_column /en も参照。
manage_link-manager_columns /en
フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想リスト
WordPress 2.7 まではmanage_link_columns。ブログロール管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクションmanage_posts_custom_column /en も参照。
manage_posts_columns /en
フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
投稿管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクションmanage_posts_custom_column /enも参照 (サンプルや使い方については Scompt's tutorial 参照(現在、リンク切れ))。
manage_pages_columns /en
フィルター関数引数および戻り値: キーがカラム名、値がそのカラムのヘッダーテキストになっている連想配列
固定ページ管理画面に出力されるカラムのリストに適用される。編集画面にカラム情報を挿入するアクションmanage_pages_custom_column /enも参照
manage_users_columns /en
manage_users_custom_column /en
manage_users_sortable_columns /en
media_row_actions /en
メディアライブラリーの各ファイルの下に表示されるアクションリンクのリスト(表示や編集など)に適用される。
menu_order /en
管理画面のメニューの順番の配列に適用される。事前に custom_menu_order フィルターで有効化される必要がある。
nonce_life /en
nonce の生成や検証などのライフスパンに適用される。通常より早く期限切れする nonce を生成できる。フィルターからの戻り値は秒単位。
nonce_user_logged_out /en
ユーザーがログアウトした際の nonce の生成や検証に利用される現行ユーザーID に適用される。
plugin_row_meta /en
プラグインページの各プラグインの下にリンクを追加する。
postmeta_form_limit /en
投稿管理画面に表示する投稿のメタ情報項目数に適用される。
post_row_actions /en
管理画面の「投稿」 > 「投稿一覧」で表示される各投稿の下のアクションのリンク(クイック編集、編集、表示、プレビューなど)のリストに適用される。
post_updated_messages /en
投稿、固定ページ、カスタム投稿タイプの操作中にユーザーに表示される管理メッセージをもつ配列に適用される。このフィルターは出力メッセージを変更するだけで、メッセージの出力そのものは行わない。register_post_type 文書内の "customizing the messages" 参照。
pre_upload_error /en
プラグインがファイルアップロード時に XMLRPC エラーを生成できるようするために適用される。
preview_page_link /en
ページ編集画面の「プレビュー」リンクに適用される。
preview_post_link /en
投稿編集画面の「プレビュー」リンクに適用される。
richedit_pre /en
wp_richedit_pre 関数内でリッチテキストエディターに投稿本文を表示する前に適用される。
schedule_event /en
cron スケジュールに追加される、単一の繰り返される各イベントに適用される。
show_password_fields /en
ユーザーがプロフィール画面からパスワードを変更できるかどうかの変数に適用される。自分で変更が可能な場合は true、変更できない場合は false。
terms_to_edit /en
各タクソノミーにおけるキーワードの CSV に適用される。CSV は、投稿にどのキーワードが付けられているかの表示に使用される、
the_editor /en
フィルター関数引数および戻り値: 文字列
リッチテキストエディターを囲む HTML の div 要素を生成し、画面に出力する前に適用される。
user_can_richedit /en

ユーザーのブラウザーがリッチテキストエディターに対応しているかどうかの評価、または user_can_richedit 関数で設定されたリッチテキストエディターを使うかどうかの設定に適用される。

user_has_cap /en
フィルター関数引数: フィルターする権限のリスト、チェックする権限、引数リスト(例えば投稿編集の権限の場合、投稿 ID など)
current_user_can 関数で呼び出される WP_User->has_cap 関数内で、ユーザーの権限リストに適用される。
wp_handle_upload_prefilter /en
フィルター関数引数: $_FILES の単一要素を表す配列
ファイルをアップロードする際のアップロード情報に適用される。
wp_handle_upload /en
フィルター関数引数: file(ファイル名)/url/type 情報の配列
ファイルをアップロードする際、アップロード情報に適用される。
wp_revisions_to_keep /en
フィルター関数引数: 保持するリビジョンの数(デフォルトは無限)、投稿オブジェクト
ある投稿に対して保持するリビジョン数を変更する。
wp_terms_checklist_args /en
フィルター関数引数: チェックボックスのリストの引数の配列、投稿ID
wp_terms_checklist() 関数の引数に適用される。
wp_upload_tabs /en
アップロードファイル管理画面でカスタムタブのリストを出力する際に実行する。カスタムタブ用のページを表示するには、upload_files_タブ名 アクションフィルターを使用する(プラグイン_API/アクションフック一覧を参照)。
media_upload_tabs /en
アップロードファイル管理画面でカスタムタブのリストを出力する際に実行する。カスタムタブ用のページを表示するには、upload_files_タブ名 アクションフィルターを使用する(プラグイン_API/アクションフック一覧を参照)。
plugin_action_links_(plugin file name) /en
プラグイン画面に表示されるリンクのリストに適用される (有効化、無効化リンクのとなり)。
views_edit-post / en
投稿一覧に適用される。例: すべて (30) | 公開済み (22) | 下書き (5) | 保留中 (2) | ゴミ箱 (1)

リッチエディター関連のフィルター

これらのフィルターはリッチテキストエディタ(TinyMCE)の設定を変更する。

mce_spellchecker_languages /en
スペルチェッカーで利用できる言語の選択肢に適用される。
mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4 /en
それぞれのフィルターにはボタン名の配列が含まれる。リッチテキストエディターツールバーのボタン行に適用される。
mce_css /en
リッチテキストエディター用の CSS ファイル URL に適用される。
mce_external_plugins /en
リッチテキストエディターが読み込む外部プラグインの配列に適用される。
mce_external_languages /en
外部プラグインによって読み込まれた言語ファイルの配列に適用され、標準の翻訳メソッドが利用できるようにする(詳しくは wp-includes/js/tinymce/langs/wp-langs.php ファイルを参照)。
tiny_mce_before_init /en
リッチテキストエディターの init 配列全体に適用される。

テンプレート関連のフィルター

このセクションではテーマ・テンプレート・スタイルファイル関連のリンクを紹介しています。

locale_stylesheet_uri /en
フィルター関数引数: URL、スタイルシートディレクトリ URL
get_locale_stylesheet_uri 関数で返されるロケール特有のスタイルシート情報に適用される。
stylesheet /en
get_stylesheet 関数で返されるスタイルシート情報に適用される。
stylesheet_directory /en
フィルター関数引数: スタイルシートディレクトリ情報、スタイルシート情報
get_stylesheet_directory 関数で返されるスタイルシートディレクトリ情報に適用される。
stylesheet_directory_uri /en
フィルター関数引数: スタイルシートディレクトリ URL、スタイルシート情報
get_stylesheet_directory_uri 関数で返されるスタイルシートディレクトリ URL に適用される。
stylesheet_uri /en
フィルター関数引数: スタイルシート URL、スタイルシート情報
get_stylesheet_uri 関数で返されるスタイルシート URL に適用される。
template /en
get_template 関数で返されるテンプレート情報に適用される。
template_directory /en
フィルター関数引数: テンプレートディレクトリ情報、テンプレート情報
get_template_directory 関数で返されるテンプレートディレクトリ情報に適用される。
template_directory_uri /en
フィルター関数引数: テンプレートディレクトリ URL、テンプレート情報
get_template_directory_uri 関数で返されるテンプレートディレクトリ URL に適用される。
theme_root /en
get_theme_root 関数で返されるテーマのルートディレクトリ情報(通常は wp-content/themes)に適用される。
theme_root_uri /en
フィルター関数引数: URL、サイトURL
get_theme_root_uri 関数で返されるテーマのルートディレクトリ URLに適用される。
また、以下のフィルターフックを使用すれば、テーマ内の各テンプレートファイルの位置指定を変更することもできる(template_redirect アクションフックも参照)。
404_template /en
archive_template /en
このフィルターを使って例えば、カスタム投稿タイプのアーカイブに特定のテンプレートを強制できる。つまりすべてのコードをプラグイン内に保持できる。
attachment_template /en
author_template /en
category_template /en
comments_popup_template /en
comments_template /en
"comments_template"フィルターを使用すると、プラグインからカスタムテンプレートをロードし、デフォルトのコメントテンプレートを置換できる。
date_template /en
home_template /en
page_template /en
paged_template /en
search_template /en
single_template /en
このフィルターを使って例えば、カスタム投稿タイプに特定のテンプレートを強制できる。つまりすべてのコードをプラグイン内に保持できる。
shortcut_link / en
「Press This」ブックマークレットに適用される。
template_include /en
wp_nav_menu_args /en
wp_nav_menu 関数の引数に適用される。

Kubrick フィルター

バージョン 3.0 以前のデフォルトテーマ kubric に存在したフィルター。

kubrick_header_color
kubrick テーマのヘッダーカラーに適用される。
kubrick_header_display
kubrick テーマのヘッダー表示オプションに適用される。
kubrick_header_image
kubrick テーマのヘッダー画像ファイルに適用される。

登録・ログイン関連のフィルター

authenticate /en
ユーザー名とパスワードを使用したログインに対して、BASIC認証を実行できる。
registration_errors /en
新規アカウントとしてユーザーを登録する際に生成された登録エラーに適用される。
user_registration_email /en
新規ユーザーとして登録する前に、登録ページから取得されたユーザーの電子メールアドレスに適用される。
validate_username /en
フィルター関数引数: 検証結果が正しいかどうか (true または false)、検証されるユーザー名
新規ユーザー名の検証結果に適用される。
wp_authenticate_user /en
ユーザーがログインし WordPress がユーザー名とパスワードを検証した後、かつ、検証エラーをチェックする前に適用される。

リダイレクト・リライト関連のフィルター

これらの高度なフィルターは、WordPress のリライトルール処理に関連したものです。

allowed_redirect_hosts /en
リダイレクトしても安全と思われるホスト名のリストに適用される。危険な 'redirect_to' リクエストパラメータを防ぐため wp-login.php が使用する。
author_rewrite_rules /en
投稿者に関連する URL リライトルールが生成された後に適用される。
category_rewrite_rules /en
カテゴリーに関連する URL リライトルールが生成された後に適用される。
comments_rewrite_rules /en
コメントに関連する URL リライトルールが生成された後に適用される。
date_rewrite_rules /en
日付に関連する URL リライトルールが生成された後に適用される。
mod_rewrite_rules /en
パーマリンク構造を変更した際、.htaccess ファイルに挿入する URL リライトルールのリストに適用される。現バージョンでは廃止済みの rewrite_rules を置き換えるフィルターでもある。
page_rewrite_rules /en
ページに関連する URL リライトルールが生成された後に適用される。
post_rewrite_rules /en
投稿に関連する URL リライトルールが生成された後に適用される。
redirect_canonical /en
フィルター関数引数: $redirect_url$requested_url
“canonical” URL リダイレクトのキャンセルに使用する。キャンセルには FALSEを返し、リダイレクトを許可するには $redirect_url を返す。
rewrite_rules_array /en
URL リライトルールが生成された後、その配列全体に適用される。
root_rewrite_rules /en
ルートレベル URL リライトルールが生成された後に適用される。
search_rewrite_rules /en
検索に関連する URL リライトルールが生成された後に適用される。
wp_redirect /en
フィルター関数引数: URL、HTTP ステータスコード
wp_redirect 関数内のリダイレクト URL に適用される(この関数はプラグインによる上書きが可能。詳しくはプラグイン APIを参照)。


wp_redirect_status /en
フィルター関数引数: URL、HTTP ステータスコード
デフォルトの wp_redirect 関数で転送が行われる際の HTTP ステータスコードに適用される(この関数はプラグインによる上書きが可能。詳しくはプラグイン APIを参照)。

WP_Query フィルター

以下は投稿を取得するためのクエリを構築・実行する間に WP_Query object によって実行されるフィルターです。ユーザー、メタ情報、その他のより一般的なクエリについては高度な WordPress フィルターも参照。

found_posts
投稿のリストをデータベースから取得した直後に、このリストに対して適用される。
found_posts_query /en
表示する投稿のリストが取得された後、WordPress はクエリ結果内の行を選択する。このフィルターを使い、その際に SELECT FOUND_ROWS() 以外の操作を加えることができる。
post_limits /en
post 配列を返すクエリの LIMIT 節に適用される。
posts_clauses /en
post配列を返す、節ごとにキー付きの配列に分割された SQLクエリ全体に適用される。posts_request よりも容易に処理できる。
posts_distinct /en
post 配列を返すクエリに、プラグインが DISTINCTROW 節を追加できるようにする。
posts_fields /en
post 配列を返すクエリのフィールドリストに適用される。
posts_groupby /en
post 配列を返すクエリの GROUP BY 節に適用される(通常は空データ)。
posts_join /en
post 配列を返すクエリの JOIN 節に適用される。通常、JOIN にテーブルを追加する際に posts_where フィルターと一緒に使う。
posts_join_paged /en
post 配列を返すクエリの JOIN 節に対し、ページングが計算された後適用される(ページング自体は JOIN に影響しないので、このフィルターは posts_join と実質的には同一)。
posts_orderby /en
post 配列を返すクエリの ORDER BY 節に適用される。
posts_request /en
post 配列を返す SQL クエリを実行する直前に、クエリ全体に対して適用される。
posts_results / en
クエリから返された結果の配列を操作できる。
posts_search /en
WP_Query の WHERE 節で使用される検索 SQL に適用される。
posts_where /en
post 配列を返すクエリの WHERE 節に適用される。
posts_where_paged /en
post 配列を返すクエリの WHERE 節に対し、ページングが計算された後適用される(ページング自体は WHERE に影響しないので、このフィルターは posts_where と実質的には同一)。
the_posts /en
投稿の固定ページで、閲覧権限および投稿ステータスのチェックが行われた後、投稿のリストのクエリに適用される。

メディア関連のフィルター

このセクションではさまざまな種類のメディアと連携して使われるメディアフィルターを紹介しています。

editor_max_image_size /en
image_downsize /en
get_image_tag_class /en
get_image_tag /en
image_resize_dimensions /en
intermediate_image_sizes /en
icon_dir /en
wp_get_attachment_image_attributes /en
img_caption_shortcode /en
post_gallery /en
use_default_gallery_style /en
gallery_style /en
(adjacent)_image_link /en
embed_defaults /en
load_default_embeds /en
embed_googlevideo /en
upload_size_limit /en
wp_image_editors /en
plupload_default_settings /en
plupload_default_params /en
image_size_names_choose /en
wp_prepare_attachment_for_js /en
media_upload_tabs /en
disable_captions /en
media_view_settings /en
media_view_strings /en
wp_handle_upload_prefilter /en

高度な WordPress フィルター

このセクションでは、国際化やさまざまなクエリ、その他 WordPress 基本関数に関連する高度なフィルターを紹介しています。

create_user_query /en
新規登録ユーザーの情報をデータベースに保存するクエリが実行される直前に、このクエリに対して適用される。
get_editable_authors /en
get_editable_authors 関数で、ユーザーが編集可能な投稿者のリストに適用される。
get_next_post_join /en
フィルター関数引数: JOIN 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
get_next_post 関数内で、SQL 文の JOIN 節に適用される。
get_next_post_sort /en
フィルター関数引数: ORDER BY
get_next_post 関数内で、SQL 文の ORDER BY 節に適用される。
get_next_post_where /en
フィルター関数引数: WHERE 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
get_next_post 関数内で、SQL 文の WHERE 節に適用される。
get_previous_post_join /en
フィルター関数引数: JOIN 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリーのリスト
get_previous_post 関数内で、SQL 文の JOIN 節に適用される。
get_previous_post_sort /en
フィルター関数引数: SQL文の ORDER BY
get_previous_post 関数内で、SQL 文の ORDER BY 節に適用される。
get_previous_post_where /en
フィルター関数引数: SQL文の WHERE 節、同じカテゴリ内かどうかの判断(true/false)、除外するカテゴリのリスト
get_previous_post 関数内で、SQL 文の WHERE 節に適用される。
gettext /en
フィルター関数引数: 翻訳済みおよび未翻訳のテキスト、テキストドメイン
translation() 関数で翻訳されたテキスト(__() および _e() などの国際化関数で呼び出される)に適用される。国際化の設定が有効になっていなかったり、テキストドメインが読み込まれていない場合にも適用。
override_load_textdomain /en
get_meta_sql /en
フィルター関数引数: array( compact( 'join', 'where' ), $this->queries, $type, $primary_table, $primary_id_column, $context )
関数 WP_Meta_Query::get_sql (高度なメタクエリ用にメインのクエリに追加される SQL 節を生成する) 内で、高度なメタクエリにより生成された SQL JOIN 節および WHERE 節に適用される。
get_others_drafts /en
管理画面で他のユーザーの下書き投稿を選択するクエリに適用される。
get_users_drafts /en
管理画面で表示する自分の下書き投稿を選択するクエリに適用される。
locale /en
get_locale 関数で取得したロケール情報に適用される。
query /en
プラグインが読み込まれた後に実行されるすべてのクエリに適用される。
query_string /en
非推奨。代わりに query_vars または request を使うこと。
query_vars /en
SQL が生成される前に、WordPress のパブリッククエリ変数のリストに対して適用される。プラグインが他の方法で扱った余分な固定リンク情報を削除するのに使える。現バージョンではすでに廃止されている、query_string を置き換えるフィルターでもある。
request /en
動作は query_vars と同じ。追加クエリ変数・プライベートクエリ変数が追加された後に適用される。
excerpt_length /en
個別投稿の抜粋の長さを定義する。
excerpt_more /en
抜粋の後に来る "more(続きを読む)" 文字列の長さを定義する。
post_edit_form_tag /en
デフォルト投稿・ページエディターのフォームタグの後にコードを付加できるようにする。
update_user_query /en
ユーザー情報を更新するクエリを実行する前に、このクエリに対して適用される。

;uploading_iframe_src /en

(バージョン 2.5 で削除)投稿・ページ編集画面のファイルアップロード iframe の src 属性に適用される。
xmlrpc_methods /en
XMLRPC サーバー用に定義された XMLRPC メソッドに適用される。
wp_mail_from /en
wp_mail 関数でメールが送信される前に、$_SERVER['SERVER_NAME'] で設定されたホスト名の値に適用される。フィルターを使ってメールアドレス(例:user@example.com)または氏名とメールアドレスの組み合わせ(例:Name <user@example.com>)を返すことができる。
wp_mail_from_name /en
wp_mail 関数によりメールが送信される前に適用される。このフィルターはメールの From 欄の名前に使用される文字列を返す必要がある。
update_(meta_type)_metadata /en
メタデータが更新される前に適用される。'user'メタデータが更新されるならフックは 'update_user_metadata'。

ウィジェット

このセクションでは WordPress コア内のウィジェットによって追加されたフィルターを紹介しています。

dynamic_sidebar_params /en
WordPress ウィジェット内の widgets_init 関数の引数に適用される。
widget_archives_dropdown_args /en
WordPress アーカイブウィジェット内の wp_get_archives() /en 関数の引数に適用される。
widget_categories_args /en
WordPress カテゴリーウィジェット内の wp_list_categories() 関数の引数に適用される。
widget_links_args /en
WordPress リンクウィジェット内の wp_list_bookmarks() 関数の引数に適用される。
widget_pages_args /en
WordPress 固定ページウィジェット内の wp_list_pages() 関数の引数に適用される。
widget_tag_cloud_args /en
WordPress 固定ページウィジェット内の wp_tag_cloud() 関数の引数に適用される。
widget_text /en
WordPress テキストウィジェットのウィジェットテキストに適用される。サードパーティ製ウィジェットに適用してもよい。
widget_title /en
ユーザーが編集可能な WordPress ウィジェットのウィジェットタイトルに適用される。サードパーティ製ウィジェットに適用してもよい。

管理バー

このセクションでは WordPress 3.0 で追加された管理バー関連のフィルターを紹介しています。

wp_admin_bar_class / en
wp-includes/admin-bar.php 内の _wp_admin_bar_init() 関数のデフォルト 'WP_Admin_Bar' クラスを変更できる。

これも読んでみよう

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