Разработка кастомных типов записей (Custom Post Types) WordPress

Разработка кастомных типов записей (Custom Post Types) WordPress

WordPress из коробки работает с двумя типами контента: «Записи» (Posts) и «Страницы» (Pages). Когда сайту нужны Проекты, Вакансии, Недвижимость, Отзывы или Товары — под каждый создаётся собственный тип записей (CPT). CPT даёт отдельный раздел в /wp-admin, свои URL, архивные страницы и полный контроль над структурой данных. Регистрация CPT с базовыми настройками занимает несколько часов; полноценная настройка с ЧПУ, кастомными колонками и возможностями поиска — 1–2 дня.

Регистрация через 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, // обязательно для Gutenberg
        'rest_base'          => 'projects',
    ]);
});

has_archive => 'projects' создаёт страницу архива по адресу /projects/ — туда попадают все записи типа. show_in_rest => true делает тип доступным через REST API и в редакторе Gutenberg.

После регистрации нового CPT нужно обновить правила ЧПУ: в /wp-admin → Настройки → Постоянные ссылки нажать «Сохранить», либо программно:

register_activation_hook(__FILE__, function () {
    // Регистрируем CPT перед flush
    add_action('init', 'register_project_cpt');
    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');
    }
});

Фильтр по таксономии в списке

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,
    ]);
});

Включение в поиск WordPress

По умолчанию стандартный поиск WordPress не включает кастомные CPT:

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']));
    }
});

Связанные записи между 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 vs таксономия vs кастомные поля

Частая ошибка — делать CPT там, где нужен другой инструмент:

• CPT нужен, когда сущность имеет собственные страницы, архив, редактор контента
• Таксономия — когда нужна группировка/фильтрация (категория, тег)
• Кастомное поле — когда нужно хранить атрибут существующей записи (цена, год, адрес)

Регистрация CPT с нулевыми шаблонами и без полноценного контента — пустая трата структуры. Если «тип» не нужен на фронте — вероятно, это просто таксономия к уже существующему CPT.