Функция get_cat_name() в WordPress: описание, примеры, изменения

## Функция GET_CAT_NAME() │ WP 1.0.0

Функция get_cat_name() позволяет получить название категории по её идентификатору (ID).

### Использует:

Функция: get_term() 

### Хуки

Функция не использует хуки.

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

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

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

```php
get_cat_name( $cat_id );

• $cat_id (int) — обязательный параметр. Идентификатор категории.

Примеры

Пример 1: Выводим название категории 4

Пример 2: Сохраняем название категории 4 в переменную для дальнейшей обработки

// получаем
$catname = get_cat_name( 4 );

// выводим
echo 'Вы находитесь в категории: ' . $catname;

Пример 3: Получаем название текущей категории

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

// если мы на странице категории
if ( is_category() ) {
    echo get_queried_object()->name;
}

Изменения

• С 1.0.0 — Впервые добавлена.

Исходный код функции GET_CAT_NAME() для WP 6.7.2

Файл: wp-includes/category.php

function get_cat_name( $cat_id ) {
    $cat_id   = (int) $cat_id;
    $category = get_term( $cat_id, 'category' );

    if ( ! $category || is_wp_error( $category ) ) {
        return '';
    }

    return $category->name;
}

Связанные функции

• cat_is_ancestor_of() — проверяет, является ли категория предком другой категории.
• category_description() — получает описание категории.
• category_exists() — проверяет, существует ли категория.
• get_cat_ID() — получает ID категории по её названию.
• get_categories() — получает список всех категорий.
• get_category() — получает данные конкретной категории.
• get_category_by_slug() — получает данные категории по её слагу.
• get_category_link() — получает ссылку на категорию.
• get_category_parents() — получает родителей категории.
• get_the_category_by_ID() — получает категорию по её ID.
• in_category() — проверяет, принадлежит ли запись к заданной категории.
• single_cat_title() — выводит название текущей категории.
• wp_create_category() — создает новую категорию.
• wp_dropdown_categories() — создает выпадающий список категорий.
• wp_insert_category() — вставляет новую категорию.
• wp_list_categories() — выводит список категорий.