Описание customize_update_{$this->type}
— Action
Хук customize_update_{$this->type} позволяет выполнять действия при обновлении определенного типа пользовательских настроек в WordPress. Он срабатывает в момент, когда изменения сохраняются в пользовательском интерфейсе настройки темы или плагина, что делает его полезным для обработки данных перед их сохранением
Примеры использования
Пример валидации значения перед его сохранением:
add_action('customize_update_text_setting', function($value, $setting) {
if (empty($value)) {
$setting->add_error('empty_value', 'Значение не может быть пустым');
}
return $value;
}, 10, 2);
В этом примере мы проверяем, чтобы значение не было пустым, и добавляем ошибку, если это так
Пример автоматического преобразования URL перед сохранением:
add_action('customize_update_url_setting', function($value, $setting) {
return esc_url($value);
}, 10, 2);
Здесь мы автоматически экранируем URL перед его сохранением
Пример изменения значения перед сохранением:
add_action('customize_update_color_setting', function($value, $setting) {
return '#' . ltrim($value, '#');
}, 10, 2);
В этом примере мы добавляем ‘#’ к значению цвета, если он отсутствует
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо выполнить действия с пользовательскими настройками перед их сохранением
– Производительность
Хук может повлиять на производительность, если используется много сложной логики, поэтому старайтесь оптимизировать код
– Предупреждения
Обратите внимание на то, чтобы не нарушить логику работы других хуков, связанных с обновлением настроек
Альтернативы
Тип: action
Этот хук срабатывает после сохранения настроек и может использоваться для выполнения действий, не связанных с их валидацией
Используйте его, если нужно выполнять действия после успешного сохранения настроек
