WordPress中用于创建以及获取侧边栏的PHP函数讲解
<p><strong>register_sidebar()（创建侧边栏）</strong><br>
建立一个侧边栏，用来放置小工具。这个函数使用的时候请放在一个函数里，挂载到 “widgets_init” 钩子。</p>
<p>
用法</p>
<div>
<div>
<div id="highlighter_910750">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>register_sidebar( </code><code>$args</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
参数</p>
<p>
$args</p>
<p>
（字符串 | 数组）（可选）要创建的侧边栏的参数。</p>
<p>
默认值：</p>
<div>
<div>
<div id="highlighter_37658">
<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>
</td>
<td>
<div>
<div>
<code>$args</code> <code>= </code><code>array</code><code>(</code>
</div>
<div>
<code> </code><code>'name'</code> <code>=> __( </code><code>'Sidebar name'</code><code>, </code><code>'theme_text_domain'</code> <code>),</code>
</div>
<div>
<code> </code><code>'id'</code> <code>=> </code><code>'unique-sidebar-id'</code><code>,</code>
</div>
<div>
<code> </code><code>'description'</code> <code>=> </code><code>''</code><code>,</code>
</div>
<div>
<code> </code><code>'class'</code> <code>=> </code><code>''</code><code>,</code>
</div>
<div>
<code> </code><code>'before_widget'</code> <code>=> </code><code>'<li id="%1">'</code><code>,</code>
</div>
<div>
<code> </code><code>'after_widget'</code> <code>=> </code><code>'</li>'</code><code>,</code>
</div>
<div>
<code> </code><code>'before_title'</code> <code>=> </code><code>'<h2>'</code><code>,</code>
</div>
<div>
<code> </code><code>'after_title'</code> <code>=> </code><code>'</h2>'</code>
</div>
<div>
<code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
数组参数介绍：</p>
<ul>
<li>
name：侧边栏名称</li>
<li>
id：侧边栏 ID，必须为小写，默认为递增的数组 ID</li>
<li>
description：侧边栏描述</li>
<li>
class：给其中的小工具的额外 class</li>
<li>
before_widget：里边的小工具的开头 Html 代码</li>
<li>
after_widget：里边的小工具的末尾的 Html 代码</li>
<li>
before_title：里边的小工具的标题的开头 Html 代码</li>
<li>
after_title：里边的小工具的标题的末尾的 Html 代码</li>
</ul>
<p>
例子</p>
<div>
<div>
<div id="highlighter_625477">
<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>register_sidebar( </code><code>array</code><code>(</code>
</div>
<div>
<code> </code><code>'name'</code> <code>=> __( </code><code>'右边的侧边栏'</code> <code>),</code>
</div>
<div>
<code> </code><code>'id'</code> <code>=> </code><code>'sidebar-1'</code><code>,</code>
</div>
<div>
<code> </code><code>'description'</code> <code>=> __( </code><code>'右侧边栏的小工具。'</code> <code>),</code>
</div>
<div>
<code> </code><code>'before_title'</code> <code>=> </code><code>'<h3>'</code><code>,</code>
</div>
<div>
<code> </code><code>'after_title'</code> <code>=> </code><code>'</h3>'</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>
<p>
该函数位于：wp-includes/widgets.php</p>
<p>
<strong>get_sidebar()（获取侧边栏）</strong><br>
get_sidebar() 用来引入侧边栏模板。如果指定名称则引入当前主题根目录的 sidebar-{name}.php 文件，不指定则引入当前主题根目录的 sidebar.php 文件，如果文件不存在则引入 wp-includes/theme-compat/sidebar.php 文件。</p>
<p>
用法</p>
<div>
<div>
<div id="highlighter_883000">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>get_sidebar( </code><code>$name</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
参数</p>
<p>
$name</p>
<p>
（字符串）（可选）引入模板的名称，如果指定则引入当前主题根目录的 sidebar-{$name}.php 文件。</p>
<p>
默认值：None</p>
<p>
例子</p>
<p>
下边的代码将引入当前主题根目录的 sidebar.php 文件：</p>
<div>
<div>
<div id="highlighter_417064">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code><?php get_sidebar(); ?></code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
下边的代码将引入当前主题根目录的 sidebar-left.php 文件：</p>
<div>
<div>
<div id="highlighter_320892">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code><?php get_sidebar( </code><code>'left'</code> <code>); ?></code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
下边的例子分别引入了左侧边栏（sidebar-left.php）和右侧边栏（sidebar-right.php）：</p>
<div>
<div>
<div id="highlighter_328552">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
</td>
<td>
<div>
<div>
<code><?php get_header(); ?></code>
</div>
<div>
<code><?php get_sidebar( </code><code>'left'</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_299341">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
</td>
<td>
<div>
<div>
<code><?php get_sidebar( </code><code>'right'</code> <code>); ?></code>
</div>
<div>
<code><?php get_footer(); ?></code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
其它</p>
<p>
此函数位于：wp-includes/general-template.php</p>
頁:
[1]