get_sidebar()
Підключає файл шаблону sidebar.php (сайдбар). Якщо передано параметр $name , то буде підключений файл sidebar-{name}.php .
Якщо файл не знайдено у шаблоні теми, то буде взяти файл за замовчуванням:wp-includes/theme-compat/sidebar.php
Працює на основі:
locate_template()
locate_template()
Хуки з функції
Повертає
null|false
. null при вдалому підключенні файлу, false якщо файл шаблону не існує.
Використання
<?php get_sidebar( $name, $args ); ?>
-
$name
(рядок) -
Індекс назви файлу. Буде підключений файл
sidebar-{name}.php
Типово: null -
$args
(масив) (З WP 5.5) -
Додаткові параметри для файлу, що підключається. Використовуйте змінну
$args у файлі, що підключається.
За замовчуванням: array()
Приклади
#1 Дві бічні панелі (сайдбара) в одній темі
<?php get_header(); ?> <?php get_sidebar('left'); ?> <?php get_sidebar('right'); ?> <?php get_footer(); ?>
У темі (шаблоні) повинні бути файли sidebar-right.php і sidebar-left.php .
#2 Підключення сайдбара з підпапки теми
Щоб це зробити, потрібно написати свій простий аналог цієї функції:
// Підключить файл 'inc/sidebar.php' із папки поточної теми. // Розміщувати у functions.php function theme_sidebar( $name = '' ){ do_action( 'get_sidebar', $name); if($name) $name = "-$name"; locate_template("inc/sidebar$name.php", true); } // виклик замість get_sidebar() theme_sidebar();
список змін
З версії 1.5.0 | Введено. |
З версії 5.5.0 | A return value був added. |
З версії 5.5.0 | The $args parameter був added. |