Как создать и настроить пользовательские типы записей (Custom Post Types) в WordPress: полное руководство для начинающих

Плагины → Добавить новый → Custom Post Type UI → Установить → Активировать

CPT UI → Добавить/изменить типы записей

function create_portfolio_post_type() { $labels = array( 'name' => 'Портфолио', 'singular_name' => 'Работа', 'menu_name' => 'Портфолио', 'add_new' => 'Добавить работу', 'add_new_item' => 'Добавить новую работу', 'edit_item' => 'Редактировать работу', 'new_item' => 'Новая работа', 'view_item' => 'Просмотреть работу', '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, 'menu_icon' => 'dashicons-portfolio', 'supports' => array('title', 'editor', 'thumbnail', 'excerpt'), 'taxonomies' => array('category', 'post_tag'), 'show_in_rest' => true, // Для Gutenberg ); register_post_type('portfolio', $args); } add_action('init', 'create_portfolio_post_type');

CPT UI → Добавить/изменить таксономии

function create_project_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' => 'Типы проектов', ); $args = array( 'labels' => $labels, 'hierarchical' => true, // true = как категории, false = как метки 'public' => true, 'show_ui' => true, 'show_admin_column' => true, 'query_var' => true, 'rewrite' => array('slug' => 'project-type'), 'show_in_rest' => true, ); register_taxonomy('project_type', array('portfolio'), $args); } add_action('init', 'create_project_taxonomy');

<?php get_header(); ?> <div class="portfolio-archive"> <h1>Наши работы</h1> <?php if (have_posts()) : ?> <div class="portfolio-grid"> <?php while (have_posts()) : the_post(); ?> <article class="portfolio-item"> <?php if (has_post_thumbnail()) : ?> <a href="<?php the_permalink(); ?>"> <?php the_post_thumbnail('medium'); ?> </a> <?php endif; ?> <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2> <?php  // Вывод таксономии $terms = get_the_terms(get_the_ID(), 'project_type'); if ($terms && !is_wp_error($terms)) : $term_list = array(); foreach ($terms as $term) { $term_list[] = '<a href="' . get_term_link($term) . '">' . $term->name . '</a>'; } echo '<div class="project-types">' . implode(', ', $term_list) . '</div>'; endif; ?> <div class="excerpt"> <?php the_excerpt(); ?> </div> <a href="<?php the_permalink(); ?>" class="read-more">Подробнее</a> </article> <?php endwhile; ?> </div> <?php the_posts_pagination(); ?> <?php else : ?> <p>Работ пока нет.</p> <?php endif; ?> </div> <?php get_footer(); ?>

<?php get_header(); ?> <?php while (have_posts()) : the_post(); ?> <article class="portfolio-single"> <h1><?php the_title(); ?></h1> <?php if (has_post_thumbnail()) : ?> <div class="featured-image"> <?php the_post_thumbnail('large'); ?> </div> <?php endif; ?> <div class="portfolio-meta"> <?php  $terms = get_the_terms(get_the_ID(), 'project_type'); if ($terms && !is_wp_error($terms)) : echo '<div class="types">Тип: '; $term_list = array(); foreach ($terms as $term) { $term_list[] = $term->name; } echo implode(', ', $term_list); echo '</div>'; endif; ?> <div class="date">Дата: <?php echo get_the_date(); ?></div> </div> <div class="portfolio-content"> <?php the_content(); ?> </div> <?php  // Навигация по соседним записям the_post_navigation(array( 'prev_text' => '← Предыдущая работа', 'next_text' => 'Следующая работа →', )); ?> <?php comments_template(); ?> </article> <?php endwhile; ?> <?php get_footer(); ?>

Плагины → Добавить новый → Advanced Custom Fields → Установить → Активировать

ACF → Группы полей → Добавить новую

<?php  // В single-portfolio.php $project_url = get_field('project_url'); $client_logo = get_field('client_logo'); $project_cost = get_field('project_cost'); $project_status = get_field('project_status'); ?> <?php if ($project_url) : ?> <div class="project-link"> <a href="<?php echo esc_url($project_url); ?>" target="_blank">Посмотреть проект</a> </div> <?php endif; ?> <?php if ($client_logo) : ?> <div class="client-logo"> <img src="<?php echo esc_url($client_logo['url']); ?>" alt="<?php echo esc_attr($client_logo['alt']); ?>"> </div> <?php endif; ?> <?php if ($project_cost) : ?> <div class="project-cost">Бюджет: <?php echo number_format($project_cost); ?> ₽</div> <?php endif; ?>

function add_portfolio_metabox() {
    add_meta_box(
        'portfolio_details',
        'Детали проекта',
        'render_portfolio_metabox',
        'portfolio',
        'normal',
        'default'
    );
}
add_action('add_meta_boxes', 'add_portfolio_metabox');

function render_portfolio_metabox($post) {
    wp_nonce_field('portfolio_details_nonce', 'portfolio_nonce');
    
    $project_url = get_post_meta($post->ID, '_project_url', true);
    ?>
    <p> <label for="project_url">Ссылка на проект:</label> <input type="url" id="project_url" name="project_url" value="<?php echo esc_attr($project_url); ?>" class="widefat"> </p> <?php } function save_portfolio_metabox($post_id) { if (!isset($_POST['portfolio_nonce']) || !wp_verify_nonce($_POST['portfolio_nonce'], 'portfolio_details_nonce')) { return; } if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) { return; } if (!current_user_can('edit_post', $post_id)) { return; } if (isset($_POST['project_url'])) { update_post_meta($post_id, '_project_url', esc_url_raw($_POST['project_url'])); } } add_action('save_post', 'save_portfolio_metabox');

class Recent_Portfolio_Widget extends WP_Widget {
    public function __construct() {
        parent::__construct(
            'recent_portfolio',
            'Последние работы портфолио',
            array('description' => 'Показывает последние работы из портфолио')
        );
    }
    
    public function widget($args, $instance) {
        echo $args['before_widget'];
        echo $args['before_title'] . $instance['title'] . $args['after_title'];
        
        $query = new WP_Query(array(
            'post_type' => 'portfolio',
            'posts_per_page' => $instance['count'],
            'orderby' => 'date',
            'order' => 'DESC'
        ));
        
        if ($query->have_posts()) : ?>
            <ul class="recent-portfolio"> <?php while ($query->have_posts()) : $query->the_post(); ?> <li> <a href="<?php the_permalink(); ?>"> <?php if (has_post_thumbnail()) : ?> <?php the_post_thumbnail('thumbnail'); ?> <?php endif; ?> <?php the_title(); ?> </a> </li> <?php endwhile; ?> </ul> <?php endif; wp_reset_postdata(); echo $args['after_widget']; } public function form($instance) { $title = !empty($instance['title']) ? $instance['title'] : ''; $count = !empty($instance['count']) ? $instance['count'] : 5; ?> <p> <label for="<?php echo $this->get_field_id('title'); ?>">Заголовок:</label> <input type="text" id="<?php echo $this->get_field_id('title'); ?>"  name="<?php echo $this->get_field_name('title'); ?>" value="<?php echo esc_attr($title); ?>" class="widefat"> </p> <p> <label for="<?php echo $this->get_field_id('count'); ?>">Количество работ:</label> <input type="number" id="<?php echo $this->get_field_id('count'); ?>"  name="<?php echo $this->get_field_name('count'); ?>" value="<?php echo esc_attr($count); ?>" min="1" max="20"> </p> <?php } } add_action('widgets_init', function() { register_widget('Recent_Portfolio_Widget'); });

Внешний вид → Меню → Настройки экрана (вверху) → Отметить "Портфолио"

'rewrite' => array( 'slug' => 'portfolio', // Базовая часть URL 'with_front' => false, // Игнорировать базовый префикс в настройках ЧПУ 'pages' => true, // Поддержка пагинации 'feeds' => true, // Поддержка RSS-лент )

SEO → Настройки → Типы контента
- Выберите ваш CPT
- Настройте шаблоны для заголовков и мета-описаний
- Включите в XML-карту

add_action('wp_head', 'fix_cpt_canonical'); function fix_cpt_canonical() { if (is_post_type_archive('portfolio')) { echo '<link rel="canonical" href="' . get_post_type_archive_link('portfolio') . '" />'; } }

Плагины → Добавить новый → Custom Search → Активировать
Настройки → Custom Search → Выбрать CPT для включения в поиск

function include_cpt_in_search($query) { if ($query->is_search && !is_admin()) { $query->set('post_type', array('post', 'page', 'portfolio')); } return $query; } add_action('pre_get_posts', 'include_cpt_in_search');

Плагины → Добавить новый → Search Anything Anywhere → Активировать

Настройки → Search → General
- ✅ ACF Search
- ✅ Taxonomy Search
- ✅ Friendly URLs

'show_in_rest' => true, 'rest_base' => 'portfolio', // База для REST-маршрутов 'rest_controller_class' => 'WP_REST_Posts_Controller',

add_filter('acf/rest_api/portfolio/get_fields', function($data, $request, $response) { return $data; }, 10, 3);

add_action('rest_api_init', function() { register_rest_route('custom/v1', '/portfolio/featured', array( 'methods' => 'GET', 'callback' => 'get_featured_portfolio', 'permission_callback' => '__return_true', )); }); function get_featured_portfolio($request) { $query = new WP_Query(array( 'post_type' => 'portfolio', 'posts_per_page' => 5, 'meta_key' => '_featured', 'meta_value' => 'yes' )); $data = array(); while ($query->have_posts()) { $query->the_post(); $data[] = array( 'id' => get_the_ID(), 'title' => get_the_title(), 'link' => get_permalink(), 'thumbnail' => get_the_post_thumbnail_url('large'), ); } return rest_ensure_response($data); }

CPT UI → Инструменты импорта/экспорта
- Выберите типы записей и таксономии
- Скопируйте код для functions.php

Плагины → Добавить новый → WP All Import → Активировать
All Import → Новый импорт → Выбрать CPT

# Экспорт только CPT
wp export --post_type=portfolio --dir=/path/to/export/

# Импорт
wp import /path/to/export/portfolio.xml --authors=create

// Плохо $query = new WP_Query(array( 'post_type' => 'portfolio', 'posts_per_page' => -1 // Загружает все записи! )); // Хорошо $query = new WP_Query(array( 'post_type' => 'portfolio', 'posts_per_page' => 12, 'no_found_rows' => true, // Отключает подсчет общего количества для пагинации 'update_post_meta_cache' => false, // Отключает кеширование мета-полей 'update_post_term_cache' => false, // Отключает кеширование таксономий ));

function cache_cpt_archives() { if (is_post_type_archive('portfolio')) { add_filter('posts_pre_query', function($posts, $query) { $cache_key = 'portfolio_archive_' . md5(serialize($query->query_vars)); $cached = wp_cache_get($cache_key, 'cpt_queries'); if ($cached !== false) { return $cached; } return $posts; }, 10, 2); } } add_action('pre_get_posts', 'cache_cpt_archives');

ALTER TABLE wp_postmeta ADD INDEX post_id_meta_key (post_id, meta_key(100)); ALTER TABLE wp_posts ADD INDEX post_type_post_date (post_type, post_date);

// CPT: Проекты // Таксономии: Категории проектов (веб-дизайн, брендинг, иллюстрации) // Поля ACF: Ссылка на проект, клиент, год, использованные технологии

// CPT: Объекты недвижимости // Таксономии: Тип недвижимости (квартира, дом, участок), район // Поля ACF: Цена, площадь, этаж, количество комнат, фото

// CPT: Рецепты // Таксономии: Кухня (итальянская, японская), тип блюда (суп, салат) // Поля ACF: Ингредиенты, время приготовления, калорийность, пошаговые фото

// CPT: Статьи базы знаний // Таксономии: Категории (установка, настройка, ошибки) // Поля ACF: Версия ПО, уровень сложности, связанные статьи

// CPT: Сотрудники // Таксономии: Отделы, должности // Поля ACF: Фото, телефон, email, соцсети, биография

Настройки → Постоянные ссылки → Нажать "Сохранить изменения"