函数原型:
add_shortcode( string $tag, callable $callback )
添加新的短代码
应注意前缀或其他方式,以确保添加的短代码标签是唯一的,不会与其他已添加的短码标签冲突。如果标签重复,最后加载的标签将优先。
参数说明:
$tag,短代码名称
$callback,回调函数
shortcode回调将传递三个参数:shortcode属性、shortcode内容(如果有的话)和shortcode的名称。
每个短代码只能有一个钩子。这意味着,如果另一个插件有类似的短代码,它将覆盖你的,或者你的将覆盖他们的,这取决于插件的包含和/或运行顺序。
短代码属性名称在传递到处理程序函数之前总是转换为小写。价值观是不变的。
请注意,shortcode调用的函数永远不应该产生任何类型的输出。短代码函数应返回用于替换短代码的文本。直接产生输出将导致意想不到的结果。这与过滤器函数的行为方式类似,因为它们不应该从调用中产生意外的副作用,因为您无法控制何时何地调用它们。
函数源码:
function add_shortcode( $tag, $callback ) {
global $shortcode_tags;
if ( '' === trim( $tag ) ) {
_doing_it_wrong(
__FUNCTION__,
__( 'Invalid shortcode name: Empty name given.' ),
'4.4.0'
);
return;
}
if ( 0 !== preg_match( '@[<>&/\[\]\x00-\x20=]@', $tag ) ) {
_doing_it_wrong(
__FUNCTION__,
sprintf(
/* translators: 1: Shortcode name, 2: Space-separated list of reserved characters. */
__( 'Invalid shortcode name: %1$s. Do not use spaces or reserved characters: %2$s' ),
$tag,
'& / < > [ ] ='
),
'4.4.0'
);
return;
}
$shortcode_tags[ $tag ] = $callback;
}
使用举例:
add_shortcode( 'footag', 'wpdocs_footag_func' );
function wpdocs_footag_func( $atts ) {
return "foo = {$atts['foo']}";
}
-
WordPress函数:esc_html__ 转义HTML字符WordPress函数:esc_html__ 转义HTML字符
-
WordPress函数:esc_html_e 转义翻译的字符串并显示WordPress函数:esc_html_e 转义翻译的字符串并显示
-
WordPress函数:esc_html_x 带上下文的转义翻译WordPress函数:esc_html_x 带上下文的转义翻译
-
WordPress函数:esc_attr__ 转义属性及翻译WordPress函数:esc_attr__ 转义属性及翻译
-
WordPress函数:esc_attr_e 属性转义、翻译、显示WordPress函数:esc_attr_e 属性转义、翻译、显示
-
WP Multilang WordPress翻译插件WP Multilang插件的主要功能是提供多语言支持,使用户能够创建多语言版本的网站,满足不同语言用户的需求。
暂无评论,抢个沙发...