自 wp2.5 版本以來,WordPress 新增了短程式碼 (Shortcodes) 支援。在一些高階主題中,短程式碼是不可少的。

本文參考自:http://www.tutorialchip.com/WordPress/WordPress-shortcode-tutorial-simple-to-advanced-part-1/

1 、什麼是短程式碼 (Shortcodes)?

  • 短程式碼是新增在文章內容中的特殊標籤,類似一些論壇的 UBB 程式碼,例如:['gallery] 、 [mylink][/mylink] 等等 (去掉 ['gallery] 中的單引號),注意到如果在文章內容中寫入 ['gallery],去掉其中的單引號,那麼在視覺化模式下,將會變成一個相簿區域,這就是段程式碼。
  • 在預覽或者外掛文章的時候,短程式碼將會被替換成某一具體內容,比如上面一點的 ['gallery]

短程式碼示例 1:我們將建立一個短程式碼 [sayhello], 建立這個短程式碼後,我們需要在文章中寫入 [sayhello] 但是網站前臺檢視文章需要替換成 「您好,這裡是阿樹工作室」 。

步驟一、在主題的 functions.php 中新增一個函式

  1. function say_hello() {   
  2.     return "您好,這裡是阿樹工作室";   
  3. }  

步驟二、建立 (註冊) 短程式碼

  1. /**  
  2. *建立短程式碼  
  3. *引數 1 為段程式碼名稱,即我們準備建立的短程式碼 [sayhello]  
  4. *引數 2 為我們前面建立的函式  
  5. */  
  6. add_shortcode( 'sayhello', 'say_hello' );  

步驟三、在文章中內容中新增剛剛新增的短程式碼
只需要在文章內容中輸入 [sayhello] 在檢視文章的時候,就將被自動替換成 「您好,這裡是阿樹工作室」 。

 

短程式碼示例 2:建立高階短程式碼--給短程式碼新增屬性、

短程式碼中還可以帶引數屬性,這個示例中,我們要建立一個短程式碼用來顯示一個超連結,當然我們需要在短程式碼中加入引數--連結地址、文字內容,短程式碼形式為 [mylink href="http://ashuwp.com"] 阿樹工作室 [/mylink] 。

注意,短程式碼也可以是這種一對標籤,其中開始標籤內容可以帶很多引數, 兩個標籤之間也可以有內容,和 html 的標籤類似

步驟一、在主題的 functions.php 檔案中建立函式

  1. //函式接受兩個引數 $atts 為短程式碼的屬性陣列   $content 為兩個標籤之間的內容
  2. function my_link( $atts$content = null ) {   
  3.   extract( shortcode_atts( array (   
  4.     'href' => 'http://www.ashuwp.com/'   
  5.   ), $atts ) ); //從短程式碼屬性陣列中獲取 href 值   
  6.   return '<a href="'.$href.'">'.$content.'</a>';   
  7. }  

步驟二、建立段程式碼

  1. add_shortcode( 'mylink', 'my_link' );  

步驟三、在文章內容中新增段程式碼

只需要在文章中輸入我們剛剛新增的段程式碼:

  1. [mylink href="http://ashuwp.com"] 阿樹工作室 [/mylink]  

儲存文章之後,檢視文章,短程式碼內容將被替換成 帶超連結的文字 「阿樹工作室」 。