在WordPress中使用register_widget()注册自定义小部件

　　WordPress 中的函数register_widget用于注册自定义小部件，以用于 WordPress 主题或插件。此功能允许开发人员创建新的小部件，并使其可用于 WordPress 管理界面。这对于向 WordPress 网站添加自定义功能或内容非常有用，例如自定义菜单、社交媒体源或广告小部件。

　　通过使用该register_widget功能，开发人员可以通过创建和集成自定义小部件来扩展 WordPress 的功能，而无需修改平台的核心代码。这有助于保持代码库的整洁和模块化，使将来更容易维护和更新 WordPress 网站。

　　推荐：[最新版]WordPress SEO插件Rank Math Pro

register_widget()基本语法

描述

　　WordPress PHP register_widget()函数注册一个自定义小部件

用法

register_widget('My_Custom_Widget');

$widget (string|WP_Widget) – 必需。WP_Widget 子类的名称或 WP_Widget 子类的实例

　　推荐：如何增加WordPress中的最大上传文件大小

register_widget()函数

　　register_widget() 是 WordPress 中用于注册自定义小工具（Widget）的核心函数，开发者通过继承 WP_Widget 基类创建的小工具必须通过此函数注册才能生效,它的主要功能包括：兼容 WordPress 小工具系统的初始化流程（如 widgets_init 钩子）将自定义小工具添加到 WordPress 后台的小工具管理界面。实现小工具的动态渲染、数据保存和前端显示逻辑。（源文件可参考这里）

function register_widget( $widget ) {
	global $wp_widget_factory;

	$wp_widget_factory->register( $widget );
}

　　推荐：使用wp_set_post_tags()为WordPress帖子设置标签

如何使用register_widget()

　　如何在 WordPress 中注册自定义小部件，此代码片段使用 register_widget 函数注册自定义小部件类 My_Custom_Widget。my_custom_widget_init 函数与 widgets_init 操作挂钩，用于初始化自定义小部件。下面是如何使用该register_widget函数在 WordPress 中注册自定义小部件的示例：

function my_custom_widget_init() {
 register_widget( 'My_Custom_Widget' );
}
add_action( 'widgets_init', 'my_custom_widget_init' );

　　如何在 WordPress 中注册多个自定义小部件，此代码片段使用 register_widget 函数注册了多个自定义小部件类 Custom_Widget_1、Custom_Widget_2 和 Custom_Widget_3。my_custom_widgets_init 函数挂接到 widgets_init 操作中，用于初始化自定义小部件。下面是如何使用该register_widget函数在 WordPress 中注册多个自定义小部件的示例

function my_custom_widgets_init() {
 register_widget( 'Custom_Widget_1' );
 register_widget( 'Custom_Widget_2' );
 register_widget( 'Custom_Widget_3' );
}
add_action( 'widgets_init', 'my_custom_widgets_init' );

　　注册一个简单的文本小部件，此代码注册了一个名为“My Text Widget”的简单文本小部件

class My_Text_Widget extends WP_Widget {
  function __construct() {
    parent::__construct(
      'my_text_widget',
      __('My Text Widget', 'text_domain')
    );
  }
function widget($args, $instance) {
echo $args['before_widget'];
echo $args['before_title'] . apply_filters('widget_title', $instance['title']) . $args['after_title'];
echo '<p>' . esc_html($instance['text']) . '</p>';
echo $args['after_widget'];
}


function form($instance) {
$title = !empty($instance['title']) ? $instance['title'] : __('New title', 'text_domain');
$text = !empty($instance['text']) ? $instance['text'] : __('New text', 'text_domain');
?>
<p>
<label for="<?php echo $this->get_field_id('title'); ?>"><?php _e('Title:'); ?></label>
<input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo esc_attr($title); ?>">
</p>
<p>
<label for="<?php echo $this->get_field_id('text'); ?>"><?php _e('Text:'); ?></label>
<input class="widefat" id="<?php echo $this->get_field_id('text'); ?>" name="<?php echo $this->get_field_name('text'); ?>" type="text" value="<?php echo esc_attr($text); ?>">
</p>
<?php
}


function update($new_instance, $old_instance) {
$instance = array();
$instance['title'] = (!empty($new_instance['title'])) ? strip_tags($new_instance['title']) : '';
$instance['text'] = (!empty($new_instance['text'])) ? strip_tags($new_instance['text']) : '';
return $instance;
}
}


function register_my_text_widget() {
register_widget('My_Text_Widget');
}
add_action('widgets_init', 'register_my_text_widget');

　　register_widget功能是向 WordPress 网站添加自定义小部件的强大工具。通过此功能，开发人员可以轻松扩展其主题和插件的功能，为用户提供更加个性化和动态的体验。该函数能够指定小部件的类别和控制选项，因此register_widget提供了高度的灵活性和自定义性。对于希望为其 WordPress 项目创建独特且引人入胜的小部件的任何开发人员来说，这都是一款必不可少的工具。register_widget功能对于 WordPress 开发人员来说是一项宝贵的资产，使他们能够轻松地将自定义小部件集成到他们的项目中并增强用户体验。其简单的语法和强大的功能使其成为任何使用 WordPress 小部件的开发人员的必备工具。

　　推荐：WordPress函数使用手册