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 '';}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
以上就介紹了詳解WordPress中添加和執行動作的函數使用方法,包括了方面的內容,希望對PHP教程有興趣的朋友有所協助。