remove_theme_mod() │ WP 2.1.0

Удаляет указанную настройку (опцию) текущей темы, установленную с помощью set_theme_mod().

Если с удалением опции в массиве опций темы ничего не остается, то опции темы будут полностью удалены из таблицы wp_options, т.е. будет использована функция remove_theme_mods().

Работает на основе: get_theme_mods(), update_option(), remove_theme_mods()
1 раз — 0.001562 сек (очень медленно) | 50000 раз — 2.79 сек (быстро)

Хуков нет.

Возвращает

null. Ничего не возвращает.

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

remove_theme_mod( $name );
$name(строка) (обязательный)
Название опции темы.

Примеры

0

#1 Удаление специальных опций темы 

// допустим мы добавили опцию так
set_theme_mod('aaa', 123);

// и тут нам нужно удалить опцию. Удаляем:
remove_theme_mod('aaa');

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

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

Код remove_theme_mod() WP 6.5.2

wp-includes/theme.php 
function remove_theme_mod( $name ) {
	$mods = get_theme_mods();

	if ( ! isset( $mods[ $name ] ) ) {
		return;
	}

	unset( $mods[ $name ] );

	if ( empty( $mods ) ) {
		remove_theme_mods();
		return;
	}

	$theme = get_option( 'stylesheet' );

	update_option( "theme_mods_$theme", $mods );
}

API модификации темы (theme_mods настройки опции темы)

Другие функции темы