WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

register_taxonomy() WP 2.3

Добавляет (регистрирует) новую (пользовательскую) таксономию. Можно перезаписать существующую таксономию.

Функцию желательно вызывать во время события init:

add_action( 'init', 'function_name' );

В качестве названия для новой таксономии нужно указывать уникальное имя, отличное от уже имеющихся таксономий, типов постов и зарезервированных WordPress публичных и частных переменных.

Полный список названий (черный список), которые не могут быть использованы, в качестве имени новой таксономии.

Когда нужно зарегистрировать новый тип записи, используйте register_post_type()

Удобный плагин, который позволяет регистрировать новые типы записей и таксономии: Custom Post Type UI

Работает на основе: WP_Taxonomy()
Хуки из функции
Возвращает

WP_Error/null.

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

// хук для регистрации
add_action( 'init', 'create_taxonomy' );
function create_taxonomy(){

	// список параметров: wp-kama.ru/function/get_taxonomy_labels
	register_taxonomy( 'taxonomy', [ 'post' ], [ 
		'label'                 => '', // определяется параметром $labels->name
		'labels'                => [
			'name'              => 'Genres',
			'singular_name'     => 'Genre',
			'search_items'      => 'Search Genres',
			'all_items'         => 'All Genres',
			'view_item '        => 'View Genre',
			'parent_item'       => 'Parent Genre',
			'parent_item_colon' => 'Parent Genre:',
			'edit_item'         => 'Edit Genre',
			'update_item'       => 'Update Genre',
			'add_new_item'      => 'Add New Genre',
			'new_item_name'     => 'New Genre Name',
			'menu_name'         => 'Genre',
		],
		'description'           => '', // описание таксономии
		'public'                => true,
		// 'publicly_queryable'    => null, // равен аргументу public
		// 'show_in_nav_menus'     => true, // равен аргументу public
		// 'show_ui'               => true, // равен аргументу public
		// 'show_in_menu'          => true, // равен аргументу show_ui
		// 'show_tagcloud'         => true, // равен аргументу show_ui
		// 'show_in_quick_edit'    => null, // равен аргументу show_ui
		'hierarchical'          => false,

		'rewrite'               => true,
		//'query_var'             => $taxonomy, // название параметра запроса
		'capabilities'          => array(),
		'meta_box_cb'           => null, // html метабокса. callback: `post_categories_meta_box` или `post_tags_meta_box`. false — метабокс отключен.
		'show_admin_column'     => false, // авто-создание колонки таксы в таблице ассоциированного типа записи. (с версии 3.5)
		'show_in_rest'          => null, // добавить в REST API
		'rest_base'             => null, // $taxonomy
		// '_builtin'              => false,
		//'update_count_callback' => '_update_post_term_count',
	] );
}

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

register_taxonomy( $taxonomy, $object_type, $args );
$taxonomy(строка) (обязательный)
Название создаваемой таксономии.
Может содержать только строчные латинские символы, числа и _, т.е. a-z0-9_.
По умолчанию: ''
$object_type(строка/массив) (обязательный)
Название типов постов, к которым будет привязана таксономия. В этом параметре, например, можно указать 'post', тогда у обычных постов WordPress появится новая таксономия (возможность классификации).
По умолчанию: ''
$args(массив) (обязательный)
Массив аргументов определяющий признаки таксономии.
По умолчанию: нет

Аргументы параметра $args

label(строка)
Название таксономии во множественном числе (для отображения в админке).
По умолчанию: используется значение аргумента $labels->name
labels(массив)

Массив описывающий заголовки таксономии (для отображения в админке).

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

  • name
    Имя таксономии, обычно во множественном числе. По умолчанию _x( 'Post Tags', 'taxonomy general name' ) или _x( 'Categories', 'taxonomy general name' );

  • singular_name
    Название для одного элемента этой таксономии. По умолчанию _x( 'Post Tag', 'taxonomy singular name' ) или _x( 'Category', 'taxonomy singular name' );

  • menu_name
    Текст для названия меню. Эта строка обозначает название для пунктов меню. По умолчанию значение параметра name;

  • search_items
    Текст для поиска элемента таксономии. По умолчанию __( 'Search Tags' ) или __( 'Search Categories' );

  • popular_items
    Текст для блока популярных элементов. __( 'Popular Tags' ) или null;

  • all_items
    Текст для всех элементов. __( 'All Tags' ) или __( 'All Categories' );

  • parent_item
    Текст для родительского элемента таксономии. Этот аргумент не используется для не древовидных таксономий. По умолчанию null или __( 'Parent Category' );

  • parent_item_colon
    Текст для родительского элемента таксономии, тоже что и parent_item но с двоеточием в конце. По умолчанию нет или __( 'Parent Category:' );

  • edit_item
    Текст для редактирования элемента. По умолчанию __( 'Edit Tag' ) или __( 'Edit Category' );

  • update_item
    Текст для обновления элемента. По умолчанию __( 'Update Tag' ) или __( 'Update Category' );

  • add_new_item
    Текст для добавления нового элемента таксономии. По умолчанию __( 'Add New Tag' ) или __( 'Add New Category' );

  • view_item
    Текст для просмотра термина таксономии. По умолчанию: "Посмотреть метку", "Посмотреть категорию". Используется например, в админ баре (тулбаре).

  • new_item_name
    Текст для создания нового элемента таксономии. По умолчанию __( 'New Tag Name' ) или __( 'New Category Name' );

  • separate_items_with_commas
    Текст описывающий, что элементы нужно разделять запятыми (для блога в админке). Не работает для древовидного типа. По умолчанию __( 'Separate tags with commas' ) или null;

  • add_or_remove_items
    Текст для "удаления или добавления элемента", который используется в блоке админке, при отключенном javascript. Не действует для древовидных таксономий. По умолчанию __( 'Add or remove tags' ) или null;

  • choose_from_most_used
    текст для блога при редактировании поста "выберите из часто используемых". Не используется для древовидных таксономий. По умолчанию __( 'Choose from the most used tags' ) или null;

  • popular_items
    Текст для поиска популярных терминов. Этот параметр не используется для древовидных таксономий. По умолчанию: "Популярные метки" или null.

  • separate_items_with_commas
    Текст говорящий о том, что термины (метки) нужно разделять запятыми. Не используется для древовидных таксономий. По умолчанию: "Разделяйте метки запятыми" или null.

  • add_or_remove_items
    Текст для добавления или удаления терминов. Не используется для древовидных типов. По умолчанию: "Добавить или удалить метки". или null.

  • choose_from_most_used
    Текст "Выбрать из часто используемых". Не используется для древовидных типов.

  • not_found
    Текст "не найдено", который отображается, если при клике на часто используемые ни один термин не был найден.

Весь список смотрите в описании get_taxonomy_labels()

По умолчанию: заголовки меток/категорий

public(логический)
Показывать ли эту таксономию в интерфейсе админ-панели. Это значение передается параметрам publicly_queryable, show_ui, show_in_nav_menus если для них не установлено свое значение.
По умолчанию: true
show_ui(логический)
Показывать блок управления этой таксономией в админке.
По умолчанию: если нет, равно аргументу public
show_in_menu(логический)

Показывать ли таксономию в админ-меню.

  • true - таксономия будет показана как подменю у типа записи, к которой она прикреплена.
  • false - подменю не будет показано.

Параметр $show_ui должен быть включен (true).

По умолчанию: если нет, равно аргументу show_ui

show_in_nav_menus(логический)
true даст возможность выбирать элементы этой таксономии в навигационном меню.
По умолчанию: если нет, равно аргументу public
show_tagcloud(логический)
Создать виджет облако элементов этой таксономии (как облако меток).
По умолчанию: если нет, равно аргументу show_ui
show_in_rest(логический)
Нужно ли включать таксономию в REST API. С WP 4.7.
rest_base(строка)
Ярлык в REST API. По умолчанию, название таксономии. С WP 4.7.
По умолчанию: $taxonomy
rest_controller_class(строка)
Название класса контроллера в REST API. С WP 4.7.
По умолчанию: 'WP_REST_Terms_Controller'
hierarchical(логический)
true - таксономия будет древовидная (как категории). false - будет не древовидная (как метки).
По умолчанию: false
update_count_callback(строка)

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

По умолчанию:

  • _update_post_term_count для таксономий прикрепленных к типам записей.
  • _update_generic_term_count для таксономий, присоединенных к другим объектам, например, к юзерам.

Функция получит следующие параметры:

  • $termsterm_taxonomy_id терминов которые нужно обновить.
  • $taxonomy — Объект таксономии.

По умолчанию: '_update_post_term_count' или '_update_generic_term_count'

rewrite(массив/логический)

false - отключит перезапись. Если указать массив, то можно задать произвольный параметр запроса (query var). А по умолчанию будет использоваться параметр $taxonomy.

Возможные аргументы массива:

  • slug - предваряет таксономии этой строкой. По умолчанию название таксономии;
  • with_front - позволяет установить префикс для постоянной ссылки. По умолчанию true;
  • hierarchical - true - включает поддержку древовидных URL (с версии 3.1). По умолчанию false;

Массив передается в функцию add_permastruct(), поэтому тут также можно указать аргументы этой функции.

По умолчанию: true

publicly_queryable(логический)
Имеют ли пользователи доступ к элементам таксономии во внешней части сайта. Если не установлено, то берется значение параметра public. C версии 4.5.
По умолчанию: null (равен аргументу public)
query_var(строка/логический)
Если указать false, выключит параметры запроса и сам запрос. Или можно указать строку, чтобы изменить параметр запроса (query var). По умолчанию будет использоваться параметр $taxonomy - название таксономии.
По умолчанию: $taxonomy
capabilities(массив)

Массив прав для этой таксономии:

  • manage_terms - 'manage_categories'
  • edit_terms - 'manage_categories'
  • delete_terms - 'manage_categories'
  • assign_terms - 'edit_posts'

По умолчанию: нет

meta_box_cb(строка)

callback функция. Отвечает за то, как будет отображаться таксономия в метабоксе (с версии 3.8).

Встроенные названия функций:

  • post_categories_meta_box - показывать как категории
  • post_tags_meta_box - показывать как метки.

Если указать false, то метабокс будет отключен вообще.

По умолчанию: null

show_admin_column(логический)
Позволить или нет авто-создание колонки таксономии в таблице ассоциированного типа записи. (с версии 3.5)
По умолчанию: false
show_in_quick_edit(логический)
Показывать ли таксономию в панели быстрого редактирования записи (в таблице, списке всех записей, при нажатии на кнопку "свойства"). С версии 4.2.
По умолчанию: null (значение show_ui)
sort(логический)

Следует ли этой таксономии запоминать порядок в котором созданные элементы (термины) прикрепляются к объектам (записям).

Например, для тегов, если этот параметр true, то при получении тегов они должны выводиться в том порядке, в котором они были указаны (добавлены) для записи. Т.е. если этот флаг установлен, то сортировка терминов должна быть не по name а по полю term_order.

При true в таблицу wp_term_relationships в поле term_order будет записываться число - порядок в котором расположены рубрики, в которые добавлена запись. Чаще всего эта настройка не нужна, более того, параметр этот есть, но в коде он нигде не прописан и по факту ни на что не виляет.
По умолчанию: null

_builtin(логический) (не для обычного использования)
Параметр предназначен для разработчиков. Если переключить на true, то это будет означать что эта таксономия относится к внутренним таксономия WordPress и не является встроенной (кастомной).
По умолчанию: false

Примеры

#1. Регистрация таксономий

Пример регистрации двух таксономий "genres" и "writers" для постов типа "book". Этот код можно вставить в файл темы functions.php. Некоторые аргументы рассчитаны на версию 3.1+:

// хук, через который подключается функция
// регистрирующая новые таксономии (create_book_taxonomies)
add_action( 'init', 'create_book_taxonomies' );

// функция, создающая 2 новые таксономии "genres" и "writers" для постов типа "book"
function create_book_taxonomies(){

	// Добавляем древовидную таксономию 'genre' (как категории)
	register_taxonomy('genre', array('book'), array(
		'hierarchical'  => true,
		'labels'        => array(
			'name'              => _x( 'Genres', 'taxonomy general name' ),
			'singular_name'     => _x( 'Genre', 'taxonomy singular name' ),
			'search_items'      =>  __( 'Search Genres' ),
			'all_items'         => __( 'All Genres' ),
			'parent_item'       => __( 'Parent Genre' ),
			'parent_item_colon' => __( 'Parent Genre:' ),
			'edit_item'         => __( 'Edit Genre' ),
			'update_item'       => __( 'Update Genre' ),
			'add_new_item'      => __( 'Add New Genre' ),
			'new_item_name'     => __( 'New Genre Name' ),
			'menu_name'         => __( 'Genre' ),
		),
		'show_ui'       => true,
		'query_var'     => true,
		//'rewrite'       => array( 'slug' => 'the_genre' ), // свой слаг в URL
	));

	// Добавляем НЕ древовидную таксономию 'writer' (как метки)
	register_taxonomy('writer', 'book',array(
		'hierarchical'  => false,
		'labels'        => array(
			'name'                        => _x( 'Writers', 'taxonomy general name' ),
			'singular_name'               => _x( 'Writer', 'taxonomy singular name' ),
			'search_items'                =>  __( 'Search Writers' ),
			'popular_items'               => __( 'Popular Writers' ),
			'all_items'                   => __( 'All Writers' ),
			'parent_item'                 => null,
			'parent_item_colon'           => null,
			'edit_item'                   => __( 'Edit Writer' ),
			'update_item'                 => __( 'Update Writer' ),
			'add_new_item'                => __( 'Add New Writer' ),
			'new_item_name'               => __( 'New Writer Name' ),
			'separate_items_with_commas'  => __( 'Separate writers with commas' ),
			'add_or_remove_items'         => __( 'Add or remove writers' ),
			'choose_from_most_used'       => __( 'Choose from the most used writers' ),
			'menu_name'                   => __( 'Writers' ),
		),
		'show_ui'       => true,
		'query_var'     => true,
		//'rewrite'       => array( 'slug' => 'the_writer' ), // свой слаг в URL
	));
}

#2 Добавление таксономии в ЧПУ

Смотрите в примерах к описаниям функций: register_post_type(), WP_Rewrite

#3 Переименования названий таксономии

Код ниже, показывает как переименовать имеющуюся таксономию category (рубрики).

## Переименуем таксономию category (рубрики)
add_action( 'init', function(){
	global $wp_taxonomies;

	$labels                     = & $wp_taxonomies['category']->labels;
	$labels->name               = 'Author';
	$labels->singular_name      = 'Author';
	$labels->add_new            = 'Add Author';
	$labels->add_new_item       = 'Add Author';
	$labels->edit_item          = 'Edit Author';
	$labels->new_item           = 'Author';
	$labels->view_item          = 'View Author';
	$labels->search_items       = 'Search Authors';
	$labels->not_found          = 'No Authors found';
	$labels->not_found_in_trash = 'No Authors found in Trash';
	$labels->all_items          = 'All Authors';
	$labels->menu_name          = 'Author';
	$labels->name_admin_bar     = 'Author';

} );

Заметки

  • Global. Массив. $wp_taxonomies Registered taxonomies.

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

С версии 2.3.0 Введена.
С версии 4.2.0 Introduced show_in_quick_edit argument.
С версии 4.4.0 The show_ui argument is now enforced on the term editing screen.
С версии 4.4.0 The public argument now controls whether the taxonomy can be queried on the front end.
С версии 4.5.0 Introduced publicly_queryable argument.
С версии 4.7.0 Introduced show_in_rest, 'rest_base' and 'rest_controller_class' arguments to register the Taxonomy in REST API.
С версии 5.1.0 Introduced meta_box_sanitize_cb argument.

Код register taxonomy: wp-includes/taxonomy.php WP 5.2.3

<?php
function register_taxonomy( $taxonomy, $object_type, $args = array() ) {
	global $wp_taxonomies;

	if ( ! is_array( $wp_taxonomies ) ) {
		$wp_taxonomies = array();
	}

	$args = wp_parse_args( $args );

	if ( empty( $taxonomy ) || strlen( $taxonomy ) > 32 ) {
		_doing_it_wrong( __FUNCTION__, __( 'Taxonomy names must be between 1 and 32 characters in length.' ), '4.2.0' );
		return new WP_Error( 'taxonomy_length_invalid', __( 'Taxonomy names must be between 1 and 32 characters in length.' ) );
	}

	$taxonomy_object = new WP_Taxonomy( $taxonomy, $object_type, $args );
	$taxonomy_object->add_rewrite_rules();

	$wp_taxonomies[ $taxonomy ] = $taxonomy_object;

	$taxonomy_object->add_hooks();

	/**
	 * Fires after a taxonomy is registered.
	 *
	 * @since 3.3.0
	 *
	 * @param string       $taxonomy    Taxonomy slug.
	 * @param array|string $object_type Object type or array of object types.
	 * @param array        $args        Array of taxonomy registration arguments.
	 */
	do_action( 'registered_taxonomy', $taxonomy, $object_type, (array) $taxonomy_object );
}

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

Из метки: Расширения WP (доп возможности регистрация)

Еще из раздела: Любые таксономии

70 комментов
Полезные 8 Вопросы 4 Все
  • Александр www.dom-zemlya.com

    Про rewrite можете чуток более подробней написать, что он делает?)

    Ответить7.7 лет назад #
  • Евгений how-to-foto.ru

    С интересным вопросом столкнулся - как посмотреть все записи древовидной таксономии? Адрес не могу найти, какой использовать. Вот к примеру есть таксономия tax1, в ней рубрики rub1 и rub2. Соответственно, чтобы увидеть записи рубрики 1, адрес - site.ru/tax1/rub1. А если нуно записи обеих рубрик? Не попадался ответ на такой вопрос?

    Ответить7.1 лет назад #
  • Timur

    Здравствуй Тимур, такая проблема: у меня около 80 таксономий, после того как я все их добавил, сервер выдает такие цифры:
    до: 44 queries 0.352 seconds
    после: 206 queries 0.703 seconds
    выяснил, что у меня каждая новая таксономия добавляет по 2 запроса. Что делать или так и должно быть?
    Функцию с таксономиями добавляю через add_action.
    Ответь, пожалуйста..

    Ответить6.10 лет назад #
  • Dzirt

    Доброго времени суток! Благодарю за статью. Я в php, к сожалению, почти ламер, посему не судите строго за след.вопрос: А как сделать, чтобы "писатель" и "жанр" отображались на сайте на страничке-цикле, где идут эти самые записи-"книги"?

    Ответить6.5 лет назад #
    • Dzirt

      А, уже разобрался smile Может кому надо - помог кодекс WordPress (там, правда на англ.) - ну а у Вас на рус. есть - вот ссылочка http://wp-kama.ru/function/the_terms

      Вообщем, как я понял, вставляем в файл-цикл.php своей темы в желаемое место вызов the_terms(), например:

      <?php
      $custom_tax = writer; // указываем регистрационный "домен" своей таксономии из function.php
      $before = 'Таксономия: ';
      $sep = ' , ';
      $after = ' блока Книг ';
      
      the_terms( $post->ID, $custom_tax, $before, $sep, $after );
      ?>

      Надеюсь, я правильно разобрался? blush
      Ещё раз - огромное спасибо Вам за необходимую инфу thank_you

      Ответить6.5 лет назад #
  • smargelov smargelov.com

    Добрый день.
    Помогите мне пожалуйста.
    Создал таксономию product. Всё хорошо. Могу создавать пункты и добавлять их к постам. Но этого мало. Нужна ваша помощь.
    В файле архива заголовок выводится примерно так (на примере тегов):

    elseif( is_tag() ) { ?>
    	<h1>Метка "<?php single_tag_title(); ?>"</h1>
    	<?php echo tag_description(); ?>

    Как мне вывести заголовок моей новой таксономии?
    А так же, как мне вывести ссылку с названием этой таксономии в шапке поста, при этом с проверкой на наличие этой таксономии в конкретном посте (иначе, ничего не выводить).
    Заранее благодарен.

    Ответить6 лет назад #
    • smargelov smargelov.com
      elseif( is_tax('company') ) { ?>
      	<h1>Компания "<?php single_term_title(); ?>"</h1>
      	<?php echo term_description(); ?>

      Нашёл. Спасибо за сайт.

      Ответить6 лет назад #
  • Alex

    небольшая описка в статье:

    capabilities (массив)
    Массив прав для этой таксономии:
    manage_terms - 'manage_categories'
    edit_terms - 'manage_categories'
    delete_terms - 'manage_categories'

    Ответить5.8 лет назад #
  • User

    В последних версиях добавились ещё параметры:

    'popular_items'
    'separate_items_with_commas'
    'add_or_remove_items'
    'choose_from_most_used'
    'not_found'

    P.S.
    в
    $labels = array()

    Ответить5.4 лет назад #
  • Денис

    Опечатка в тексте:

    hierarchical (логический)
    true - эта таксономия древовидного типа (как категории). flase - не древовидного (как мтеки).
    По умолчанию: false

    Ответить5.3 лет назад #
  • Евгений redcastle.by

    Можно ли создать таксономию без slug? Чтобы запись имела адрес сайт/запись?
    И если уже существует таксономия с slug, как ее убрать? Сначала убрать ее в коде, а потом заменить адреса в базе данных?

    Ответить5 лет назад #
    • Kama7601

      Не очень понятно что вам нужно, вам ЧПУ нужно изменить? Сделать это можно, но это может вызвать ряд проблем и как такое сделать я точно не знаю. Вам придется изменять правила ЧПУ.

      Ответить5 лет назад #
      • Евгений redcastle.by

        Смотрите, создается новая таксономия "Проекты". У нее можно добавлять записи. Вот только адрес этих записей будет иметь вид сайт/проекты/запись. Потому что в коде создания таксономии есть строка slug=проекты.

        Можно ли иметь новую таксономию, без приставки slug "Проекты"?
        Спасибо.

        Ответить5 лет назад #
        • Kama7601

          Немного странно для меня. У вас в ЧПУ указываются категории? Для какого типа поста указывается эта таксономия? Так помоч сложно, нужно все посмотреть. К тому же, как я и сказал, я этой темой в совершенстве не владею.

          Вот функция регистрации таксономии http://wp-kama.ru/function/register_taxonomy там есть параметр rewrite в нем указывается slag, с ним надо попробовать поиграться...

          Ответить5 лет назад #
          • Евгений redcastle.by

            Установил тему, в которой заранее создана была таксономия для портфолио. Добавляя в нее записи, получаю адреса с названием таксономии project.)

            Ответить5 лет назад #
  • Андрей

    Просто интересно, а как сделать аналогично страницам, что бы родительскую запись выбирать?

    Ответить4.8 года назад #
    • Givandos

      Таксономии - это не записи.
      У таксономий тоже могут быть "дети", но все же это не записи.
      Для вашей цели вероятнее всего подойдет создание собственного типа записи (custom types) с аналогичным параметром как и у таксономий: 'hierarchical' => true.
      Тогда этот ваш новый тип записей будет аналогичен страницам (можно будет выбрать родителя).

      Ответить4.6 года назад #
Здравствуйте, !     Войти . Зарегистрироваться