其實實現短代碼很簡單,我們只需要用到 WordPress 里面的一個函數就可以搞定短代碼,外加自己的一個小函數,可以讓短代碼實現的輕松加愉快。
短代碼實現原理
就像往 WP 一些動作里加鉤子和過濾函數一樣,
短代碼只是經過封裝了的針對文章輸出內容的過濾器而已,
沒有像有一些主題功能說的那么震撼、那么高深。
下面來一個簡單例子:
function myName() {//短代碼要處理的函數
return "My name's XiangZi !";
}
//掛載短代碼
//xz為短代碼名稱
//即你在編輯文章時輸入[xz]就會執行 myName 函數
add_shortcode('xz', 'myName');
那么我們在文章中輸入[xz]就會得到
My name's XiangZi !
短代碼傳參
更高深一點的利用,我將會在后面的文章中講到,
今天只講一下,短代碼的傳參機制
高級一點的例子
function myName($array,$content) {
var_dump($array);
var_dump($content);
}
add_shortcode('xz', 'myName');
編輯文章時我們輸入:
[xz a="1" b="2" c="3"]這里是三個參數哦[/xz]
在函數中我們將得到:
//$array 是一個數組,
//大體結構如下
$array = array('a'=>'1','b'=>'2','c'=>'3');
//$content 是一個字符串
$content = '這里是三個參數哦';
shortcode_atts
不是因為搞短代碼插件,我也不會用到這個函數,
shortcode_atts 函數主要是用來設置短代碼中截獲變量的初始值。
這是一個很實用的函數,其實這個函數的真正是作用在數組上得,
因為我們從短代碼中截獲的參數都是數組形式的。
shortcode_atts 函數詳解
不要被函數名所疑惑,在 WordPress 里主要是用于設置短代碼參數的默認值,
如果我們將代碼提取出來,用在別的地方,該函數可以幫我們設置一個既得數組的默認值。
shortcode_atts 函數使用
這個函數使用起來很簡單。
shortcode_atts(array(
"url" => 'http://PangBu.Com'
), $url)
以上代碼的意思是,
將 $url 數組 鍵值為url的成員默認值設定為'http://PangBu.Com',
別的地方用處似乎不多,但對于一些超級懶人,有時候攬到總是忘記或是懶得設定數組的數值時,這個函數超好用。
shortcode_atts 函數聲明
/**
* Combine user attributes with known attributes and fill in defaults when needed.
*
* The pairs should be considered to be all of the attributes which are
* supported by the caller and given as a list. The returned attributes will
* only contain the attributes in the $pairs list.
*
* If the $atts list has unsupported attributes, then they will be ignored and
* removed from the final returned list.
*
* @since 2.5
*
* @param array $pairs Entire list of supported attributes and their defaults.
* @param array $atts User defined attributes in shortcode tag.
* @return array Combined and filtered attribute list.
*/
function shortcode_atts($pairs, $atts) {
$atts = (array)$atts;
$out = array();
foreach($pairs as $name => $default) {
if ( array_key_exists($name, $atts) )
$out[$name] = $atts[$name];
else
$out[$name] = $default;
}
return $out;
}
以上就是本文章的內容,希望對大家有所幫助。
新聞熱點
疑難解答