# Функция 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.