WordPress开发中短代码的实现及相关函数使用技巧
<p>其实实现短代码很简单，我们只需要用到 WordPress 里面的一个函数就可以搞定短代码，外加自己的一个小函数，可以让短代码实现的轻松加愉快。</p>
<p>
<strong>短代码实现原理</strong><br>
就像往 WP 一些动作里加钩子和过滤函数一样，<br>
短代码只是经过封装了的针对文章输出内容的过滤器而已，<br>
没有像有一些主题功能说的那么震撼、那么高深。<br>
下面来一个简单例子：</p>
<div>
<div>
<div id="highlighter_706366">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
<div>
7</div>
</td>
<td>
<div>
<div>
<code>function</code> <code>myName() {</code><code>//短代码要处理的函数</code>
</div>
<div>
<code>return</code> <code>"My name's XiangZi !"</code><code>;</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code>//挂载短代码</code>
</div>
<div>
<code>//xz为短代码名称 </code>
</div>
<div>
<code>//即你在编辑文章时输入就会执行 myName 函数</code>
</div>
<div>
<code>add_shortcode(</code><code>'xz'</code><code>, </code><code>'myName'</code><code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
那么我们在文章中输入就会得到</p>
<div>
<div>
<div id="highlighter_120427">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>My name's XiangZi !</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
<strong>短代码传参</strong><br>
更高深一点的利用，我将会在后面的文章中讲到，<br>
今天只讲一下，短代码的传参机制<br>
高级一点的例子</p>
<div>
<div>
<div id="highlighter_48050">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
</td>
<td>
<div>
<div>
<code>function</code> <code>myName(</code><code>$array</code><code>,</code><code>$content</code><code>) {</code>
</div>
<div>
<code>var_dump(</code><code>$array</code><code>);</code>
</div>
<div>
<code>var_dump(</code><code>$content</code><code>);</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code> </code>
</div>
<div>
<code>add_shortcode(</code><code>'xz'</code><code>, </code><code>'myName'</code><code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
编辑文章时我们输入：</p>
<div>
<div>
<div id="highlighter_262602">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>这里是三个参数哦</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
在函数中我们将得到：</p>
<div>
<div>
<div id="highlighter_318729">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
</td>
<td>
<div>
<div>
<code>//$array 是一个数组，</code>
</div>
<div>
<code>//大体结构如下</code>
</div>
<div>
<code>$array</code> <code>= </code><code>array</code><code>(</code><code>'a'</code><code>=></code><code>'1'</code><code>,</code><code>'b'</code><code>=></code><code>'2'</code><code>,</code><code>'c'</code><code>=></code><code>'3'</code><code>);</code>
</div>
<div>
<code>//$content 是一个字符串</code>
</div>
<div>
<code>$content</code> <code>= </code><code>'这里是三个参数哦'</code><code>;</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
<strong>shortcode_atts</strong><br>
不是因为搞短代码插件，我也不会用到这个函数，<br>
shortcode_atts 函数主要是用来设置短代码中截获变量的初始值。<br>
这是一个很实用的函数，其实这个函数的真正是作用在数组上得，<br>
因为我们从短代码中截获的参数都是数组形式的。</p>
<p>
shortcode_atts 函数详解<br>
不要被函数名所疑惑，在 WordPress 里主要是用于设置短代码参数的默认值，<br>
如果我们将代码提取出来，用在别的地方，该函数可以帮我们设置一个既得数组的默认值。</p>
<p>
shortcode_atts 函数使用<br>
这个函数使用起来很简单。</p>
<div>
<div>
<div id="highlighter_55942">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
</td>
<td>
<div>
<div>
<code>shortcode_atts(</code><code>array</code><code>(</code>
</div>
<div>
<code>"url"</code> <code>=> </code><code>'http://PangBu.Com'</code>
</div>
<div>
<code>), </code><code>$url</code><code>)</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
以上代码的意思是，<br>
将 $url 数组 键值为url的成员默认值设定为'http://PangBu.Com',<br>
别的地方用处似乎不多，但对于一些超级懒人，有时候揽到总是忘记或是懒得设定数组的数值时，这个函数超好用。</p>
<p>
shortcode_atts 函数声明</p>
<div>
<div>
<div id="highlighter_892269">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
<div>
7</div>
<div>
8</div>
<div>
9</div>
<div>
10</div>
<div>
11</div>
<div>
12</div>
<div>
13</div>
<div>
14</div>
<div>
15</div>
<div>
16</div>
<div>
17</div>
<div>
18</div>
<div>
19</div>
<div>
20</div>
<div>
21</div>
<div>
22</div>
<div>
23</div>
<div>
24</div>
<div>
25</div>
<div>
26</div>
<div>
27</div>
</td>
<td>
<div>
<div>
<code>/**</code>
</div>
<div>
<code> </code><code>* Combine user attributes with known attributes and fill in defaults when needed.</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* The pairs should be considered to be all of the attributes which are</code>
</div>
<div>
<code> </code><code>* supported by the caller and given as a list. The returned attributes will</code>
</div>
<div>
<code> </code><code>* only contain the attributes in the $pairs list.</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* If the $atts list has unsupported attributes, then they will be ignored and</code>
</div>
<div>
<code> </code><code>* removed from the final returned list.</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @since 2.5</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @param array $pairs Entire list of supported attributes and their defaults.</code>
</div>
<div>
<code> </code><code>* @param array $atts User defined attributes in shortcode tag.</code>
</div>
<div>
<code> </code><code>* @return array Combined and filtered attribute list.</code>
</div>
<div>
<code> </code><code>*/</code>
</div>
<div>
<code>function</code> <code>shortcode_atts(</code><code>$pairs</code><code>, </code><code>$atts</code><code>) {</code>
</div>
<div>
<code> </code><code>$atts</code> <code>= (</code><code>array</code><code>)</code><code>$atts</code><code>;</code>
</div>
<div>
<code> </code><code>$out</code> <code>= </code><code>array</code><code>();</code>
</div>
<div>
<code> </code><code>foreach</code><code>(</code><code>$pairs</code> <code>as</code> <code>$name</code> <code>=> </code><code>$default</code><code>) {</code>
</div>
<div>
<code> </code><code>if</code> <code>( </code><code>array_key_exists</code><code>(</code><code>$name</code><code>, </code><code>$atts</code><code>) )</code>
</div>
<div>
<code> </code><code>$out</code><code>[</code><code>$name</code><code>] = </code><code>$atts</code><code>[</code><code>$name</code><code>];</code>
</div>
<div>
<code> </code><code>else</code>
</div>
<div>
<code> </code><code>$out</code><code>[</code><code>$name</code><code>] = </code><code>$default</code><code>;</code>
</div>
<div>
<code> </code><code>}</code>
</div>
<div>
<code> </code><code>return</code> <code>$out</code><code>;</code>
</div>
<div>
<code>}</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
</p>
頁:
[1]