在WordPress中添加自定义短代码(shortcode)是一个相对简单的过程。以下是创建自定义短代码的步骤:
-
定义短代码处理函数:
您需要在主题的functions.php
文件中定义一个函数来处理短代码。这个函数将负责生成短代码的内容。 -
注册短代码:
使用add_shortcode()
函数将短代码名称与您的处理函数关联起来。
以下是一个简单的示例,展示如何创建一个名为 [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('my_shortcode', 'my_shortcode_handler');
在上面的代码中,my_shortcode_handler
是处理短代码的函数。它接受两个参数:
$atts
:一个包含短代码属性的关联数组。$content
:短代码内的内容(如果有的话)。
shortcode_atts()
函数用于设置默认属性值,并确保传递给短代码的属性是安全的。
add_shortcode()
函数用于将短代码名称 my_shortcode
与处理函数 my_shortcode_handler
关联起来。
现在,您可以在WordPress的任何帖子或页面中使用 [my_shortcode title="我的标题"]这是内容。[my_shortcode]
,它将显示一个标题为“我的标题”的二级标题,后面跟着“这是内容”。
请注意,直接修改主题的 functions.php
文件可能会导致在更新主题时丢失您的更改。为了避免这种情况,您可以考虑创建一个子主题或使用一个专门的插件来添加自定义功能。