Описание customize_partial_render
— Filter
Хук customize_partial_render позволяет изменять HTML-код, который используется для рендеринга предварительных частей настроек в кастомайзере WordPress. Он срабатывает во время процесса рендеринга, когда пользователь взаимодействует с кастомайзером, предоставляя возможность динамически изменять отображаемое содержимое.
Примеры использования
Пример изменения HTML для определенной части кастомайзера:
add_filter('customize_partial_render', function($rendered, $partial) {
if ($partial->id === 'site_title') {
$rendered = '<h1 class="custom-title">' . get_bloginfo('name') . '</h1>';
}
return $rendered;
});
В этом примере мы изменяем рендеринг заголовка сайта на кастомный HTML.
Пример добавления классов к HTML частям кастомайзера:
add_filter('customize_partial_render', function($rendered, $partial) {
if ($partial->id === 'footer_text') {
$rendered = str_replace('<footer>', '<footer class="custom-footer">', $rendered);
}
return $rendered;
});
Здесь мы добавляем класс к элементу footer, если ID части соответствует ‘footer_text’.
Пример изменения содержимого виджета в кастомайзере:
add_filter('customize_partial_render', function($rendered, $partial) {
if ($partial->id === 'widget_area') {
$rendered .= '<p>Кастомное содержимое виджета</p>';
}
return $rendered;
});
В этом примере мы добавляем дополнительный контент к части виджета кастомайзера.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо динамически изменять отображение частей кастомайзера в зависимости от пользовательских настроек или других условий.
– Производительность
Изменения, внесенные через этот хук, могут влиять на производительность, если они приводят к сложным вычислениям или запросам к базе данных.
– Предупреждения
Следите за тем, чтобы изменения не нарушали логику работы кастомайзера и корректно обрабатывались в различных контекстах.
Альтернативы
Тип: action
Этот хук позволяет добавлять дополнительные данные и функционал к частям кастомайзера.
Используйте его, если нужно добавить функционал, а не просто изменять существующий HTML.
