## Функция add_theme_support()
в WordPress
Функция add_theme_support()
позволяет вам зарегистрировать поддержку различных функций для вашей темы WordPress. Она должна быть вызвана в файле functions.php
вашей темы, чтобы корректно работать. Если использовать её с хук, это должно быть сделано в хуке after_setup_theme
. Хук init
может быть слишком поздним для некоторых функций.
### Пример использования
Вот как можно использовать эту функцию:
```php
add_theme_support( 'title-tag' );
add_theme_support( 'custom-logo', array(
'height' => 480,
'width' => 720,
) );
Возвращаемое значение
Функция возвращает:
null
, если все прошло успешно.false
, если произошла ошибка.
Синтаксис
add_theme_support( $feature, ...$args );
Параметры
-
$feature
(строка, обязательный) — это функция, которую вы хотите добавить. Популярные значения:'admin-bar'
— поддержка панели администратора.'align-wide'
— поддержка широкого выравнивания.'custom-logo'
— поддержка кастомного логотипа.'title-tag'
— поддержка тега заголовка.- И многие другие...
-
...$args
(разные, необязательный) — дополнительные аргументы для определённых функций.
Примеры
Регистрация функций темы
Вставьте следующий код в файл functions.php
вашей темы, чтобы добавить различные функции:
// Регистрация функций темы
add_action( 'after_setup_theme', function() {
// Возможность изменять фон из административной панели
add_theme_support( 'custom-background' );
// Возможность изменять изображения в заголовке из административной панели
add_theme_support( 'custom-header' );
// Включить меню в административной панели
add_theme_support( 'menus' );
// Автоматическая генерация тега
add_theme_support( 'title-tag' );
// Возможность загружать логотип
add_theme_support( 'custom-logo', [
'height' => 190,
'width' => 190,
'flex-width' => false,
'flex-height' => false,
'header-text' => '',
] );
});
Примечания
- Глобальная переменная:
$_wp_theme_features
— массив, который хранит информацию о поддерживаемых функциях темы.
Изменения в версии
- С 2.9.0: Функция была введена.
- С 4.1.0: Добавлена поддержка
title-tag
. - С 5.0.0: Добавлена поддержка новых возможностей, таких как
responsive-embeds
иeditor-color-palette
. - Более поздние версии добавили поддержку для множества других функций.
Дополнительная информация
Если вам нужно проверить, поддерживает ли текущая тема какую-либо функцию, используйте функцию current_theme_supports()
:
if ( current_theme_supports( 'custom-logo' ) ) {
// Логотип поддерживается
}
Заключение
Функция add_theme_support()
— это мощный инструмент для настройки и улучшения функциональности вашей темы WordPress. С её помощью вы можете доба��лять различные функции, которые улучшат пользовательский опыт и оформляют ваш сайт более привлекательно.