Описание функции register_taxonomy()
Функция register_taxonomy() используется для регистрации новой таксономии (например, категории, метки) в WordPress. Она позволяет создавать и настраивать таксономии для постов, страниц и других типов контента, обеспечивая гибкость в организации контента.
Функция обычно вызывается в файлах темы или плагина на этапе инициализации (например, в хуке ‘init’)
Параметры
$taxonomy
Тип: string
Обязательный: Да
Описание: Уникальное название новой таксономии
Возможные значения:
$object_type
Тип: array|string
Обязательный: Да
Описание: Массив или строка с типами объектов, к которым будет применяться таксономия (например, ‘post’, ‘page’)
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных параметров для настройки таксономии
Возможные значения:
labels: Массив меток для интерфейса
public: 1,
hierarchical: 1,
show_ui: 1,
show_admin_column: 1,
query_var: 1,
rewrite: Массив параметров перезаписи URL
Возвращаемое значение
Тип: void
Описание: Нет возвращаемого значения.
Возможные значения:
Примеры использования
Регистрация таксономии ‘genre’ для постов.
register_taxonomy('genre', 'post');
Теперь можно использовать таксономию ‘genre’ для организации постов.
Регистрация и настройка таксономии ‘genre’ с метками и параметрами.
$args = array(
'labels' => array(
'name' => 'Жанры',
'singular_name' => 'Жанр'
),
'public' => true,
'hierarchical' => true
);
register_taxonomy('genre', 'post', $args);
Таксономия будет иерархической и доступной в интерфейсе.
Безопасность
Валидация входных данных: Параметры проходят проверку на корректность внутри функции.
Санитизация: Входные данные автоматически очищаются WordPress.
Рекомендации: Используйте проверенные названия для таксономий, избегайте конфликтов с существующими.
— Связанные функции
Регистрация нового типа записи.
Получение терминов (значений) таксономии.
— Примечания
– Ограничения
Необходимо использовать уникальные названия для таксономий.
– Частые проблемы
- Конфликты названий с существующими таксономиями или типами записей.
- Ошибки при неправильных настройках параметров.
