the_widget

Выводит указанный виджет за пределами сайдбара. Можно использовать в любом месте шаблона.

Хуки из функции:
the_widget
Возвращает

Ничего. Выводит на экран HTML код виджета.

Использование

the_widget( $widget, $instance, $args );
$widget(строка) (обязательный)
Название PHP класса, который отвечает за виджет. см. /wp-includes/default-widgets.php. Список ниже…
$instance(массив/строка)

параметры виджета (настройки экземпляра класса).

Можно указать: массив array('dropdown'=>'1') или строку запроса: ‘dropdown=1&count=1’.

Какие параметры у каждого виджета смотрите ниже. Или зайдите в админку WP Внешний вид > Виджеты, активируйте нужный виджет и посмотрите какие у него есть параметры. Чтобы узнать конкретное название параметра, смотрите последнее значение атрибута name у поля виджета, например у виджета «облако меток» поле «заголовок» равно name="widget-tag_cloud[2][title]" – значит настройка будет – title.

oblako

По умолчанию: array()

$args(массив)

Массив параметров для изменения отображения виджета. Может быть:

  • before_widget (строка)
    HTML который будет добавлен перед кодом виджета.
    По умолчанию: <div class="widget %s">, где %s class виджета.

  • after_widget (строка)
    HTML который будет добавлен после кода виджета.
    По умолчанию: </div>

  • before_title (строка)
    HTML который будет добавлен перед кодом заголовка виджета.
    По умолчанию: <h2 class="widgettitle">

  • after_title (строка)
    HTML который будет добавлен после кода заголовка виджета.
    По умолчанию: </h2>

По умолчанию: array()

Базовые виджеты WordPress

Оглавление ▴


  • WP_Widget_Archives – архивы


  • WP_Widget_Calendar – календарь


  • WP_Widget_Categories – рубрики


  • WP_Widget_Meta – вход/выход и мета данные


  • WP_Widget_Pages – постоянные страницы


  • WP_Widget_Recent_Comments – последние комментарии


  • WP_Widget_Recent_Posts – последние записи


  • WP_Widget_RSS – RSS


  • WP_Widget_Search – поиск


  • WP_Widget_Tag_Cloud – облако меток


  • WP_Widget_Text – произвольные текст


  • WP_Nav_Menu_Widget – меню


  • Произвольный виджет

WP_Widget_Archives – архивы

the_widget( 'WP_Widget_Archives', $instance, $args );
  • Код виджета
  • classname: widget_archive
  • id_base: archives

Возможные элементы $instance:

title(строка)
Заголовок виджета.
По умолчанию: __(‘Archives’)
count(число)
Сколько постов для каждого архива выводить. Параметр show_post_count для функции wp_get_archives().
По умолчанию: 0 (спрятать)
dropdown(логический)
1 – как выдающий список. 0 – как ul список.
По умолчанию: 0 (ul список)

Примеры:

Базовый вывод:

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

Выпадающий список:

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

	$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);
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *