Как использовать WordPress Custom Logo API

 function mytheme_setup() {
    add_theme_support('custom-logo');
}

add_action('after_setup_theme', 'mytheme_setup');

Теперь ваши пользователи смогут выбрать логотип. Проблема в том, что он еще не отображается. Прежде чем мы рассмотрим, как мы отображаем собственный логотип, я сейчас пройдусь по другому полезному параметру.

Выбор размера логотипа

Логотип является частью идентичности веб-сайта. Однако это не означает, что, как разработчик темы, вы не можете выбирать ее размер. Я думаю, что это может быть довольно важно, поскольку слишком большой логотип может нарушить весь дизайн темы, а это не то, что нам нужно.

Если вы хотите контролировать размер пользовательского логотипа, вам сначала нужно объявить размер с помощью add_image_size() Затем вы указываете этот размер (с выбранным вами именем) в качестве параметра в объявлении поддержки настраиваемого логотипа.

 add_image_size('mytheme-logo', 160, 90);
add_theme_support('custom-logo', array(
    'size' => 'mytheme-logo'
));

Если пользователь выбирает логотип меньшего размера, размер логотипа не изменится. Однако, если размеры изображения больше, чем указано, будь то по высоте и / или ширине, тогда оно будет изменено. Во всех случаях WordPress сохранит исходное соотношение при изменении размера изображения.

Таким образом, пользовательский логотип не будет выше или шире, чем предоставленная область, но он может быть меньше.

Отображение логотипа

Если вы объявите о поддержке функции «Пользовательский логотип», вам нужно будет отобразить выбор пользователя. Для этого вы можете использовать функцию the_custom_logo() Он автоматически отобразит правильный HTML-код для отображения логотипа: изображение нужного размера, инкапсулированное в ссылку, перенаправляющую на домашнюю страницу.

Если по какой-либо причине вы хотите получить этот код, а не просто повторить его, вы также можете использовать get_custom_logo() Обратите внимание, что the_custom_logo()get_custom_logo()

Наконец, третья функция может помочь вам в вашей теме: has_custom_logo() Как следует из названия, эта функция возвращает логическое значение: truefalse

В следующем коде мы показываем собственный логотип, если есть. Мы обнаруживаем существование собственного логотипа с помощью has_custom_logo()

 <?php
// Display the Custom Logo
the_custom_logo();

// No Custom Logo, just display the site's name
if (!has_custom_logo()) {
    ?>
    <h1><?php bloginfo('name'); ?></h1>
    <?php
}
?>

Обратите внимание, что мы не используем has_custom_logo()the_custom_logo() На самом деле, если логотип не отображается, то the_custom_logo()

Ниже приведен еще один способ сделать то же самое. Мы определяем функцию (например, в файле functions.php На этот раз мы используем function_exists()

 function mytheme_custom_logo() {
    // Try to retrieve the Custom Logo
    $output = '';
    if (function_exists('get_custom_logo'))
        $output = get_custom_logo();

    // Nothing in the output: Custom Logo is not supported, or there is no selected logo
    // In both cases we display the site's name
    if (empty($output))
        $output = '<h1><a href="' . esc_url(home_url('/')) . '">' . get_bloginfo('name') . '</a></h1>';

    echo $output;
}

Затем мы можем вызвать эту функцию где угодно, например, в заголовке.

В итоге

По мере выпуска новых версий WordPress Theme Customizer становится все более полезным для конечных пользователей. Теперь пользователи могут персонализировать свой веб-сайт без необходимости изменять код темы.

Благодаря новому API пользовательского логотипа и API-интерфейсу иконки сайта, о котором мы говорили в предыдущей статье, конечный пользователь теперь может более легко контролировать идентичность своего веб-сайта без необходимости специальной разработки.