Описание get_custom_logo
— Filter
Хук get_custom_logo позволяет изменить HTML-код, который выводится при отображении пользовательского логотипа сайта. Он срабатывает в момент вызова функции get_custom_logo() и позволяет настраивать отображение логотипа, добавляя дополнительные классы, атрибуты или изменяя сам HTML.
Примеры использования
Пример добавления класса к логотипу:
add_filter('get_custom_logo', function($html) {
$html = str_replace('class="custom-logo"', 'class="custom-logo my-custom-class"', $html);
return $html;
});
В этом примере мы добавляем кастомный класс к логотипу.
Пример изменения атрибута alt логотипа:
add_filter('get_custom_logo', function($html) {
$html = str_replace('alt="site_title"', 'alt="Мой кастомный логотип"', $html);
return $html;
});
Здесь мы изменяем атрибут alt логотипа на кастомный текст.
Пример изменения HTML-кода логотипа:
add_filter('get_custom_logo', function($html) {
$html = '<a href="home_url"><img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" decoding="async" data-src="new_logo_url" alt="Мой сайт" /></a>';
return $html;
});
В этом примере мы полностью заменяем HTML-код логотипа на новый.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить отображение логотипа сайта без редактирования шаблонов
– Производительность
Изменения, выполненные через этот хук, не должны значительно влиять на производительность сайта
– Предупреждения
Убедитесь, что изменения соответствуют стандартам доступности, например, атрибут alt для изображений
Альтернативы
Тип: action
Этот хук позволяет добавлять дополнительные настройки для логотипа в кастомайзер
Используйте его, если нужно предоставить пользователям возможность изменять логотип через интерфейс кастомайзера
