Как правильно добавить и настроить категории для пользовательских типов записей (Custom Post Types) в WordPress: пошаговая инструкция?

05.11.2025
62159

4 мин
28

В WordPress пользовательские типы записей (Custom Post Types, CPT) позволяют создавать контент, отличный от стандартных записей и страниц. Однако, чтобы эффективно управлять этим контентом, необходима правильная организация. Категории играют ключевую роль в структурировании CPT, обеспечивая удобную навигацию и улучшая SEO. В этой статье мы подробно рассмотрим, как добавить и настроить категории для пользовательских типов записей, используя различные методы и инструменты.

Понимание пользовательских типов записей и таксономий в WordPress

Что такое Custom Post Type (CPT) и зачем они нужны?

Custom Post Type – это способ расширить возможности WordPress, позволяя создавать типы контента, отличные от стандартных записей (post) и страниц (page). Например, можно создать CPT для "Книг", "Мероприятий" или "Портфолио". Это позволяет более четко структурировать информацию на сайте и управлять ею. Использование CPT необходимо, когда структура контента выходит за рамки стандартного функционала WordPress.

Что такое таксономии и как они связаны с категориями? Разница между категориями и метками.

Таксономии – это механизмы классификации контента в WordPress. Категории и метки – это встроенные таксономии, но можно создавать и собственные. Категории предназначены для широкой классификации контента (иерархические), а метки – для более детального описания (неиерархические). Для CPT часто требуется собственная иерархия категорий, отличная от стандартных записей. Важно понимать, что стандартные категории и метки, предназначенные для post, напрямую не связаны с CPT, пока мы их не свяжем.

Добавление категорий к Custom Post Type с помощью кода

Регистрация новой таксономии для CPT с использованием `register_taxonomy()`: пошаговая инструкция.

Для добавления категорий к CPT необходимо зарегистрировать новую таксономию. Это можно сделать, добавив код в файл functions.php вашей темы или в пользовательский плагин. Вот пошаговая инструкция:

Определите идентификатор CPT и таксономии. Например, CPT – product, таксономия – product_category.
Используйте функцию register_taxonomy() для регистрации таксономии.

Пример кода:

function register_product_category() {
 $labels = array(
 'name' => 'Категории товаров',
 'singular_name' => 'Категория товара',
 );
 $args = array(
 'labels' => $labels,
 'hierarchical' => true, // Включает иерархию категорий
 'public' => true,
 'show_ui' => true,
 'show_admin_column' => true,
 'query_var' => true,
 'rewrite' => array( 'slug' => 'product-category' ),
 );
 register_taxonomy( 'product_category', 'product', $args );
}
add_action( 'init', 'register_product_category' );

Объяснение параметров:
- hierarchical: true включает иерархию (категории), false — метки.
- rewrite: определяет, как будет выглядеть URL категорий.
Подключите таксономию к вашему CPT. Второй аргумент register_taxonomy() – это имя CPT.

Связывание существующей категории с CPT. Использование хуков `init` и `register_post_type`.

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

function add_existing_category_to_cpt() {
 register_taxonomy_for_object_type( 'category', 'your_custom_post_type' );
}
add_action( 'init', 'add_existing_category_to_cpt' );

Не забудьте заменить your_custom_post_type на фактическое имя вашего CPT. Также необходимо убедиться, что ваш CPT зарегистрирован до того, как вы попытаетесь связать с ним таксономию. Это достигается правильной расстановкой приоритетов в хуках init.

Использование плагинов для управления категориями CPT

Настройка категорий для CPT с помощью плагина CPT UI: подробное руководство.

CPT UI (Custom Post Type UI) – это удобный плагин для создания и управления CPT и таксономиями через административный интерфейс WordPress.

Установите и активируйте плагин CPT UI.
Перейдите в CPT UI -> Add/Edit Taxonomies.
Заполните необходимые поля:
- Taxonomy Slug (идентификатор таксономии).
- Plural Label (множественное название).
- Singular Label (единственное название).
В разделе "Settings" выберите CPT, к которому нужно привязать таксономию.
Установите Hierarchical в true для создания категорий.
Сохраните таксономию.

Плагин CPT UI упрощает процесс регистрации таксономий, предоставляя удобный интерфейс и избавляя от необходимости писать код.

Добавление и управление категориями CPT с помощью плагина ACF (Advanced Custom Fields).

ACF (Advanced Custom Fields) – это мощный плагин, который позволяет добавлять пользовательские поля и таксономии к CPT.

Установите и активируйте плагин ACF.
Перейдите в ACF -> Taxonomies.
Создайте новую таксономию, указав ее название и идентификатор.
В разделе "Location" укажите, к какому CPT нужно привязать таксономию.
Настройте дополнительные параметры, такие как отображение в админке и URL rewrite.

ACF предоставляет гибкие возможности для управления таксономиями, позволяя создавать сложные структуры данных и пользовательские интерфейсы.

Отображение категорий CPT на сайте и решение распространенных проблем

Как отобразить категории для Custom Post Type в шаблонах (archive.php, single.php)?

Для отображения категорий CPT на сайте необходимо внести изменения в шаблоны WordPress.

archive.php (для отображения списка записей CPT):

<?php
$terms = get_terms( array(
 'taxonomy' => 'your_taxonomy',
 'hide_empty' => false,
) );

if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
 echo '<ul>';
 foreach ( $terms as $term ) {
 echo '<li><a href="' . esc_url( get_term_link( $term ) ) . '" alt="' . esc_attr( sprintf( __( 'View all post filed under %s', 'my_text_domain' ), $term->name ) ) . '">' . $term->name . '</a></li>';
 }
 echo '</ul>';
}
?>

single.php (для отображения категорий на странице отдельной записи CPT):

<?php
$terms = get_the_terms( $post->ID, 'your_taxonomy' );

if ( $terms && ! is_wp_error( $terms ) ) : 
 echo '<ul>';
 foreach ( $terms as $term ) {
 echo '<li><a href="' . get_term_link( $term ) . '">' . $term->name . '</a></li>';
 }
 echo '</ul>';
endif;
?>

Замените your_taxonomy на идентификатор вашей таксономии.

Решение распространенных проблем: категории не отображаются, ошибки 404, конфликты плагинов.

При работе с категориями CPT могут возникать следующие проблемы:

Категории не отображаются:
- Убедитесь, что таксономия правильно зарегистрирована и связана с CPT.
- Проверьте, что код отображения категорий правильно добавлен в шаблоны.
- Проверьте, что у записей CPT назначены категории.
Ошибки 404:
- После регистрации таксономии или изменения URL перезапишите правила перезаписи, перейдя в "Настройки" -> "Постоянные ссылки" и нажав кнопку "Сохранить изменения".
Конфликты плагинов:
- Отключите все плагины и активируйте их по одному, чтобы выявить конфликт.
- Проверьте консоль браузера на наличие ошибок JavaScript.

Заключение

Добавление и настройка категорий для пользовательских типов записей в WordPress – важный шаг для организации контента и улучшения пользовательского опыта. Используя код, плагины CPT UI и ACF, вы можете легко управлять таксономиями и создавать сложные структуры данных. Не забывайте о решении распространенных проблем и тестировании изменений на локальном сервере перед внедрением на production.