Возвращает объект таксономии WP_Taxonomу.
Если указанной таксономии не существует, функция возвращает false
.
get_taxonomy( $taxonomy )
Параметры
- $taxonomy
- (строка) Название таксономии, например
category
,post_tag
или произвольной таксономии.
WP_Taxonomy
Объект таксономии имеет плюс-минус все те же свойства, которые мы указывали как параметры при её регистрации.
Попробуем получить и распечатать его функцией print_r()
для стандартной таксономии рубрик.
$category = get_taxonomy( 'category' ); print_r( $category ); /* WP_Taxonomy Object ( [name] => category [label] => Рубрики [labels] => stdClass Object ( [name] => Рубрики [singular_name] => Рубрика [search_items] => Поиск рубрик [popular_items] => [all_items] => Все рубрики [parent_item] => Родительская рубрика [parent_item_colon] => Родительская рубрика: [name_field_description] => Название определяет, как элемент будет отображаться на вашем сайте. [slug_field_description] => «Ярлык» — это вариант названия, подходящий для URL. Обычно содержит только латинские буквы в нижнем регистре, цифры и дефисы. [parent_field_description] => Назначьте родительский элемент для создания иерархии. "Джаз" например может быть родителем для "Бибоп" и "Биг-бэнд". [desc_field_description] => Описание по умолчанию не отображается, однако некоторые темы могут его показывать. [edit_item] => Изменить рубрику [view_item] => Просмотреть рубрику [update_item] => Обновить рубрику [add_new_item] => Добавить новую рубрику [new_item_name] => Название новой рубрики [separate_items_with_commas] => [add_or_remove_items] => [choose_from_most_used] => [not_found] => Рубрик не найдено. [no_terms] => Рубрик нет [filter_by_item] => Фильтр по рубрике [items_list_navigation] => Навигация по списку рубрик [items_list] => Список рубрик [most_used] => Часто используемые [back_to_items] => ← Перейти к рубрикам [item_link] => Category Link [item_link_description] => Ссылка на рубрику. [menu_name] => Рубрики [name_admin_bar] => category ) [description] => [public] => 1 [publicly_queryable] => 1 [hierarchical] => 1 [show_ui] => 1 [show_in_menu] => 1 [show_in_nav_menus] => 1 [show_tagcloud] => 1 [show_in_quick_edit] => 1 [show_admin_column] => 1 [meta_box_cb] => post_categories_meta_box [meta_box_sanitize_cb] => taxonomy_meta_box_sanitize_cb_checkboxes [object_type] => Array ( [0] => post ) [cap] => stdClass Object ( [manage_terms] => manage_categories [edit_terms] => edit_categories [delete_terms] => delete_categories [assign_terms] => assign_categories ) [rewrite] => Array ( [with_front] => 1 [hierarchical] => 1 [ep_mask] => 512 [slug] => category ) [query_var] => category_name [update_count_callback] => [show_in_rest] => 1 [rest_base] => categories [rest_namespace] => wp/v2 [rest_controller_class] => WP_REST_Terms_Controller [rest_controller] => [default_term] => [sort] => [args] => [_builtin] => 1 ) */
Описание всех этих свойств вы можете найти здесь.
Пример
Эта функция в основном довольно часто используется в ядре WordPress и является основой для многих других функций.
При использовании объекта таксономии в плагинах и темах WordPress чаще всего из него получают значения свойства labels
.
Например:
$category = get_taxonomy( 'category' ); if( $category ) { echo '<a href="#">' . $category->labels->edit_item . '</a>'; // <a href="#">Изменить рубрику</a> }