워드프레스 attachment 포스트 타입의 아카이브

현재 과정까지의 예제에서 타입 attachment 포스트의 모든 아카이브 페이지에는 이미지 포스트가 출력되지 않습니다. 검색 결과도 마찬가지입니다. 워드프레스 아카이브의 기본 출력 포스트는 타입 post에 한정하도록 정의되어 있어 나타나는 결과로, 오류가 아닌 올바른 결과입니다.

예제는 타입 attachment 포스트의 하나인 이미지 포스트만 아카이브 페이지에 출력할 것이며, page 타입은 출력하지 않으며, post 타입은 나중에 템플릿 페이지에 커스텀 쿼리를 사용하여 출력할 것입니다. 따라서 워드프레스 아카이브 쿼리에 ‘attachment’ 타입을 추가하여 이미지 포스트를 출력합니다.

워드프레스 메인 쿼리

이미지 포스트의 아카이브 출력을 위해 이어서 안내하는 워드프레스 조건(태그, 함수)과 템플릿 파일에 관하여 간략하게 알아봅니다. 더 많은 관련 함수가 있지만, 이번 장에서 구성할 예제의 일부에 핵심적인 요소만 안내합니다.

is_home()

대부분 테마는 워드프레스 사이트의 첫 화면(페이지)에 타입 post의 포스트를 출력하도록 정의되어 있습니다. 테마에서 정의하였다는 뜻보다 어떤 정의도 하지 않았기에 워드프레스 기본 설정으로 타입 post의 포스트가 출력된다고 생각해야 합니다. 출력 수는 관리페이지의 설정에 의존합니다. 또, 템플릿 페이지 등의 사용자 정의 페이지가 아닌 테마의 ‘index.php’ 템플릿 파일을 사용합니다. 이때, 워드프레스는 is_home 조건에 의한 쿼리를 정의(선언)합니다. 지난 과정에서 간략하게 확인했는데, 예제에서는 ‘둘러보기’ 메뉴에 의한 페이지가 is_home 조건을 가집니다. 예제 사이트에서 ‘둘러보기’ 메뉴를 클릭한 후 어드민바에 있는 Query Monitor(이후부터 QM으로 표기) 영역에 마우스를 올려보세요.

is_archive()

지난 과정까지 싱글 이미지 포스트 페이지에 데이터를 출력하는 작업을 진행했지만, 분류 term과 등록자의 이미지 포스트 아카이브 페이지는 아직 이미지 포스트가 출력되지 않습니다. 타입 attachment 포스트는 기본으로 아카이브에 출력되지 않기에 나오는 올바른 결과임을 이미 알렸습니다. 아래 목록은 등록자 포스트 아카이브와 term 아카이브 URL 및 조건 태그를 나열한 것으로 일부 예를 든 것입니다.

localhost/author/photowoman (등록자 포스트 아카이브, is_author)
localhost/camera/nikon-d90 (카메라 분류의 term 아카이브, is_tax)
localhost/photocat/여행 (2차분류의 term 아카이브, is_tax)

위의 모든 조건은 is_archive 하나로 정의할 수 있습니다.¹ 또, 현재 예제에서 테마 ‘archive.php’ 템플릿 파일에 의존합니다. 위의 목록에 있는 URL 페이지로 접근한 후 사이트에서 QM 영역에 마우스를 올려보세요.

is_search()

브라우저 주소 입력란에 다음을 입력한 후 결과를 확인하면 page 타입의 포스트가 출력될 것이며, 이미지 포스트는 나오지 않을 것입니다. 이 결과도 앞에서 안내한 이유와 같습니다.

localhost/?s=

이때의 조건은 is_search, 테마의 ‘search.php’ 파일에 의존한 결과입니다. 역시 사이트에서 QM 영역에 마우스를 올려보세요.

is_main_query()

지금까지의 예제 과정에서 is_home, is_archive, is_search 조건과 대응하는 ‘index.php’, ‘archive.php’, ‘search.php’ 테마 템플릿 파일에 쿼리와 관련한 그 어떤 추가 정의를 하지 않았지만, URL 요청에 따라 워드프레스가 특정 조건을 선언하고 그에 맞는 결과(포스트)를 출력하였습니다. 타입 attachment 포스트는 기본으로 출력 정의가 되어 있지 않으므로 나오지 않는 것이 현재는 올바른 결과입니다.

이처럼 사용자가 추가 정의하지 않은, 조건과 템플릿 파일에 따라 워드프레스가 출력하는 포스트 쿼리를 ‘메인 쿼리^{main query}’라고 부릅니다. ‘사전 정의된 워드프레스 기본의 쿼리’로 해석할 수도 있습니다. 반대의 뜻으로 ‘Second Query’가 있지만, 넓게 ‘커스텀 쿼리^{Custom Query}’로 부르는 것이 편리합니다.

메인 쿼리도 is_main_query 조건으로 다른 is_home 조건 등과 연속하여 관계하므로 사용자가 특정 포스트 출력 제어를 위해 메인 쿼리 조건과 다른 조건을 함께 사용하는 것이 일반적입니다.

메인 쿼리에 attachment 타입 포스트 추가

코드를 추가하여 이미지 포스트를 아카이브에 출력하는 것으로 이해를 더합니다. 편집기로 테마 루트의 functions.php 파일을 열고 맨 아래에 다음 코드를 추가하고 저장합니다.

// functions.php 파일을 열고 맨 아래에 다음 코드를 추가
require get_parent_theme_file_path( '/inc/main-query.php' );

위의 코드에 있는 ‘main-query.php’ 파일은 메인 쿼리와 관련한 일부 코드만 추가할 것으로 독자의 나중 활용을 위해 구분하여 두는 것을 목적으로 합니다.

테마 루트 inc 디렉터리에 ‘main-query.php’ 이름의 파일을 만듭니다.
만든 파일을 편집기로 엽니다.

바로 코드를 추가해봅니다. 다음 코드를 main-query.php 파일에 추가하고 저장합니다.

<?php
add_action( 'pre_get_posts', 'pics_attachment_query_filter' );
function pics_attachment_query_filter( $query ) {
    if ( ! is_admin() && $query->is_main_query() ) { // 관리페이지가 아닐 때, 메인 쿼리일 때
        /* 타입 attachment 포스트를 메인 쿼리에 추가 */
        if ( $query->is_archive() || $query->is_home() || $query->is_search() ) { // 메인 쿼리가 특정 조건일 때
            $query->set( 'post_type', 'attachment' ); // attachment 포스트 타입
            $query->set( 'post_status', 'inherit' ); // 'inherit' 포스트 상태 (기본으로 attachment 포스트 타입에만 존재하므로 생략 가능)
            $query->set( 'post_parent', 0 ); // 예제처럼 attachment 포스트를 단독으로 사용할 때 (특정 포스트에 첨부하여 등록하지 않을 때)
        }
    }
}

pre_get_posts

2번 줄에서 사용한 pre_get_posts 훅이 코드의 핵심으로 쿼리 오브젝트를 결정하는 것입니다. 이 훅은 메인 쿼리를 변경하는 것이 아니라 메인 쿼리를 사용자가 정의(결정)할 때 사용하는 유용한 훅이므로 사용 패턴을 먼저 익히는 것이 유리합니다. 나머지는 코드의 설명을 참고하고, 더 많은 정보는 코덱스에서 얻으세요.

WordPress Codex – pre_get_posts

아래 주소를 브라우저에 각각 입력하여 접근하여 이미지 포스트가 출력되는지 확인하세요. 그림으로 따로 안내하지 않습니다.

localhost/pics
localhost/author/photoman
localhost/author/photowoman
localhost/mediacat/사진
localhost/camera/nikon-d90
localhost/photocat/여행
localhost/?s=

위 목록의 주소는 ‘둘러보기’ 페이지에 해당하는 is_home 조건, 등록자 아카이브의 is_author 조건, term 아카이브의 is_tax 조건, 검색 조건 is_search에 해당하는 것으로 모든 페이지에 출력되는 포스트 수는 ‘20’개이며 관리페이지의 설정에 의존합니다. 관리페이지 설정에 의존하지 않으려면 다음 코드를 추가하면 됩니다.

// 관리페이지 설정에 의존하지 않으려면 다음 코드를 추가
$query->set( 'posts_per_page', 10 ); // ‘10’은 10개를 출력한다는 것으로 원하는 수를 입력

검색 결과 페이지에는 코드를 추가하기 전 page 타입의 포스트가 출력되었지만, 추가한 후 attachment 타입의 이미지 포스트만 출력된 것을 볼 수 있습니다.

워드프레스에 사전 정의된 쿼리를 ‘메인 쿼리’로 간단하게 생각할 수 있다고 하였고, 지금처럼 사용자가 변경하면 ‘커스텀 쿼리’로 정의할 수 있다고 하였습니다. 그러나 지금의 방식은 ‘변경’이 아닌 ‘결정’의 개념으로 이해하면 됩니다. 또, pre_get_posts 훅으로 메인 쿼리를 결정할 수 없는 조건도 있으므로 코덱스와 여러 예시 및 예제를 통해 ‘경험적 이해’를 축적하는 것이 좋습니다.

다음 링크의 파일을 받아 압축을 푼 후 테마 루트에 덮어쓰세요.

25장 변경 및 추가 파일

다음 장에서는 공개 소스와 워드프레스 자바스크립트 변수 데이터 등록 방법으로 아카이브 페이지에 이미지 포스트 섬네일 목록 출력을 구성합니다.