這篇文章主要介紹了WordPress開發中短代碼的實現及相關函數使用技巧,文中講到了add_shortcode函數和shortcode_atts函數的用法,需要的朋友可以參考下。

其實實現短代碼很簡單，我們只需要用到 WordPress 里面的一個函數就可以搞定短代碼，外加自己的一個小函數，可以讓短代碼實現的輕松加愉快。

短代碼實現原理

就像往 WP 一些動作里加鉤子和過濾函數一樣，短代碼只是經過封裝了的針對文章輸出內容的過濾器而已，沒有像有一些主題功能說的那么震撼、那么高深。

下面來一個簡單例子：

1. function myName() {//短代碼要處理的函數 
2. return "My name's XiangZi !"; 
3. } 
4. //掛載短代碼 
5. //xz為短代碼名稱  
6. //即你在編輯文章時輸入[xz]就會執行 myName 函數 
7. add_shortcode('xz', 'myName'); 

那么我們在文章中輸入[xz]就會得到

My name's XiangZi !

短代碼傳參

更高深一點的利用，我將會在后面的文章中講到，今天只講一下，短代碼的傳參機制

高級一點的例子

1. function myName($array,$content) { 
2. var_dump($array); 
3. var_dump($content); 
4. } 
5.    
6. add_shortcode('xz', 'myName'); 

編輯文章時我們輸入：

[xz a="1" b="2" c="3"]這里是三個參數哦[/xz]

在函數中我們將得到：

1. //$array 是一個數組， 
2. //大體結構如下 
3. $array = array('a'=>'1','b'=>'2','c'=>'3'); 
4. //$content 是一個字符串 
5. $content = '這里是三個參數哦'; 
6. shortcode_atts 

不是因為搞短代碼插件，我也不會用到這個函數，shortcode_atts 函數主要是用來設置短代碼中截獲變量的初始值。

這是一個很實用的函數，其實這個函數的真正是作用在數組上得，因為我們從短代碼中截獲的參數都是數組形式的。

shortcode_atts 函數詳解

不要被函數名所疑惑，在 WordPress 里主要是用于設置短代碼參數的默認值，如果我們將代碼提取出來，用在別的地方，該函數可以幫我們設置一個既得數組的默認值。

shortcode_atts 函數使用

這個函數使用起來很簡單。

1. shortcode_atts(array( 
2. "url" => 'http://PangBu.Com' 
3. ), $url) 

以上代碼的意思是，將 $url 數組 鍵值為url的成員默認值設定為'http://PangBu.Com',別的地方用處似乎不多，但對于一些超級懶人，有時候攬到總是忘記或是懶得設定數組的數值時，這個函數超好用。

shortcode_atts 函數聲明

1. /** 
2.  * Combine user attributes with known attributes and fill in defaults when needed. 
3.  * 
4.  * The pairs should be considered to be all of the attributes which are 
5.  * supported by the caller and given as a list. The returned attributes will 
6.  * only contain the attributes in the $pairs list. 
7.  * 
8.  * If the $atts list has unsupported attributes, then they will be ignored and 
9.  * removed from the final returned list. 
10.  * 
11.  * @since 2.5 
12.  * 
13.  * @param array $pairs Entire list of supported attributes and their defaults. 
14.  * @param array $atts User defined attributes in shortcode tag. 
15.  * @return array Combined and filtered attribute list. 
16.  */ 
17. function shortcode_atts($pairs, $atts) { 
18.  $atts = (array)$atts; 
19.  $out = array(); 
20.  foreach($pairs as $name => $default) { 
21.  if ( array_key_exists($name, $atts) ) 
22.   $out[$name] = $atts[$name]; 
23.  else 
24.   $out[$name] = $default; 
25.  } 
26.  return $out; 
27. }