Коли записів на сайті стає багато, їх розкладають по категоріях (в адмінці WordPress вони називаються рубриками). Клацаєш на категорію – і бачиш лише її записи. Колись, роблячи свою тему, я довго розбирався, звідки береться вигляд цієї сторінки і як зробити його не таким, як на головній. Тож розповім, як WordPress вибирає шаблон для категорії, як зробити нормальний шаблон архіву, archive.php, з назвою й описом рубрики і як оформити одну категорію зовсім інакше, ніж решту.

Як WordPress вибирає шаблон категорії

Якщо ти нічого спеціально не робив/ла, сторінка категорії виглядає так само, як головна. Причина в ієрархії шаблонів WordPress: WordPress по черзі шукає в темі файли, від найточнішого до найзагальнішого, і бере перший, який знайде. Для категорії з адресою /category/wordpress черга така:

  1. category-wordpress.php – шаблон для категорії з таким слагом (слаг – це частина адреси, утворена від назви);
  2. category-5.php – шаблон для категорії з таким ID (номер видно в адресі, коли редагуєш рубрику в адмінці);
  3. category.php – спільний шаблон для всіх категорій;
  4. archive.php – спільний шаблон для всіх архівів: категорій, позначок, архівів за датою й автором;
  5. index.php – запасний шаблон для всього.

Ось чому без жодних зусиль категорія виглядає як головна: файл index.php у теми вже є, і WordPress бере його. Для позначок черга та сама, тільки файли називаються tag-слаг.php і tag.php.

Одна пастка з кирилицею: якщо слаг категорії українською, у назві файлу він мав би бути закодований, щось на кшталт category-%d0%bc%d1%83%d0%b7%d0%b8%d0%ba%d0%b0.php. Тому або давай категоріям латинські слаги (це й для адрес краще), або використовуй варіант з ID.

Один archive.php на всі архіви

На практиці мені майже завжди вистачає одного archive.php: він покриває і категорії, і позначки, і архіви за датами. Від index.php він відрізняється лише шапкою з назвою та описом розділу:

<?php get_header(); ?>

<main id="main" class="site-main">
    <?php if ( have_posts() ) : ?>

        <header class="page-header">
            <?php
            the_archive_title( '<h1 class="page-title">', '</h1>' );
            the_archive_description( '<div class="archive-description">', '</div>' );
            ?>
        </header>

        <?php while ( have_posts() ) : the_post(); ?>
            <?php get_template_part( 'template-parts/content' ); ?>
        <?php endwhile; ?>

        <?php the_posts_pagination(); ?>

    <?php else : ?>

        <?php get_template_part( 'template-parts/content', 'none' ); ?>

    <?php endif; ?>
</main>

<?php get_footer(); ?>

Колись я робив такий файл, просто скопіювавши весь index.php і дописавши в нього опис категорії. Тепер копіювати нічого не треба: розмітка запису лежить у template-parts/content.php, тож archive.php лише підключає її, як і index.php.

Назва архіву

the_archive_title() сама розуміє, де ми: для категорії виведе її назву, для позначки – назву позначки, для архіву за місяць – місяць і рік. Але перед назвою вона ставить підпис на кшталт «Рубрика:» чи «Позначка:». Якщо він тобі не потрібен, додай у functions.php один рядок:

add_filter( 'get_the_archive_title_prefix', '__return_empty_string' );

Опис категорії

the_archive_description() виводить опис, який ти вписуєш у полі «Опис» під час редагування рубрики (Записи → Рубрики). Якщо опис порожній, функція нічого не виведе, тож перевіряти це окремо, як я колись робив, не потрібно. Опис корисний не лише відвідувачам: пару речень про те, що в цьому розділі, люблять і пошуковики, бо інакше сторінка категорії – це просто список чужих заголовків.

Окремий вигляд для однієї категорії

А тепер найцікавіше. Скажімо, у категорії «Книги» тобі потрібен не стандартний список із картинками й уривками, а просто перелік назв. Створюєш файл category-books.php (де books – слаг категорії):

<?php get_header(); ?>

<main id="main" class="site-main">
    <header class="page-header">
        <?php
        the_archive_title( '<h1 class="page-title">', '</h1>' );
        the_archive_description( '<div class="archive-description">', '</div>' );
        ?>
    </header>

    <?php if ( have_posts() ) : ?>
        <ul class="title-list">
            <?php while ( have_posts() ) : the_post(); ?>
                <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
            <?php endwhile; ?>
        </ul>

        <?php the_posts_pagination(); ?>
    <?php endif; ?>
</main>

<?php get_footer(); ?>

Усе: WordPress знайде цей файл раніше за archive.php, і саме ця категорія матиме свій вигляд, а решта лишиться як була. Так можна зробити хоч кожну категорію схожою на окремий сайт.

Коли окремий файл не потрібен

Якщо відрізнятися має лише оформлення – інший колір, інший фон, сітка замість стовпчика, – окремий шаблон не потрібен. Функція body_class(), яку ми ставили в header.php, сама додає до <body> класи category, category-books і category-5. Тож усе робиться в CSS:

.category-books .site-main {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
    gap: 1.5rem;
}

А якщо відрізняється лише якийсь маленький шматочок розмітки, вистачить умови прямо в archive.php:

<?php if ( is_category( 'books' ) ) : ?>
    <p class="archive-note"><?php esc_html_e( 'Book reviews, from newest to oldest.', 'mytheme' ); ?></p>
<?php endif; ?>

Дочірні категорії

Одна неочевидна річ: шаблон category-books.php діє лише на саму категорію «Книги», а її дочірні категорії, наприклад «Фантастика», про нього нічого не знають і відкриваються звичайним archive.php. Якщо хочеш, щоб дочірні категорії брали шаблон батьківської, додай у functions.php:

function mytheme_parent_category_template( $template ) {
    $category = get_queried_object();

    if ( $category->parent ) {
        $parent = get_category( $category->parent );
        $parent_template = locate_template( 'category-' . $parent->slug . '.php' );

        if ( $parent_template ) {
            return $parent_template;
        }
    }

    return $template;
}

add_filter( 'category_template', 'mytheme_parent_category_template' );

Фільтр category_template спрацьовує, коли WordPress уже вибрав шаблон категорії. Якщо в категорії є батьківська і для неї в темі знайшовся свій файл, ми підсовуємо його замість вибраного.

Кількість і порядок записів

Шаблон відповідає лише за вигляд, а які записи і в якому порядку показувати, WordPress вирішує ще до нього. Тож якщо в якійсь категорії тобі потрібен інший порядок чи інша кількість записів на сторінці, правити треба не archive.php, а запит – через хук pre_get_posts. Як це зробити і на чому я колись спіткнувся, читай у статті правильне сортування статей у WordPress.

А в блокових темах?

Ієрархія там та сама, тільки шаблони лежать у теці templates і мають розширення .html: category-books.html, category.html, archive.html. Їх можна створювати й редагувати прямо в редакторі сайту, без жодного рядка PHP.

Що далі

Сторінка результатів пошуку – теж архів, але зі своїм шаблоном і своїми нюансами: ось форма та результати пошуку в темі WordPress. А щоб архіви, категорії й записи мали спільний низ сторінки, глянь, як зробити файл footer.php.

А в тебе всі категорії виглядають однаково чи якась має свій особливий вигляд? Пиши в коментарях 🙂