wpboot.ru wordpress WPBoot

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

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

Ниже разберём практический сценарий: как создать CPT, включить его в админке, вывести на сайте и проверить, что всё работает без лишних костылей.

Что такое пользовательский тип записей и когда он нужен

CPT — это отдельный тип контента внутри WordPress. Для ядра это такой же объект, как запись или страница, но со своими настройками. Например, можно сделать тип case для кейсов, portfolio для работ, catalog для товаров без WooCommerce или review для обзоров.

Использовать CPT имеет смысл, когда у контента есть собственная структура и он должен жить отдельно от обычных постов. Типичный признак: у элементов одинаковые поля, свой архив, отдельные рубрики или теги, и их нужно выводить в отдельном разделе сайта.

Если же вам нужен просто один-два дополнительных блока на странице, CPT часто избыточен. В таком случае проще обойтись страницами, произвольными полями или блоками в редакторе.

Как создать CPT через код

Самый надёжный способ — зарегистрировать тип записей в теме или, лучше, в небольшом плагине. Если вы меняете тему, а CPT лежит в её functions.php, при смене темы тип записей пропадёт из админки и со страниц архива. Для рабочих проектов безопаснее вынести регистрацию в отдельный плагин.

Ниже пример регистрации CPT для раздела кейсов. Код можно добавить в плагин или в functions.php дочерней темы.

add_action('init', function () {
    register_post_type('case', [
        'labels' => [
            'name'               => 'Кейсы',
            'singular_name'      => 'Кейс',
            'add_new'            => 'Добавить кейс',
            'add_new_item'       => 'Добавить кейс',
            'edit_item'          => 'Редактировать кейс',
            'new_item'           => 'Новый кейс',
            'view_item'          => 'Посмотреть кейс',
            'search_items'       => 'Найти кейс',
            'not_found'          => 'Кейсы не найдены',
            'not_found_in_trash' => 'В корзине кейсов нет',
            'menu_name'          => 'Кейсы',
        ],
        'public'             => true,
        'has_archive'        => true,
        'show_in_rest'       => true,
        'menu_position'      => 5,
        'menu_icon'          => 'dashicons-portfolio',
        'supports'           => ['title', 'editor', 'thumbnail', 'excerpt', 'custom-fields'],
        'rewrite'            => ['slug' => 'cases'],
    ]);
});

Здесь важны несколько параметров. public делает тип доступным на сайте и в админке. has_archive включает архивную страницу, например /cases/. show_in_rest нужен, если вы хотите нормально работать с блоковым редактором и REST API. supports определяет, какие поля будут доступны в редакторе записи.

Если вам не нужен редактор Gutenberg, можно убрать show_in_rest, но в большинстве современных проектов его лучше оставить включённым.

Что важно настроить сразу после регистрации

После создания CPT обычно настраивают не только сам тип, но и поведение URL, архивов и прав доступа. Это влияет на то, как раздел будет открываться и как его увидят посетители.

ЧПУ и архив

Параметр rewrite задаёт основу адресов. В примере записи будут открываться по адресу вида /cases/slug-zapisi/. Если вы хотите другой адрес, поменяйте slug на нужное значение.

После добавления или изменения rewrite нужно сбросить правила постоянных ссылок. Для этого откройте Настройки → Постоянные ссылки и просто нажмите кнопку сохранения. Это обязательный шаг, иначе WordPress может продолжать отдавать 404 на новый архив или одиночные записи.

Таксономии для фильтрации

Если у кейсов или объектов каталога должны быть категории, добавьте отдельную таксономию. Для этого используют register_taxonomy(). Так вы не смешиваете рубрики блога с рубриками кейсов.

Пример для отдельной таксономии:

add_action('init', function () {
    register_taxonomy('case_category', ['case'], [
        'labels' => [
            'name'          => 'Категории кейсов',
            'singular_name' => 'Категория кейса',
        ],
        'public'            => true,
        'hierarchical'      => true,
        'show_in_rest'      => true,
        'rewrite'           => ['slug' => 'case-category'],
    ]);
});

Таксономию можно использовать для фильтров, хлебных крошек и отдельных страниц архива по категориям.

Как вывести CPT на сайте

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

Архивная страница CPT

Если у типа включён has_archive, WordPress попытается показать архив по адресу, который соответствует rewrite. Но внешний вид архива зависит от темы. Если в теме нет шаблона, WordPress использует стандартную иерархию шаблонов.

Чтобы задать отдельный вид архива, создайте файл archive-case.php в теме. Внутри можно вывести список кейсов как обычный цикл WordPress:

<?php get_header(); ?>

<main class="site-main">
    <h1><?php post_type_archive_title(); ?></h1>

    <?php if (have_posts()) : ?>
        <div class="cases-grid">
            <?php while (have_posts()) : the_post(); ?>
                <article <?php post_class('case-card'); ?>>
                    <a href="<?php the_permalink(); ?>">
                        <?php if (has_post_thumbnail()) the_post_thumbnail('medium'); ?>
                        <h2><?php the_title(); ?></h2>
                    </a>
                    <div class="case-excerpt"><?php the_excerpt(); ?></div>
                </article>
            <?php endwhile; ?>
        </div>

        <?php the_posts_pagination(); ?>
    <?php else : ?>
        <p>Кейсы пока не добавлены.</p>
    <?php endif; ?>
</main>

<?php get_footer(); ?>

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

Одиночная запись CPT

Для отдельной записи создайте файл single-case.php. WordPress будет использовать его для просмотра одного кейса. Это удобное место для вывода заголовка, изображения, текста, метаданных и дополнительных полей.

Если у кейса есть свои поля, например клиент, срок, бюджет или ссылка на проект, их обычно выводят через get_post_meta() или через плагин полей. Сам WordPress хранит такие данные, но не рисует их автоматически.

Вывод в произвольном месте страницы

Иногда CPT нужно показать не только в архиве, но и на главной, в блоке «Последние кейсы» или на лендинге. Для этого используют отдельный запрос через WP_Query.

$cases = new WP_Query([
    'post_type'      => 'case',
    'posts_per_page' => 6,
]);

if ($cases->have_posts()) {
    while ($cases->have_posts()) {
        $cases->the_post();
        the_title('<h3>', '</h3>');
    }
    wp_reset_postdata();
}

После такого запроса обязательно вызывайте wp_reset_postdata(), иначе можно сломать основной цикл страницы и получить неожиданный вывод в других блоках.

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

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

  • В админке появился новый пункт меню с вашим типом записей.
  • Можно создать и сохранить новую запись этого типа.
  • Открывается архив CPT по адресу, который задан в rewrite.
  • Открывается одиночная запись без 404.
  • Если есть шаблон archive-*.php или single-*.php, WordPress действительно использует его.
  • После изменения ссылок вы заново сохранили постоянные ссылки.

Если архив не открывается, сначала проверьте has_archive, затем rewrite, а потом сброс постоянных ссылок. Если одиночные записи есть в админке, но на сайте 404, чаще всего проблема именно в правилах пермалинков или в конфликте slug с уже существующей страницей.

Типичные ошибки при работе с CPT

Самая частая ошибка — регистрировать CPT в теме, а потом менять тему. В этом случае раздел исчезает из админки, хотя записи в базе остаются. Для проекта, который живёт долго, лучше хранить регистрацию в плагине.

Вторая распространённая проблема — использовать slug, который уже занят страницей или другим типом записей. Тогда WordPress может путаться в маршрутизации URL. Перед запуском проверьте, не совпадает ли адрес архива с существующими страницами сайта.

Ещё одна ошибка — забыть про show_in_rest, а потом пытаться редактировать контент в блоковом редакторе или через современные интеграции. Если сайт уже работает на Gutenberg, этот параметр лучше включать сразу.

Когда CPT лучше делать плагином, а когда хватит темы

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

В тему имеет смысл добавлять CPT только тогда, когда это временный проект, прототип или раздел тесно связан именно с этой темой. В остальных случаях плагин даёт больше стабильности и меньше риска потерять контентную структуру при редизайне.

Если вам нужен не только CPT, но и аккуратная работа с дублями, служебными страницами и технической чистотой сайта, для WordPress-проектов иногда используют Clearfy Pro. Но сам CPT он не создаёт — для этого всё равно нужен код или отдельный плагин под тип записей.

В итоге рабочая схема выглядит так: регистрируете CPT через register_post_type(), при необходимости добавляете таксономии, настраиваете архив и шаблоны, затем проверяете URL и вывод в теме. После этого пользовательский тип записей становится полноценным разделом сайта, а не просто пунктом в админке.

×

AI-плагин

WPGPT
Сам создает статьи для вашего сайта WordPress

SEO и мета-теги

Парсинг конкурентов

Изображения

Комментарии

Подробнее