WordPress shortcode_atts() 函數應用

【函數介紹】

shortcode_atts() 函數是與 WordPress 短代碼函數:add_shortcode() 一起使用的, 結果返回短代碼中的屬性系列數組。

【函數使用】

<?php shortcode_atts( $pairs , $atts ); ?>

【參數説明】

$pairs
(array) (必須) 所有支持的屬性和他們默認值的完整列表。
默認: None

$atts
(array) (必須) 用户在短代碼標籤中輸入的屬性值
默認: None

【返回值】

(array)
用户輸入和默認兩者合併和過濾之後的數組列表。

【函數實例】

在你主題的 functions.php 文件添加如下代碼

function bartag_func($atts) {
	extract(shortcode_atts(array(
		'foo' => 'no foo',  //默認為 no foo
		'bar' => 'default bar'//默認為 default bar
	), $atts));

	return 'bartag: ' . $foo . ' ' . $bar;
}
add_shortcode('bartag', 'bartag_func');

編輯文件時切換到文本模式添加如下短代碼：

[bartag foo="koala" bar="bears"] 

輸出內容如下:
bartag: koala bears

【源文件】

shortcode_atts() 位於 wp-includes/shortcodes.php.

相關函數：add_shortcode()