在WordPress中,使用 add_shortcode()
函数可以轻松地添加自定义短代码。以下是如何使用这个函数的步骤和示例代码:
步骤:
-
定义短代码处理函数:首先,你需要定义一个PHP函数,这个函数将处理短代码的内容并返回你想在页面上显示的内容。
-
使用
add_shortcode()
添加短代码:然后,你需要使用add_shortcode()
函数将你的自定义短代码与之前定义的处理函数关联起来。 -
在主题的
functions.php
文件中添加代码:通常,你会在你的主题的functions.php
文件中添加上述代码。
示例代码:
下面是一个简单的例子,演示如何添加一个名为 my_shortcode
的短代码,它将简单地返回一段文本。
// 定义处理短代码的函数
function my_shortcode_handler($atts, $content = null) {
// 解析短代码的属性
$atts = shortcode_atts(
array(
'title' => '默认标题', // 默认值
),
$atts,
'my_shortcode' // 短代码名称
);
// 返回要显示的内容
return "<h2>" . esc_html($atts['title']) . "</h2>" . wpautop(esc_html($content));
}
// 使用 add_shortcode() 添加短代码
add_shortcode('my_shortcode', 'my_shortcode_handler');
在这个例子中,my_shortcode
是短代码的名称,my_shortcode_handler
是处理短代码的函数。这个短代码接受一个可选的属性 title
,并显示一个标题和短代码包围的内容。
使用短代码:
在WordPress编辑器中,你可以像这样使用这个短代码:
[my_shortcode title="我的标题"]这是我的内容。[my_shortcode]
这将在页面上显示一个标题为“我的标题”的二级标题,紧接着是“这是我的内容。”的文本。
确保将上述代码添加到你的主题的 functions.php
文件中,或者如果你正在开发一个插件,可以将其添加到插件的主文件中。