自 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 中新增一個函式
- function say_hello() {
- return "您好,這裡是阿樹工作室";
- }
步驟二、建立 (註冊) 短程式碼
- /**
- *建立短程式碼
- *引數 1 為段程式碼名稱,即我們準備建立的短程式碼 [sayhello]
- *引數 2 為我們前面建立的函式
- */
- add_shortcode( 'sayhello', 'say_hello' );
步驟三、在文章中內容中新增剛剛新增的短程式碼
只需要在文章內容中輸入 [sayhello] 在檢視文章的時候,就將被自動替換成 「您好,這裡是阿樹工作室」 。
短程式碼示例 2:建立高階短程式碼--給短程式碼新增屬性、
短程式碼中還可以帶引數屬性,這個示例中,我們要建立一個短程式碼用來顯示一個超連結,當然我們需要在短程式碼中加入引數--連結地址、文字內容,短程式碼形式為 [mylink href="http://ashuwp.com"] 阿樹工作室 [/mylink] 。
注意,短程式碼也可以是這種一對標籤,其中開始標籤內容可以帶很多引數, 兩個標籤之間也可以有內容,和 html 的標籤類似
步驟一、在主題的 functions.php 檔案中建立函式
- //函式接受兩個引數 $atts 為短程式碼的屬性陣列 $content 為兩個標籤之間的內容
- function my_link( $atts, $content = null ) {
- extract( shortcode_atts( array (
- 'href' => 'http://www.ashuwp.com/'
- ), $atts ) ); //從短程式碼屬性陣列中獲取 href 值
- return '<a href="'.$href.'">'.$content.'</a>';
- }
步驟二、建立段程式碼
- add_shortcode( 'mylink', 'my_link' );
步驟三、在文章內容中新增段程式碼
只需要在文章中輸入我們剛剛新增的段程式碼:
- [mylink href="http://ashuwp.com"] 阿樹工作室 [/mylink]
儲存文章之後,檢視文章,短程式碼內容將被替換成 帶超連結的文字 「阿樹工作室」 。