unregister_widget() │ WP 2.8.0

Цей приклад показує, як скасувати реєстрацію віджету Календар. Може стати в нагоді коли потрібно замінити стандартний віджет на свій:

add_action( 'widgets_init', 'remove_calendar_widget');
function remove_calendar_widget() {
	unregister_widget('WP_Widget_Calendar');
}

Щоб відключити всі базові віджети в WordPress, використовуйте такий код:

## Відключаємо стандартні віджети WordPress
add_action('widgets_init', 'unregister_basic_widgets');
function unregister_basic_widgets() {
	unregister_widget('WP_Widget_Pages'); // Віджет сторінок
	unregister_widget('WP_Widget_Calendar'); // Календар
	unregister_widget('WP_Widget_Archives'); // Архіви
	unregister_widget('WP_Widget_Links'); // Посилання
	unregister_widget('WP_Widget_Meta'); // Мета віджет
	unregister_widget('WP_Widget_Search'); // Пошук
	unregister_widget('WP_Widget_Text'); //Текст
	unregister_widget('WP_Widget_Categories'); // Категорії
	unregister_widget('WP_Widget_Recent_Posts'); // Останні записи
	unregister_widget('WP_Widget_Recent_Comments'); // Останні коментарі
	unregister_widget('WP_Widget_RSS'); // RSS
	unregister_widget('WP_Widget_Tag_Cloud'); // Хмара міток
	unregister_widget('WP_Nav_Menu_Widget'); // Меню
	unregister_widget('WP_Widget_Media_Audio'); // Audio
	unregister_widget('WP_Widget_Media_Video'); // Video
	unregister_widget('WP_Widget_Media_Gallery'); // Gallery
	unregister_widget('WP_Widget_Media_Image'); // Image
}

Використовуйте цей код у файлі теми functions.php .

Приклад вище показує, як відключити всі віджети за замовчуванням і дає вибір, які відключати, а які ні.

Але, якщо вам потрібно відключити абсолютно все віджет разом, краще зробити це до того, як вони будуть підключені, тобто. взагалі їх не підключати і не викликати подію, що включає інші віджети. Для цього відкріпіть функцію wp_widgets_init() від події init, ось так:

remove_action( 'init', 'wp_widgets_init', 1);

Цей приклад показує, як відключити базові віджети WordPress. Але зробити це треба так, щоб відключалися PHP файли віджетів і після відключення не існувало класів базових віджетів: WP_Widget_Pages, WP_Widget_Search і т.д. Після такого відключення ми можемо створити віджети з назвами базових класів. Це якщо можна відключення базових віджетів на корені.

Так як це низькорівневе налаштування, такий код повинен бути або в звичайному плагіні, або в обов’язковому плагіні , але не пізніше.

remove_action( 'plugins_loaded', 'wp_maybe_load_widgets', 0);
// включимо подію відключену в wp_maybe_load_widgets
add_action( '_admin_menu', 'wp_widgets_add_menu');

// щоб не реєструвалися віджети класів яких тепер взагалі немає.
remove_action( 'init', 'wp_widgets_init', 1);

// включимо подію відключену в wp_widgets_init
add_action( 'init', 'my_wp_widgets_init', 1);
function my_wp_widgets_init(){
	if ( !is_blog_installed() ) return;

	/**
	 * Fires after all default WordPress widgets have been registered.
	 *
	 * @ Since 2.2.0
	 */
	do_action( 'widgets_init');
}

Після встановлення цього коду будуть відключені всі базові віджети, але меню віджетів в адмін-панелі залишиться робочим… А також ви зможете написати свої віджети з назвами PHP класів базових віджетів: WP_Widget_Pages, WP_Widget_Search і т.д.