get_category() — получает всю информацию о категории с указанным ID

Ключевая функция для работы с конкретной рубрикой, позволяет получить всю необходимую информацию о ней — достаточно лишь знать ID рубрики.

Если информации о категории не существует в кеше, тогда она достается из базы данных.

get_category( $category, $output, $filter )

$category
(целое число|объект) (обязательное) — ID рубрики или объект, в случае использования объекта в качестве параметра данные будут закешированы.

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

$output
(строка) (необязательное) — позволяет задать формат вывода:

  • OBJECT (по умолчанию) — объект;
    $category = get_category(5);
    echo '<a href="' . get_category_link( $category->term_id ) . '">' . $category->name . '</a>';

    Полный список выводимых значений (в скобках указаны эквивалентные варианты).

    term_id (cat_id) – ID рубрики,
    name (cat_name) – название рубрики,
    slug (category_nicename) – ярлык категории,
    description (category_description) – описание категории,
    parent (category_parent) – ID родительской категории,
    count (category_count) – количество записей (постов) в рубрике,
    term_group – значение колонки term_group в базе данных,
    term_taxonomy_id – ID таксономии, у рубрик он равен 1,
    taxonomy – название таксономии, для рубрик – category,
    object_id – ID объекта;

  • ARRAY_A — ассоциативный массив;
    $category = get_category(5, 'ARRAY_A');
    echo '<a href="' . get_category_link( $category['term_id'] ) . '">' . $category['name'] . '</a>';
  • ARRAY_N — индексированный массив;
  • $category = get_category(5, 'ARRAY_A');
    echo '<a href="' . get_category_link( $category[0] ) . '">' . $category[1] . '</a>';

    Чтобы узнать, какой индекс соответствует каждому параметру в этом случае, можно пропустить массив через функцию print_r(), то есть print_r($category)

$filter
(строка) (необязательное) позволяет пропустить выводимые значения через фильтр (это тема для отдельной статьи, когда она будет готова, тут появится ссылка).

  • raw (по умолчанию) — не применять фильтры

Источник: misha.blog

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

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

%d такие блоггеры, как: