600 次 

 WordPress函数the_widget()

描述：

在侧边栏外显示任意小工具。它可以在模板中的任何位置使用。

用法：

<?php the_widget( $widget, $instance, $args ); ?>

参数：

$widget (
string) 必填 小工具的php类名 WordPress中包含的小工具的类是：

  • WP_Widget_Archives — Archives
  • WP_Widget_Calendar — Calendar
  • WP_Widget_Categories — Categories
  • WP_Widget_Links — Links
  • WP_Widget_Meta — Meta
  • WP_Widget_Pages — Pages
  • WP_Widget_Recent_Comments — Recent Comments
  • WP_Widget_Recent_Posts — Recent Posts
  • WP_Widget_RSS — RSS
  • WP_Widget_Search — Search (a search from)
  • WP_Widget_Tag_Cloud — Tag Cloud
  • WP_Widget_Text — Text
  • WP_Nav_Menu_Widget

默认值:
None
$instance (
array|string) (
可选) 小工具的实例设置。数组或字符串。请参阅下面的每个小工具以获取示例。 默认值: 
array()
$args (
array|string) (
可选)
小工具的查询参数。数组或字符串。如果为空，则默认为： before_widget (string) 在输出的小工具前面添加的信息 Default： <div class=”widget {widget’s classname}”> after_widget (string) 在输出的小工具之后添加的信息 Default： </div> before_title (string) 小工具标题之前的信息. Default： <h2 class=”widgettitle”> after_title (string) 小工具标题之后的信息. Default： </h2> 默认值: 
array() 

function the_widget( $widget, $instance = array(), $args = array() ) {
    global $wp_widget_factory;
 
    if ( ! isset( $wp_widget_factory->widgets[ $widget ] ) ) {
        /* translators: %s: register_widget() */
        _doing_it_wrong( __FUNCTION__, sprintf( __( '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 );
 
    /**
     * 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-includes/widgets.php

«
»
收藏夹