활용 가이드커스텀 카테고리
커스텀 카테고리
WordPress에서는 게시물에 카테고리를 추가할 수 있습니다(즉, "category"라는 이름의 분류 체계를 사용합니다). 이는 이미 PostCategory 타입을 통해 GraphQL 스키마에 매핑되어 있으며, Post 항목과 연결되어 있습니다.
마찬가지로, 테마나 플러그인에 의해 정의된 커스텀 게시물 타입(예: "product")에는 자체 카테고리 분류 체계(예: "product-cat")를 연결할 수 있습니다. 이러한 커스텀 게시물 타입은 GraphQL 스키마에 매핑되지 않으므로, GenericCustomPost 타입을 통해 처리되며, 해당 카테고리는 GenericCategory로 처리됩니다.
카테고리 데이터를 가져오려면 category 필드와 categories 필드를 사용하며, 필드 인수 taxonomy를 통해 참조할 분류 체계를 지정합니다. 결과는 유니온 타입 CategoryUnion으로, PostCategory 또는 GenericCategory 중 하나의 항목이 포함됩니다(항목의 분류 체계에 따라 다릅니다).
예를 들어, 다음 쿼리는 분류 체계 "product-category"의 카테고리를 가져옵니다:
query {
categories(taxonomy: "product-category") {
__typename
...on Category {
count
description
id
name
slug
url
}
...on GenericCategory {
taxonomy
customPostCount
customPosts {
__typename
...on CustomPost {
id
title
}
}
}
}
}매핑되지 않은 카테고리 분류 체계에 대한 접근 허용
GenericCategory 타입을 통해 접근할 수 있는 카테고리 분류 체계는 플러그인 설정 페이지에서 명시적으로 구성해야 합니다. 자세한 내용은 가이드 스키마에 커스텀 카테고리 분류 체계 추가하기를 참조하십시오.