unregister_sidebar()
Скасує реєстрацію раніше зареєстрованої панелі віджетів (сайдбар).
Хуків немає.
Повертає
null. Нічого не вертає.
Використання
unregister_sidebar($id);
- $id
(рядок) (обов’язковий) - ID панелі, яку потрібно скасувати. ID вказується під час реєстрації панелі.
Приклади
#1 Приклад використання функції
Якщо додати цей код у functions.php, то зареєстровані для TwentyTen теми сайдбари у підвалі будуть скасовані:
function remove_some_widgets(){
// Скасуємо реєстрацію деяких панелей віджетів
unregister_sidebar( 'first-footer-widget-area');
unregister_sidebar( 'second-footer-widget-area');
unregister_sidebar( 'third-footer-widget-area');
unregister_sidebar( 'fourth-footer-widget-area');
}
add_action( 'widgets_init', 'remove_some_widgets', 11);У прикладі ми встановили пріоритет 11 на хук widgets_init, тому що functions.php дочірньої теми підключається раніше ніж у основної. А це означає, що якщо залишити поле порожнім, пріоритет буде 10 і скасування віджетів не станеться.
Змінюючи пріоритет нашого хука, ми можемо бути впевнені, що він буде викликаний після того, як functions.php файл батьківської теми буде завантажено.
нотатки
- Global. Масив. $wp_registered_sidebars Registered sidebars.
список змін
| З версії 2.2.0 | Введено. |
Код unregister_sidebar() unregister sidebar WP 6.0.2
function unregister_sidebar( $sidebar_id ) {
global $wp_registered_sidebars;
unset($wp_registered_sidebars[$sidebar_id]);
}