Функция GET_THEME_MOD() в WordPress

Описание

Функция get_theme_mod() позволяет получить значение настройки темы для текущей темы WordPress. Эта функция полезна для динамического изменения стилей и параметров вашего сайта на основе настроек, заданных в админке.

Если имя настройки не существует и передано значение $default_value, которое является строкой, то оно будет обработано с помощью функции sprintf().

Применение

Вот как вы можете использовать эту функцию:

get_theme_mod( $name, $default_value );

• $name (обязательный): название настройки темы.
• $default_value (необязательный): значение по умолчанию для настройки.
  • По умолчанию: false.

Возврат

Функция возвращает смешанное значение — значение настройки темы. Если настройка не найдена, вернет $default_value.

Примеры использования

Пример 1: Цвет фона из настроек темы

Этот пример показывает, как добавить верхнюю границу для блока подвала с таким же цветом, как и цвет фона, установленный в настройках.

Вставьте этот код в начале файла header.php:

Пример 2: Цвет фона с значением по умолчанию

Иногда нужно установить значение по умолчанию, чтобы избежать проблем. Вот пример его использования для добавления собственного цвета фона для блока .footer:

.footer {
    background: #;
}

Пример 3: Рекомендуется экранировать значение

Лучше всегда использовать функции экранирования для безопасности. Вот как это сделать:

.search-bar {
    background-color: ;
}

function get_theme_mod( $name, $default_value = false ) {
    $mods = get_theme_mods();

    if ( isset( $mods[ $name ] ) ) {
        return apply_filters( "theme_mod_{$name}", $mods[ $name ] );
    }

    if ( is_string( $default_value ) ) {
        if ( preg_match( '#(?