WordPress發(fā)布文章的一些動作鉤子

WordPress常用的有兩種鉤子,過濾鉤子add_filter和動作鉤子add_action经磅,它們是WordPress插件機制中非常重要的兩個函數(shù)。過濾鉤子用來創(chuàng)建一個過濾器,讓其它的主題和插件對一個值進行修改過濾眷蜈;動作鉤子核心代碼跟過濾鉤子差不多,但是沒有返回值沈自,單純的就是在特定的地方執(zhí)行插件或者主題開發(fā)者掛載的函數(shù)酌儒。

wordpress hooks

在開發(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 ReferenceWordPress 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_postsave_post师妙、edit_postpublish_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)易博客了介袜,好用的話記得給個好評喔甫何!

查看原文:http://xuhehuan.com/2173.html

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市遇伞,隨后出現(xiàn)的幾起案子辙喂,更是在濱河造成了極大的恐慌,老刑警劉巖鸠珠,帶你破解...
    沈念sama閱讀 217,826評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件巍耗,死亡現(xiàn)場離奇詭異,居然都是意外死亡跳芳,警方通過查閱死者的電腦和手機芍锦,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,968評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來飞盆,“玉大人娄琉,你說我怎么就攤上這事∠判” “怎么了孽水?”我有些...
    開封第一講書人閱讀 164,234評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長城看。 經(jīng)常有香客問我女气,道長,這世上最難降的妖魔是什么测柠? 我笑而不...
    開封第一講書人閱讀 58,562評論 1 293
  • 正文 為了忘掉前任炼鞠,我火速辦了婚禮,結(jié)果婚禮上轰胁,老公的妹妹穿的比我還像新娘谒主。我一直安慰自己,他們只是感情好赃阀,可當(dāng)我...
    茶點故事閱讀 67,611評論 6 392
  • 文/花漫 我一把揭開白布霎肯。 她就那樣靜靜地躺著,像睡著了一般榛斯。 火紅的嫁衣襯著肌膚如雪观游。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,482評論 1 302
  • 那天驮俗,我揣著相機與錄音懂缕,去河邊找鬼。 笑死王凑,一個胖子當(dāng)著我的面吹牛搪柑,可吹牛的內(nèi)容都是我干的吮蛹。 我是一名探鬼主播,決...
    沈念sama閱讀 40,271評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼拌屏,長吁一口氣:“原來是場噩夢啊……” “哼潮针!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起倚喂,我...
    開封第一講書人閱讀 39,166評論 0 276
  • 序言:老撾萬榮一對情侶失蹤每篷,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后端圈,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體焦读,經(jīng)...
    沈念sama閱讀 45,608評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,814評論 3 336
  • 正文 我和宋清朗相戀三年舱权,在試婚紗的時候發(fā)現(xiàn)自己被綠了矗晃。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,926評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡宴倍,死狀恐怖张症,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情鸵贬,我是刑警寧澤俗他,帶...
    沈念sama閱讀 35,644評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站阔逼,受9級特大地震影響兆衅,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜嗜浮,卻給世界環(huán)境...
    茶點故事閱讀 41,249評論 3 329
  • 文/蒙蒙 一羡亩、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧危融,春花似錦畏铆、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,866評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽片排。三九已至寨腔,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間率寡,已是汗流浹背迫卢。 一陣腳步聲響...
    開封第一講書人閱讀 32,991評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留冶共,地道東北人乾蛤。 一個月前我還...
    沈念sama閱讀 48,063評論 3 370
  • 正文 我出身青樓每界,卻偏偏與公主長得像,于是被迫代替她去往敵國和親家卖。 傳聞我的和親對象是個殘疾皇子眨层,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,871評論 2 354

推薦閱讀更多精彩內(nèi)容

  • 過濾器 Filters 過濾器鉤子和動作鉤子有很大的區(qū)別。它讓你可以控制代碼的輸出上荡。 apply_filters(...
    StevenQin閱讀 648評論 0 0
  • 動作鉤子 ( actions ) 動作鉤子讓你可以在 WordPress 加載過程中或者當(dāng)某個事件發(fā)生的特定時刻觸...
    StevenQin閱讀 484評論 0 0
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理趴樱,服務(wù)發(fā)現(xiàn),斷路器酪捡,智...
    卡卡羅2017閱讀 134,656評論 18 139
  • Lua 5.1 參考手冊 by Roberto Ierusalimschy, Luiz Henrique de F...
    蘇黎九歌閱讀 13,793評論 0 38
  • 我覺得 丟東西 是因為 想要的東西太多 是“貪”的體現(xiàn) @學(xué)霸貓老師一句話點醒了我叁征,這件事其實是我做人生最重要的事...
    李智閱讀 529評論 0 3