Описание customize_section_active
— Filter
Хук customize_section_active позволяет управлять активностью секций в кастомизаторе WordPress. Он срабатывает на этапе инициализации кастомизатора и позволяет динамически контролировать, какие секции должны быть активны для отображения пользователю
Примеры использования
Пример деактивации секции в зависимости от настройки темы:
add_filter('customize_section_active', function($active, $section) {
if ($section == 'my_custom_section') {
return is_user_logged_in(); // Секция активна только для зарегистрированных пользователей
}
return $active;
}, 10, 2);
В этом примере секция my_custom_section будет активна только для зарегистрированных пользователей
Пример деактивации секции на основе пользовательских опций:
add_filter('customize_section_active', function($active, $section) {
if ($section == 'my_custom_section') {
return get_theme_mod('show_custom_section', true); // Секция зависит от пользовательской настройки
}
return $active;
}, 10, 2);
Здесь активность секции зависит от пользовательской настройки в кастомизаторе
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо контролировать активность секций кастомизатора в зависимости от условий
– Производительность
Хук не должен существенно повлиять на производительность, если используется разумно
– Предупреждения
Следите за тем, чтобы изменения не вводили пользователей в заблуждение, отключая важные секции
Альтернативы
Тип: action
Этот хук позволяет добавлять или изменять секции и контроллеры в кастомизаторе
Используйте его, если нужно не только управлять активностью, но и добавлять новые элементы в кастомизатор
