get_taxonomy()

Возвращает объект таксономии WP_Taxonomу.

Если указанной таксономии не существует, функция возвращает false.

Если вы попали сюда, ища способ получения объекта элемента таксономии WP_Term, то взгляните пожалуйста на функции get_term_by() или get_term().

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>
}

Источник: Блог Миши Рудрастых

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

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

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

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