创建 WordPress 简码

WordPress 短代码非常方便，尤其是在将基于 WordPress 的网站交给客户时。使用短代码的替代方法是创建复杂的模板，即使那样，您也无法充分替代短代码的功能。我最近需要为 Mozilla Hacks 博客实现一个新的短代码，很高兴了解到 WordPress API 使创建新的短代码变得如此简单！让我向您展示如何创建自己的 WordPress 简码！

首先，您首先要在主题的 functions.php 文件中创建一个函数。该函数应返回一个字符串，用于替换呈现内容中的简码。您的函数可以接受 $args 参数，它是传入的参数的 key=>value 数组。

function my_shortcode_routine($args) {
	// $args = array('key1' => 'value1', 'key2' => 'value2')
	$return = '';

	// a bunch of logic and string-building here

	// return the result
	return $return;
}

记住你的函数不应该echo；必须返回一个字符串。

创建函数后，您可以使用 WordPress 的 add_shortcode 函数来注册简码。短代码名称函数名称不需要与短代码匹配：

// Add a shortcode called 'shortcode_name' that runs the 'my_shortcode_routine' function
add_shortcode('shortcode_name', 'my_shortcode_routine');

创建函数并注册短代码后，现在您可以在帖子和页面中使用所述短代码：

[shortcode_name key1="value1" key2="value2"]

短代码系统非常漂亮；它对经验丰富的开发人员和训练有素的客户都具有巨大的价值，也是 WordPress 为何是一个深度而灵活的平台的一个典型例子。