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

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

「関数リファレンス/add action」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(翻訳済み、div は付けていない)
(最新版に更新。カテゴリーを修正。)
1行目: 1行目:
 +
{{NeedTrans|注}}
 
== 説明 ==
 
== 説明 ==
  
14行目: 15行目:
 
{{Parameter|$function_to_add|コールバック|呼び出す関数名。注: any of the syntaxes explained in [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback 'callback' タイプについてのドキュメント] で説明される構文は全て有効です。}}
 
{{Parameter|$function_to_add|コールバック|呼び出す関数名。注: any of the syntaxes explained in [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback 'callback' タイプについてのドキュメント] で説明される構文は全て有効です。}}
 
{{Parameter|$priority|整数|関数の重要度です。呼び出す関数と他の関数との順序を変更します。デフォルト値は 10 で、例えば 5 に設定すると早く実行され、12 に設定すると遅く実行されます。|オプション|10}}
 
{{Parameter|$priority|整数|関数の重要度です。呼び出す関数と他の関数との順序を変更します。デフォルト値は 10 で、例えば 5 に設定すると早く実行され、12 に設定すると遅く実行されます。|オプション|10}}
{{Parameter|$accepted_args|整数|関数の引数の数です。WordPress 1.5.1+ では、フックした関数は、対応する [[関数リファレンス/do_action|do_action()]] あるいは apply_filters() が実行される時に、余分に引数を取ることができます。例えば、アクション <tt>comment_id_not_found</tt> は、これにフックする関数に、リクエストされたコメントの ID を渡すことができます。|オプション|1}}
+
{{Parameter|$accepted_args|整数|関数の引数の数です。WordPress 1.5.1+ では、フックした関数は、対応する [[関数リファレンス/do_action|do_action()]] あるいは [[関数リファレンス/apply_filters|apply_filters()]] が実行される時に、余分に引数を取ることができます。例えば、アクション <tt>comment_id_not_found</tt> は、これにフックする関数に、リクエストされたコメントの ID を渡すことができます。|オプション|1}}
  
 
== 用例 ==
 
== 用例 ==
42行目: 43行目:
  
 
== 注 ==
 
== 注 ==
 +
 +
To find out the number and name of arguments for an action, simply search the code base for the matching do_action() call.  For example, if you are hooking into 'save_post', you would find it in post.php:
 +
 +
do_action('save_post', $post_ID, $post);
 +
 +
Your add_action call would look like:
 +
 +
add_action('save_post', 'my_save_post');
 +
 +
And your function would be:
 +
 +
function my_save_post($post_ID, $post) {
 +
//code here
 +
}
  
 
== 更新履歴 ==
 
== 更新履歴 ==
49行目: 64行目:
 
== ソースファイル ==
 
== ソースファイル ==
  
<tt>add_action()</tt> is located in {{Trac|wp-includes/plugin.php}}.
+
<tt>add_action()</tt> {{Trac|wp-includes/plugin.php}} にあります。
  
{{原文|Function Reference/do_action|76444}}<!-- 21:07, 29 July 2009 Brentes 版 -->
+
{{原文|Function Reference/do_action|http://codex.wordpress.org/index.php?title=Function_Reference/add_action&oldid=95163}}<!-- 2010-11-18T19:29:45 Nao 版 -->
  
 
== 関連資料 ==
 
== 関連資料 ==
60行目: 75行目:
  
 
{{DEFAULTSORT:Add_action}}
 
{{DEFAULTSORT:Add_action}}
[[Category:Functions]]
+
[[Category:関数]]
 +
 
 +
[[en:Function_Reference/add_action]]
 +
[[zh-hans:函数参考/add_action]]

2010年11月19日 (金) 08:34時点における版

このページ「関数リファレンス/add action」は注未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

特定のアクションに関数をフックします。

アクションフックの一覧は アクションフック一覧 をごらんください。アクションは(通常は) WordPress コアが do_action() を呼び出すときにトリガーされます。

使い方

<?php add_action( $tag, $function_to_add, $priority, $accepted_args ); ?> 

パラメータ

$tag
文字列) (必須) フックするアクション名 (アクションの一覧は アクションフック一覧 を参照)
初期値: なし
$function_to_add
コールバック) (必須) 呼び出す関数名。注: any of the syntaxes explained in 'callback' タイプについてのドキュメント で説明される構文は全て有効です。
初期値: なし
$priority
整数) (オプション) 関数の重要度です。呼び出す関数と他の関数との順序を変更します。デフォルト値は 10 で、例えば 5 に設定すると早く実行され、12 に設定すると遅く実行されます。
初期値: 10
$accepted_args
整数) (オプション) 関数の引数の数です。WordPress 1.5.1+ では、フックした関数は、対応する do_action() あるいは apply_filters() が実行される時に、余分に引数を取ることができます。例えば、アクション comment_id_not_found は、これにフックする関数に、リクエストされたコメントの ID を渡すことができます。
初期値: 1

用例

単純なフック

ブログに投稿したときに、メールで友人に知らせます。

function email_friends($post_ID)  {
   $friends = 'bob@example.org, susie@example.org';
   mail($friends, "sally's blog updated" , 'I just put something on my blog: http://blog.example.com');
   return $post_ID;
}

add_action('publish_post', 'email_friends');

引数を取る

フックした関数は、アクションから引数を 1 つ取ります。特に 'echo_comment_id' 関数は、$comment_ID を取ります。この例は、受け取った引数の値を画面に表示します。

function echo_comment_id($comment_ID) {
   echo "I just received $comment_ID";
}
add_action('comment_id_not_found','echo_comment_id', 10, 1);

To find out the number and name of arguments for an action, simply search the code base for the matching do_action() call. For example, if you are hooking into 'save_post', you would find it in post.php:

do_action('save_post', $post_ID, $post);

Your add_action call would look like:

add_action('save_post', 'my_save_post');

And your function would be:

function my_save_post($post_ID, $post) {
//code here
}

更新履歴

1.2.0 以降

ソースファイル

add_action()wp-includes/plugin.php にあります。

最新英語版: WordPress Codex » Function Reference/do_action

関連資料

アクション: has_action(), add_action(), do_action(), do_action_ref_array(), did_action(), remove_action(), remove_all_actions()



関数リファレンステンプレートタグ目次もご覧ください。