2015年7月3日 星期五

WordPress 技巧- 在文件中使用 Shortcode

WordPress Shortcode 是使用[]包含的短代碼,WordPress 會識別這些短代碼並根據短代碼的定義輸出為特定的內容,Shortcode API 這個功能是 WordPress 從 2.5 版本開始引入的,使用它可以給日誌內容添加各種功能,並且 Shortcode 這個接口非常容易使用,並且功能非常強大。

WordPress 短代碼(Shortcode)詳細介紹和使用

Shortcode API 支持幾乎所有可能的組合形式:自關閉標籤,開放標籤,含有參數的標籤等。

  1. [mycode]   
  2. [mycode foo="bar" id="123" color="red" something="data"]   
  3. [mycode]Some Content[/mycode]   
  4. [mycode]<p><a href="http://example.com/">HTML Content</a<>/p>[/mycode]   
  5. [mycode]Content [another-shotcode] more content[/mycode]   
  6. [mycode foo="bar" id="123"]Some Content[/mycode]  

首先你要去定義一個函數,來處理你定義的 Shortcode,和它的屬性參數以及引用的內容。

  1. function my_shortcode_func($attr$content) {   
  2.     // $attr $key=>$value 的數組   
  3.     // $content 是 shortcode 中包含的字符串   
  4.     // 對 $attr 和 $content 進行處理   
  5.     // 返回預期的值   
  6. }  

然後把自己定義的 Shortcode 和其處理函數管理起來,以便 [mycode attr="value"]content[/mycode] 能夠按照預期執行。

  1. add_shortcode('mycode''my_shortcode_func')  

WordPress 定義了以下和 Shortcode 相關的函數:

  1. add_shortcode(‘mycode’, ‘function_name’); // 定義一個新的    
  2. Shortcoderemove_shortcode(‘mycode’); // 移除一個    
  3. Shortcoderemove_all_shortcodes(); // 移除所有的    
  4. Shortcode$return = do_shortcode($content); // 解析 $content 中的 Shortcode 並返回   
  5. $return = strip_shortcodes($content); // 刪除 $content 中的 Shortcode 標籤並返回  


如果想在主題文件中使用名為 [shortcode] 的 Shortcode,只需要按照下面的方式使用 do_shortcode() 函數即可:

  1. echo do_shortcode("[my_shortcode]");  




反應:

0 意見:

Related Posts Plugin for WordPress, Blogger...