Как создать кастомный тип записей в WordPress с примерами кода

Если на сайте нужно отдельно вести кейсы, портфолио, отзывы или услуги, обычных записей и страниц быстро становится мало. В 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.

Как проверить, что всё работает правильно

После добавления кода проверьте несколько вещей подряд:

  1. В админке появился новый пункт меню с вашим типом записей.
  2. Можно создать новую запись и сохранить её без ошибок.
  3. Открывается одиночная запись по красивому URL.
  4. Архив открывается по адресу, заданному в rewrite.
  5. Таксономия отображается в редакторе и сохраняется вместе с записью.

Если вместо страницы вы видите 404, сначала обновите постоянные ссылки. Если раздел в админке не появился, проверьте, что код действительно выполняется и что хук init подключён без опечаток.

Типичные ошибки при создании custom post type

Чаще всего проблемы возникают не из-за самого register_post_type(), а из-за мелочей в настройках и месте размещения кода.

  • Код добавили в обычную тему. После смены темы раздел исчезнет.
  • Не обновили постоянные ссылки. Из-за этого архив и записи могут отдавать 404.
  • Не включили show_in_rest. Тогда в редакторе блоков и REST-интеграциях возможны ограничения.
  • Использовали слишком общий slug. Например, если slug совпадает со страницей или другим разделом, могут появиться конфликты URL.
  • Не создали шаблоны. Раздел работает, но выглядит как обычные записи или ломает верстку.

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

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

Добавь в закладки и поделись с друзьями:

⭐⭐⭐⭐⭐
Как настроить robots.txt в WordPress для индексации нужных страниц
18.10.2026
Как создать кастомный тип записей в WordPress с примерами кода
31.10.2026
Как автоматически удалять спам комментарии в WordPress: практические решения
10.09.2026
Как создать свой виджет в WordPress с примерами кода
01.10.2026
Автопостинг в WordPress: как автоматизировать публикации
10.09.2026
×
Review
Добавь ценность своему сайту WordPress!
-15%

на Expert Review плагин WordPress

Порадуй свой сайт ⋙