WordPress常用的有兩種鉤子,過濾鉤子add_filter和動作鉤子add_action经磅,它們是WordPress插件機制中非常重要的兩個函數(shù)。過濾鉤子用來創(chuàng)建一個過濾器,讓其它的主題和插件對一個值進行修改過濾眷蜈;動作鉤子核心代碼跟過濾鉤子差不多,但是沒有返回值沈自,單純的就是在特定的地方執(zhí)行插件或者主題開發(fā)者掛載的函數(shù)酌儒。
在開發(fā)WordPress博客同步到CSDN插件時,需要在WordPress發(fā)布文章后枯途,加入一些動作鉤子函數(shù)忌怎,實現(xiàn)同步發(fā)布到其它博客平臺的功能,但同時又要避免修改文章后的重復(fù)發(fā)布酪夷。最早版本用的是publish_post和xmlrpc_public_post這兩個函數(shù)榴啸,結(jié)合發(fā)布時間判斷,實現(xiàn)了基本的功能晚岭;隨后又加入了publish_future_post來支持晚于當(dāng)前時間的定時發(fā)布功能,但對于將定時發(fā)布時間設(shè)在當(dāng)前時間之前的,就沒法同步了弓候。為了解決這個問題,今天又查了一些資料狂鞋,最后用transition_post_status替換了上面提到的幾個鉤子,完美實現(xiàn)了定時發(fā)布后的文章同步問題璃弄,值得記錄一下要销。
首先需要了解的是動作鉤子的用法和參數(shù):
<?php
add_action( $tag, $function_to_add, $priority = 10, $accepted_args =1);
?>
$tag是所掛載的動作鉤子(action hooks)的名稱,就是WordPress核心調(diào)用do_action()時一些可以觸發(fā)的動作夏块,用來確定掛載函數(shù)的位置疏咐,在官方Plugin API/Action Reference或WordPress Hooks Database上可以查看動作鉤子列表;$tag也可以是一個主題或插件文件內(nèi)部的一個動作脐供,或者特定的標(biāo)簽“all”浑塞,這個函數(shù)將被所有的鉤子調(diào)用。
$function_to_add是你掛載的函數(shù)政己,用來實現(xiàn)期望添加的功能酌壕。
$priority是可選項,用于指定和特定的動作相關(guān)聯(lián)函數(shù)的執(zhí)行順序歇由,數(shù)字越小卵牍,執(zhí)行越早,默認(rèn)值為10沦泌。
$accepted_args也是可選項糊昙,用于標(biāo)識掛鉤函數(shù)所接受的參數(shù)數(shù)量,默認(rèn)值為1谢谦。
然后為了便于了解下面那些發(fā)布文章時會被觸發(fā)的鉤子释牺,先簡單介紹下幾個涉及到的屬性值:
$post為文章對象;$post_ID為文章ID回挽;$post_status為文章對象的發(fā)布狀態(tài)(包括new没咙,publish,future千劈,draft祭刚,pending,private墙牌,trash袁梗,auto-draft等);$post_type為文章對象的發(fā)布類型(包括post憔古,page遮怜,attachment,revision等)鸿市。
最后就是相關(guān)的動作鉤子:
publish_post:參數(shù)一個($post_ID)锯梁,點擊發(fā)布文章時就會被觸發(fā)即碗;
save_post:參數(shù)一個($post_ID),發(fā)布或更新文章時就會被觸發(fā)陌凳;
edit_post:參數(shù)兩個($post_ID, $post)剥懒,只要編輯已經(jīng)存在的文章就會被觸發(fā);
publish_future_post:參數(shù)一個($post_ID)合敦,到定時發(fā)布文章設(shè)定的時間點就會被觸發(fā)初橘,如果設(shè)定的時間早于發(fā)布時間,不會被觸發(fā)充岛;
transition_post_status:參數(shù)三個($new_status, $old_status, $post)保檐,實現(xiàn)功能比較強大,可以根據(jù)文章發(fā)布狀態(tài)的變化實現(xiàn)一些功能崔梗。
{$old_status}to{$new_status}:參數(shù)一個($post)夜只,比如draft_to_publish是通常的文章發(fā)布事件,future_to_publish則可以用來處理定時文章發(fā)布事件蒜魄。
post_updated:參數(shù)三個($post_ID, $post_after, $post_before)扔亥,已存在文章更新了就會被觸發(fā)。
對比上面的函數(shù)說明可以發(fā)現(xiàn)谈为,post_updated事件是最強大的旅挤,可以獲取到文章修改前后的所有內(nèi)容,參數(shù)較多伞鲫;其次是transition_post_status事件粘茄,功能也比較強;接著是{$old_status}to{$new_status}事件榔昔,針對性較強驹闰,可以對特定情況進行事件抓缺窬撒会;而publish_post、save_post师妙、edit_post和publish_future_post這四個事件就相對比較簡單诵肛,可以視情況而用。
WordPress中有關(guān)發(fā)布默穴、編輯文章的代碼主要在文件/wp-includes/post.php里怔檩,主要函數(shù)有wp_update_post、wp_insert_post等蓄诽,有興趣可以去細(xì)細(xì)看下源碼或者官方網(wǎng)站上的相關(guān)文檔薛训,一定會收獲不少的。
最后的最后仑氛,如果你也有同步文章的需求乙埃,記得去試下WP2CSDNBlog插件闸英,目前已經(jīng)支持同步CSDN、新浪和網(wǎng)易博客了介袜,好用的話記得給個好評喔甫何!