Описание customize_register
— Action
Хук customize_register позволяет добавлять пользовательские настройки и секции в кастомайзер WordPress. Он срабатывает при инициализации кастомайзера, что позволяет разработчикам расширять функциональность темы или плагина, добавляя новые параметры для настройки
Примеры использования
Пример добавления новой секции в кастомайзер:
add_action('customize_register', function($wp_customize) {
$wp_customize->add_section('my_custom_section', array(
'title' => 'Моя секция',
'priority' => 30,
));
});
В этом примере мы создаем новую секцию в кастомайзере с заголовком ‘Моя секция’.
Пример добавления настройки цвета в кастомайзер:
add_action('customize_register', function($wp_customize) {
$wp_customize->add_setting('my_custom_color', array(
'default' => '#000000',
));
$wp_customize->add_control(new WP_Customize_Color_Control($wp_customize, 'my_custom_color_control', array(
'label' => 'Цвет фона',
'section' => 'my_custom_section',
'settings' => 'my_custom_color',
)));
});
Здесь мы добавляем настройку цвета в ранее созданную секцию, позволяя пользователю выбирать цвет для фона.
Пример добавления текстового поля в кастомайзер:
add_action('customize_register', function($wp_customize) {
$wp_customize->add_setting('my_custom_text', array(
'default' => 'Привет, мир!',
));
$wp_customize->add_control('my_custom_text_control', array(
'label' => 'Текстовое поле',
'section' => 'my_custom_section',
'settings' => 'my_custom_text',
'type' => 'text',
));
});
В этом примере мы добавляем текстовое поле для ввода текста в кастомайзер.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо добавить пользовательские настройки в кастомайзер WordPress
– Производительность
Хук обычно не влияет на производительность, но следует избегать избыточного количества настроек для снижения нагрузки на кастомайзер
– Предупреждения
Убедитесь, что настройки имеют смысл для конечного пользователя и не перегружают интерфейс кастомайзера
Альтернативы
Тип: action
Этот хук позволяет выполнять действия после сохранения настроек кастомайзера
Используйте его, если нужно выполнить действия после изменения настроек, например, очистить кэш или обновить данные
