Action是Hooks的兩種類型之一。 它們提供了在執行WordPress Core，插件和主題的特定點運行功能的方法。 它們是Filter的對應物。 ##添加Action 添加Action的過程包括兩個步驟。 首先，您需要創建一個回調函數，該函數在運行時將被調用。 其次，您需要將Callback函數添加到一個將執行該函數調用的鉤子中。 您將使用add_action（）函數，傳遞至少兩個參數string $ tag，callable $ function_to_add。 下面的例子將在執行init鉤子時運行： ``` <?php function wporg_custom() { // do something } add_action('init', 'wporg_custom'); ``` 您可以參考Hooks章節了解可用掛鉤的列表。 當您獲得更多的經驗，通過WordPress核心源代碼將允許您找到最合適的鉤子。 ## 附加參數 add_action（）可以接受兩個附加參數，int $ priority用于給予回調函數的優先級，int $ accepted_args表示將傳遞給回調函數的參數數。 ## 優先 優先級決定了與給定鉤子相關聯的其他回調函數相關的回調函數何時執行。 優先級為11的功能將以優先級為10的功能運行; 并且優先級為9的函數將在優先級為10的函數之前運行。任何正整數是可接受的值，默認值為10。 如果兩個回調函數以相同的優先級為同一個鉤子注冊，那么將按照它們掛鉤的順序運行。 例如，以下回調函數都注冊到 init鉤子，但具有不同的優先級： ``` <?php add_action('init', 'run_me_early', 9); add_action('init', 'run_me_normal'); // default value of 10 is used since a priority wasn't specified add_action('init', 'run_me_late', 11); ``` 運行的第一個函數是run_me_early（），其次是run_me_normal（），最后運行的函數將是run_me_late（）。 ## 參數數量 有時候，回調函數需要接收一些與其掛接的函數相關的額外數據。 例如，當WordPress保存一個帖子并運行save_post鉤子時，它會將兩個參數傳遞給回調函數：保存的帖子的ID以及post對象本身： ``` do_action('save_post', $post->ID, $post); ``` 所以，當save_post鉤子注冊一個回調函數時，它可以指定它要接收這兩個參數： ``` add_action('save_post', 'wporg_custom', 10, 2); ``` ...然后它可以在函數定義中注冊參數： ``` function wporg_custom($post_id, $post) { // do something } ``` ## 示例 如果您想修改在前端的循環中獲取搜索結果的查詢，則可以鉤入pre_get_posts鉤子。 ``` <?php function wporg_search($query) { if (!is_admin() && $query->is_main_query() && $query->is_search) { $query->set('post_type', ['post', 'movie']); } } add_action('pre_get_posts', 'wporg_search'); ```