自 wp2.5 版本以来,WordPress 添加了短代码 (Shortcodes) 支持。在一些高级主题中,短代码是不可少的。

本文参考自:http://www.tutorialchip.com/WordPress/WordPress-shortcode-tutorial-simple-to-advanced-part-1/

1 、什么是短代码 (Shortcodes)?

  • 短代码是添加在文章内容中的特殊标签,类似一些论坛的 UBB 代码,例如:['gallery] 、 [mylink][/mylink] 等等 (去掉 ['gallery] 中的单引号),注意到如果在文章内容中写入 ['gallery],去掉其中的单引号,那么在可视化模式下,将会变成一个相册区域,这就是段代码。
  • 在预览或者插件文章的时候,短代码将会被替换成某一具体内容,比如上面一点的 ['gallery]

短代码示例 1:我们将创建一个短代码 [sayhello], 创建这个短代码后,我们需要在文章中写入 [sayhello] 但是网站前台查看文章需要替换成 「您好,这里是阿树工作室」 。

步骤一、在主题的 functions.php 中添加一个函数

  1. function say_hello() {   
  2.     return "您好,这里是阿树工作室";   
  3. }  

步骤二、创建 (注册) 短代码

  1. /**  
  2. *创建短代码  
  3. *参数 1 为段代码名称,即我们准备创建的短代码 [sayhello]  
  4. *参数 2 为我们前面创建的函数  
  5. */  
  6. add_shortcode( 'sayhello', 'say_hello' );  

步骤三、在文章中内容中添加刚刚添加的短代码
只需要在文章内容中输入 [sayhello] 在查看文章的时候,就将被自动替换成 「您好,这里是阿树工作室」 。

 

短代码示例 2:创建高级短代码--给短代码添加属性、

短代码中还可以带参数属性,这个示例中,我们要创建一个短代码用来显示一个超链接,当然我们需要在短代码中加入参数--链接地址、文字内容,短代码形式为 [mylink href="http://ashuwp.com"] 阿树工作室 [/mylink] 。

注意,短代码也可以是这种一对标签,其中开始标签内容可以带很多参数, 两个标签之间也可以有内容,和 html 的标签类似

步骤一、在主题的 functions.php 文件中创建函数

  1. //函数接受两个参数 $atts 为短代码的属性数组   $content 为两个标签之间的内容
  2. function my_link( $atts$content = null ) {   
  3.   extract( shortcode_atts( array (   
  4.     'href' => 'http://www.ashuwp.com/'   
  5.   ), $atts ) ); //从短代码属性数组中获取 href 值   
  6.   return '<a href="'.$href.'">'.$content.'</a>';   
  7. }  

步骤二、创建段代码

  1. add_shortcode( 'mylink', 'my_link' );  

步骤三、在文章内容中添加段代码

只需要在文章中输入我们刚刚添加的段代码:

  1. [mylink href="http://ashuwp.com"] 阿树工作室 [/mylink]  

保存文章之后,查看文章,短代码内容将被替换成 带超链接的文字 「阿树工作室」 。