WordPress开发中短代码的实现及相关函数使用技巧

 更新时间:2016年01月05日 17:30:16   作者:稍息少年  
这篇文章主要介绍了WordPress开发中短代码的实现及相关函数使用技巧,文中讲到了add_shortcode函数和shortcode_atts函数的用法,需要的朋友可以参考下

其实实现短代码很简单,我们只需要用到 WordPress 里面的一个函数就可以搞定短代码,外加自己的一个小函数,可以让短代码实现的轻松加愉快。

短代码实现原理
就像往 WP 一些动作里加钩子和过滤函数一样,
短代码只是经过封装了的针对文章输出内容的过滤器而已,
没有像有一些主题功能说的那么震撼、那么高深。
下面来一个简单例子:

function myName() {//短代码要处理的函数
return "My name's XiangZi !";
}
//挂载短代码
//xz为短代码名称 
//即你在编辑文章时输入[xz]就会执行 myName 函数
add_shortcode('xz', 'myName');

那么我们在文章中输入[xz]就会得到

My name's XiangZi !

短代码传参
更高深一点的利用,我将会在后面的文章中讲到,
今天只讲一下,短代码的传参机制
高级一点的例子

function myName($array,$content) {
var_dump($array);
var_dump($content);
}
 
add_shortcode('xz', 'myName');

编辑文章时我们输入:

[xz a="1" b="2" c="3"]这里是三个参数哦[/xz]

在函数中我们将得到:

//$array 是一个数组,
//大体结构如下
$array = array('a'=>'1','b'=>'2','c'=>'3');
//$content 是一个字符串
$content = '这里是三个参数哦';

shortcode_atts
不是因为搞短代码插件,我也不会用到这个函数,
shortcode_atts 函数主要是用来设置短代码中截获变量的初始值。
这是一个很实用的函数,其实这个函数的真正是作用在数组上得,
因为我们从短代码中截获的参数都是数组形式的。

shortcode_atts 函数详解
不要被函数名所疑惑,在 WordPress 里主要是用于设置短代码参数的默认值,
如果我们将代码提取出来,用在别的地方,该函数可以帮我们设置一个既得数组的默认值。

shortcode_atts 函数使用
这个函数使用起来很简单。

shortcode_atts(array(
"url" => 'http://PangBu.Com'
), $url)

以上代码的意思是,
将 $url 数组 键值为url的成员默认值设定为'http://PangBu.Com',
别的地方用处似乎不多,但对于一些超级懒人,有时候揽到总是忘记或是懒得设定数组的数值时,这个函数超好用。

shortcode_atts 函数声明

/**
 * Combine user attributes with known attributes and fill in defaults when needed.
 *
 * The pairs should be considered to be all of the attributes which are
 * supported by the caller and given as a list. The returned attributes will
 * only contain the attributes in the $pairs list.
 *
 * If the $atts list has unsupported attributes, then they will be ignored and
 * removed from the final returned list.
 *
 * @since 2.5
 *
 * @param array $pairs Entire list of supported attributes and their defaults.
 * @param array $atts User defined attributes in shortcode tag.
 * @return array Combined and filtered attribute list.
 */
function shortcode_atts($pairs, $atts) {
 $atts = (array)$atts;
 $out = array();
 foreach($pairs as $name => $default) {
 if ( array_key_exists($name, $atts) )
  $out[$name] = $atts[$name];
 else
  $out[$name] = $default;
 }
 return $out;
}

相关文章

  • PHP仿tp实现mvc框架基本设计思路与实现方法分析

    PHP仿tp实现mvc框架基本设计思路与实现方法分析

    这篇文章主要介绍了PHP仿tp实现mvc框架基本设计思路与实现方法,简单讲述了php实现tp框架的原理,并结合实例形式分析了相关控制器、视图及URL访问操作技巧与注意事项,需要的朋友可以参考下
    2018-05-05
  • php通过array_unshift函数添加多个变量到数组前端的方法

    php通过array_unshift函数添加多个变量到数组前端的方法

    这篇文章主要介绍了php通过array_unshift函数添加多个变量到数组前端的方法,涉及php中array_unshift函数操作数组的使用技巧,需要的朋友可以参考下
    2015-03-03
  • 破解图片防盗链的代码(asp/php)测试通过

    破解图片防盗链的代码(asp/php)测试通过

    许多的网站图片都加了防盗链措施,常见的新浪博客、网易相册、百度空间、QQ空间都不能外链图片,如果要先把图片保存到本地再上传,不免显得麻烦。
    2010-07-07
  • PHP大文件切割上传功能实例分析

    PHP大文件切割上传功能实例分析

    这篇文章主要介绍了PHP大文件切割上传功能,结合实例形式分析了php针对大文件切割上传的原理、实现方法及相关操作技巧,需要的朋友可以参考下
    2019-07-07
  • PHP人民币金额转大写实例代码

    PHP人民币金额转大写实例代码

    一个非常有趣的PHP人民币金额数字转中文大写实例代码与大家分享,感兴趣的小伙伴可以参考一下。
    2015-10-10
  • php采用file_get_contents代替使用curl实例

    php采用file_get_contents代替使用curl实例

    这篇文章主要介绍了php采用file_get_contents代替使用curl的方法,实例讲述了file_get_contents模拟curl的post方法,对于服务器不支持curl的情况来说有一定的借鉴价值,需要的朋友可以参考下
    2014-11-11
  • php使用GuzzleHttp实现HTTP请求

    php使用GuzzleHttp实现HTTP请求

    这篇文章主要为大家详细介绍了php如何使用GuzzleHttp实现HTTP请求,文中的示例代码讲解详细,具有一定的借鉴价值,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-11-11
  • php5.3 注意事项说明

    php5.3 注意事项说明

    本篇文章是对php5.3中需要注意的一些事项进行了详细的分析介绍,需要的朋友参考下
    2013-07-07
  • php生成excel文件的简单方法

    php生成excel文件的简单方法

    生成excel文件,最简单的莫过于把数据库的数据导入到excel就行了,下面有个不错的示例,大家可以参考下
    2014-02-02
  • Java中final关键字详解

    Java中final关键字详解

    这篇文章主要介绍了final关键字,通过final关键字的基本用法和对final关键字的理解展开,有需要的朋友可以参考下
    2015-08-08

最新评论