Как вывести описание категории в WordPress с помощью функции category_description().

Описание рубрик чаще всего используется для создания информативной структуры категорий статей или товаров, а также для seo продвижения данных страниц. В данной статье мы разберемся с тем как вывести описание рубрики в WordPress, а также рассмотрим некоторые нюансы, с которыми вы столкнетесь при разработке такого блока содержимого.

Где добавлять описание категории?

Описание категории в WordPress можно добавить, перейдя в админку в раздел «Записи» — «Рубрики» и выбрав пункт «Настроить».

Как вывести описание категории в WordPress при помощи возможности category_description().

Ниже можно увидеть поле ввода «Описание».

Как вывести описание категории в WordPress при помощи возможности category_description().

Сюда вводят текст описания, после чего жмем кнопку «Обновить». Добавить текст описания можно и при создании рубрики.

Методы вывода описания рубрики в WordPress

Давайте смоделируем разные ситуации, в которых вам необходимо вывести описание для категории.

Для редактирования страниц рубрик найдите в папке темы файл category.php, если нет то archive.php.

1. На странице самой категории.

Чтобы вывести описание рубрики в WordPress используется функцию — category_description().

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

<?php $description = category_description( $category_id);?>

Здесь принимаемый настройка $category_id – данное id категории, описание которой вы планируете вывести. Посмотреть значение id, можно без проблем перейдя в админку в раздел «Записи» — «Рубрики» нажать на кнопку настроить в строке нужной вам категории и в строке браузера вы увидите данное значение.

Как вывести описание категории в WordPress при помощи возможности category_description().

Чтобы вывести описание на странице текущей категории следует использовать код.

<?php echo category_description();?>

Тут есть важный момент. В случае использования category_description() на странице архива, отличной от category.php, то вам необходимо произвести проверку на то генерируется ли страница категории, а не страница автора, меток или другая таксономия.

Сделать данное можно легко при помощи условного оператора is_category().

<?php if(is_category){ echo category_description(); }?>

2. На любой произвольной странице.

Для вывода данной информации на любой произвольной странице используют ту же возможность category_description(), но указывают значение параметры id.

Можно легко прямо ввести числовое значение id.

<?php echo category_description(19);?>

Либо же определить id при помощи возможности get_the_category().

<?php $catID = get_the_category(); echo category_description( $catID[0]);?>

3. Как вывести описание только на первой странице категории при наличии пагинации в WordPress?

Данное важная задача, которая поможет избежать дублирования контента на страницах пагинации. Сделать данное можно при помощи следующего кода.

<?php if(is_category()) { if(is_paged()) { echo '';} else { echo category_description(); } }?>

4. Выводим блок с описанием только в случае его заполнения.

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

<?php if( $category_description = category_description())   echo '<div class="category__description">'. $category_description.'</div>';    else echo '<div class="no__category__description">Описание не найдено.</div>';?>

Альтернативный вариант

Ещё один метод вывести описание рубрики на странице самой рубрики в WordPress – данное использовать возможность — the_archive_description(). Она комплексно может отображать описание для разных таксономий, страниц авторов, меток, категорий, архивов и пр.

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

<?php the_archive_description( $before, $after);?>

Где $before – данное текст перед описанием. Можно без проблем указать HTML. А $after – данное текст после описания. Можно без проблем указать HTML. Пример использования данных настроек.

<?php the_archive_description( '<div class="taxonomy-description">', '</div>');?>

Шотркод с функционалом вывода списка категорий в формате: название + описание.

Для создания такого шорткода, вам необходимо будет добавить код, приведенный ниже в файл functions.php темы на WordPress.

function wp_catlist_description() {$string = '<ul>';$catlist = get_terms( 'category');if(! empty( $catlist)) {foreach( $catlist as $key => $item) {$string.= '<li>'. $item->name. '<br />';$string.= '<em>'. $item->description. '</em></li>';}}$string.= '</ul>';return $string;}add_shortcode('wp_categories_list', 'wp_catlist_description');add_filter('widget_text', 'do_shortcode');

Далее вы можете использовать шорткод для вывода данного блока.

[wp_categories_list]

В админке данное выглядит следующим образом.

Как вывести описание категории в WordPress при помощи возможности category_description().

А на веб-сайте вот так.

Как вывести описание категории в WordPress при помощи возможности category_description().

На этом сегодня все. Мы разобрались, как работать с описанием категорий в WordPress в разных ситуациях и как эффективно отображать этот блок при seo оптимизации проекта.

Добавить комментарий

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