get_theme_mods() WP 3.1.0

Получает все настройки (опции) темы.

Используйте get_theme_mod() чтобы получить отдельную настройку темы.

Является основой для: remove_theme_mod(), set_theme_mod(), get_theme_mod()

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

✈ 1 раз = 0.00009с = очень быстро | 50000 раз = 2.86с = быстро

Хуков нет.

Возвращает

Массив/false. Настройки темы. Если настроек у темы нет, то вернет false.

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

get_theme_mods();

Примеры

#1 Получим все настройки темы

Этот пример показывает как получить все настройки темы в виде массива.

$mods = get_theme_mods();

print_r( $mods );

/*
Вернет:
array(
	"header_textcolor" => "333"
	"header_image" => "random-default-image"
)
*/

echo $mods['header_textcolor']; // > 333

Заметки

Вызов этой функции обновит название опции в таблице wp_options со старого "mods_$theme_name" на новое "theme_mods_$theme_slug".

Код get_theme_mods: `wp-includes/theme.php` ^{VER 5.0}

<?php
function get_theme_mods() {
	$theme_slug = get_option( 'stylesheet' );
	$mods = get_option( "theme_mods_$theme_slug" );
	if ( false === $mods ) {
		$theme_name = get_option( 'current_theme' );
		if ( false === $theme_name )
			$theme_name = wp_get_theme()->get('Name');
		$mods = get_option( "mods_$theme_name" ); // Deprecated location.
		if ( is_admin() && false !== $mods ) {
			update_option( "theme_mods_$theme_slug", $mods );
			delete_option( "mods_$theme_name" );
		}
	}
	return $mods;
}

Cвязанные функции

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

set_theme_mod()