REMOVE_THEME_SUPPORT() │ WP 3.0.0

Функция remove_theme_support() позволяет вашей теме отменить поддержку определенной функции. Обычно это используется в дочерних темах, чтобы переопределить поддержку, установленную в родительской теме.

Как это работает

Вызывайте эту функцию в файле functions.php вашей темы. Это важно для правильной работы.

Возврат

• true | false | null: Определяет, была ли отменена поддержка функции.

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

remove_theme_support( $feature );

• $feature (string) (обязательный): Функция, поддержку которой вы хотите отменить. Список возможных значений можно найти в add_theme_support().

Примеры

Пример 1: Удаление поддержки миниатюр для записей

add_action( 'after_setup_theme', 'wp_kama_after_setup_theme_action', 99 );

function wp_kama_after_setup_theme_action() {
    remove_theme_support( 'post-thumbnails' );
}

Этот код отключает поддержку миниатюр для всех записей вашей темы.

Пример 2: Удаление функции в дочерней теме

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

// в файле functions.php дочерней темы

// Используем хук after_setup_theme с приоритетом 11, чтобы загрузить его после
// родительской темы, которая сработает на стандартном приоритете 10
add_action( 'after_setup_theme', 'remove_featured_images_from_child_theme', 11 );

function remove_featured_images_from_child_theme() {
    // Это отключит поддержку миниатюр для всех типов записей
    remove_theme_support( 'post-thumbnails' );

    // Добавляем эту строку, чтобы повторно включить поддержку только для постов
    add_theme_support( 'post-thumbnails', array( 'post' ) );
}

Примечания

• Для получения дополнительной информации ознакомьтесь с add_theme_support().

История изменений

• С версии 3.0.0: функция была введена.

Код функции remove_theme_support()

Вот как выглядит реализация этой функции в файле wp-includes/theme.php:

function remove_theme_support( $feature ) {
// Не удалять внутренние регистрации, которые не используются напрямую темами.
if ( in_array( $feature, array( 'editor-style', 'widgets', 'menus' ), true ) ) {
return false;
}

return _remove_theme_support( $feature );

}

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

• add_theme_support(): Добавляет поддержку для различных функций темы.
• current_theme_supports(): Про��еряет, поддерживает ли текущая тема определенную функцию.
• get_theme_support(): Получает информацию о поддержке темы.

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

Теперь вы знаете, как отменить поддержку функций в вашей теме WordPress!