Описание customize_post_value_set_{$setting_id}
— Filter
Хук customize_post_value_set_{$setting_id} позволяет изменять значение настраиваемого параметра в WordPress. Он срабатывает при установке значения для конкретного параметра в Customizer, что позволяет разработчикам модифицировать его перед сохранением
Примеры использования
Пример изменения значения настройки перед его сохранением:
add_filter('customize_post_value_set_my_setting', function($value, $setting) {
return 'Новое значение';
}, 10, 2);
В этом примере мы изменяем значение настройки ‘my_setting’ на ‘Новое значение’ перед его сохранением
Пример изменения значения настройки в зависимости от текущего состояния:
add_filter('customize_post_value_set_my_setting', function($value, $setting) {
if ($value === 'старое значение') {
return 'обновленное значение';
}
return $value;
}, 10, 2);
Здесь мы проверяем, если текущее значение равно ‘старое значение’, то изменяем его на ‘обновленное значение’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить значение настраиваемой настройки перед ее сохранением
– Производительность
Хук может оказать влияние на производительность, если используется для сложных вычислений или запросов
– Предупреждения
Убедитесь, что изменения не конфликтуют с другими настройками или логикой вашего плагина/темы
Альтернативы
Тип: filter
Этот хук позволяет изменять значение настройки после его получения, но перед отображением в Customizer
Используйте его, если нужно модифицировать значение перед его выводом в интерфейсе пользователя
