Как зарегистрировать произвольную таксономию в ACF

Обзор

Таксономии используются для классификации и категоризации отдельных записей для типа записи. WordPress предоставляет админ-интерфейс для управления терминами в таксономии и категоризации записей с помощью терминов.

Список таксономий, созданных с помощью ACF.

Добавить новую

Чтобы зарегистрировать новую таксономию, перейдите на экран «ACF» > «Taxonomy» и нажмите «Добавить новую». Вы увидите экран с базовыми настройками таксономии.

Добавление новой таксономии с помощью ACF.

Базовые настройки

Обязательные поля «Метка во множественном числе», «Метка в единственном числе» и «Ключ таксономии» — это минимально необходимая информация для создания таксономии. Однако доступны и другие настройки, если вам нужна более детальная конфигурация.

Метка во множественном числе

Это метка таксономии во множественном числе, которую вы регистрируете. Например: Genres, Series, Franchises.

Метка в единственном числе

Это метка таксономии в единственном числе, которую вы регистрируете. Например: Genre, Series, Franchise.

Ключ таксономии

Он автоматически генерируется из введенной вами метки в единственном числе, но его можно изменить. Это должна быть строка, состоящая только из строчных букв, цифр, символов подчёркивания и дефиса. Ограничение — 20 символов.

Типы записей

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

Публичная

Эта настройка определяет, является ли таксономия публичной или приватной. По умолчанию она включена, что означает: таксономия отображается в админ-панели и доступна для просмотра на фронтенде сайта.

Иерархическая

Эта настройка определяет тип таксономии с точки зрения возможности создавать отношения родительский/дочерний между терминами таксономии. Стандартная таксономия WordPress «Рубрики» является иерархической, а «Метки» — нет. По умолчанию она выключена.

Дополнительная настройка

При регистрации таксономии можно настроить большое количество параметров. Чтобы всё было проще, ACF не показывает их по умолчанию, но вы можете управлять ими, если включен переключатель «Дополнительная настройка».

Расширенные настройки при создании таксономии с помощью ACF.

Общие

Раздел «Общие настройки» предлагает несколько общих параметров, связанных с таксономией.

Сортировать термины

Определяет, должны ли термины в этой таксономии быть отсортированы в том порядке, в котором они передаются в wp_set_object_terms().

Термин по умолчанию

Создаёт термин для таксономии, который нельзя удалить. По умолчанию он не будет выбран для записей.

Название термина

Название термина по умолчанию (обязательно).

Слаг термина

Одно слово, без пробелов. Подчёркивания и дефисы допускаются.

Описание термина

Краткое описание термина.

Описание

Краткое описание таксономии.

Активна

Переключатель активности — это быстрый способ деактивировать таксономию, чтобы её можно было выключить без удаления.

Метки

Вкладка «Метки» позволяет задать строковые метки, используемые для таксономии во всей админ-панели. Вы можете быстро либо пересоздать все метки на основе ранее введённых «Метки во множественном числе» и «Метки в единственном числе», либо очистить все метки.

Можно настроить все метки, используемые WordPress.

Видимость

Вкладка «Видимость» содержит настройки, которые управляют тем, как таксономия будет отображаться в админ-панели и на фронтенде сайта. Настройте её отображение в боковом меню, удалите из админ-бара, исключите из результатов поиска на фронтенде и многое другое.

Показывать в интерфейсе

Включено по умолчанию. Это означает, что таксономию можно редактировать и управлять ею в админ-панели WordPress.

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

Включено по умолчанию. Эта настройка определяет, будет ли таксономия отображаться в боковом меню админ-панели.

Мета-бокс

Управляет мета-боксом на экране редактора содержимого. По умолчанию мета-бокс «Рубрики» показывается для иерархических таксономий, а мета-бокс «Метки» — для неиерархических. Позволяет задать пользовательский callback для мета-бокса или полностью отключить его.

Callback для регистрации мета-бокса

Имя PHP-функции, которая будет вызвана для обработки содержимого мета-бокса вашей таксономии.

Callback для санитизации мета-бокса

Имя PHP-функции, которая будет вызвана для очистки данных таксономии, сохранённых из мета-бокса.

Поддержка меню раздела «Внешний вид»

Включено по умолчанию. Управляет тем, можно ли добавлять элементы в меню на экране «Внешний вид» > «Меню». Должно быть включено в «Параметрах экрана».

Облако меток

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

Быстрое редактирование

Включено по умолчанию. Показывает таксономию на панели быстрого/массового редактирования.

Показывать столбец в админке

Отображает столбец для таксономии на экранах списка типов записей.

URL-адреса

Вкладка «URL-адреса» содержит настройки, которые управляют тем, как таксономия отображается в URL. Сюда входят структура постоянных ссылок для терминов таксономии и параметры управления переменной запроса для URL.

Перезапись постоянных ссылок

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

Префикс базового URL

Включено по умолчанию. Изменяет структуру постоянных ссылок, добавляя к URL префикс WP_Rewrite::$front.

Иерархическая

Включает родительские и дочерние термины в URL для иерархических таксономий.

Доступность для публичных запросов

Включено по умолчанию. Управляет тем, можно ли получить доступ к URL элемента и элементов через строку запроса.

Поддержка переменной запроса

Управляет тем, можно ли получить доступ к элементам через нечеловеко-понятные постоянные ссылки, используя ключ таксономии в качестве переменной запроса, пользовательскую переменную или полностью отключив доступ через переменную запроса.

REST API

Вкладка «REST API» содержит настройки, управляющие поведением таксономии в WordPress REST API.

Показывать в REST API

Включено по умолчанию. Управляет тем, будет ли эта таксономия доступна в REST API.

Базовый URL

Базовый URL для URL REST API таксономии.

Маршрут пространства имён

Часть URL REST API, отвечающая за пространство имён.

Класс контроллера

Необязательный пользовательский контроллер, который можно использовать вместо WP_REST_Terms_Controller.

Следующий шаг

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

Следующие шаги после сохранения таксономии с помощью ACF.

К ним относятся:

Создание новой группы полей

Один из распространённых сценариев — зарегистрировать таксономию, а затем добавить к ней поля для хранения другой структурированной информации вне названия и содержимого термина. Это значительно упрощается нажатием ссылки «Добавить поля в», которая переводит вас в новую группу полей, где правило размещения уже настроено так, чтобы группа полей отображалась при редактировании терминов новой таксономии.

Подключение к существующим группам полей

Иногда создаётся новая таксономия, и существующие группы полей тоже нужно отображать при редактировании её терминов. Вы можете подключить существующие группы полей, нажав ссылку «Связать существующие группы полей» и выбрав нужные группы в появившемся модальном окне.

Этот процесс добавляет новое правило размещения к выбранным группам полей, чтобы они отображались при редактировании терминов новой таксономии.

Обновлено: 01.06.2026