热搜：编程 Python Microsoft 编程语言 C++

编写和注册你的 WordPress 小工具

发布时间：2023-01-01 14:51:42 来源：互联网

.

每个人都渴望内心深处的成功，但问题是大多数人认为他们无法成功。他们不相信自己可以通过斗争获得成功。

本文是《一步步创建你的第一个 WordPress 小工具》专题的第 2 篇，共 5 篇：

创建你的第一个WordPress小工具
编写和注册你的 WordPress 小工具
为你的 WordPress 小工具创建表单
构建你的 WordPress 小工具
在正确的工具区域内显示你创建的WordPress小工具

本文是系列好代码教程《创建你的第一个WordPress小工具》的第二部分，向你展示如何创建属于你的第一个WordPress小工具。在第一部分的好代码教程中，你已经了解了WordPress小工具API（Application Programming Interface，应用程序编程接口）和the WP_Widget类。

你需要做的是

跟随本好代码教程，你需要

安装一个WordPress开发环境
一个代码编辑器

安装插件

首先你要做的是安装你的插件。在你的 wp-content/plugins 目录下创建一个新文件（可以命名为 tutsplus-list-subpages-widget），在该文件夹中新建一个名为“tutsplus-list-subpages-widget.php”的php文件。

将以下內容添加到文件中：

<?php 
/*Plugin Name: List Subpages Widget
Description: This widget checks if the current page has parent or child pages and if so, outputs a list of the highest ancestor page and its descendants. This file supports part 1 of the series to create the widget and doesn't give you a functioning widget.
Version: 0.1
Author: Rachel McCollin
Author URI: http://rachelmccollin.com
License: GPLv2
*/
?>

<?php /*Plugin Name: List Subpages Widget Description: This widget checks if the current page has parent or child pages and if so, outputs a list of the highest ancestor page and its descendants. This file supports part 1 of the series to create the widget and doesn't give you a functioning widget. Version: 0.1 Author: Rachel McCollin Author URI: http://rachelmccollin.com License: GPLv2 */ ?>

显然，你会想改掉作者的名字和url（网址），而这也恰好决定了WordPress在插件界面需要显示的内容。

保存你的插件文件。

创建小工具类

下一步就是创建一个新类来拓展 WP_Widget 类。

将以下代码复制到你的插件文件中：

<?php
class Tutsplus_List_Pages_Widget extends WP_Widget {

    function __construct() {
    }

    function form( $instance ) {
    }

    function update( $new_instance, $old_instance ) {       
    }

    function widget( $args, $instance ) {

    }

}
?>

<?php class Tutsplus_List_Pages_Widget extends WP_Widget { function __construct() { } function form( $instance ) { } function update( $new_instance, $old_instance ) { } function widget( $args, $instance ) { } } ?>

让我们来看一看这个新类包含些什么：

__construct 函数会完成你所期望的——它会构造一个函数。在这个函数里面你可以做出一些定义，比如WordPress小工具的ID、标题和说明。
form函数会在WordPress小工具界面创建表单，让用户来定制或者激活它。
update函数确保WordPress能及时更新用户在WordPress小工具界面输入的任何设置。
widget函数则定义了在网站前端通过WordPress小工具输出的内容。

最后这三个函数的参数我会在相关课程中做进一步详细的解释。

注册小工具

只有通过WordPress进行了注册，你的WordPress小工具才能工作。在你的新类下面加入以下函数和钩子：

<?php
function tutsplus_register_list_pages_widget() {

    register_widget( 'Tutsplus_List_Pages_Widget' );

}
add_action( 'widgets_init', 'tutsplus_register_list_pages_widget' );
?>

<?php function tutsplus_register_list_pages_widget() { register_widget( 'Tutsplus_List_Pages_Widget' ); } add_action( 'widgets_init', 'tutsplus_register_list_pages_widget' ); ?>

register_widget()函数是一个WordPress函数，它唯一的参数就是你刚刚创建的类的命名。

随后将你创建的函数挂入 widgets_init 钩子，确保它可以被WordPress拾起。