在WordPress中,添加短代码通常是通过使用add_shortcode()
函数来实现的。以下是如何使用add_shortcode()
函数添加自定义短代码的步骤:
-
首先,确保你已经在你的插件文件或者主题的
functions.php
文件中开始了PHP代码块。 -
使用
add_shortcode()
函数注册你的短代码。这个函数有两个参数:短代码名称和用于处理短代码内容的回调函数。
下面是一个简单的例子,展示如何添加一个名为my_shortcode
的短代码:
function my_shortcode_handler($atts, $content = null) {
// 解析短代码属性
$atts = shortcode_atts(
array(
'title' => '默认标题', // 默认值
),
$atts,
'my_shortcode' // 短代码名称
);
// 处理短代码内容
$output = '<h2>' . esc_html($atts['title']) . '</h2>';
if ($content) {
$output .= '<p>' . esc_html($content) . '</p>';
}
// 返回处理后的内容
return $output;
}
// 注册短代码
add_shortcode('my_shortcode', 'my_shortcode_handler');
在上面的代码中:
my_shortcode_handler
是处理短代码内容的函数。它接收两个参数:$atts
(短代码的属性数组)和$content
(短代码包围的内容,如果没有提供则为null
)。shortcode_atts()
函数用于设置默认属性和覆盖它们,如果用户在短代码中提供了属性的话。esc_html()
函数用于确保内容在输出到HTML之前是安全的,防止XSS攻击。add_shortcode()
函数用于注册短代码。第一个参数是短代码的名称,第二个参数是处理短代码的函数名。
现在,你可以在WordPress的文章、页面或自定义文章类型中使用[my_shortcode title="自定义标题"]你的内容[/my_shortcode]
来调用这个短代码。如果没有提供title
属性,它将使用默认值“默认标题”。如果提供了包围的内容,它也会被包含在<p>
标签中输出。