在WordPress中使用the_widget()显示特定小部件

　　WordPress 中的此the_widget功能是显示网站特定区域的小部件的有用工具。它允许开发人员轻松地将小部件添加到他们的主题中，而无需为每个小部件编写自定义代码。这可以节省时间和精力，尤其是在使用跨网站不同区域的多个小部件时。

　　通过使用该the_widget功能，开发人员可以快速高效地向其主题添加小部件，从而更轻松地自定义其网站的布局和功能。这对于可能不习惯编写代码的非技术用户特别有用，因为它提供了一种向其网站添加功能的简单方法，而无需了解底层代码。

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

the_widget()基本语法

描述

　　WordPress PHP the_widget()函数将任意小部件输出为模板标签

用法

the_widget( $widget, $instance, $args );

$widget (字符串) (必需)小部件的 PHP 类名（参见 class-wp-widget.php）。
$instance（数组）小部件的实例设置。默认值：空数组
$args （数组）用于配置小部件显示的参数数组。默认值：array()
before_widget (字符串)将添加到小部件 HTML 输出的 HTML 内容。默认值：<div class=”widget %s”>，其中%s是小部件的类名
after_widget （字符串）将附加到小部件的 HTML 输出的 HTML 内容。默认值：</div>
before_title （字符串）显示时将添加到小部件标题前面的 HTML 内容。默认值：<h2 class=”widgettitle”>
after_title （字符串）显示时将附加到小部件标题的 HTML 内容。默认值：</h2>

the_widget()函数

　　the_widget() 是一个 WordPress 模板标签函数，用于直接在主题模板中输出注册的小工具，无需通过后台小工具管理界面添加到侧边栏区域。它特别适用于需要将小工具“硬编码”到主题特定位置（如页脚、自定义布局区块等）的场景（源文件可参考这里）

function the_widget( $widget, $instance = array(), $args = array() ) {
	global $wp_widget_factory;

	if ( ! isset( $wp_widget_factory->widgets[ $widget ] ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: register_widget() */
				__( 'Widgets need to be registered using %s, before they can be displayed.' ),
				'<code>register_widget()</code>'
			),
			'4.9.0'
		);
		return;
	}

	$widget_obj = $wp_widget_factory->widgets[ $widget ];
	if ( ! ( $widget_obj instanceof WP_Widget ) ) {
		return;
	}

	$default_args          = array(
		'before_widget' => '<div class="widget %s">',
		'after_widget'  => '</div>',
		'before_title'  => '<h2 class="widgettitle">',
		'after_title'   => '</h2>',
	);
	$args                  = wp_parse_args( $args, $default_args );
	$args['before_widget'] = sprintf( $args['before_widget'], $widget_obj->widget_options['classname'] );

	$instance = wp_parse_args( $instance );

	/** This filter is documented in wp-includes/class-wp-widget.php */
	$instance = apply_filters( 'widget_display_callback', $instance, $widget_obj, $args );

	if ( false === $instance ) {
		return;
	}

	/**
	 * Fires before rendering the requested widget.
	 *
	 * @since 3.0.0
	 *
	 * @param string $widget   The widget's class name.
	 * @param array  $instance The current widget instance's settings.
	 * @param array  $args     An array of the widget's sidebar arguments.
	 */
	do_action( 'the_widget', $widget, $instance, $args );

	$widget_obj->_set( -1 );
	$widget_obj->widget( $args, $instance );
}

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

如何使用the_widget()

　　如何使用 the_widget 函数显示特定的小部件，此代码片段将在您的 WordPress 网站前端显示最近的帖子小部件。以下是使用 the_widget 函数在 WordPress 中显示特定小部件的示例：

<?php
 the_widget( 'WP_Widget_Recent_Posts' );
?>

　　如何使用 the_widget 函数自定义小部件参数，此代码片段将显示带有自定义标题和帖子数量的最近帖子小部件，以显示在 WordPress 网站前端。以下是使用 the_widget 函数自定义 WordPress 中小部件参数的示例：

<?php
 $widget_params = array(
 'title' => 'Custom Recent Posts',
 'number' => 5
 );
 the_widget( 'WP_Widget_Recent_Posts', $widget_params );
?>

　　如何使用 the_widget 函数有条件地显示小部件，此代码片段将检查 ID 为“sidebar-1”的侧边栏是否处于活动状态，如果是，它将在 WordPress 网站前端显示最近的帖子小部件。以下是使用 the_widget 函数在 WordPress 中有条件地显示小部件的示例：

<?php
 if ( is_active_sidebar( 'sidebar-1' ) ) {
 the_widget( 'WP_Widget_Recent_Posts' );
 }
?>

　　the_widget功能是用于在 WordPress 中添加和显示小部件的强大工具。它的灵活性和易用性使其成为希望自定义网站的开发人员和网站所有者的宝贵资产。通过利用的功能the_widget，用户可以轻松地将各种功能和设计元素整合到他们的 WordPress 网站中，从而增强整体用户体验。无论是显示最近的帖子、热门标签还是自定义内容，the_widget该功能都提供了一种直接有效的方式。

　　推荐：WordPress函数使用手册