Php wordpress вывести категорию

get_categories() │ WP 2.1.0

Получает категорий в виде массива объектов. По каким критериям получить категории и как их отсортировать указывается в параметрах функции.

Параметры передаваемые этой функции очень похожи на параметры wp_list_categories(). Они также могут быть переданы в виде массива или строки запроса: type=post&order=DESC .

Хуки из функции

Возвращает

Array ( [0] => WP_Term Object ( [term_id] => 7 [name] => Codex [slug] => codex [term_group] => 0 [term_taxonomy_id] => 7 [taxonomy] => category [description] => [parent] => 3 [count] => 17 [filter] => raw [term_order] => 1 [cat_ID] => 7 [category_count] => 17 [category_description] => [cat_name] => Codex [category_nicename] => codex [category_parent] => 3 ) [1] => WP_Term Object ( . ) . )

Шаблон использования

$categories = get_categories( [ 'taxonomy' => 'category', 'type' => 'post', 'child_of' => 0, 'parent' => '', 'orderby' => 'name', 'order' => 'ASC', 'hide_empty' => 1, 'hierarchical' => 1, 'exclude' => '', 'include' => '', 'number' => 0, 'pad_counts' => false, // полный список параметров смотрите в описании функции http://wp-kama.ru/function/get_terms ] ); if( $categories )< foreach( $categories as $cat )< // Данные в объекте $cat // $cat->term_id // $cat->name (Рубрика 1) // $cat->slug (rubrika-1) // $cat->term_group (0) // $cat->term_taxonomy_id (4) // $cat->taxonomy (category) // $cat->description (Текст описания) // $cat->parent (0) // $cat->count (14) // $cat->object_id (2743) // $cat->cat_ID (4) // $cat->category_count (14) // $cat->category_description (Текст описания) // $cat->cat_name (Рубрика 1) // $cat->category_nicename (rubrika-1) // $cat->category_parent (0) > >

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

$categories = get_categories( $args );

Аргументы $args

Полный список параметров смотрите в get_terms().

taxonomy(строка) Название таксономии, которую нужно обрабатывать. Добавлено с версии 3.0.
По умолчанию: ‘category’ type(строка)

Тип категорий, которые будут получены.

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

• id или term_id — по ID.
• name — по названию. По умолчанию.
• count — по полю count в term_taxonomy — по количеству записей.
• slug — по альтернативному названию.
• description — по описанию.
• term_group — по группе.
• term_group — по группе.
• parent — по полю parent.
• include — по порядку указанному в параметре $include
• slug__in — с версии 4.9. В порядке указанном в параметре $slug.
• meta_value — по значению произвольного поля
• meta_value_num — по значению произвольного поля, значение будет интерпретироваться как число, а не строка.
• ключ «meta_query» — в параметре $meta_query мы можем указать параметры запроса по метаполям, и там же указать ключ для конкретного запроса. Этот ключ можно использовать как ключ для сортировки по соответствующему метаполю.
• none — не сортировать

Направление сортировки, указанной в параметре «orderby»:

• ASC — по порядку, от меньшего к большему (1, 2, 3; a, b, c);
• DESC — в обратном порядке, от большего к меньшему (3, 2, 1; c, b, a).

Получать или нет пустые категории (не имеющие записей):

hierarchical(логический) Если параметр установлен в true, то в результат будут включены пустые дочерние категории, дочерние категории которых имеют записи (непустые).
По умолчанию: true exclude(строка/массив) Исключить какие-либо категории из списка. Нужно указывать ID категорий через запятую или в массиве. Если этот параметр указан, параметр child_of будет отменен.
По умолчанию: » include(строка/массив) Вывести списком только указанные категории. Указывать нужно ID категорий через запятую или в массиве.
По умолчанию: » number(число) Лимит. Число категорий, которые будут получены. По умолчанию без ограничений — будут получены все категории. pad_counts(логический) Если передать true, то число которое показывает количество записей в родительских категориях будет суммой своих записей и записей из дочерних категорий.
По умолчанию: false

Примеры

#1 Список категорий и их описание

Этот пример покажет нам как можно вывести списком ссылки на категории, где сразу после каждой ссылки будет идти описание категории (указывается при создании/редактировании категории):

 'name', 'order' => 'ASC' ] ); foreach( $categories as $category )< echo '
Category: name ) . '" ' . '>' . $category->name.' 
 '; echo ' 
Description:'. $category->description . '
'; echo ' 
Post Count: '. (int) $category->count . '
'; > ?>

#2 Получение только категорий верхнего уровня

Для этого, установите значение ‘parent’ => 0 . Этот пример получает ссылку и название категорий верхнего уровня.

$cats = get_categories( array( 'orderby' => 'name', 'parent' => 0 ) ); foreach ( $cats as $cat ) < printf( '%2$s
', esc_url( get_category_link( $cat->term_id ) ), esc_html( $cat->name ) ); >

#3 Выпадающий список

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

wp_dropdown_categories( [ 'hide_empty' => 0, 'name' => 'category_parent', 'orderby' => 'name', 'selected' => $category->parent, 'hierarchical' => true, 'show_option_none' => __('None') ] );

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

Поэтому, в некоторых случаях будет логичнее создать выпадающий список с помощью этой функции — get_categories(). Пример (предполагается что нам нужно вывести подкатегории (дочерние) категории 10):

  '; $option .= $category->name; $option .= ' (' . $category->count . ')'; $option .= ''; echo $option; > ?> 

#4 Получим только категории в которых есть посты

По умолчанию функция get_category() возвращает ТОЛЬКО категории, в которых есть посты (не пустые категории). Это означает, что если для категории не назначен пост, то такая категория не будет получена.

Чтобы этого избежать и показать все категории независимо есть в ней посты или нет, нужно указать параметр ‘hide_empty’ => false :

$args = array( 'hide_empty' => false, ); $cats = get_categories( $args ); // вернет все категории (включая пустые)

Заметки

Список изменений

Код get_categories() get categories WP 6.2.2

function get_categories( $args = '' ) < $defaults = array( 'taxonomy' =>'category' ); $args = wp_parse_args( $args, $defaults ); /** * Filters the taxonomy used to retrieve terms when calling get_categories(). * * @since 2.7.0 * * @param string $taxonomy Taxonomy to retrieve terms from. * @param array $args An array of arguments. See get_terms(). */ $args['taxonomy'] = apply_filters( 'get_categories_taxonomy', $args['taxonomy'], $args ); // Back compat. if ( isset( $args['type'] ) && 'link' === $args['type'] ) < _deprecated_argument( __FUNCTION__, '3.0.0', sprintf( /* translators: 1: "type =>link", 2: "taxonomy => link_category" */ __( '%1$s is deprecated. Use %2$s instead.' ), 'type => link', 'taxonomy => link_category' ) ); $args['taxonomy'] = 'link_category'; > $categories = get_terms( $args ); if ( is_wp_error( $categories ) ) < $categories = array(); >else < $categories = (array) $categories; foreach ( array_keys( $categories ) as $k ) < _make_cat_compat( $categories[ $k ] ); >> return $categories; >

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

Рубрики

• cat_is_ancestor_of()
• category_description()
• category_exists()
• get_cat_ID()
• get_cat_name()
• get_category()
• get_category_by_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()

Источник

Как вывести категории записей в WordPress

Йо-йо! Сегодня я расскажу как можно вывести список категорий в worpdress. Хоть эта тема, на мой взгляд, хорошо освещена до сих пор у многих людей возникают с ней трудности.

И так. Вывести список категорий или как их иначе называют рубрики можно двумя путями. Первый путь это сразу вывести html, а второй получить массив с объектами категорий. Хоть первый вариант и проще в нём есть серьёзный недостаток. Он либо может вывести всё в тэгах , либо в виде ссылок через запятую. Это довольно простой вариант, но как правило нам нужно обернуть категорию во что-то другое, например в . В этом случае нам подойдёт второй вариант. Ну начнём.

$categories = get_categories( array( 'taxonomy' => 'category', 'type' => 'post', 'orderby' => 'name', 'order' => 'ASC', 'number' => 0, ) ); foreach( $categories as $categoty )< // Ваш код. >

$categoty->term_id // id термина таксономии $categoty->name // Название категории $categoty->slug // Слаг $categoty->term_taxonomy_id $categoty->taxonomy // category $categoty->description // Описание рубрики $categoty->parent // Родитель $categoty->count // Количество записей $categoty->cat_ID // ID рубрики $categoty->category_count // Количество категорий $categoty->category_description // Описание рубрики $categoty->cat_name (Рубрика 1) // Название категории $categoty->category_nicename (rubrika-1) // Никнэйм категории $categoty->category_parent (0) // ID родительской категории

get_category_link( $category->term_id );