Описание customize_sanitize_{$this->id}
— Filter
Хук customize_sanitize_{$this->id} позволяет изменить и очистить данные, которые передаются через кастомизатор WordPress. Он срабатывает при сохранении настроек и предоставляет возможность модифицировать значения перед их сохранением в базе данных
Примеры использования
Пример очистки строки перед сохранением:
add_filter('customize_sanitize_my_setting', function($value, $setting) {
return sanitize_text_field($value);
}, 10, 2);
В этом примере мы используем sanitize_text_field для удаления нежелательных символов из текстового поля
Пример очистки массива значений:
add_filter('customize_sanitize_my_array_setting', function($value, $setting) {
return array_map('sanitize_text_field', $value);
}, 10, 2);
Здесь мы применяем sanitize_text_field ко всем элементам массива, чтобы очистить их
Пример изменения значения перед его сохранением:
add_filter('customize_sanitize_my_setting', function($value, $setting) {
return strtoupper($value);
}, 10, 2);
В этом случае мы преобразуем все введенные данные в верхний регистр перед сохранением
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить или очистить данные, которые поступают из кастомизатора перед их сохранением
– Производительность
Хук не должен значительно влиять на производительность, но стоит избегать сложных и ресурсоемких операций внутри него
– Предупреждения
Убедитесь, что возвращаемое значение соответствует ожидаемому типу данных для корректного сохранения
Альтернативы
Тип: action
Этот хук позволяет добавлять кастомные настройки в кастомизатор, но не предназначен для очистки значений
Используйте его для добавления новых настроек, а для очистки используйте sanitize-хук
