Выводим описание рубрики или категории в WordPress

Как в WordPress вывести описание категории или рубрики на странице своего сайта?

Чтобы вывести описание категории в WordPress, можно использовать встроенную функцию category_description() или get_the_archive_description(), в зависимости от того, где и как вы хотите отобразить описание.

Вывод описания в файле category.php

В файле шаблона категории (category.php) вставьте следующий код:

Этот код проверяет, есть ли описание для текущей категории, и выводит его, если оно существует.

<?php 
$category_description = category_description(); 
if ( ! empty( $category_description ) ) {
    echo '<div class="category-description">' . $category_description . '</div>';
}
?>

Использование в архивных страницах (в archive.php)

Для архивных страниц категорий можно использовать:

<?php 
if ( is_category() ) {
    the_archive_description( '<div class="archive-description">', '</div>' );
}
?>

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

Примечания:

1. Если описание не выводится, убедитесь, что в вашей теме корректно реализована поддержка категорий и архивных страниц.
2. Если ваша тема не использует category.php или archive.php, проверьте родительский шаблон, например, index.php или taxonomy.php.
3. Для кастомизации стилей добавьте класс .category-description в ваш CSS.

Выводим описание рубрики категории через functions.ph

Чтобы вывести описание категории через functions.php с помощью шорткода, нужно создать кастомный шорткод, который будет возвращать описание категории. Вот пошаговая инструкция:

Шаг 1: Создание шорткода в functions.php

Добавьте следующий код в файл functions.php вашей темы:

function wikiour_category_description_shortcode( $atts ) {
    // Получаем параметры из шорткода
    $atts = shortcode_atts(
        array(
            'id' => '', // ID категории
            'slug' => '', // Слаг категории
        ),
        $atts,
        'category_description'
    );

    // Если указан ID категории
    if ( ! empty( $atts['id'] ) ) {
        $category_id = intval( $atts['id'] );
        $description = category_description( $category_id );

    // Если указан слаг категории
    } elseif ( ! empty( $atts['slug'] ) ) {
        $category = get_category_by_slug( $atts['slug'] );
        $description = $category ? category_description( $category->term_id ) : '';
    } else {
        // Если параметры не указаны, пытаемся получить описание текущей категории
        if ( is_category() ) {
            $description = category_description( get_queried_object_id() );
        } else {
            return 'Описание категории не найдено.';
        }
    }

    // Возвращаем описание или сообщение, если оно пустое
    return ! empty( $description ) ? $description : 'Описание категории отсутствует.';
}

// Регистрируем шорткод Первоклассный контент для разработчиков
add_shortcode( 'category_description', 'wikiour_category_description_shortcode' );

Шаг 2: Использование шорткода

Для вывода описания текущей категории на странице категории:

[ category_description ]

Для вывода описания конкретной категории по ID:

[ category_description id=»5″ ]

Для вывода описания категории по слагу:

[ category_description slug=»novosti» ]

Примечания

• category_description() возвращает HTML, поэтому описание будет выводиться с форматированием. Если нужно удалить HTML-теги, можно использовать wp_strip_all_tags() в функции.
• Убедитесь, что у ваших категорий есть описания, добавленные через админку WordPress.

Вопросы по теме: Вывести описание категории или рубрики