스키마에 커스텀 태그 택소노미 추가하기

WordPress에서는 포스트에 태그를 추가할 수 있습니다（즉, "post_tag"라는 이름의 택소노미를 사용합니다）. 이는 이미 GraphQL 스키마에서 PostTag로 매핑되어 있으며, Post 항목과 연결되어 있습니다.

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

태그 데이터를 조회하려면 tag 및 tags 필드를 사용합니다. 이 필드들은 필드 인수 taxonomy를 통해 참조할 택소노미를 지정합니다. 결과는 유니온 타입 TagUnion으로 반환되며, 항목의 택소노미에 따라 PostTag 또는 GenericTag 항목이 포함됩니다.

​

쿼리 가능한 태그 택소노미 설정

쿼리할 수 있는 태그 택소노미는 명시적으로 설정해야 합니다. 설정은 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 tag taxonomies」 섹션에서 정의된 값이 사용됩니다.

​

추가 설정

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

• 태그 택소노미 목록을 쿼리할 때 기본으로 가져올 요소 수（필드 인수 limit이 설정되지 않은 경우）
• 단일 쿼리 실행에서 가져올 수 있는 최대 요소 수