Нічого або WP_Error.
Використання
шаблон використання
$ Taxonomy (рядок) (обов'язковий) Назва створюваної таксономії.
Може містити тільки рядкові латинські символи, числа і _. тобто a-z0-9_.
За замовчуванням: '' $ object_type (рядок / масив) (обов'язковий) Назва типів постів, до яких буде прив'язана таксономія. У цьому параметрі, наприклад, можна вказати 'post', тоді у звичайних постів WordPress з'явиться нова таксономія (можливість класифікації).
За замовчуванням: '' $ args (масив) (обов'язковий) Масив аргументів визначає ознаки таксономії.
За замовчуванням: немає
Аргументи параметра $ args
label (рядок) Назва таксономії у множині (для відображення в адмінці).
За замовчуванням: використовується значення аргументу $ labels-> name
Масив описує заголовки таксономії (для відображення в адмінці).
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');
new_item_name
Текст для створення нового елемента таксономії. За замовчуванням __ ( 'New Tag Name') або __ ( 'New Category Name');
separate_items_with_commas
Текст описує, що елементи потрібно розділяти комами (для блога в адмінці). Чи не працює для деревовидного типу. За замовчуванням __ ( 'Separate tags with commas') або 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
Текст "Вибрати з часто використовуваних". Не використовується для деревовидних типів.
Текст "не знайдено", який відображається, якщо при кліці на часто використовувані жоден термін не був знайдений.
Весь список дивіться в описі get_taxonomy_labels ()
public (логічний) Чи показувати цю таксономію в інтерфейсі адмін-панелі. Це значення передається параметрам publicly_queryable. show_ui. show_in_nav_menus якщо для них не встановлено своє значення.
За замовчуванням: true
show_ui (логічний) Показувати блок управління цією таксономії в адмінці.
За замовчуванням: якщо немає, так само аргументу public
Чи показувати таксономию в адмін-меню.
- 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'
update_count_callback (рядок) Назва функції, яка буде викликатися для поновлення кількості записів в даній таксономії, для типу (ів) записів які асоційовані з цієї таксономії.
За замовчуванням: немає
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
Масив прав для цієї таксономії:
За замовчуванням: немає
callback функція. Відповідає за то, як буде відображатися таксономія в МЕТАБОКС (з версії 3.8).
Вбудовані назви функцій:
Якщо вказати false, то метабокс буде відключений взагалі.
За замовчуванням: null
show_admin_column (логічний) Дозволити чи ні авто-створення колонки таксономії в таблиці асоційованого типу записи. (З версії 3.5)
За замовчуванням: false
sort (логічний) Чи слід цієї таксономії запам'ятовувати порядок в якому створені елементи (терміни) прикріплюються до об'єктів (записів).
За замовчуванням: null
show_in_quick_edit (логічний) Чи показувати таксономию в панелі швидкого редагування записи (в таблиці, списку всіх записів, при натисканні на кнопку "властивості"). З версії 4.2.
За замовчуванням: null (значення show_ui)
_builtin (логічний) (не для звичайного використання) Параметр призначений для розробників. Якщо переключити на true, то це буде означати що ця таксономія відноситься до внутрішніх таксономія WordPress і не є вбудованою (кастомной).
За замовчуванням: false
# 1. Реєстрація таксономій
Приклад реєстрації двох таксономій "genres" і "writers" для постів типу "book". Цей код можна вставити в файл теми functions.php. Деякі аргументи розраховані на версію 3.1+:
# 2 Додавання таксономії в ЧПУ
Плагін для реги такс
Є дуже зручний, на мій погляд, плагін який дозволяє реєструвати нові типи записів і таксономії: Custom Post Type UI
Перейменування назв таксономії
Код нижче, показує як перейменувати наявну таксономию category (рубрики).