WPML GraphQL – 헤드리스 WordPress를 위한 다국어 WPGraphQL

프런트엔드에서 언어별로 콘텐츠 쿼리

모든 WPGraphQL 쿼리에 language 인수가 추가됩니다. 단일 필드에서 글, 사용자 정의 글 유형, 택소노미 용어, 메뉴, 메뉴 항목 및 댓글을 언어별로 필터링합니다. 프런트엔드에서 쿼리 후 필터링을 하거나 요청 볼륨을 두 배로 늘리거나 언어를 추측할 필요가 없습니다.

query PostsES {
  posts(where: { language: "es" }) {
    nodes { slug uri title }
  }
}

최상위 노드를 언어별로 필터링하면 연결된 항목(카테고리, 태그, 사용자 정의 택소노미)이 자동으로 동일한 언어를 따릅니다. 중첩된 필드마다 추가 인수 없이도 결과가 일관되게 유지됩니다.

사이트맵이나 총계 계산을 위해 언어에 관계없이 모든 항목을 원하시나요? language: "all"를 전달하세요.

단일 쿼리로 노드의 모든 번역 가져오기

글 및 택소노미 용어의 translations 필드는 슬러그, URI, 언어 코드 및 요청한 중첩 필드 등 노드의 다른 모든 언어 버전을 반환합니다. 한 번의 쿼리, 한 번의 왕복으로 페이지의 모든 언어 버전을 가져옵니다.

이는 프런트엔드에서 관련 쿼리 체인을 따르지 않고도 페이지 콘텐츠 옆에 렌더링되는 언어 전환기에 필요한 데이터입니다.

다국어 메뉴, 택소노미, 댓글 및 언어 데이터

WPML GraphQL은 글 외에도 동일한 language 인수와 번역 처리를 다음으로 확장합니다.

• 메뉴 및 메뉴 항목. 언어별 네비게이션을 위한 menu(language: "fr"). WPML GraphQL 1.1.0에 추가되었습니다.
• 택소노미 용어. 카테고리, 태그 및 사용자 정의 택소노미는 기본적으로 해당 글의 언어를 따르며 언어별로 직접 쿼리할 수 있습니다.
• 댓글. 특정 언어의 글과 연결된 댓글을 반환합니다.
• languages 및 defaultLanguage 쿼리. 사이트에 설치된 모든 언어를 코드, 로캘, 고유 명칭, 국가 국기 URL 및 홈 URL과 함께 나열합니다. 사용자 정의 언어 전환기에 적합한 데이터 형태입니다.

모든 언어에서 ID 또는 슬러그로 특정 글 쿼리

두 가지 쿼리 형태로 언어별 식별자를 통해 번역된 단일 글을 가져옵니다.

query PostBySlug {
  post(id: "hola-mundo", idType: SLUG) {
    title slug uri
  }
}

query PostById {
  post(id: "2", idType: DATABASE_ID) {
    title slug uri
  }
}

두 형태 모두 프런트엔드에 별도의 “이것이 번역인가요?” 로직 없이 번역된 제목, 슬러그 및 URI와 함께 번역된 글을 반환합니다.

현재 WPGraphQL 릴리스에 맞춰 유지 관리

WPML GraphQL 1.1.3은 WPGraphQL 프로젝트의 주요 릴리스 경로인 WPGraphQL 2.0.0까지 테스트되었습니다. WPGraphQL을 유지 관리하는 팀은 다국어 레이어가 스키마와 함께 계속 이동하도록 당사와 협력합니다. WPGraphQL이 새 릴리스를 출시하면 WPML GraphQL도 바로 그 뒤를 따릅니다.

ACFML 및 WPGraphQL for ACF를 추가할 때 ACF와 함께 작동

Advanced Custom Fields로 콘텐츠 모델을 구축하고 WPGraphQL을 통해 해당 필드를 노출하는 사이트의 경우, WPML GraphQL은 ACFML 및 WPGraphQL for ACF와 결합하여 ACF 옵션 페이지 쿼리에 language 인수를 추가합니다.

query Settings {
  myOptionPage(language: "de") {
    addressFieldGroup {
      addressTitle
      repeaterAddressDetails { addressDetails }
    }
  }
}

글 및 CPT의 ACF 필드는 호스트 글의 언어를 자동으로 따릅니다.