加入收藏 | 设为首页 | 会员中心 | 我要投稿 昌吉站长网 (https://www.0994zz.com/)- 科技、建站、经验、云计算、5G、大数据,站长网!
当前位置: 首页 > 教程 > 正文

详解WordPress中简码格式标签编写的基本方法推荐

发布时间:2022-06-20 11:33:55 所属栏目:教程 来源:互联网
导读:这篇文章主要介绍了详解WordPress中简码格式标签编写的基本方法,文中讲到了添加和移除简码等的一些PHP函数的用法,需要的朋友可以参考下。 WordPress 简码是一种类似于论坛标签的东西,格式类似于把尖括号换成中括号的 Html 标签。简码很多人叫做短代码,但
  这篇文章主要介绍了详解WordPress中简码格式标签编写的基本方法,文中讲到了添加和移除简码等的一些PHP函数的用法,需要的朋友可以参考下。
 
  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();
 
  判断简码
 
  关于判断简码,有两个函数,shortcode_exists() 函数判断简码是否存在。
 
  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' => 'http://www.bgbk.org',
      'hide' => false,
      'text' => '点击隐藏 / 显示'
    ), $attr ) );
    $hide = $hide ? ' style="display:none;"' : '';
    return '<a href="' . $url . '"' . $hide . '>' . $text . '</a>';
  }
  add_shortcode( 'test', 'Bing_shortcode_test' );
  只有页面中使用了简码的时候才加载脚本
 
  而在开发的过程中,有时会遇到这种问题:简码模块需要加载 JS 或者 CSS 脚本,而当页面没有使用简码的时候就会造成资源浪费。
 
  总结:
 
  简码是个非常强大的功能,对文章内容是一种很好的扩展,利用好可以让添加某些东西变的方便快捷。
 
  关于简码的函数都在:wp-includes/shortcode.php 文件里,有能力的朋友可以阅读一下,了解原理。
 
 

(编辑:昌吉站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!