Genesis框架从入门到精通（13）： 小部件函数

Genesis Explained系列中的上一篇文章是关于配置项函数的，并演示了一些用于从数据库中检索自定义字段和主题选项的重要函数。本文是关于 genesis/lib/functions/widgetize.php 文件的。 以下是文件中所有函数的列表:

• genesis_register_widget_area： 注册新的侧边栏
• genesis_register_sidebar：
• genesis_register_default_widget_areas：动作钩子的一部分，用于注册默认的侧边栏
• genesis_register_default_widget_areas_cb
• genesis_register_footer_widget_areas：动作钩子的一部分，注册页脚的侧边栏
• genesis_register_after_entry_widget_area 注册文章内容之后的侧边栏区域
• genesis_widget_area
• genesis_a11y_register_sidebar_defaults
• genesis_sidebar_title

在我们深入研究之前，我想先讨论一些名词术语。

侧边栏（Sidebar）

WordPress中的侧边栏术语是指主题中任何可以用于添加窗口小部件的部分。狭义的Sidebar通常就是指“侧边栏”，这也就是这个术语的原意，但是越来越多的高级主题把所有区域都当作侧边栏来使用。它们可能出现在网站头部区、页面内容区、侧边栏区或页脚区。有些人通常会把这些称作“小部件”，但这不准确，可能导致混淆。可以把它们叫做侧边栏或小部件区域。

侧边栏有几个重要部分。侧边栏名称，ID，小部件之前和之后，以及小部件的标题之前和标题之后。我们稍后会详细讨论这些内容。

窗口小部件（Widget）

小部件要放入侧边栏内。在WordPress中注册小部件需要扩展一个特殊的类，一个小部件包括有两个主要部分。后台和前端。在后台，可以将小部件拖动到侧边栏中。小部件放入侧边栏后，你还可以对其进行各种设置。如果窗口小部件无法找到它应该归属的侧边栏位置，则会被归入到非活动窗口小部件。当ID发生变化时会发生这种情况。后面我将再次讨论这个问题。前端就是是网站上实际出现的内容。

function genesis_register_widget_area( $args )

此函数只有一个参数，但它是一个数组值。内置默认值如下：

这里有一个过滤器“genesis_register_sidebar_defaults”可你让你更改任何默认值。如果你想要一个不同的标题或小部件区域，这是非常方便的。默认传递值被解析后，就会用register_sidebar()注册一个新的侧边栏。当然你可以直接使用register_siderbar()函数，但让我们看看Genesis函数的效率如何 。

两种方法都会创建相同的侧边栏，但Genesis的函数需要的信息要少得多。唯一的要求是名称和ID。你甚至可以省略ID，但我不推荐这么做。如果你的小部件有ID，那么它会呆在它该呆的地方。否则，如果侧边栏的顺序发生变化，那么你的窗口小部件将移动到其他侧边栏或非活动窗口小部件。

ID应为小写且没有空格。如果你想使用空格，那就在里面放一个“ – ”。这很重要，因为这个ID会被用作html中的ID，因此需要符合html标准。另外，如果有空格，WordPress可能会跟踪不到你的小部件。

当然，如果你想创建一个特殊侧边栏，可以更改默认值。

你可以通过取消注册来删除任何默认侧边栏。这是通过unregister_sidebar()函数完成的。只需将它放在您的functions.php文件中即可删除辅助侧边栏:

unregister_sidebar( 'sidebar-alt' );

当然，这在布局选项中还会保留。要删除它们，你需要删除布局中的选项。我将在下一次涉及layout.php文件时讨论这个问题。