wp_unregister_icon()WP 7.1.0

Удаляет зарегистрированную SVG-иконку из реестра.

Функцию следует вызывать после регистрации иконки через wp_register_icon(). Обычно её подключают к событию init с поздним приоритетом.

Чтобы удалить все иконки коллекции, используйте wp_unregister_icon_collection().

После удаления уже добавленные блоки, использующие эту иконку, не смогут её вывести.

Работает на основе: WP_Icons_Registry::unregister()

Хуков нет.

Возвращает

true|false.

  • true - иконка успешно удалена из реестра.
  • false - иконка с указанным именем не зарегистрирована. Также будет создано уведомление _doing_it_wrong().

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

wp_unregister_icon( $icon_name );
$icon_name(string) (обязательный)
Имя иконки в формате коллекция/имя, например my-plugin/star.

Примеры

#1 Удаление зарегистрированной иконки

add_action( 'init', 'my_plugin_unregister_icon', 99 );

function my_plugin_unregister_icon() {
	wp_unregister_icon( 'my-plugin/star' );
}

Список изменений

С версии 7.1.0 Введена.

Код wp_unregister_icon() WP 7.1

function wp_unregister_icon( $icon_name ) {
	return WP_Icons_Registry::get_instance()->unregister( $icon_name );
}