Описание функции wp_custom_css_cb()
Функция wp_custom_css_cb() используется для обработки пользовательского CSS, добавленного через кастомайзер WordPress. Она позволяет пользователям добавлять свои стили, которые затем применяются к сайту. Функция активируется в момент сохранения пользовательских настроек CSS и позволяет проверить, есть ли изменения, а также сохранить их в базе данных.
Функция упрощает процесс добавления кастомного стиля, делая его доступным прямо из интерфейса кастомайзера.
Параметры
$css
Тип: string
Обязательный: Да
Описание: Пользовательский CSS-код для сохранения
Возможные значения:
Возвращаемое значение
Тип: string|null
Описание: Возвращает обновленный CSS-код после обработки или null в случае ошибки
Возможные значения:
• Обновленный CSS-код при успешном выполнении
• null если произошла ошибка при обработке
Примеры использования
Базовый пример сохранения пользовательского CSS-кода
$custom_css = 'body { background-color: #f00; }';
$updated_css = wp_custom_css_cb($custom_css);
// $updated_css содержит обновленный CSS-код
CSS сохраняется, если он корректен
Пример обработки ошибки при сохранении пустого CSS
$custom_css = ''; // Пустой CSS-код
$updated_css = wp_custom_css_cb($custom_css);
if($updated_css === null) {
echo 'Ошибка при сохранении CSS';
}
Функция вернет null при пустом CSS
Безопасность
Валидация входных данных: Входной параметр CSS проходит проверку на корректность
Санитизация: CSS-код очищается для предотвращения уязвимостей
Рекомендации: Используйте sanitize_text_field() для очистки входящих данных перед сохранением
— Связанные функции
Получает пользовательскую настройку темы
Сохраняет пользовательскую настройку темы
— Примечания
– Ограничения
Функция не поддерживает сложные селекторы и может игнорировать ошибки в CSS
– Частые проблемы
- Проблемы с отображением, если CSS-код некорректен
- Не сохраняет стили, если они пустые
