在文章或頁面內(nèi)容中輸入上面的調(diào)用，可以在相應(yīng)的位置輸出一段歡迎語句，在 style.css 中定義相應(yīng)的 CSS ，即可為短代碼賦予樣式。

Kayo 簡略的介紹了 WordPress 的短代碼(shortcode) 功能，主要是介紹了 shortcode 的主要概念和使用方法。在本文中， Kayo 將會更加詳細(xì)的介紹一下 shortcode 中較為重要的 API ，希望有助于各位開發(fā)較為復(fù)雜的 shortcode 。

四.函數(shù) add_shortcode

該函數(shù)用于注冊一個 shortcode ，它有兩個參數(shù)：短代碼名與 shortcode 處理函數(shù)名，引用上文的例子：

msc 即為短代碼名，以后在寫文章或頁面時可以直接使用 [msc][/msc] 標(biāo)簽調(diào)用該短代碼，而 "myshortcode_function" 即為例子中的短代碼處理函數(shù)的名稱。下面重點分析短代碼處理函數(shù)。

五.短代碼處理函數(shù)

shortcode 處理函數(shù)是一個 shortcode 的核心， shortcode 處理函數(shù)類似于 Flickr（WordPress 過濾器），它們都接受特定參數(shù)，并返回一定的結(jié)果。 shortcode 處理器接受兩個參數(shù)， $attr 和 $content ， $attr 代表 shortcode 的各個屬性參數(shù)，從本質(zhì)上來說是一個關(guān)聯(lián)數(shù)組，而 $content 代表 shortcode 標(biāo)簽中的內(nèi)容。

如上面的例子，若在文章內(nèi)作出調(diào)用，輸出一段歡迎語句：

[msc php" id="highlighter_111994">

在輸出結(jié)果時，可以直接使用 $參數(shù)名 的形式進(jìn)行輸出，如例子中的情況即以 $title 輸出該屬性值。

六.shortcode_atts

shortcode_atts 是一個很實用的函數(shù)，它可以為你需要的屬性參數(shù)設(shè)置默認(rèn)值，并且刪除一些不需要的參數(shù)。

shortcode_atts() 包含兩個參數(shù) $defaults_array 與 $atts ， $attr 即為屬性參數(shù)集合， $defaults_array 是代表需要設(shè)置的屬性默認(rèn)值，舉個例子：

這時 $result 的結(jié)果為

'title' 由于在 $defaults_array 有不同的值，因此以這個新的值為準(zhǔn)更新了 'title' ，同時也增加了 'description' 這個值。值得注意的是， shortcode_atts() 會過濾 $defaults_array 中沒有的屬性，假如 $attr 中還有一個 'ohter' 的屬性，那么 $result 的結(jié)果仍然是上面的結(jié)果，因為 $defaults_array 中并沒有 'other' 這個屬性。當(dāng)然，這里說的值只是屬性的默認(rèn)值，真正輸出的值還是 shortcode 調(diào)用時填寫的值。

七.進(jìn)一步解析屬性與設(shè)置屬性默認(rèn)值

extract() 函數(shù)用于進(jìn)一步解析屬性并設(shè)置屬性默認(rèn)值，其中一個功能是把各屬性參數(shù)值賦予給一個形如 "$參數(shù)名" 的變量保存起來(如例子中的 $title )，方便調(diào)用，使用該函數(shù)配合 shortcode_atts() 就可以很安全的輸出結(jié)果。這點的具體使用可以參見本文第一點“一.函數(shù) add_shortcode”的例子。

另外，屬性名中的大寫字母在傳遞給處理函數(shù)前會先轉(zhuǎn)化為小寫字母，因此建議在編寫屬性名時直接使用小寫字母。