在WordPress中,使用add_shortcode()
函数创建自定义短代码是一个简单的过程。以下是如何实现这一功能的步骤:
-
定义短代码处理函数:首先,你需要定义一个PHP函数,该函数将处理短代码的内容和属性,并返回你希望显示在页面上内容。
-
注册短代码:使用
add_shortcode()
函数将你的自定义函数与一个短代码标签关联起来。
下面是一个具体的例子:
// 步骤1: 定义处理短代码的函数
function my_custom_shortcode($atts, $content = null) {
// 解析短代码属性
$atts = shortcode_atts(
array(
'title' => '默认标题', // 默认值
),
$atts,
'my_shortcode' // 短代码标签
);
// 返回你希望显示的内容
// 这里我们使用属性title和短代码内容content
return '<h2>' . esc_html($atts['title']) . '</h2>' . wpautop(esc_html($content));
}
// 步骤2: 使用add_shortcode()函数注册短代码
add_shortcode('my_shortcode', 'my_custom_shortcode');
在上面的例子中,my_custom_shortcode
函数将处理名为my_shortcode
的短代码。你可以通过在WordPress编辑器中使用[my_shortcode title="这是标题"]这是内容[/my_shortcode]
来调用这个短代码。
这里是如何使用shortcode_atts()
函数来设置默认属性,以及如何使用esc_html()
来确保内容安全,防止XSS攻击。
要使自定义短代码生效,你需要将上述代码放入你的主题的functions.php
文件中,或者创建一个插件来包含这段代码。
注意:在WordPress中修改functions.php
文件或创建插件时,请确保备份你的网站,以防万一出现错误导致网站无法正常运行。