WordPress 从 2.5 的版本开始,增加了一个 shortcode (短代码) API,类似于 BBS 上的 BBCode,shortcode 也可以很方便的为文章或页面增加功能,并且 shortcode 的比起 BBCode 更加灵活和强大,下面MK为大家介绍一下shortcode.

一.shortcode 简介

shortcode 可以让开发者通过以函数的形式创建宏内容来生成内容,或许这个概念看上去有点模糊,但实际上它是一个很简单而实用的功能,只要会编写基本的 PHP 函数,即可使用 shortcode,下文会以实际的例子来说明 shortcode 的使用方法.

二.shortcode 形式

shortcode 支持封闭标签和自闭(自动封闭)标签,并且支持在标签内使用参数,至于 shortcode 具体是何种形式,这就决定于开发者怎样编写这个 shortcode 了,代码如下:

1. [myshortcode]Some Content[/myshortcode] // 封闭标签 
2. [myshortcode]  // 自闭标签 
3. [myshortcode title="example"] // 带有一个参数的自闭标签 
4. [myshortcode]<p><a href="#"><span>内容</span></a></p>[/myshortcode] // 标签内可以填写文本或 HTML 
5. [myshortcode]Content [myshortcodesecond] more content[/myshortcodesecond] // 也可以嵌套 

三.shortcode 例子

在使用 shortcode 前,首先必须在主题的 functions.php 文件中定义 shortcode,例如,代码如下:

1. function myshortcode_function($atts, $content = null){  
2. // $atts 代表了 shortcode 的各个参数，$content 为标签内的内容 
3.     extract(shortcode_atts(array( // 使用 extract 函数解析标签内的参数 
4.     "title" => '标题' // 给参数赋默认值，下面直接调用 $ 加上参数名输出参数值  //phpfensi.com 
5.     ), $atts)); 
6.     // 返回内容 
7.     return '<div class="myshortcode"> 
8.                 <h3>'. $title .'</h3> 
9.                 <p> 
10.                     '. $content .' 
11.                 </p> 
12.             </div>'; 
13. } 
14. add_shortcode("msc", "myshortcode_function"); 

注册该 shortcode,以后使用 [msc] 标签调用该 shortcode,把上面的代码添加到 functions.php 中,一个简单的 shortcode 便创建好了,我们可以通过 [msc][/msc]标签调用该 shortcode,代码如下:

[msc title="欢迎"]这是明凯博客,欢迎来到本博客[/msc]

在文章或页面内容中输入上面的调用,可以在相应的位置输出一段欢迎语句,在 style.css 中定义相应的 CSS,即可为短代码赋予样式.

Tags: WordPress短代码 shortcode

分享到：