摘要
WordPress缩写类似于论坛标签，其格式类似于将尖括号改为中括号的Html标签。简码被很多人称为短码，但官方翻译应该是简码。请在这里更正。
简码发展的逻辑比
正文：
WordPress 缩写类似于论坛标签，其格式类似于将尖括号改为中括号的 Html 标签。简码被很多人称为短码，但官方翻译应该是简码。请在这里更正。
简码的开发逻辑比较简单，主要是添加、删除和判断，本文将对此进行介绍。
简码格式
简码的格式非常灵活，可以是有属性、无属性、闭合、非闭合等等：
example][example]内容[/example]
[example attr=”属性” attr-hide=”1″]内容[/example]
[example “属性”]
添加简码
要添加简化代码，需要使用 add_shortcode（）函数和两个属性，第一个是简化代码的名称，第二个是简化代码的回调函数。
add_shortcode( $tag, $func );
例如，添加一个名为 test 的短代码并回调 Bing_shortcode_test（）函数:
function Bing_shortcode_test( $attr, $content ){
return 'Hello World!';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
在文章中添加【test】将输出“Hello World！”。
从上面的例子可以看出，简化代码的回调函数需要接收两个参数。第一个是简码的所有属性，通过数组存储；二是简码的内容（封闭简码中的内容）。
移除简码
remove_shortcode（）函数可以删除简化代码，您只需指定简化代码的名称。
remove_shortcode( 'test' );
remove_all_shortcodes（）函数用于删除当前添加的所有简码。
remove_all_shortcodes();
判断简码
判断简码有两个功能。函数的作用是:判断简码是否存在。
remove_all_shortcodes();
if( shortcode_exists( 'test' ) ) echo '简码 test 存在';//False
add_shortcode( 'test', 'Bing_shortcode_test' );
if( shortcode_exists( 'test' ) ) echo '简码 test 存在';//True
还有一个 has_shortcode() 函数，判断字符串中是否出现某某简码。
$content = '测试测试测试测试测试测试测试测试';
if( has_shortcode( $content, 'test' ) ) echo '字符串中有 test 简码';//False
$content = '测试测试测试测[test]测试[/test]试测试测试测试测试';
if( has_shortcode( $content, 'test' ) ) echo '字符串中有 test 简码';//True
执行简码
do_shortcode（）函数用于查找字符串中的简化代码，并在简化代码处调用之前添加的回调函数，以将简化代码执行成所需的内容。
WordPress 添加的挂钩:
add_filter( 'the_content', 'do_shortcode', 11 );
例子
function Bing_shortcode_test( $attr, $content ){
return 'Hello World!';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
$content = '测试测试测试测[test]试测试测试测试测试';
echo do_shortcode( $content );//测试测试测试测 Hello World!试测试测试测试测试
简码属性
简码支持各种格式的属性，接受给简码回调函数的第一个参数。如果你要给参数设置默认值，可以使用 shortcode_atts() 函数：
function Bing_shortcode_test( $attr, $content ){
extract( shortcode_atts( array(
'url' => 'https://www.xxx.com',
'hide' => false,
'text' => '点击隐藏 / 显示'
), $attr ) );
$hide = $hide ? ' style="display:none;"' : '';
return '<a href="' . $url . '" rel="external nofollow" ' . $hide . '>' . $text . '</a>';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
只有页面中使用了简码的时候才加载脚本
而在开发的过程中，有时会遇到这种问题：简码模块需要加载 JS 或者 CSS 脚本，而当页面没有使用简码的时候就会造成资源浪费。
比如下边的这个 Google 地图插件：
//添加简码
function Bing_add_google_map( $atts, $content ){
//content...
}
add_shortcode( 'google_map', 'Bing_add_google_map');
//挂载脚本
function Bing_add_javascript(){
wp_enqueue_script( 'map_scripts' );
}
add_action( 'wp_enqueue_scripts', 'Bing_add_javascript' );
只有在页面中使用了 [google_map] 简码的时候才需要加载脚本，这怎么做到呢？
其实很简单，只需要在简码函数触发的时候在页脚挂载脚本即可。
//添加简码
function Bing_add_google_map( $atts, $content ){
$GLOBALS['google_map_shortcode'] = true;
return '地图的代码';
}
add_shortcode( 'google_map', 'Bing_add_google_map');
//挂载脚本
function Bing_add_javascript(){
global $google_map_shortcode;
if( isset( $google_map_shortcode ) && $google_map_shortcode ) wp_enqueue_script( 'map_scripts' );
}
add_action( 'wp_footer', 'Bing_add_javascript' );
总结
简码是个非常强大的功能，对文章内容是一种很好的扩展，利用好可以让添加某些东西变的方便快捷。
关于简码的函数都在：wp-includes/shortcode.php 文件里，有能力的朋友可以阅读一下，了解原理。
转载请注明：汇站网 » 详细解释在WordPress中编译简码格式标签的基本方法
