首页 > wordpress开发 > wordpress主题开发 > wordpress主题开发Widgets
摘要:小部件将内容和功能添加到小部件区域(也称为侧边栏)。 wordpress主题开发小部件区域为用户定制其网站提供了一种方式...

小部件将内容和功能添加到小部件区域(也称为侧边栏)。 wordpress主题开发小部件区域为用户定制其网站提供了一种方式。 窗口小部件区域可以显示在多个页面上或仅在一个页面上。 您的主题可能只有一个小部件区域或其中许多。

可以使用小部件区域的一些示例如下:

  • 使用小部件布置首页。 这允许网站所有者决定在其主页的每个部分应该出现什么。
  • 创建一个页脚,用户可以使用自己的内容进行自定义。
  • 向博客添加可自定义的侧边栏。
  • 小部件是输出一些HTML的PHP对象。 相同类型的小部件可以在同一页面上多次使用(例如,文本小部件)。 小部件可以将数据保存在数据库中(在选项表中)。

当您创建一种新的小部件时,它将显示在用户的“管理屏幕”的“外观”>“小部件”中。 用户可以将窗口小部件添加到窗口小部件区域,并从WordPress管理员自定义窗口小部件设置。

内置和独立的小部件

默认WordPress安装包含一组小部件。 除了这些标准的小部件,主题或插件可以包含额外的小部件。 内置在主题或插件中的小部件的优点是提供额外的功能并增加小部件的数量。

缺点是,如果主题已更改或插件被停用,插件或主题小部件的功能将会丢失。 但是,如果重新激活主题或插件,则小部件的数据和首选项将保存到选项表,并恢复。

如果您的主题包含小部件,则只有在该主题处于活动状态时才能使用。 如果用户决定改变他们的主题,他们将无法访问该小部件。 但是,如果插件包含插件,则用户可以更改其主题,而不会失去对窗口小部件功能的访问。

小部件解剖

视觉上,一个小部件包括两个方面:

  • 标题区
  • 小部件选项

例如,这里是管理员和前端内置文本小部件的布局:

  • 示例可编辑小部件
  • 管理区域中的小部件表单。

一个小部件,因为它可以访问一个网站访问者。网站访问者看到的小部件。此小部件的HTML输出如下所示:

每个小部件都有自己的方式输出与正在显示的数据相关的HTML。 小部件的包装器标签由其正在显示的小部件区域定义。

PHP需要创建一个内置的文本小部件,如下所示:

上面的代码将在后面的文章中详细解释。

开发小部件

要创建和显示窗口小部件,您需要执行以下操作:

  • 通过扩展标准的WP_Widget类及其一些功能来创建小部件的类。
  • 注册您的小部件,以便它可以在Widgets屏幕中使用。
  • 确保您的主题至少有一个小部件区域添加小部件。

你的小部件类

WP_Widget类位于wp-includes / widgets.php中

每个这些功能的文档可以在窗口小部件类代码中找到:

  • __construct:在管理员中设置具有说明,名称和显示宽度的小部件。
  • widget:处理小部件选项并在页面上显示HTML。 $ args参数提供了HTML可以用来显示窗口小部件标题类和窗口小部件内容类。
  • form:显示用于设置窗口小部件选项的窗体。 如果您的窗口小部件没有任何选项,则可以跳过此功能(尽管即使空白也是最佳做法)。
  • update:将小部件选项保存到数据库。 如果您的窗口小部件没有任何选项,则可以跳过此功能(尽管即使空白也是最佳做法)。

注册小部件

register_widget()函数用于注册一个小部件。

使用widgets_init钩子调用此函数:

然后可以在widgets_init钩子中注册此示例窗口小部件:

##使用命名空间的示例

如果您使用PHP 5.3命名空间,则应直接调用构造函数,如下例所示:

并使用以下命令调用注册窗口

有关详细信息,请参阅堆栈交换中的此答案。

特殊考虑

如果要在其他模板文件中使用小部件,而不是侧边栏,则可以the_widget()以编程方式显示。 该函数接受窗口小部件类名。 您将小部件类名称传递给这样的函数:

如果您需要在页面上的特定区域中使用窗口小部件,则可能需要使用此方法,例如在网站首页的某个部分中显示表单旁边的事件列表,或者显示电子邮件捕获表单 一个超级菜单旁边的导航。

分享到:
赞(0) 打赏

作者: 大挖酱

挖主题团队自2014年开始专注于WordPress企业主题设计开发,致力于为更多用户打造出更漂亮、更易用、更专业的网站。距今已累计开发近50款WP主题,付费客户超过5千人。挖主题,是您可以长期信赖的合作伙伴。

81 queries in 1.060 seconds

联系作者Q: 8413708 WX: zdmin7

支付宝扫一扫

微信扫一扫