WordPress 從 2.5 的版本開始,增加了一個 shortcode (短代碼) API,類似于 BBS 上的 BBCode,shortcode 也可以很方便的為文章或頁面增加功能,并且 shortcode 的比起 BBCode 更加靈活和強大,下面MK為大家介紹一下shortcode.

一.shortcode 簡介

shortcode 可以讓開發者通過以函數的形式創建宏內容來生成內容,或許這個概念看上去有點模糊,但實際上它是一個很簡單而實用的功能,只要會編寫基本的 PHP 函數,即可使用 shortcode,下文會以實際的例子來說明 shortcode 的使用方法.

二.shortcode 形式

shortcode 支持封閉標簽和自閉(自動封閉)標簽,并且支持在標簽內使用參數,至于 shortcode 具體是何種形式,這就決定于開發者怎樣編寫這個 shortcode 了,代碼如下:

1. [myshortcode]Some Content[/myshortcode] // 封閉標簽 
2. [myshortcode]  // 自閉標簽 
3. [myshortcode title="example"] // 帶有一個參數的自閉標簽 
4. [myshortcode]<p><a href="#"><span>內容</span></a></p>[/myshortcode] // 標簽內可以填寫文本或 HTML 
5. [myshortcode]Content [myshortcodesecond] more content[/myshortcodesecond] // 也可以嵌套 

三.shortcode 例子

在使用 shortcode 前,首先必須在主題的 functions.php 文件中定義 shortcode,例如,代碼如下:

1. function myshortcode_function($atts, $content = null){  
2. // $atts 代表了 shortcode 的各個參數，$content 為標簽內的內容 
3.     extract(shortcode_atts(array( // 使用 extract 函數解析標簽內的參數 
4.     "title" => '標題' // 給參數賦默認值，下面直接調用 $ 加上參數名輸出參數值  //Vevb.com 
5.     ), $atts)); 
6.     // 返回內容 
7.     return '<div class="myshortcode"> 
8.                 <h3>'. $title .'</h3> 
9.                 <p> 
10.                     '. $content .' 
11.                 </p> 
12.             </div>'; 
13. } 
14. add_shortcode("msc", "myshortcode_function"); 

注冊該 shortcode,以后使用 [msc] 標簽調用該 shortcode,把上面的代碼添加到 functions.php 中,一個簡單的 shortcode 便創建好了,我們可以通過 [msc][/msc]標簽調用該 shortcode,代碼如下:

[msc title="歡迎"]這是明凱博客,歡迎來到本博客[/msc]

在文章或頁面內容中輸入上面的調用,可以在相應的位置輸出一段歡迎語句,在 style.css 中定義相應的 CSS,即可為短代碼賦予樣式.