스키마에 커스텀 카테고리 택소노미 추가하기

WordPress에서는 게시물에 카테고리를 추가할 수 있습니다(즉, "category"라는 이름의 택소노미를 사용합니다). 이는 이미 GraphQL 스키마에서 PostCategory로 매핑되어 있으며, Post 항목과 연결되어 있습니다.

테마나 플러그인이 정의하는 커스텀 포스트 타입(예: "product")도 마찬가지로 자체 카테고리 택소노미(예: "product-cat")를 연결할 수 있습니다. 이러한 카테고리 택소노미는 GraphQL 스키마 전용 타입을 별도로 제공하지 않으므로(그러기 위해서는 PHP 코드를 통한 확장이 필요합니다), GenericCategory 타입을 통해 처리됩니다.

카테고리 데이터를 가져오려면 category 필드와 categories 필드를 사용하며, 필드 인수 taxonomy로 참조할 택소노미를 지정합니다. 결과는 유니온 타입 CategoryUnion으로 반환되며, 항목의 택소노미에 따라 PostCategory 또는 GenericCategory 중 하나의 항목이 포함됩니다.

​

쿼리 가능한 카테고리 택소노미 설정

쿼리할 수 있는 카테고리 택소노미는 명시적으로 설정해야 합니다. 이는 2곳에서 설정할 수 있습니다.

엔드포인트에 적용되는 스키마 설정에서 「Customize configuration, or use default from Settings?」 아래의 "Use custom configuration" 옵션을 선택한 후 원하는 항목을 선택합니다.

이 목록에는 쿼리 가능한 커스텀 포스트에 연결된 모든 「계층형」 택소노미가 포함됩니다. 즉, 「Custom Posts」 설정의 「Included custom post types」에서 선택된 항목들입니다. 각 카테고리 택소노미와 연결된 커스텀 포스트 타입은 (CPT: ...) 아래에 표시됩니다. 원하는 카테고리 택소노미가 여기에 표시되지 않는다면, 해당 택소노미와 연결된 모든 커스텀 포스트 타입이 허용 목록에 포함되어 있는지 확인하세요.

"Use configuration from Settings" 옵션을 선택한 경우에는 Schema Custom Posts 설정 페이지의 「Included category taxonomies」 섹션에서 정의된 값이 사용됩니다.

​

추가 설정

Schema Categories 설정을 통해 다음 항목도 정의할 수 있습니다.

• 임의의 카테고리 택소노미 목록을 쿼리할 때 가져올 기본 요소 수(필드 인수 limit가 설정되지 않은 경우)
• 단일 쿼리 실행에서 가져올 수 있는 최대 요소 수