/*--------------- Action Hook Function---------------*/
// 增加要鈎上'do_more'這個hook的hook function，
// 並為此hook function取名叫more_func。
// 第一個參數是hook名稱、第二個是hook function名稱
add_action('do_more', 'more_func');
// 實作more_func的內容，不需回傳值
function more_func()
{
    echo 'do more thing...';
}
 
/*--------------- Filter Hook Function ---------------*/
// 增加要鈎上'get_special' hook的hook function，
// 並為此hook function取名叫special_func。
// 參數1是hook名稱、參數2是hook function名稱
// 參數3是Priority(優先序)、參數4是hook function參數的數目
add_filter('get_special', 'special_func', 10, 2);
// 實作special_func的內容，需要給它回傳值
function special($a, $b)
{
    $c = $a.' & '.$b; //做一些事，例如把兩個參數連接起來
    return $c; //回傳值
}

所以其實兩種Hook的運作方式幾乎一樣，只差在增加Action Hook函式不需回傳值，而增加Filter Hook function時，你必須要回傳一個值。所以Filter Hook函式通常都有提供參數，讓想客製的人可以取得它，處理後再回傳。

但如果有一個Filter Hook，它沒有任何hook function有去鈎它，它該怎麼取得回傳值？答案是，直接拿第一個它給的參數，以上面的例子來說，它會直接拿$a丟進$c。另外，其實我們也可以把filter寫的跟action一樣，只要不回傳值就行，但action hook就沒辦法「模仿」filter hook，因為無法取得回傳值。

Hook Function的優先序(Priority)

如果有很多地方(plugin或者佈景functions.php)都add同一個hook，會怎麼決定出現順序？等案很顯然是可以透過Hook Function的Priority參數來作優先序的設定：

就像我們剛才說明的例子中，我們使用add_filter加入special_func時設定的優先序是10，這也是Priority參數的預設值。如果你希望它能優先被執行，就設定小於10的數字，反之，就設個100、500之類的，讓它延後被執行。

但其實這裡有個隱含的衝突問題。

以wp_head這個hook為例，如果我寫了一個外掛，希望透過wp_head來輸出「增加a.css檔案」的HTML語法，而a.css會重新設定body元素的樣式，所以我希望它可以最後才被匯入，不要被其他css檔干擾，於是我將Priority設為900，但我怎麼知道Priority 900夠不夠大？若某個WP網站，它除了安裝我的外掛，也安裝了其他外掛，而其他外掛剛好也重新設定body元素的樣式，然後把Priority設為950，此時我寫的外掛在處理body樣式時就出事了，於是就跟其他外掛衝突了。

所以此時我們需要了解的是：我的WP網站可能裝了很多外掛，我怎麼知道同一個Hook被加了多少Hook Function，而每個Hook Function的Priority被設定為多少？

答案是，我們可以透過$wp_filters這個global變數來取得所有hook的資訊，像是如下的function：

  // 列出所有的hook function及其priority
function list_hooked_functions($tag=false)
{
    global $wp_filter;
     
    if ($tag) 
    {
        $hook[$tag]=$wp_filter[$tag];
        if (!is_array($hook[$tag])) 
        {
            trigger_error("Nothing found for '$tag' hook", E_USER_WARNING);
            return;
        }
    }
    else
    {
        $hook=$wp_filter;
        ksort($hook);
    }
     
    echo '
<pre>';
    foreach($hook as $tag => $priority)
    {
        echo "
&gt;&gt;&gt;&gt;&gt;t<strong>$tag</strong>
";
        ksort($priority);
        foreach($priority as $priority => $function)
        {
            echo $priority;
            foreach($function as $name => $properties) echo "t$name
";
        }
    }
    echo '</pre>

';
    return;
}

當我們呼叫 list_hooked_functions(‘wp_head’); 時，就會列出wp_head這個Hook所鈎住的所有hook function，可以看到priority 10之後有好幾個都沒有數字，因為它們都沒有特別指定priority，所以都是10，包括我們剛才寫的print_sth也在其中：

>>>>> wp_head

1	wp_enqueue_scripts
2	feed_links
3	feed_links_extra
8	wp_print_styles
9	wp_print_head_scripts
10	rsd_link
wlwmanifest_link
index_rel_link
parent_post_rel_link
start_post_rel_link
adjacent_posts_rel_link_wp_head
locale_stylesheet
wp_generator
rel_canonical
wp_shortlink_wp_head
print_sth
wp_admin_bar_header
_admin_bar_bump_cb

所以，衝突很難提早避免，但發生衝突時，可以預先思考有沒有可能是因為priority的設定，導致結果跟預期不符合。