WordPress Shortcode 是使用[]包含的短代碼,WordPress 會識別這些短代碼並根據短代碼的定義輸出為特定的內容,Shortcode API 這個功能是 WordPress 從 2.5 版本開始引入的,使用它可以給日誌內容添加各種功能,並且 Shortcode 這個接口非常容易使用,並且功能非常強大。
WordPress 短代碼(Shortcode)詳細介紹和使用
Shortcode API 支持幾乎所有可能的組合形式:自關閉標籤,開放標籤,含有參數的標籤等。
- [mycode]
- [mycode foo="bar" id="123" color="red" something="data"]
- [mycode]Some Content[/mycode]
- [mycode]<p><a href="http://example.com/">HTML Contenta<>/p>[/mycode]
- [mycode]Content [another-shotcode] more content[/mycode]
- [mycode foo="bar" id="123"]Some Content[/mycode]
首先你要去定義一個函數,來處理你定義的 Shortcode,和它的屬性參數以及引用的內容。
- function my_shortcode_func($attr, $content) {
- // $attr $key=>$value 的數組
- // $content 是 shortcode 中包含的字符串
- // 對 $attr 和 $content 進行處理
- // 返回預期的值
- }
然後把自己定義的 Shortcode 和其處理函數管理起來,以便 [mycode attr="value"]content[/mycode] 能夠按照預期執行。
- add_shortcode('mycode', 'my_shortcode_func')
WordPress 定義了以下和 Shortcode 相關的函數:
- add_shortcode(‘mycode’, ‘function_name’); // 定義一個新的
- Shortcoderemove_shortcode(‘mycode’); // 移除一個
- Shortcoderemove_all_shortcodes(); // 移除所有的
- Shortcode$return = do_shortcode($content); // 解析 $content 中的 Shortcode 並返回
- $return = strip_shortcodes($content); // 刪除 $content 中的 Shortcode 標籤並返回
如果想在主題文件中使用名為 [shortcode] 的 Shortcode,只需要按照下面的方式使用 do_shortcode() 函數即可:
- echo do_shortcode("[my_shortcode]");