在WordPress中,使用add_shortcode()
函数创建短代码是一个相对简单的过程。以下是如何使用这个函数的步骤和示例代码:
-
首先,确保你已经在WordPress的主题的
functions.php
文件或者在一个单独的插件文件中。 -
使用
add_shortcode()
函数来注册一个新的短代码。这个函数接受两个参数:短代码的名称和你想要执行的回调函数。 -
在回调函数中编写你希望在短代码被调用时执行的代码。
下面是一个简单的例子,演示如何创建一个名为my_shortcode
的短代码,它将输出“Hello, World!”:
// 在functions.php文件或者插件文件中添加以下代码
function my_shortcode_function() {
return "Hello, World!";
}
add_shortcode('my_shortcode', 'my_shortcode_function');
在上面的代码中,my_shortcode_function
是当你在WordPress内容中使用[my_shortcode]
时会被调用的函数。当这个短代码被调用时,它将返回字符串“Hello, World!”。
如果你想要传递参数到短代码,可以在回调函数中添加参数。下面是一个带有参数的例子:
function my_shortcode_function($atts) {
// 设置默认属性
$atts = shortcode_atts(
array(
'name' => 'World',
),
$atts
);
// 使用属性
return "Hello, " . esc_html($atts['name']) . "!";
}
add_shortcode('my_shortcode', 'my_shortcode_function');
在这个例子中,my_shortcode
短代码可以接受一个名为name
的参数。如果你在内容中使用[my_shortcode name="WordPress"]
,它将输出“Hello, WordPress!”。如果没有提供name
参数,它将使用默认值“World”。
记得,在修改functions.php
文件或插件文件后,你需要保存文件并刷新WordPress页面,以便新的短代码生效。