Описание customize_partial_render_{$partial->id}
— Action
Хук customize_partial_render_{$partial->id} позволяет вмешиваться в процесс отрисовки частичных обновлений в кастомизаторе WordPress. Он срабатывает при частичной отрисовке кастомизируемых элементов, таких как виджеты или настройки темы, и дает возможность изменять возвращаемые данные перед их выводом на экран
Примеры использования
Пример изменения HTML-кода для виджета в кастомизаторе:
add_action('customize_partial_render_widget', function($output, $partial) {
$output = 'Ваш контент здесь';
return $output;
});
В этом примере мы заменяем HTML-код виджета на кастомный
Пример добавления класса к элементу при частичной отрисовке:
add_action('customize_partial_render_header', function($output, $partial) {
$output = str_replace('class="header"', 'class="header custom-class"', $output);
return $output;
});
Здесь мы добавляем кастомный класс к заголовку при его отрисовке
Пример изменения текста в заголовке при частичной отрисовке:
add_action('customize_partial_render_title', function($output, $partial) {
$output = str_replace('Оригинальный заголовок', 'Новый заголовок', $output);
return $output;
});
Мы заменяем оригинальный заголовок на новый
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить содержимое или внешний вид элементов в кастомизаторе WordPress
– Производительность
Изменения должны быть минимальными, чтобы не замедлять процесс отрисовки в кастомизаторе
– Предупреждения
Осторожно с изменением больших объемов HTML-кода, это может негативно сказаться на производительности
Альтернативы
Тип: action
Этот хук позволяет добавлять новые настройки и секции в кастомизатор
Используйте его, если требуется добавление новых элементов, а не изменение существующих