Как создать собственный тип постов в WordPress с поддержкой REST API

Автор: Павел Смирнов | Опубликовано: 14.04.2026

WordPress предоставляет удобный механизм для расширения функциональности сайта за счёт создания собственных типов записей — Custom Post Types (CPT). Это позволяет структурировать контент, отделять обычные записи от, например, портфолио, отзывов или событий. В современной разработке всё чаще требуется обеспечить поддержку REST API для CPT, чтобы можно было работать с данными через внешние приложения, фронтенды на React, Vue и другие.

Что такое Custom Post Type и зачем нужна поддержка REST API

Custom Post Type — это особый тип записей в WordPress, который отличается от стандартных записей (posts) и страниц (pages). С помощью CPT можно создавать различные категории контента с уникальными характеристиками и отдельным управлением.

Поддержка REST API позволяет создавать, получать, обновлять и удалять записи этого типа через HTTP-запросы. Это важно для разработки мобильных приложений, SPA, интеграций с внешними сервисами и современного фронтенда.

Без REST API CPT будут доступны только в административной панели и на сайте, но использовать их данные программно будет неудобно.

Создание собственного типа постов с поддержкой REST API

Для регистрации CPT используется функция register_post_type(). Чтобы включить поддержку REST API, нужно задать параметр show_in_rest в true. Рассмотрим пример создания типа постов «portfolio».

function wpmart_register_cpt_portfolio() {
    $labels = array(
        'name'               => 'Портфолио',
        'singular_name'      => 'Портфолио',
        'menu_name'          => 'Портфолио',
        'name_admin_bar'     => 'Портфолио',
        'add_new'            => 'Добавить запись',
        'add_new_item'       => 'Добавить новую запись портфолио',
        'new_item'           => 'Новая запись портфолио',
        'edit_item'          => 'Редактировать запись',
        'view_item'          => 'Просмотреть запись',
        'all_items'          => 'Все записи',
        'search_items'       => 'Поиск в портфолио',
        'not_found'          => 'Записи не найдены',
        'not_found_in_trash' => 'В корзине записей не найдено'
    );

    $args = array(
        'labels'             => $labels,
        'public'             => true,
        'publicly_queryable' => true,
        'show_ui'            => true,
        'show_in_menu'       => true,
        'query_var'          => true,
        'rewrite'            => array('slug' => 'portfolio'),
        'capability_type'    => 'post',
        'has_archive'        => true,
        'hierarchical'       => false,
        'menu_position'      => 5,
        'supports'           => array('title', 'editor', 'thumbnail', 'excerpt', 'comments'),
        'show_in_rest'       => true, // Включаем REST API
        'rest_base'          => 'portfolio', // Базовый endpoint REST API
        'rest_controller_class' => 'WP_REST_Posts_Controller',
    );

    register_post_type('portfolio', $args);
}
add_action('init', 'wpmart_register_cpt_portfolio');

В этом примере мы создали CPT с названием portfolio. Благодаря параметру show_in_rest = true WordPress автоматически добавит маршруты REST API для этого типа записей.

Проверка REST API для портфолио

После регистрации CPT можно проверить работу REST API, отправив GET-запрос к URL:

https://example.com/wp-json/wp/v2/portfolio

Вы получите JSON с записями портфолио, если они есть. Это отличный способ интегрировать WordPress с внешними приложениями.

Добавление пользовательских полей к CPT и их поддержка в REST API

Обычно для кастомных типов постов нужны дополнительные поля — дата события, цена, адрес и т.д. Чтобы эти поля были доступны через REST API, их нужно зарегистрировать и явно добавить в ответ API.

Рассмотрим пример добавления поля «client_name» для CPT «portfolio».

function wpmart_register_portfolio_meta() {
    register_post_meta('portfolio', 'client_name', array(
        'show_in_rest' => true, // Обязательно для REST API
        'single' => true,
        'type' => 'string',
        'description' => 'Имя клиента для портфолио',
        'sanitize_callback' => 'sanitize_text_field',
        'auth_callback' => function() {
            return current_user_can('edit_posts');
        },
    ));
}
add_action('init', 'wpmart_register_portfolio_meta');

Теперь при запросе через REST API поле client_name будет включено в ответ, а при создании или обновлении записи — его можно передавать.

Использование плагинов для расширенного управления CPT и REST API

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

Custom Post Type UI — позволяет без кода создавать CPT и таксономии. Однако для поддержки REST API нужно вручную ставить галочку в настройках.
ACF (Advanced Custom Fields) — для создания произвольных полей с удобным интерфейсом и возможностью экспорта данных в REST API с помощью дополнений.
Clearfy Pro — оптимизационный плагин, который позволяет управлять CPT, таксономиями и REST API для повышения производительности.

Для сайтов, использующих темы WPCommunity или JournalX, добавление CPT и REST API с помощью кода отлично вписывается в архитектуру и не создаёт лишних нагрузок.

Практические советы по работе с CPT и REST API

Безопасность и права доступа

При включении REST API важно контролировать права доступа. По умолчанию REST API открыт для чтения публичных данных, но при создании/редактировании стоит добавить проверки возможностей пользователя (capabilities) через параметр auth_callback в мета-полях и через фильтры для маршрутов API.

Оптимизация запросов REST API

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

Расширение REST API своими маршрутами

Если функционала стандартных маршрутов недостаточно, можно создавать собственные REST API endpoints с помощью register_rest_route(). Это позволяет реализовать сложную логику и кастомные операции.

function wpmart_register_custom_rest_route() {
    register_rest_route('wpmart/v1', '/portfolio-count', array(
        'methods' => 'GET',
        'callback' => 'wpmart_get_portfolio_count',
        'permission_callback' => '__return_true',
    ));
}
add_action('rest_api_init', 'wpmart_register_custom_rest_route');

function wpmart_get_portfolio_count() {
    $count_posts = wp_count_posts('portfolio');
    return array('count' => $count_posts->publish);
}

Этот пример создаёт endpoint /wp-json/wpmart/v1/portfolio-count, который возвращает количество опубликованных портфолио.

Заключение по теме

Создание собственного типа постов с поддержкой REST API — важный шаг к современному и гибкому WordPress-сайту. Это позволяет не только структурировать контент, но и открывает двери для интеграций и современных frontend-решений. Используйте показанные примеры, чтобы быстро начать работу и создавать мощные решения под свои задачи.

Если хотите дополнительно упростить управление CPT и мета-полями, обратите внимание на Clearfy Pro и ACF.