the_widget() — позволяет вывести виджет непосредственно через PHP, за пределами сайдбара

Функция выводит указанный виджет в любой части сайта. Все параметры выводимого виджета можно настроить во втором аргументе функции.

the_widget($widget, $instance = array(), $args = array())

$widget

(строка) PHP-класс виджета. Перечислю классы стандартных виджетов 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 — Произвольное меню;

$instanse

(строка|массив) массив или строка с параметрами виджета (каждый виджет имеет собственные параметры, какие именно смотрите ниже).

Параметры виджетов вы также можете посмотреть сами, для этого в админке переходим во Внешний вид > Виджеты, затем перетаскиваем интересующий нас виджет в сайдбар и видим его параметры:

$args

(массив|строка) массив или строка с параметрами, которые обычно задаются при регистрации сайдбара (некоторые из них). Cписок значений параметров следующий:

before_widget

Текст или HTML-код, который будет добавлен перед виджетом, по умолчанию: <div class="widget {класс виджета}">

after_widget

Текст или HTML-код, который будет добавлен после виджета, по умолчанию: </div>

before_title

Текст или HTML-код перед заголовком виджета, по умолчанию: <h2 class="widgettitle">

after_title

Текст или HTML-код после заголовка виджета, по умолчанию: </h2>

Параметры виджетов вы также можете посмотреть сами, для этого в админке переходим во Внешний вид > Виджеты, затем перетаскиваем интересующий нас виджет в сайдбар и видим его параметры:

before_widget

Текст или HTML-код, который будет добавлен перед виджетом, по умолчанию: <div class="widget {класс виджета}">

after_widget

Текст или HTML-код, который будет добавлен после виджета, по умолчанию: </div>

before_title

Текст или HTML-код перед заголовком виджета, по умолчанию: <h2 class="widgettitle">

after_title

Текст или HTML-код после заголовка виджета, по умолчанию: </h2>

Описание стандартных виджетов в WordPress и их параметров

Виджет «Архивы»

Выводит ссылки на страницы архивов по месяцам. Параметры:

title

(строка) Заголовок виджета архивов на сайте, по умолчанию __('Archives').

count

(логическое) Нужно ли рядом со ссылками отображать количество постов (является аналогом параметра show_post_count функции wp_get_archives()), значение по умолчанию — false (т.е. не отображать).

dropdown

(логическое) true — выводить выпадающий список в виде <select>, false (по умолчанию) — маркированный список <ul>.

Примеры использования:

the_widget( 'WP_Widget_Archives' );

the_widget( 'WP_Widget_Archives', array('title' => 'Мой виджет', 'count' => true, 'dropdown' => true) );

the_widget( 'WP_Widget_Archives', 'title=Мой виджет&dropdown=1' );

Виджет «Календарь»

Выводит календарь, на котором отображаются даты публикации постов. Его удобно использовать для навигации по страницам архивов постов.

Параметры:

title

(строка) Заголовок виджета, по умолчанию без заголовка

Пример:

the_widget( 'WP_Widget_Calendar' );

Виджет «Рубрики»

Позволяет вывести список рубрик блога.

Параметры:

title

(строка) Заголовок виджета, по умолчанию __(' Categories')

count

(логическое) Нужно ли отображать количество постов рядом с названием рубрики, аналог параметра show_count функции wp_list_categories(), значение по умолчанию — false (не отображать).

hierarchical

(логическое) Нужно ли соблюдать иерархию категорий (по умолчанию false — не нужно).

dropdown

(логическое) true — в виде выпадающего списка, false (по умолчанию) — в виде маркированного списка.

Пример:

the_widget( 'WP_Widget_Categories', array('count' => true) );

Виджет «Мета»

Выводит ссылки входа и выхода на сайте, а также ссылки на RSS ленты (лента постов и лента комментариев) и на официальный сайт WordPress.

title

(строка) Заголовок, по умолчанию __(' Meta')

the_widget( 'WP_Widget_Meta' );

Виджет «Страницы»

Выводит ссылки на страницы (тип поста page) сайта.

Параметры:

title

(строка) Заголовок выводимого списка страниц, по умолчанию __('Pages')

sortby

(строка) По какому критерию сортировать страницы. По умолчанию — menu_order.

exclude

(строка) IDы страниц через запятую, которые нужно исключить из выводимого списка. По умолчанию выводятся все.

Например выведем список страниц, отсортированных по дате изменения и исключим из этого списка страницы с ID = 4 и ID = 5:

the_widget('WP_Widget_Pages', 'sortby=post_modified&exclude=4,5' );

Виджет «Свежие комментарии»

Думаю из заголовка прекрасно понятно, какую функцию выполняет этот виджет. Его параметры:

title

(строка) Заголовок выводимого списка комментариев, по умолчанию __('Recent Comments')

number

(целое число) Количество комментариев, которые нужно отобразить (не более 15). По умолчанию — 5.

the_widget( 'WP_Widget_Recent_Comments', 'number=15' );

Виджет «Свежие записи»

title

(строка) Заголовок виджета, по умолчанию __('Recent Posts')

number

(целое число) Количество записей, которые нужно отобразить (не более 15). По умолчанию — 10.

the_widget( 'WP_Widget_Recent_Posts', array( 'number' => 5 ) );

Виджет «RSS»

Этот виджет позволяет вывести RSS или Atom ленту любого блога. Это также можно сделать при помощи функции fetch_feed().

Параметры виджета:

title

(строка) Заголовок виджета, по умолчанию выводится название ленты в виде ссылки на сайт, слева от которого иконка RSS со ссылкой непосредственно на ленту.

items

(целое число) Количество элементов, которые нужно отобразить. По умолчанию — все доступные.

url

(строка) Ссылка на RSS-фид, который хотим вывести (параметр обязателен).

show_summary

(логическое) Нужно ли под ссылками с заголовками вывести краткое описание. По умолчанию — false.

show_author

(логическое) Нужно ли отобразить авторов постов. По умолчанию — false.

show_date

(логическое) Нужно ли вывести даты публикаций постов. По умолчанию — false.

Пример:

$instance = array(
	'feed' => 'https://misha.agency/feed',
	'items' => 5,
	'show_summary' => true
);
the_widget( 'WP_Widget_RSS', $instance );

Виджет «Поиск»

Выводит форму поиска по сайту.

title

(строка) Заголовок виджета, по умолчанию null.

the_widget( 'WP_Widget_Search' );

Виджет «Облако меток»

Выводит облако меток / категорий / элементов таксономий.

title

(строка) Заголовок виджета, по умолчанию __( 'Tags' ).

taxonomy

(строка) Элементы какой таксономии следует вывести в виде облака тегов (по умолчанию — метки post_tag.

Выводим облако рубрик блога:

the_widget( 'WP_Widget_Tag_Cloud', 'title=Облако рубрик&taxonomy=category', 'before_title=<h3>&after_title=</h3>' );

Виджет «Текст»

title

(строка) Заголовок виджета, по умолчанию null (т.е. без заголовка).

text

(строка) Текст или HTML-код.

the_widget( 'WP_Widget_Text', array('text' => 'Привет.') );

Виджет «Произвольное меню»

Позволяет вывести одно из созданных в админке меню в виде списка (с учетом вложенности элементов).

title

(строка) Заголовок виджета, по умолчанию null.

nav_menu

(строка|целое число) ID или название меню, которое нужно вывести (регистр не имеет значения, кириллические символы тоже). Как узнать ID меню? Легко и просто — переходим на страницу редактирования меню и залазим в исходный код:

the_widget( 'WP_Nav_Menu_Widget', array('nav_menu' => 122) );

the_widget( 'WP_Nav_Menu_Widget', array('nav_menu' => 'My Menu') );