Если на сайте нужно отдельно вести кейсы, портфолио, отзывы или услуги, обычных записей и страниц быстро становится мало. В WordPress для этого используют кастомный тип записей — custom post type. Он позволяет вынести отдельный вид контента в собственный раздел админки, задать ему архив, отдельные шаблоны и свои таксономии.
Ниже разберём, как создать кастомный тип записей в WordPress с примерами кода, что именно делает каждая настройка и как проверить, что всё работает без ошибок.
Что такое кастомный тип записей и когда он нужен
Кастомный тип записей — это отдельная сущность контента внутри WordPress. По сути, это тот же механизм, что и у стандартных post и page, но с собственным названием, иконкой, набором полей и поведением.
Такой подход полезен, когда контент отличается по структуре и логике от обычных публикаций. Например:
- кейсы с полями «задача», «решение», «результат»;
- портфолио с галереей, отраслью и ссылкой на проект;
- отзывы с именем клиента, компанией и рейтингом;
- услуги с ценой, сроками и блоком преимуществ.
Если вы просто хотите добавить несколько страниц, кастомный тип записей не нужен. Но если контент должен жить отдельно, иметь свой архив и редактироваться по своей структуре, это правильное решение.
Как зарегистрировать новый тип записей через код
Самый надёжный способ — добавить регистрацию в тему или, что лучше, в отдельный плагин. Если вы привяжете CPT к теме, при смене темы раздел исчезнет из админки. Для сайта с важным контентом это плохой вариант.
Ниже рабочий пример регистрации типа записей case для раздела кейсов. Его можно добавить в файл плагина или в functions.php дочерней темы.
function wpexamples_register_case_post_type() {
$labels = array(
'name' => 'Кейсы',
'singular_name' => 'Кейс',
'add_new' => 'Добавить кейс',
'add_new_item' => 'Добавить новый кейс',
'edit_item' => 'Редактировать кейс',
'new_item' => 'Новый кейс',
'view_item' => 'Просмотреть кейс',
'search_items' => 'Искать кейсы',
'not_found' => 'Кейсы не найдены',
'not_found_in_trash' => 'В корзине кейсы не найдены',
'menu_name' => 'Кейсы',
);
$args = array(
'labels' => $labels,
'public' => true,
'publicly_queryable' => true,
'show_ui' => true,
'show_in_menu' => true,
'query_var' => true,
'rewrite' => array( 'slug' => 'cases' ),
'capability_type' => 'post',
'has_archive' => true,
'hierarchical' => false,
'menu_position' => 20,
'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt' ),
'show_in_rest' => true,
);
register_post_type( 'case', $args );
}
add_action( 'init', 'wpexamples_register_case_post_type' );Здесь ключевой вызов — register_post_type(). Первый аргумент — внутренний идентификатор типа записей, второй — массив настроек. Идентификатор должен быть коротким, без пробелов, лучше в нижнем регистре.
Что означают основные аргументы
Не все параметры обязательны, но несколько из них нужны почти всегда:
labels— подписи в админке;public— делает тип записей доступным на сайте;rewrite— задаёт красивый URL;has_archive— включает архивный список записей;supports— какие поля доступны в редакторе;show_in_rest— включает поддержку редактора блоков и REST API.
Если вы используете современный редактор WordPress, show_in_rest лучше оставлять включённым. Без него часть интеграций и редактор блоков могут работать не так, как ожидается.
Как добавить архив и красивый URL
Для большинства бизнес-сайтов архив нужен обязательно: это страница со списком всех кейсов, услуг или отзывов. За неё отвечает параметр has_archive. В примере выше он включён, а URL архива будет зависеть от rewrite.
Если вы указали 'slug' => 'cases', то отдельная запись может открываться по адресу вроде /cases/nazvanie-kase/, а архив — по /cases/. Это удобно и для пользователей, и для структуры сайта.
После добавления или изменения rewrite нужно обновить правила постоянных ссылок. Иначе WordPress может продолжать отдавать 404.
Сделать это можно в админке: Настройки → Постоянные ссылки, затем просто нажать кнопку сохранения. Это безопаснее, чем вручную править конфигурацию.
Как подключить таксономии к новому типу записей
Если у кейсов, услуг или портфолио должны быть категории, теги или собственные фильтры, к CPT подключают таксономии. Иногда достаточно стандартных рубрик, но чаще для отдельного раздела лучше создать свою таксономию.
Пример регистрации таксономии case_category для кейсов:
function wpexamples_register_case_taxonomy() {
$labels = array(
'name' => 'Категории кейсов',
'singular_name' => 'Категория кейса',
'search_items' => 'Искать категории',
'all_items' => 'Все категории',
'parent_item' => 'Родительская категория',
'parent_item_colon' => 'Родительская категория:',
'edit_item' => 'Редактировать категорию',
'update_item' => 'Обновить категорию',
'add_new_item' => 'Добавить категорию',
'new_item_name' => 'Название новой категории',
'menu_name' => 'Категории кейсов',
);
register_taxonomy(
'case_category',
array( 'case' ),
array(
'labels' => $labels,
'public' => true,
'hierarchical' => true,
'show_ui' => true,
'show_admin_column' => true,
'show_in_rest' => true,
'rewrite' => array( 'slug' => 'case-category' ),
)
);
}
add_action( 'init', 'wpexamples_register_case_taxonomy' );Здесь второй аргумент register_taxonomy() — массив типов записей, к которым привязывается таксономия. Если вы хотите, чтобы одна и та же таксономия работала и для кейсов, и для услуг, можно перечислить несколько типов.
Где лучше хранить код: тема или плагин
Для рабочего сайта правильнее выносить регистрацию CPT в отдельный плагин. Тогда контент не пропадёт при смене темы. Это особенно важно, если раздел уже наполнен и используется в меню, шаблонах и внутренних ссылках.
В тему код имеет смысл класть только в двух случаях:
- вы делаете проект под одну конкретную тему и точно не планируете её менять;
- тип записей — часть визуальной логики темы, а не отдельный бизнес-раздел.
Если нужен минимальный плагин, достаточно создать файл, например wpexamples-cpt.php, добавить в него заголовок плагина и поместить туда код регистрации. Это удобнее, чем держать всё в functions.php, где код легко потерять при обновлении или замене темы.
Как вывести кастомный тип записей на сайте
После регистрации WordPress создаст отдельный раздел в админке, но на фронтенде ещё нужно подготовить шаблоны. Если шаблонов нет, WordPress может использовать стандартные, и внешний вид архива или одиночной записи окажется не тем, что вы ожидаете.
Обычно достаточно создать в теме два файла:
archive-case.php— для архива кейсов;single-case.php— для одной записи кейса.
Если этих файлов нет, WordPress ищет более общие шаблоны по иерархии. Это работает, но для отдельного типа записей лучше сделать собственные шаблоны, чтобы не смешивать кейсы с обычными постами.
Внутри шаблона архива можно использовать обычный цикл WordPress. Пример:
<?php if ( have_posts() ) : ?>
<h1>Кейсы</h1>
<div class="cases-list">
<?php while ( have_posts() ) : the_post(); ?>
<article>
<h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php the_excerpt(); ?>
</article>
<?php endwhile; ?>
</div>
<?php endif; ?>Это не единственный вариант, но он показывает базовую логику: архив CPT выводится так же, как и любой другой список записей WordPress.
Как проверить, что всё работает правильно
После добавления кода проверьте несколько вещей подряд:
- В админке появился новый пункт меню с вашим типом записей.
- Можно создать новую запись и сохранить её без ошибок.
- Открывается одиночная запись по красивому URL.
- Архив открывается по адресу, заданному в
rewrite. - Таксономия отображается в редакторе и сохраняется вместе с записью.
Если вместо страницы вы видите 404, сначала обновите постоянные ссылки. Если раздел в админке не появился, проверьте, что код действительно выполняется и что хук init подключён без опечаток.
Типичные ошибки при создании custom post type
Чаще всего проблемы возникают не из-за самого register_post_type(), а из-за мелочей в настройках и месте размещения кода.
- Код добавили в обычную тему. После смены темы раздел исчезнет.
- Не обновили постоянные ссылки. Из-за этого архив и записи могут отдавать 404.
- Не включили
show_in_rest. Тогда в редакторе блоков и REST-интеграциях возможны ограничения. - Использовали слишком общий slug. Например, если slug совпадает со страницей или другим разделом, могут появиться конфликты URL.
- Не создали шаблоны. Раздел работает, но выглядит как обычные записи или ломает верстку.
Если вы делаете сайт для клиента или проект с долгим сроком жизни, лучше сразу вынести регистрацию CPT в отдельный плагин и продумать шаблоны до наполнения контентом. Это избавляет от лишней миграции позже.
Когда нужен не просто новый раздел, а ещё и аккуратная структура контента, кастомный тип записей — самый практичный вариант. Он не усложняет WordPress, если зарегистрировать его один раз и сразу продумать архив, таксономии и шаблоны.