Разработка кастомных типов записей (Custom Post Types) WordPress
Представьте: клиент просит раздел «Портфолио» с фильтром по годам, а стандартные записи не дают ни своего URL, ни метаполей. Мы сталкиваемся с этим регулярно. WordPress из коробки работает с двумя типами контента — «Записи» и «Страницы». Когда сайту нужны Проекты, Вакансии, Недвижимость, Отзывы или Товары, под каждый создаётся собственный тип записей (CPT). CPT даёт отдельный раздел в /wp-admin, свои URL, архивные страницы и полный контроль над структурой данных. Регистрация CPT с базовыми настройками занимает несколько часов; полноценная настройка с ЧПУ, кастомными колонками и возможностями поиска — 1–2 дня. Наш опыт — более 50 настроенных CPT для разных проектов, от портфолио до интернет-магазинов.
Как регистрировать CPT с правильными настройками?
Регистрация начинается с хука init. Внутри вызываем register_post_type с обязательными параметрами. Рассмотрим пример для типа «Проекты»:
add_action('init', function () { register_post_type('project', [ '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, 'publicly_queryable' => true, 'show_ui' => true, 'show_in_menu' => true, 'query_var' => true, 'rewrite' => ['slug' => 'projects', 'with_front' => false], 'capability_type' => 'post', 'has_archive' => 'projects', 'hierarchical' => false, 'menu_position' => 5, 'menu_icon' => 'dashicons-portfolio', 'supports' => ['title', 'editor', 'thumbnail', 'excerpt', 'custom-fields'], 'show_in_rest' => true, 'rest_base' => 'projects', ]); }); has_archive => 'projects' создаёт страницу архива по адресу /projects/ — туда попадают все записи типа. show_in_rest => true делает тип доступным через REST API и в редакторе Gutenberg. После регистрации обязательно обновите правила ЧПУ: в админке «Настройки → Постоянные ссылки» нажмите «Сохранить» либо выполните flush_rewrite_rules() при активации.
Кастомные колонки в списке записей и сортировка
По умолчанию список проектов показывает только заголовок и дату. Добавим колонки «Клиент», «Год» и «На главной» — все они сортируемые. Вот компактный блок кода, включающий регистрацию колонок, вывод данных и сортировку:
// Регистрируем колонки и выводим данные add_filter('manage_project_posts_columns', function (array $columns): array { $new = []; foreach ($columns as $key => $title) { $new[$key] = $title; if ($key === 'title') { $new['client'] = 'Клиент'; $new['year'] = 'Год'; $new['featured'] = 'На главной'; } } unset($new['comments']); return $new; }); add_action('manage_project_posts_custom_column', function (string $column, int $post_id): void { switch ($column) { case 'client': echo esc_html(get_post_meta($post_id, '_project_client', true) ?: '—'); break; case 'year': echo esc_html(get_post_meta($post_id, '_project_year', true) ?: '—'); break; case 'featured': $is_featured = get_post_meta($post_id, '_project_featured', true); echo $is_featured ? '⭐' : '—'; break; } }, 10, 2); add_filter('manage_edit-project_sortable_columns', function (array $columns): array { $columns['year'] = 'year'; return $columns; }); add_action('pre_get_posts', function (WP_Query $query): void { if (!is_admin() || !$query->is_main_query()) return; if ($query->get('orderby') === 'year') { $query->set('meta_key', '_project_year'); $query->set('orderby', 'meta_value_num'); } }); Включение CPT в поиск WordPress и фильтр по таксономии
По умолчанию стандартный поиск не включает кастомные CPT. Исправляем это через pre_get_posts:
add_action('pre_get_posts', function (WP_Query $query): void { if ($query->is_search() && !is_admin() && $query->is_main_query()) { $post_types = $query->get('post_type') ?: ['post']; if (!is_array($post_types)) { $post_types = [$post_types]; } $query->set('post_type', array_merge($post_types, ['project', 'vacancy'])); } }); А для фильтрации списка по таксономии (например, категория проекта) добавляем выпадающий список:
add_action('restrict_manage_posts', function (string $post_type): void { if ($post_type !== 'project') return; $taxonomy = get_taxonomy('project_category'); wp_dropdown_categories([ 'taxonomy' => 'project_category', 'name' => 'project_category', 'show_option_all' => 'Все категории', 'selected' => $_GET['project_category'] ?? 0, 'value_field' => 'slug', 'hierarchical' => true, ]); }); Сравнение: CPT vs таксономия vs кастомное поле
Частая ошибка — использовать CPT там, где достаточно таксономии или поля. Таблица ниже поможет выбрать правильный инструмент:
| Сущность | Когда использовать | Пример |
|---|---|---|
| Custom Post Type | Нужна отдельная страница, архив, редактор контента | Проект, отзыв, вакансия |
| Таксономия | Требуется группировка или фильтрация записей | Категория проекта, тег услуги |
| Кастомное поле | Храним атрибут существующей записи | Цена товара, год проекта, адрес офиса |
CPT лучше таксономии для содержательных сущностей — он даёт отдельный URL, редактор и полный контроль. Использование таксономии вместо CPT — это потеря SEO-потенциала и ограничение контента.
Какие шаблоны нужны для корректного отображения CPT?
WordPress автоматически ищет шаблоны в определённом порядке. Для типа project приоритет такой:
| Приоритет | Шаблон | Назначение |
|---|---|---|
| 1 | single-project.php |
Отдельная запись |
| 2 | single.php |
Фолбэк для записей |
| 3 | archive-project.php |
Архив (список) |
| 4 | archive.php |
Фолбэк для архивов |
Если нужного шаблона нет, WordPress падает на index.php. Создание single-project.php и archive-project.php — базовая практика для любого CPT.
Связанные записи между разными CPT
Стандартный способ связать два CPT — хранить ID связанных записей в post meta. Например, привязываем кейсы к проекту:
// Сохранение связей update_post_meta($project_id, '_related_cases', array_map('absint', $case_ids)); // Получение связанных кейсов $case_ids = get_post_meta($project_id, '_related_cases', true); if (!empty($case_ids)) { $cases = get_posts([ 'post_type' => 'case', 'post__in' => $case_ids, 'orderby' => 'post__in', 'posts_per_page' => -1, ]); } Для двусторонних связей (многие-ко-многим) используйте плагин Posts 2 Posts или создайте промежуточную таблицу.
Что входит в настройку CPT под ключ
Наш опыт — более 5 лет разработки на WordPress, более 50 настроенных CPT для портфолио, интернет-магазинов и каталогов. В услугу входит:
- Регистрация CPT с полным набором параметров (ЧПУ, архив, иконка, колонки);
- Кастомные колонки с сортировкой и фильтрацией;
- Интеграция с поиском и REST API;
- Создание шаблонов single-{cpt}.php и archive-{cpt}.php;
- Документация и передача доступов;
- Обучение контент-менеджеров.
Гарантируем, что все CPT будут корректно работать с Gutenberg и W3C-валидатором. Свяжитесь, чтобы обсудить ваш проект — оценим задачу за один рабочий день. Получите консультацию: мы поможем выбрать оптимальную архитектуру и реализуем CPT быстрее, чем вы напишете spec.
Почему стоит доверить настройку CPT профессионалам?
Некорректная регистрация CPT приводит к ошибкам 404, неработающему поиску и падению производительности. Мы используем проверенные паттерны: registration_hook для сброса правил, кастомные колонки без лишних запросов, правильные capability_type. Ваш сайт не потеряет в скорости — гарантируем Core Web Vitals на уровне зелёной зоны.
Для глубокого понимания механизма регистрации обратитесь к официальной документации: register_post_type. Наши специалисты всегда готовы проконсультировать и подобрать решение под ваш проект.