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

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

Использование функции

Функция использует get_term_by() для поиска категории.

Возврат:

• Если категория найдена, возвращает идентификатор категории (тип int).
• Если категория не найдена, возвращает 0.

Синтаксис

get_cat_ID( $cat_name );

Параметры

• $cat_name (string) — Название категории (обязательный параметр).

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

Пример 1: Получение идентификатора категории

$cat_id = get_cat_ID( 'Имя категории' );

Пример 2: Использование идентификатора категории

Эта функция полезна в таких случаях, как использование функции category_description(), которая требует идентификатор категории:

$cat_id = get_cat_ID( 'Имя категории' ); 
echo "Описание категории 'Имя категории': " . category_description( $cat_id );

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

Пример использования этой функции для получения постов из конкретной категории с помощью query_posts():

$category_id = get_cat_ID('Имя категории');

$q = 'cat=' . $category_id;

query_posts( $q );

if( have_posts() ){
    while( have_posts() ){
        the_post();
        the_content();
    }
}

wp_reset_query();

Код функции

Ниже представлен код функции get_cat_ID():

function get_cat_ID( $cat_name ) {
$cat = get_term_by( 'name', $cat_name, 'category' );

if ( $cat ) {
    return $cat->term_id;
}

return 0;

}

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

Вот некоторые функции, которые могут быть полезны в работе с категориями:

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

Теперь вы можете легко использовать функцию get_cat_ID() для работы с категориями в WordPress!