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