在WordPress中,add_shortcode()
函数用于注册一个短代码,这样你就可以在文章、页面或小工具中使用该短代码来插入自定义内容或功能。以下是使用 add_shortcode()
函数创建自定义短代码的步骤:
-
定义短代码处理函数:首先,你需要定义一个PHP函数,该函数将处理短代码的输出。这个函数可以接收两个参数:短代码的属性数组(可选)和短代码的内容(可选)。
-
注册短代码:使用
add_shortcode()
函数将短代码名称与你的处理函数关联起来。
下面是一个简单的例子,展示如何创建一个名为 my_shortcode
的自定义短代码,该短代码将输出“Hello, World!”:
function my_shortcode_handler($atts = [], $content = null) {
// 解析短代码属性
$atts = shortcode_atts(
array(
'greeting' => 'Hello', // 默认值
),
$atts,
'my_shortcode' // 短代码名称
);
// 返回短代码的输出
return "{$atts['greeting']}, World!";
}
// 使用 add_shortcode() 函数注册短代码
add_shortcode('my_shortcode', 'my_shortcode_handler');
将上述代码放入你的主题的 functions.php
文件中,或者在插件中使用。之后,你可以在编辑器中使用 [my_shortcode]
来插入短代码,它将输出 "Hello, World!"。如果你想要改变问候语,可以像这样使用属性:[my_shortcode greeting="Hi"]
,这将输出 "Hi, World!"。
请注意,在修改 functions.php
文件或创建插件时,确保备份你的网站,以防止任何潜在的错误导致网站无法正常工作。