Кастомный тип записи по умолчанию использует index.php для архивной страницы.

Я разработал пользовательскую тему с пользовательским типом записи, названным events. Однако по какой-то причине WP отказывается использовать мой шаблон страницы архива с именем файла archive-events.php в соответствии с иерархией шаблонов WP. WP продолжает по умолчанию использовать index.php в качестве шаблона для этого типа записи.

Ранее у меня была страница, настроенная в WP, которая была установлена на слуг /events/, который теперь является слугом пользовательского типа записи. Эта страница теперь удалена, и я не знаю, является ли это проблемой, из-за которой WP отказывается использовать archive-events.php для моего списка архивов пользовательского типа записи. Я попытался изменить и сохранить структуру постоянных ссылок, но это не сработало. В настоящее время структура пермальных ссылок установлена на “Имя записи”, т.е. http://my.domain/post-name/.

Более подробная информация:

• Я зарегистрировал пользовательский тип записи events (код ниже)
• Слуг типа записи – “events”, и отдельные записи успешно отображаются по ссылке http://domain.com/events/post-name
• Страница архива для типа записи доступна по /events/, но используется index.php, даже несмотря на то, что я создал шаблон архива для типа записи как archive-events.php
• Чтобы подтвердить, какой шаблон WP использует для отображения страницы архива для пользовательского типа записи, я создал функцию, которая выводит $GLOBALS['current_theme_template'], используемый для рендеринга страницы. Это подтверждает, что WP использует index.php для рендеринга страницы архива.
• В моем файле header.php я выводил функцию get_post_type_archive_link('events'), чтобы подтвердить, что WP считает, что страница архива для моего пользовательского типа записи должна быть http://domain.com/events/
• Шаблоны archive.php и index.php WP отдаются как ожидается, но шаблон для пользовательского типа записи пропускается WP, независимо от обстоятельств
• В качестве теста я переименовал мой существующий пользовательский тип записи на что-то новое, переназначил все свои запросы на этот CPT и обновил имена шаблонов соответственно. Тем не менее, WP отказывается использовать cpt-archive.php в качестве шаблона для пользовательского типа записи и вместо этого отдает либо archive.php, либо index.php.

Вот мой код в functions.php для регистрации типа записи:

function registerEvents()
{
    $labels = array(
        'name'                  => _x( 'События', 'Общее название типа записи', 'textdomain' ),
        'singular_name'         => _x( 'Событие', 'Сигнальное название типа записи', 'textdomain' ),
        'menu_name'             => _x( 'События', 'Текст админ-меню', 'textdomain' ),
        'name_admin_bar'        => _x( 'События', 'Добавить новое в панели инструментов', 'textdomain' ),
        <snip>
    );
    $args = array(
        'labels'                => $labels,
        'public'                => true,
        'hierarchical'          => false,
        'publicly_queryable'    => true,
        'exclude_from_search'   => false,
        'show_ui'               => true,
        'show_in_menu'          => true,
        'show_in_rest'          => false,
        'menu_position'         => 5,
        'menu_icon'             => 'dashicons-calendar-alt',
        'capability_type'       => 'post',
        'has_archive'           => true,
        'query_var'             => true,
        'delete_with_user'      => false,
        'supports'              => array( 
            'title',
            'editor',
            'excerpt',
            'thumbnail',
            'page-attributes'
        ),
        'taxonomies'            => array( 'kind' ), // Пользовательская таксономия, ранее зарегистрированная
        'rewrite'               => array( 'slug' => 'events', 'with_front' => false ),
    );
    register_post_type( 'events', $args );
}
add_action( 'init', 'registerEvents' );

Решение этой проблемы оказалось следующим:

• Изменение названия пользовательского типа записи с “events” (со слугом /events/) на “event” (со слугом /event/)
• Создание страницы с пользовательским шаблоном со слугом /events/ для отображения архивов пользовательского типа записи

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

На протяжении всего процесса я использовал wp-cli для очистки внутреннего кеша WP и удаления всех временных данных, но это не дало результата.

Если вы регистрируете типы записей вручную (в отличие от использования CPT UI или чего-то подобного), вам нужно помнить, что следует перейти в настройки > постоянные ссылки и просто нажать ‘Сохранить’. Это пару раз сбивало меня с толку.