1. 程式人生 > >WordPress 插件機制的簡單用法和原理(Hook 鉤子)

WordPress 插件機制的簡單用法和原理(Hook 鉤子)

原理 pre 事情 回調函數 subject http 參與 quest 的人

WordPress 的插件機制實際上只的就是這個 Hook 了,它中文被翻譯成鉤子,允許你參與 WordPress 核心的運行,是一個非常棒的東西,下面我們來詳細了解一下它。

PS:本文只是簡單的總結一下,更多用法還是要參考文中給出的函數。

鉤子分類
鉤子分為兩種,一種叫做動作(action),還有一種叫做過濾器(filter)。這兩種鉤子實現原理基本一樣,後邊會講到,使用上的區別在於過濾器有返回值,而動作沒有。

動作的理念是讓你在一種情況或者一個特別的位置執行一些函數,比如發送一封郵件等;過濾器則是讓你修改 WordPress 核心需要用到的一個值,然後 WordPress 再用這些值做一些事情,比如函數的返回值等。

動作鉤子
wp_head 是一個很常用的動作鉤子,在開發主題過程中,開發者都會在 head 標簽裏加上 wp_head() 函數,事實上,正是這個函數調用了 wp_head 鉤子。

如果插件開發者想要在 head 標簽裏添加一句話,就可以使用 wp_head 鉤子,下邊是個簡單的例子。

//在 head 標簽添加一些內容
function Bing_add_head_tag(){
    echo ‘添加內容‘;
}
add_action( ‘wp_head‘, ‘Bing_add_head_tag‘ );

  

添加代碼後,查看前臺的網頁源代碼,就能在 head 標簽裏看到我們添加的內容了。

上邊是一個簡單的例子,只是打印了一句話。利用這個鉤子,我們還可以做一個遇到 404 頁面給管理員發送一封郵件的插件,下邊簡單的寫了一個。

//遇到 404 頁面給管理員發送郵件
function Bing_404_page_mail(){
    if( !is_404() ) return;//如果不是 404 頁面就退出函數
    $to = get_option( ‘admin_email‘ );//獲取管理員地址
    $subject = ‘遇到 404 頁面啦!‘;//郵件標題
    $message = ‘404 頁面的地址:http://‘ . $_SERVER[‘HTTP_HOST‘] . $_SERVER
[‘REQUEST_URI‘];//郵件內容 wp_mail( $to, $subject, $message );//發送郵件 } add_action( ‘wp_head‘, ‘Bing_404_page_mail‘ );

更多關於 add_action() 函數的內容:《 WordPress 函數:add_action()(添加動作) 》

過濾器鉤子
根據我的親身經歷,可能過濾器鉤子會難理解些,尤其對不熟悉 PHP 的人來說。

過濾器鉤子可以讓你改一些東西的值,過濾器回調函數會接受一個參數,這就是當前的值。還記得那個用來調用文章內容的 the_content() 函數吧,這個函數就提供了一個 the_content 過濾器。

給 the_content 鉤子添加一個函數,這個函數需要接收一個參數,這個參數就是當前的值。

//文章內容全部鏈接新窗口打開
function Bing_autoblank( $content ){//$content 變量就是文章內容,因為其它過濾器也要過濾,所以這個內容可能是經過其它函數過濾的
    $content = str_replace( ‘<a‘, ‘<a target="_blank"‘, $content );//添加 target="_blank"
    return $content;//必須要把過濾後的內容返回回去,否則值就丟了
}
add_filter( ‘the_content‘, ‘Bing_autoblank‘ );

更多關於 add_filter() 函數的內容:《 WordPress 函數:add_filter()(添加過濾器) 》

調用鉤子
WordPress 核心是怎麽調用這些鉤子的就不再這篇文章了,可以參考下邊兩篇文章。

動作鉤子:《 WordPress 函數:do_action()(執行動作) 》

過濾器鉤子:《 WordPress 函數:apply_filters()(創建過濾器) 》

鉤子原理
事實上,在調用 add_action() 和 add_filter() 的時候,只是向 $wp_filter 全局變量添加了一個數組元素,還要說的就是動作和過濾器是公用的一個全局變量,也就是說,過濾器和動作是不能重名的。

當調用 do_action() 的時候,會查找 $wp_filter 全局變量中都有哪些添加到此動作的函數,循環執行即可。

apply_filters() 比 do_action() 多了一個步奏,就是每次調用函數時還要接收這個函數的返回值,最後把經過多次過濾的值返回出去,供使用。

Reference from : https://www.cnblogs.com/zhangchenliang/p/4000219.html

WordPress 插件機制的簡單用法和原理(Hook 鉤子)