Получение Описания Категории в WordPress

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

Описание Функции

Функция category_description() предназначена для извлечения описания указанной категории.

Использование

Для вызова функции используется следующий синтаксис:

category_description( $category );

• $category (int) — ID категории.
• По умолчанию: используется ID текущей категории.

Возвращаемое Значение

Функция возвращает строку — описание категории, если оно доступно.

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

Пример 1: Отображение Описания Категории

С помощью оператора echo мы можем отобразить описание категории с ID 3:

Этот код выведет описание категории с ID 3 н�� экран.

Пример 2: Вывод Описания Только Если Оно Существует

Можно проверить, есть ли описание категории, и вывести его, только если оно действительно доступно:

$cat_desc = category_description();

if ( $cat_desc ) {
    echo '
'. $cat_desc .'
';
} else {
    echo '
Описание отсутствует!
';
}

В этом примере, если описание есть, оно будет выведено в элементе <div>, а если отсутствует — сообщим об этом.

Пример 3: Получение Описания через Слаг

Можно получить описание категории, используя слаг (альтернативное название категории) вместо ID. Для этого сначала необходимо получить ID категории с помощью функции get_category_by_slug():

$term = get_category_by_slug( 'category-slug' );

if( $term ){
    echo category_description( $term->term_id ); 

    // или
    echo esc_html( $term->description );
}

В данном примере мы используем слаг category-slug, чтобы извлечь ID, а затем выводим описание.

Пример 4: Очистка Описания в Выводе

Если в описании категории есть короткие коды, которые вы не хотите использовать, можно удалить их с помощью фильтра. Например, чтобы убрать короткий код для изображения:

add_filter( 'term_description', 'clear_term_description_image_shortcode' );

function clear_term_description_image_shortcode( $value ){
    return preg_replace( '/[image=[^]]*]/', '', $value );
}

Код выше удаляет любой текст, который соответствует шаблону короткого кода [image=...].

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

Вот как выглядит внутренняя структура функции category_description() в коде WordPress:

function category_description( $category = 0 ) {
    return term_description( $category );
}

Эта функция просто вызывает другую функцию term_description(), передавая ей ID категории.

Заключение

Функция category_description() в WordPress — это полезный инструмент для работы с описаниями категорий. Теперь вы знаете, как получить описание категории, использовать слаг и обрабатывать возможные проблемы с выводом.

Если у вас есть дополнительные вопросы или вы хотите узнать больше, не стесняйтесь экспериментировать с примерами!