在WordPress中,使用 add_shortcode()
函数添加短代码是一个相对简单的过程。以下是如何使用 add_shortcode()
函数来创建自定义短代码的步骤:
-
定义一个函数:首先,你需要定义一个PHP函数,该函数将处理短代码的内容,并返回你想要在页面上显示的内容。
-
使用
add_shortcode()
函数:然后,你需要使用add_shortcode()
函数将短代码名称与你的自定义函数关联起来。
下面是一个示例,展示如何创建一个简单的短代码,该短代码将显示一段自定义文本:
// 1. 定义处理短代码的函数
function my_custom_shortcode() {
// 返回你想要显示的内容
return "这是我的自定义短代码内容!";
}
// 2. 使用 add_shortcode() 将短代码与函数关联
add_shortcode('my_shortcode', 'my_custom_shortcode');
在上面的示例中,my_shortcode
是你可以在WordPress内容编辑器中使用的短代码名称。当你在内容编辑器中输入 [my_shortcode]
并保存或预览页面时,它将被替换为 my_custom_shortcode()
函数返回的内容。
如果你想传递参数到短代码,可以在自定义函数中添加参数,并在短代码中使用这些参数。以下是一个带有参数的短代码示例:
// 定义处理短代码的函数,并接受参数
function my_custom_shortcode($atts) {
// 解析短代码的属性
$atts = shortcode_atts(
array(
'text' => '默认文本', // 默认值
),
$atts,
'my_shortcode' // 短代码名称
);
// 返回带有参数的内容
return "这是我的自定义短代码内容:{$atts['text']}";
}
// 将短代码与函数关联
add_shortcode('my_shortcode', 'my_custom_shortcode');
现在,你可以在内容编辑器中使用 [my_shortcode text="Hello, World!"]
来显示自定义文本。
要使这些代码生效,你需要将它们添加到你的WordPress主题的 functions.php
文件中,或者创建一个自定义插件并在插件文件中包含这些代码。记得在每次修改 functions.php
文件或插件代码后,重新加载WordPress网站以应用更改。