WordPress中的shortcode短代码功能用法详解_

1、WordPress中的shortcode短代码功能用法详解_ WordPress 从 2.5 的版本开头，增加了一个 shortcode (短代码) API ,类似于 BBS 上的 BBCode ， shortcode 也可以很便利的为文章或页面增加功能，并且 shortcode 的比起 BBCode 更加敏捷和强大。下面 Kayo 为大家介绍一下 shortcode 。 一.shortcode 简介 shortcode 可以让开发者通过以函数的形式创建宏内容来生成内容，或许这个概念看上去有点模糊，但事实上它是一个很简洁而有用的功能，只要会编写基本的 PHP 函数，即可用法 shortcode

2、 ，下文会以实际的例子来说明 shortcode 的用法方法。 二.shortcode 形式 shortcode 支持封闭标签和自闭（自动封闭）标签，并且支持在标签内用法参数，至于 shortcode 具体是何种形式，这就决定于开发者怎样编写这个 shortcode 了。 myshortcodeSome Content/myshortcode / 封闭标签 myshortcode / 自闭标签 myshortcode title=example / 带有一个参数的自闭标签 myshortcodepa href=#span内容/span/a/p/myshortcode / 标签内可以填写文本或

3、HTML myshortcodeContent myshortcodesecond more content/myshortcodesecond / 也可以嵌套用法标签 三.shortcode 例子 在用法 shortcode 前，首先必需在主题的 functions.php 文件中定义 shortcode ，例如： function myshortcode_function($atts, $content = null) / $atts 代表了 shortcode 的各个参数，$content 为标签内的内容 extract(shortcode_atts(array( / 用法 extrac

4、t 函数解析标签内的参数 title = 标题 / 给参数赋默认值，下面挺直调用 $ 加上参数名输出参数值 ), $atts); / 返回内容 return div class=myshortcode h3. $title ./h3 p . $content . /p /div; add_shortcode(msc, myshortcode_function); / 注册该 shortcode，以后用法 msc 标签调用该 shortcode 把上面的代码添加到 functions.php 中，一个简洁的 shortcode 便创建好了，我们可以通过 msc/msc标签调用该 shortcod

5、e ，如： msc title=欢迎这是独立博客 Kayos Melody ，欢迎来到本博客/msc 在文章或页面内容中输入上面的调用，可以在相应的位置输出一段欢迎语句，在 style.css 中定义相应的 CSS ，即可为短代码给予样式。 Kayo 简略的介绍了 WordPress 的短代码(shortcode) 功能，主要是介绍了 shortcode 的主要概念和用法方法。在本文中， Kayo 将会更加具体的介绍一下 shortcode 中较为重要的 API ，盼望有助于各位开发较为简单的 shortcode 。 四.函数 add_shortcode 该函数用于注册一个 shortcode

6、 ，它有两个参数：短代码名与 shortcode 处理函数名，引用上文的例子： function myshortcode_function($atts, $content = null) / $atts 代表了 shortcode 的各个参数，$content 为标签内的内容 extract(shortcode_atts(array( / 用法 extract 函数解析标签内的参数 title = 标题 / 给参数赋默认值，下面挺直调用 $ 加上参数名输出参数值 ), $atts); / 返回内容 return div class=myshortcode h3. $title ./h3 p .

7、 $content . /p /div; add_shortcode(msc, myshortcode_function); / 注册该 shortcode，以后用法 msc 标签调用该 shortcode msc 即为短代码名，以后在写文章或页面时可以挺直用法 msc/msc 标签调用该短代码，而 myshortcode_function 即为例子中的短代码处理函数的名称。下面重点分析短代码处理函数。 五.短代码处理函数 shortcode 处理函数是一个 shortcode 的核心， shortcode 处理函数类似于 Flickr（WordPress 过滤器），它们都接受特定参数，并返回

8、肯定的结果。 shortcode 处理器接受两个参数， $attr 和 $content ， $attr 代表 shortcode 的各个属性参数，从本质上来说是一个关联数组，而 $content 代表 shortcode 标签中的内容。 如上面的例子，若在文章内作出调用，输出一段欢迎语句： msc title=欢迎这是独立博客 Kayos Melody ，欢迎来到本博客/msc 当文章显示时， WordPress 会注册全部的 shortcode ，如上面的 msc ，若 shortcode 中有属性参数和内容， WordPress 会把它们分别出来并解析，然后传递给该 shortcode

9、的短代码处理函数，处理后以处理函数输出的结果代替短代码原本的内容显示在文章内。 这时属性参数会并解析会关联数组并传递给 $attr ，如上面的例子中 $attr 的值为如下的一个关联数组： array( title = 欢迎) 在输出结果时，可以挺直用法 $参数名 的形式进行输出，如例子中的状况即以 $title 输出该属性值。 六.shortcode_atts shortcode_atts 是一个很有用的函数，它可以为你需要的属性参数设置默认值，并且删除一些不需要的参数。 shortcode_atts() 包含两个参数 $defaults_array 与 $atts ， $attr 即为属性

10、参数集合， $defaults_array 是代表需要设置的属性默认值，举个例子： $result = shortcode_atts( array( title = 新标题, description = 描述内容 ), $atts ); $attr 依旧为 array( title = 欢迎) 这时 $result 的结果为 array( title = 新标题, description = 描述标题) title 由于在 $defaults_array 有不同的值，因此以这个新的值为准更新了 title ，同时也增加了 description 这个值。值得留意的是， shortcode_atts() 会过滤 $defaults_array 中没有的属性，假如 $attr 中还有一个 ohter 的属性，那么 $result 的结果仍旧是上面的结果，由于 $defaults_array 中并没有 other 这个属性。当然，这里说的值只是属性的默认值，真正输出的值还是 shortcode 调用时填写的值。 七.进一步解析属性与设置属性默认值 extract() 函数用于进一步解析属性并设置属性默认值，其中一个功能是把各属性参数值给予给一