Функция wp_site_icon() в WordPress с примерами

Главная - WordPress Codex - Функция wp_site_icon() в WordPress с примерами
Доступна с версии: 4.3
Раздел: Тема
Написал: Александр Сокирка

Функция wp_site_icon() выводит HTML-код с мета-тегами, которые указывают на иконку сайта (favicon) для различных устройств и платформ. Она используется для того, чтобы браузеры и устройства могли отображать значок сайта рядом с URL, на вкладках браузера, в закладках и других местах.

wp_site_icon();

Параметры

Функция не принимает параметров.

Возвращаемое значение

  • null: Функция не возвращает значений, она выводит HTML-код.

Важные особенности:

  • Валидация наличия иконки: Функция проверяет, установлена ли иконка сайта, используя опцию site_icon.
  • Автоматическая интеграция: Функция добавляется в <head> сайта через хук wp_head с приоритетом 99 по умолчанию.
  • Функция выводит 4 мета-тега:
    • <link rel="icon" href="%s" sizes="32x32" /> — для стандартного favicon размером 32×32 пикселя.
    • <link rel="icon" href="%s" sizes="192x192" /> — для устройств Android.
    • <link rel="apple-touch-icon-precomposed" href="%s" /> — для устройств Apple (iPhone, iPad).
    • <meta name="msapplication-TileImage" content="%s" /> — для плиток Windows (Metro UI).

Хуки

  • site_icon_meta_tags: Позволяет изменять выводимые мета-теги для иконки сайта.

Пример 1: Демонстрация работы

Если для сайта установлена иконка через меню «Внешний вид > Настроить > Свойства сайта», то вызов функции wp_site_icon() выведет следующий код:

wp_site_icon();

Результат:

<link rel="icon" href="http://example.com/wp-content/uploads/2024/10/cropped-site-icon-32x32.jpg" sizes="32x32" />
<link rel="icon" href="http://example.com/wp-content/uploads/2024/10/cropped-site-icon-192x192.jpg" sizes="192x192" />
<link rel="apple-touch-icon-precomposed" href="http://example.com/wp-content/uploads/2024/10/cropped-site-icon-180x180.jpg" />
<meta name="msapplication-TileImage" content="http://example.com/wp-content/uploads/2024/10/cropped-site-icon-270x270.jpg" />

Пример 2: Отключение вывода иконки

Если вы хотите отключить вывод иконки сайта, вы можете удалить хук wp_site_icon из wp_head. Это можно сделать, добавив следующий код в файл functions.php вашей темы:

remove_action('wp_head', 'wp_site_icon', 99 );

Заключение

Функция wp_site_icon() автоматически выводит мета-теги для favicon и значков для различных устройств, что делает её удобной для интеграции иконки сайта в тему WordPress. Если вам нужно отключить вывод иконки или изменить поведение, это можно сделать через хуки и фильтры.

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема