WP_SITE_ICON() │ WP 4.3.0
Функция wp_site_icon() отвечает за отображение метатегов иконки сайта.
Использование функций
- get_site_icon_url() - возвращает URL иконки сайта.
- has_site_icon() - проверяет, установлена ли иконка для сайта.
Хуки
- site_icon_meta_tags - позволяет другим плагинам изменять метатеги иконки сайта.
Возвращаемое значение
Функция ничего не возвращает (null).
Использование функции
Чтобы вывести иконку сайта, используйте следующую команду:
wp_site_icon();Примеры использования
Пример 1: Вывод метатегов иконки
Предположим, вы установили иконку сайта в разделе: Внешний вид > Настроить > Идентичность сайта. В этом случае следующий код выведет метатеги иконки:
wp_site_icon();Этот код создаст следующие метатеги в HTML:
Пример 2: Отключение вывода иконки сайта
Если вы хотите отключить вывод иконки (если она установлена), добавьте следующий код в файл functions.php вашей темы:
remove_action( 'wp_head', 'wp_site_icon', 99 );Изменения в версии
Функция wp_site_icon() была добавлена в WordPress версии 4.3.0.
Код функции
Вот код, который определяет, как функция wp_site_icon() работает:
function wp_site_icon() {
if ( ! has_site_icon() && ! is_customize_preview() ) {
return;
}
$meta_tags = array();
$icon_32 = get_site_icon_url( 32 );
if ( empty( $icon_32 ) && is_customize_preview() ) {
$icon_32 = '/favicon.ico'; // Показать URL иконки по умолчанию во время настройки.
}
if ( $icon_32 ) {
$meta_tags[] = sprintf( '', esc_url( $icon_32 ) );
}
$icon_192 = get_site_icon_url( 192 );
if ( $icon_192 ) {
$meta_tags[] = sprintf( '', esc_url( $icon_192 ) );
}
$icon_180 = get_site_icon_url( 180 );
if ( $icon_180 ) {
$meta_tags[] = sprintf( '', esc_url( $icon_180 ) );
}
$icon_270 = get_site_icon_url( 270 );
if ( $icon_270 ) {
$meta_tags[] = sprintf( '', esc_url( $icon_270 ) );
}
// Фильтр для метатегов иконки сайта, другие плагины могут добавлять свои собственные.
$meta_tags = apply_filters( 'site_icon_meta_tags', $meta_tags );
$meta_tags = array_filter( $meta_tags );
foreach ( $meta_tags as $meta_tag ) {
echo "$meta_tagn";
}
}Связанные функции
- add_theme_support() - добавляет поддержку различных функций темы.
- bloginfo() - выводит информацию о сайте.
- body_class() - добавляет классы к элементу
<body>. - get_custom_logo() - возвращает кастомный логотип темы.
Эти функции могут быт�� полезны при работе с темами в WordPress, позволяя вам настраивать вид и поведение вашего сайта.