add_action()(添加動作)
add_action() 函數用來掛載一個函數到動作鉤子上。
用法
add_action( $tag, $function_to_add, $priority, $accepted_args );
參數
$hook
(字符串)(必須)掛載函數的動作名稱。
默認值:None
$function_to_add
(回調函數)(必須)掛載的函數,直接填寫字符串形式的函數名即可。
默認值:None
$priority
(整數)(可選)動作執行的優先級,數值越小越先被執行。
默認值:10
$accepted_args
(整數)(可選)回調函數接收幾個參數。
默認值:1
返回值
(布爾)始終返回 True.
例子
給 wp_head 動作掛載一個函數,在 head 標簽打印輸出一些東西。
function Bing_wp_head_test_print(){ echo '<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=0" />'; } add_action( 'wp_head', 'Bing_wp_head_test_print' );
其它
該函數位於:wp-includes/plugin.php
do_action()(執行動作)
do_action() 用來執行動作鉤子,它和 apply_filters() 的區別在於沒有返回值,單純的就是在特定的地方執行插件或者主題開發者掛載的函數,一般存在於某個特殊的節點或者事件上(比如開始加載主題模板的時候或者發布一篇文章的時候)。
用法
do_action( $tag, $arg... );
參數
$tag
(字符串)(必須)要執行的動作的名字。
$arg
(混合)(可選)額外的參數,會被傳到調用的函數裡,可以添加無限個,比如保存文章的時候觸發 save_post 動作,就可以把保存的文章的 id 穿進去,讓回調函數根據文章 id 進行操作。
返回值
None
例子
function func(){ echo '測試'; } add_action( 'test', 'func' ); do_action( 'test' );
屏幕打印:
測試
更多參考類似的 apply_filters():http://www.endskin.com/apply_filters/
其它
此函數位於:wp-includes/plugin.php