在WordPress中,使用 add_shortcode()
函数创建自定义短代码是一个简单的过程。以下是创建自定义短代码的步骤:
-
定义短代码处理函数:首先,你需要定义一个PHP函数,这个函数将处理短代码的内容,并返回你想要在页面上显示的内容。
-
注册短代码:使用
add_shortcode()
函数将短代码与你的处理函数关联起来。
下面是一个简单的例子,演示如何创建一个名为 [myshortcode]
的自定义短代码,它将简单地返回一段文本。
// 定义处理短代码的函数
function my_shortcode_handler($atts, $content = null) {
// 解析短代码的属性
$atts = shortcode_atts(
array(
'param' => 'default value', // 默认值
),
$atts
);
// 返回短代码的内容或处理后的内容
return "This is the content of my custom shortcode. Parameter value: " . esc_attr($atts['param']);
}
// 注册短代码
add_shortcode('myshortcode', 'my_shortcode_handler');
在上面的代码中:
my_shortcode_handler
是处理短代码的函数。$atts
是一个数组,包含了短代码的属性。$content
是短代码包围的内容,如果有的话。shortcode_atts()
函数用于设置默认属性值,并确保属性值被过滤。esc_attr()
函数用于转义属性值,确保它们可以安全地输出到HTML中。
要使用这个短代码,你可以在WordPress编辑器中添加 [myshortcode param="Custom Value"]
,它将输出:
This is the content of my custom shortcode. Parameter value: Custom Value
如果你没有提供 param
属性,它将使用默认值 "default value"。
注意:这段代码应该放在你的主题的 functions.php
文件中,或者在一个自定义插件中。如果你在主题或插件中添加了这段代码,确保保存文件并在WordPress后台更新或重新激活插件以使更改生效。