如何创建你的第一个Wordpress widget

King| 2015-03-03 WordPress, 教程 评论数( 1 )

对于不擅长编写代码的用户,widget是他们创建WordPress网站时的得力助手。通过添加widget可以在网站主题允许的区域添加菜单、列表、文本等等。

我们将通过五个部分的系列教程,带你成功创建您的第一个widget。

如何创建你的第一个Wordpress widget

该系列包括以下五个教程:

  1. widget及Wideget API的介绍
  2. 编写并注册你的widget
  3.  构建你的widget
  4. 为你的widget创建表单
  5. 在正确的小工具区域显示你创建的widget

第一个部分主要给大家介绍widget以及Widget API。

创建widget

想要创建一个widget,首先要创建一个包含以下功能函数的类来扩展WP_Widget类。

  • 一个处理widget的函数
  • 一个用于在widget仪表盘界面显示widget表单的函数
  • 一个给用户更新widget设置的函数
  • 一个在任何小工具区域输出widget的函数

除此之外你还需要用函数register_widget()对创建的widget进行注册。

在构建widget时,你可以添加许多内容到widget中,比如:静态文本、从数据库中查询输出的内容以及其他网站的订阅资料等等。需要大家注意的是:由于你的widget需要适应页面上定义的区域,所以你的widget的输出不要太大。

另外,WordPress带有内置的widget数组,所以,在编辑你的widget之前首先要检查在WordPress核心内是否已经存在该widget。

Widget API

Widget API中包括你创建widget的过程中所需要的所有功能函数。该API具体内容如下

首先给大家介绍四个widget函数

1、is_active_widget():这是一个条件标签,用于检查单一widget是否处于活动状态。切记不要与函数:is_active_sidebar()混淆,这个函数用来检查widget是否已经被添加到特定的小工具区域。

2、the_widget():这是一个模板标签,用于在小工具区域以外显示widget的函数。

3、register_widget():该函数用来注册编写好的widget,在该系列后面的教程中会用到该函数。

4、unregister_widget():通过这个函数可以注销一个widget,widget被注销后,用户将无法在小工具界面使用该widget。

Widget API中除了上述的四个widget函数还包括以下五个内部函数。

1、wp_register_widget_control():在widget界面上创建控制选项,以便用户对widget的设置进行修改。

2、wp_unregister_widget_control():用来对通过 wp_register_widget_control()注册的widget进行注销

3、wp_convert_widget_settings():该函数可以将单一widget的设置装换到多个widget设置中

4、wp_get_widget_defaults():核心函数,不向插件或主题开发者提供使用。

5、wp_widget_description():用于创建一个可以在widget界面显示的widget描述。

要访问这些内部功能,需要用到WP_Widget类。这是一个构造函数类,可以对它进行扩展来创建额外的widget。

小结

希望该教程可以激发起你对创建自己的widget的兴趣。接下来的教程中我们将为您介绍如何编写和注册你的widget。

 

 

 

 

聚焦云计算,扫描二维码,关注HostUCan云计算

有好的文章希望站长之间帮助分享推广,猛戳这里我要投稿

您需要登录后才可以评论登录|注冊

全部评论(1)

2017-08-16 15:44
聚币网:http://www.yueweipanw.com  领先的数字货币交易平台。
[回复]
[取消回复]