the_custom_logo()

Отображает пользовательский логотип, связанный с главной страницей, если тема поддерживает удаление ссылки на главную страницу
Функция WordPress
INT 4.5.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Отображение логотипа на главной странице
  4. Изменение логотипа для определенного блога
  5. Создание ссылки на главную страницу
  6. Настройка отображения логотипа на разных страницах
  7. Вопросы и ответы
  8. Как изменить размер логотипа, отображаемого с помощью функции the_custom_logo()?
  9. Как изменить ссылку на главную страницу, к которой ведет логотип, отображаемый с помощью функции the_custom_logo()?
  10. Как изменить классы и атрибуты, применяемые к логотипу, отображаемому с помощью функции the_custom_logo()?
  11. Как добавить альтернативный текст для логотипа, отображаемого с помощью функции the_custom_logo()?
  12. Как изменить HTML-разметку, используемую для отображения логотипа с помощью функции the_custom_logo()?
  13. Как добавить дополнительные стили для логотипа, отображаемого с помощью функции the_custom_logo()?
  14. Как удалить ссылку с логотипа на главную страницу, отображаемого с помощью функции the_custom_logo()?
  15. Как добавить логотип в подвал (footer) сайта с помощью функции the_custom_logo()?
  16. Как изменить порядок отображения логотипа с помощью функции the_custom_logo()?
  17. Связанные элементы

Описание функции

Функция the_custom_logo() отображает на сайте пользовательский логотип, который обычно является ссылкой на главную страницу сайта. Если тема поддерживает удаление ссылки на главной странице, то логотип не будет являться ссылкой.

Функция использует функцию get_custom_logo() для получения HTML-кода логотипа и выводит его на экран с помощью функции echo.

Использование

the_custom_logo( int $blog_id )

Функция the_custom_logo() принимает один параметр:

  • $blog_id (int) — необязательный параметр, ID блога. По умолчанию используется ID текущего блога.
<?php
/**
 * Выводит пользовательский логотип.
 *
 * @param int $blog_id ID блога (необязательно).
 */
the_custom_logo( $blog_id );
?>

В приведенном выше примере кода функция the_custom_logo() используется для вывода пользовательского логотипа на сайте. Параметр $blog_id является необязательным и может быть использован для указания ID блога, если требуется отобразить логотип для другого блога.

Примеры использования

Отображение логотипа на главной странице


// Проверяем, поддерживает ли тема удаление ссылки на главной странице
if ( has_custom_logo() && ! is_home() && ! is_front_page() ) {
    // Выводим логотип с ссылкой на главную страницу
    the_custom_logo();
} else {
    // Выводим только логотип без ссылки
    echo wp_get_attachment_image( get_theme_mod( 'custom_logo' ), 'full' );
}

В этом примере мы используем функцию has_custom_logo() для проверки, есть ли установленный пользовательский логотип. Затем мы проверяем, не является ли текущая страница главной страницей или страницей переднего плана, и если это так, то мы выводим логотип с ссылкой на главную страницу с помощью функции the_custom_logo(). Если тема не поддерживает удаление ссылки на главной странице, то мы выводим только логотип без ссылки с помощью функции wp_get_attachment_image().

Изменение логотипа для определенного блога


// Получаем ID блога
$blog_id = get_current_blog_id();
// Выводим логотип для определенного блога
the_custom_logo( $blog_id );

В этом примере мы используем функцию get_current_blog_id() для получения ID текущего блога. Затем мы передаем этот ID в функцию the_custom_logo(), чтобы вывести логотип для определенного блога.

Создание ссылки на главную страницу


// Выводим логотип с ссылкой на главную страницу
the_custom_logo();

В этом примере мы просто используем функцию the_custom_logo() для вывода логотипа с ссылкой на главную страницу. Если тема поддерживает удаление ссылки на главной странице, то ссылка будет удалена автоматически.

Настройка отображения логотипа на разных страницах


// Выводим логотип только на главной странице
if ( is_front_page() ) {
    the_custom_logo();
}
// Выводим логотип на всех остальных страницах
if ( ! is_front_page() ) {
    echo wp_get_attachment_image( get_theme_mod( 'custom_logo' ), 'full' );
}

В этом примере мы используем условные операторы is_front_page() и ! is_front_page() для проверки, является ли текущая страница главной страницей или не является. Если это главная страница, то мы выводим логотип с помощью функции the_custom_logo(). Если это любая другая страница, то мы выводим только логотип без ссылки с помощью функции wp_get_attachment_image().

Вопросы и ответы

Как изменить размер логотипа, отображаемого с помощью функции the_custom_logo()?

Функция the_custom_logo() отображает пользовательский логотип, который по умолчанию является ссылкой на главную страницу сайта. Если тема поддерживает удаление ссылки на главную страницу, то логотип не будет являться ссылкой на главную страницу.

Для изменения размера логотипа, отображаемого с помощью функции the_custom_logo(), можно использовать фильтр get_custom_logo. Этот фильтр позволяет изменить HTML-код логотипа перед его выводом.

Пример кода:


add_filter( 'get_custom_logo', 'custom_logo_size' );
function custom_logo_size( $html ) {
    $html = str_replace( 'custom-logo', 'custom-logo custom-logo-size', $html );
    return $html;
}

Как изменить ссылку на главную страницу, к которой ведет логотип, отображаемый с помощью функции the_custom_logo()?

По умолчанию, логотип, отображаемый с помощью функции the_custom_logo(), является ссылкой на главную страницу сайта. Если тема поддерживает удаление ссылки на главную страницу, то логотип не будет являться ссылкой на главную страницу.

Для изменения ссылки на главную страницу, можно использовать фильтр get_custom_logo_url. Этот фильтр позволяет изменить URL-адрес, на который ведет логотип.

Пример кода:


add_filter( 'get_custom_logo_url', 'custom_logo_url' );
function custom_logo_url( $url ) {
    $url = 'https://example.com';
    return $url;
}

Как изменить классы и атрибуты, применяемые к логотипу, отображаемому с помощью функции the_custom_logo()?

Функция the_custom_logo() выводит пользовательский логотип с классом «custom-logo». Для изменения классов и атрибутов логотипа, можно использовать фильтр get_custom_logo. Этот фильтр позволяет изменить HTML-код логотипа перед его выводом.

Пример кода:


add_filter( 'get_custom_logo', 'custom_logo_attributes' );
function custom_logo_attributes( $html ) {
    $html = str_replace( 'custom-logo', 'custom-logo custom-logo-class', $html );
    $html = str_replace( 'alt=""', 'alt="Custom Logo"', $html );
    return $html;
}

Как добавить альтернативный текст для логотипа, отображаемого с помощью функции the_custom_logo()?

Для добавления альтернативного текста для логотипа, отображаемого с помощью функции the_custom_logo(), нужно использовать фильтр get_custom_logo. Этот фильтр позволяет изменить HTML-разметку логотипа и добавить альтернативный текст.


function custom_logo_alt_text( $html ) {
    $html = str_replace( 'alt=""', 'alt="My Custom Logo"', $html );
    return $html;
}
add_filter( 'get_custom_logo', 'custom_logo_alt_text' );

Как изменить HTML-разметку, используемую для отображения логотипа с помощью функции the_custom_logo()?

Для изменения HTML-разметки, используемой для отображения логотипа с помощью функции the_custom_logo(), нужно использовать фильтр get_custom_logo. Этот фильтр позволяет заменить стандартную разметку на свою.


function custom_logo_markup( $html ) {
    $html = str_replace( 'class="custom-logo-link"', 'class="custom-logo-link my-custom-class"', $html );
    return $html;
}
add_filter( 'get_custom_logo', 'custom_logo_markup' );

Как добавить дополнительные стили для логотипа, отображаемого с помощью функции the_custom_logo()?

Для добавления дополнительных стилей для логотипа, отображаемого с помощью функции the_custom_logo(), нужно использовать фильтр get_custom_logo. Этот фильтр позволяет добавить свои CSS-классы к разметке логотипа.


function custom_logo_styles( $html ) {
    $html = str_replace( 'class="custom-logo-link"', 'class="custom-logo-link my-custom-class"', $html );
    $html = str_replace( 'class="custom-logo"', 'class="custom-logo my-custom-class"', $html );
    return $html;
}
add_filter( 'get_custom_logo', 'custom_logo_styles' );

Как удалить ссылку с логотипа на главную страницу, отображаемого с помощью функции the_custom_logo()?

Для удаления ссылки с логотипа на главную страницу, отображаемого с помощью функции the_custom_logo(), необходимо использовать хук wp_get_attachment_image_attributes. Этот хук позволяет изменить атрибуты изображения, включая ссылку.


function remove_logo_link( $attr ) {
    if ( is_home() ) {
        $attr['href'] = '';
    }
    return $attr;
}
add_filter( 'wp_get_attachment_image_attributes', 'remove_logo_link' );

Для добавления логотипа в подвал (footer) сайта с помощью функции the_custom_logo(), необходимо использовать хук get_custom_logo. Этот хук позволяет изменить вывод логотипа.


function add_logo_to_footer( $html ) {
    if ( is_footer() ) {
        $html .= '<div class="footer-logo">' . get_custom_logo() . '</div>';
    }
    return $html;
}
add_filter( 'get_custom_logo', 'add_logo_to_footer' );

Как изменить порядок отображения логотипа с помощью функции the_custom_logo()?

Для изменения порядка отображения логотипа с помощью функции the_custom_logo(), необходимо использовать хук the_custom_logo. Этот хук позволяет изменить вывод логотипа.


function change_logo_order( $html ) {
    $html = '<div class="logo">' . get_custom_logo() . '</div>';
    return $html;
}
add_filter( 'the_custom_logo', 'change_logo_order' );

Функция the_custom_logo() в WordPress позволяет отображать пользовательский логотип, связанный с главной страницей сайта. С помощью документированных примеров кода можно удалить ссылку с логотипа на главную страницу, добавить логотип в подвал сайта и изменить порядок отображения логотипа. Эти возможности делают функцию the_custom_logo() гибкой и удобной для использования в разработке WordPress-сайтов.

Связанные элементы

  • Функция get_custom_logo(): Возвращает HTML-код для отображения пользовательского логотипа.
  • Функция has_custom_logo(): Проверяет, установлен ли пользовательский логотип для текущего сайта.
  • Хук get_custom_logo: Позволяет изменить HTML-код для отображения пользовательского логотипа.
  • Хук customize_register: Позволяет добавить настройки пользовательского логотипа в пользовательский интерфейс настройки темы.
  • Хук customize_controls_enqueue_scripts: Позволяет добавить скрипты и стили для пользовательского интерфейса настройки темы.
  • Класс WP_Customize_Cropped_Image_Control: Предоставляет возможность настройки обрезанного изображения в пользовательском интерфейсе настройки темы.
  • Класс WP_Customize_Image_Control: Предоставляет возможность настройки изображения в пользовательском интерфейсе настройки темы.
Разработка
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.