Описание customize_value_{$this->id_data['base']}
— Filter
Хук customize_value_{$this->id_data[‘base’]} позволяет изменить значение настройки в кастомайзере WordPress. Он срабатывает при выводе значения настройки и может использоваться для модификации данных перед их отображением или сохранением
Примеры использования
Пример изменения значения настройки перед его отображением:
add_filter('customize_value_{$this->id_data['base']}', function($value, $wp_customize) {
return 'Новое значение';
}, 10, 2);
В этом примере мы изменяем значение настройки на ‘Новое значение’ перед тем, как оно будет отображено
Пример изменения массива настроек:
add_filter('customize_value_{$this->id_data['base']}', function($value, $wp_customize) {
if (is_array($value)) {
$value['option1'] = 'новое значение';
}
return $value;
}, 10, 2);
Здесь мы изменяем элемент массива настройки, если текущее значение является массивом
Пример изменения целочисленного значения настройки:
add_filter('customize_value_{$this->id_data['base']}', function($value, $wp_customize) {
return $value + 10;
}, 10, 2);
Мы увеличиваем целочисленное значение настройки на 10
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить значение настройки в кастомайзере перед его отображением или сохранением
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только значений настроек
– Предупреждения
Убедитесь, что изменения не нарушают логику работы других настроек или функциональности темы
Альтернативы
Тип: action
Этот хук позволяет добавлять новые настройки и секции в кастомайзер
Используйте его, если нужно добавить новую настройку, а не просто изменить существующую
