Функция the_custom_logo() в WordPress: как использовать и примеры работы

# Функция the_custom_logo() в WordPress

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

### Использование
Эта функция использует еще одну функцию — get_custom_logo(), чтобы получить информацию о логотипе.

#### Как работает функция

```php
the_custom_logo( $blog_id );
  • $blog_id (int) — это ID блога, для которого вы хотите отобразить логотип.
  • По умолчанию: ID текущего блога.

Примеры работы с логотипом

1. Получение URL изображения логотипа

Чтобы получить URL логотипа, можно использовать следующий код:

$custom_logo_id = get_theme_mod( 'custom_logo' );
$image = wp_get_attachment_image_src( $custom_logo_id, 'full' );
echo $image[0];

Этот код получит ID вашего логотипа, а затем извлечет URL логотипа.

2. Вывод логотипа сайта

Чтобы вывести логотип на сайт, используйте:

Эта команда сгенерирует HTML-код, который будет выглядеть примерно так:

3. Получение логотипа без ссылки на главную страницу

Если вам нужен логотип без ссылки, используйте:

$logo_img = '';
$custom_logo_id = get_theme_mod( 'custom_logo' );

if( $custom_logo_id ){
    $logo_img = wp_get_attachment_image( $custom_logo_id, 'full', false, array(
        'class'    => 'custom-logo',
        'itemprop' => 'logo',
    ) );
}

echo $logo_img;

4. Добавление логотипа на страницу входа

Чтобы добавить свой логотип на страницу входа в WordPress, используйте следующий код:

add_action( 'login_head', 'wpdev_filter_login_head', 100 );

function wpdev_filter_login_head() {
    if ( has_custom_logo() ) :
        $image = wp_get_attachment_image_src( get_theme_mod( 'custom_logo' ), 'full' );
        ?>
        
        

Также можно заменить ссылку на WordPress на ссылку на ваш сайт:

add_filter( 'login_headerurl', 'new_wp_login_url');

function new_wp_login_url() {
    return home_url();
}

Изменения в функции

Функция the_custom_logo() была введена в WordPress начиная с версии 4.5.0.

Структура функции

Функция the_custom_logo() выглядит следующим образом:

function the_custom_logo( $blog_id = 0 ) {
    echo get_custom_logo( $blog_id );
}

Связанные функции

Вот несколько других функций, которые могут быть полезны при работе с логотипами и темами:

  • get_custom_logo()
  • has_custom_logo()
  • add_theme_support()
  • bloginfo()
  • body_class()
  • get_theme_mod()

Эти функции помогут вам лучше управлять элементами дизайна вашего сайта на WordPress.

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *