워드프레스에서 카테고리 리스트 페이지 만들기

워드프레스에서 카테고리를 선택하였을 때, 해당 카테고리에 해당되는 포스트들의 리스트만 보여주는 페이지가 필요할 수 있다. 아마 찾아보면 플러그인도 있긴 할텐데, 간단히 파일 하나 정도만 생성해주면 사용자가 원하는 카테고리 페이지를 만들 수 있다.

현재 사용하고 있는 테마의 디렉토리로 이동한다.

$ cd /var/www/html/wp-content/theme/twentyseventeen

category.php 파일을 생성한다. 만약 카테고리 이름별로 페이지를 생성하고 싶다면, 원하는 카테고리 이름을 추가하여 만들어주면 된다. 예를 들어 scratch 카테고리 페이지를 만든다면, category-scratch.php를 만들어준다. 워드프레스는 해당 페이지를 읽을 때 우선순위를 두게 되는데,

category-{name}.php — category.php — archive.php — index.php

와 같은 우선순위를 두고 읽게 된다.

category.php 파일을 생성하고, 다음과 같이 입력한다. archive.php 파일에서 필요한 부분만 수정하였다.

<?php
    get_header(); ?>

<div class="wrap">
    <?php if ( have_posts() ) : ?>
        <header class="page-header">
        <?php
            the_archive_title( '<h1 class="page-title">', '</h1>' );
            the_archive_description( '<div class="taxonomy-description">', '</div>' );
        ?>
        </header><!-- .page-header -->
    <?php endif; ?>

    <div id="primary" class="content-area">
        <main id="main" class="site-main" role="main">

        <?php
        if ( have_posts() ) :
        ?>
        <?php
            /* Start the Loop */
            while ( have_posts() ) :
                    the_post(); ?>

            <div id="category-post">+ <a href="<?php the_permalink(); ?>" rel="bookmark" title="Permanent Link to <?php the_title_attribute(); ?>"><?php the_title(); ?></a>
            <small><?php the_time('F jS, Y') ?> by <?php the_author_posts_link() ?></small> </div>

            <?php
            endwhile;
        else :
            get_template_part( 'template-parts/post/content', 'none' );
        endif;
        ?>
        </main>
    </div>
<?php get_sidebar(); ?>
</div>

<?php
get_footer();

저장한 다음, 다시 블로그에서 카테고리를 선택하면 다음과 같이 보인다.

이때 보여지는 포스트의 수는 워드프레스의 Reading 설정에 있는 갯수를 따른다. 이를 늘려도 되지만, 그렇게 되면 첫 페이지에 보여지는 포스트의 수가 너무 늘어나게 되므로, archive 페이지에서만 보여지는 포스트의 수를 늘려주도록 한다.

마찬가지로 테마의 디렉토리에서 functions.php 파일을 열어 다음의 내용을 추가한다.

add_action( 'pre_get_posts', 'prefix_category_query' );
function prefix_category_query( $query ) {
    if( is_archive() && $query->is_main_query() ) {
        $query->set( 'posts_per_page', '100' );
    }
}

archive 페이지의 경우에 보여지는 포스트의 수를 100개로 늘렸다. 이제 다시 카테고리를 선택해보면,

전체 포스트가 잘 보여짐을 볼 수 있다.