Описание функции the_custom_logo()
Функция the_custom_logo() используется для вывода настраиваемого логотипа сайта, который задается в настройках темы. Эта функция позволяет легко интегрировать логотип в шаблон, обеспечивая гибкость и совместимость с различными темами.
Логотип может быть загружен через панель настройки кастомизатора и будет отображаться в определенных местах темы, таких как шапка.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных параметров для вывода логотипа
Возможные значения:
height: Высота логотипа в пикселях
width: Ширина логотипа в пикселях
alt: Текст для атрибута alt
Возвращаемое значение
Тип: void
Описание: Выводит HTML-код логотипа, если он установлен
Возможные значения:
• HTML-код логотипа при наличии
• Ничего не выводит, если логотип не установлен
Примеры использования
Простой вызов для вывода логотипа
the_custom_logo();
Логотип будет выводиться на странице, если он задан в настройках
Вывод логотипа с указанием высоты, ширины и атрибута alt
$args = array(
'height' => 100,
'width' => 300,
'alt' => 'Логотип моего сайта'
);
the_custom_logo($args);
Убедитесь, что параметры соответствуют загруженному логотипу
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Всегда проверяйте наличие логотипа перед выводом, чтобы избежать ошибок
— Связанные функции
Получает HTML-код логотипа без его вывода
Проверяет, установлен ли логотип
— Хуки
Фильтрует HTML-код логотипа перед его выводом
— Примечания
– Ограничения
Поддерживает только один логотип, если он задан
– Частые проблемы
- Логотип не отображается, если не задан в кастомизаторе
- Ошибки при вызове в неподходящих местах шаблона
