编辑“WordPressWidgets API”（章节）

==定义侧边栏==
下面这些函数可以使侧边栏在主题中正常显示。

'''注册多个侧边栏'''
 register_sidebars( $count, $args );  
注册一个或多个侧边栏以供当前主题使用。大多数主题都只有一个侧边栏。因此count参数不是必需参数，且默认值为1。

$args参数将被传递给register_sidebar()并遵循其格式，但参数名除外，若count参数值为双数，$args参数名将与sprintf()合作，在每个侧边栏中插入或添加一个唯一数字。

例如，以下代码会生成两个分别名为"Foobar 1"与 "Foobar 2"的侧边栏。

 register_sidebars(2, array('name'=>'Foobar %d'));  

注册一个侧边栏

register_sidebar( $args );  可选的args参数是一个关联数组，该关联数组将作为第一个参数被传递给所有已激活的widget回调。（若传递的是字符串而非数组，该参数将被parse_str()遍历，从而生成一个关联数组。）传递指定主题的[[HTML]]标签以包裹widget与其标题，这是参数的基本用法。下面是参数默认值：

 'before_widget' => '< li id="%1$s" class="widget %2$s">',
 'after_widget' => "</li>n",
 'before_title' => '< h2 class="widgettitle">',
 'after_title' => "</h2>n" 

只有在你希望为侧边栏赋予独有名称时，如"Right Sidebar"与"Left Sidebar"，或侧边栏需要被特别标记时，才有必要使用register_sidebar函数而不是register_sidebars函数。侧边栏名称只出现在管理面板中，但也会被用作一个保存侧边栏排列的索引。因此，如果有另一个主题使用相同的侧边栏名称，那么侧边栏就可以再利用并重写它们的排列。

before/after参数的默认值适用于可生成带有“h2”标题的列表型侧边栏的主题。我们推荐所有主题都采用这种侧边栏，以这种方式构建的主题可以轻松注册侧边栏而无需担心before/after标签。如果主题由于某些原因无法以这种方式构建，那么注册侧边栏时一定要指定before/after标签。推荐逐字复制id和class属性，以使内部sprintf调用得以运行，[[CSS]]样式也能够被应用到单个widget上。

'''在主题上显示侧边栏'''

dynamic_sidebar( $sidebar );  该函数按顺序逐个调用已启用的widget，从而输出侧边栏的框架。如果你有不止一个侧边栏，你需要向该函数指明你希望输出的侧边栏名称或编号。若显示成功，该函数返回TRUE，若失败则返回FALSE。

用返回的值决定是否显示静态侧边栏。这可保证即使在未激活widgets插件的情况下，主题也能够正常显示。下面是对该函数推荐用法，附带一个可避免致命错误的测试。

 < ul id="sidebar">
 <?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar() ) : ?>
 < li>{static sidebar item 1}</li>
 < li>{static sidebar item 2}</li>
 <?php endif; ?>
 </ul> 

如果按编号注册侧边栏，那么检索时应该按编号检索。如果按名称注册侧边栏，检索时也应按名称检索。
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*