🚀 Gato GraphQL 버전 0.8을 출시했습니다!

Gato GraphQL 버전 0.8이 다운로드 가능해졌습니다! 🎉

이번 릴리스는 매우 대규모로, 다음 세 가지 영역에 중점을 두고 있습니다:

확장 기능을 지원하기 위한 코드베이스 리팩토링
GraphQL 사양의 추가 준수
GraphQL 스키마 완성

또한 새로운 WordPress 5.8을 지원하며, 다수의 버그 수정 및 개선 사항이 포함되어 있습니다.

이번 릴리스에는 호환성을 깨는 변경 사항이 포함되어 있으므로 주의하시기 바랍니다.

아래는 릴리스 노트입니다. 빠른 링크:

WordPress 5.8 지원
PHP 8.0 지원 개선
컨테이너 서비스를 전면적으로 사용한 코드베이스 간소화
wp-content 하위에 캐시 저장
WordPress 편집기를 구동하기 위한 「고정 스키마」GraphQL 엔드포인트 도입
스키마에서 필드 유형 추가 지원
입력 강제 변환: 리스트가 예상되는 경우 단일 값 허용
WordPress 스키마 추가 완성
GraphQL 스키마에 「무제한」관리자 필드 추가
스칼라 유형 AnyScalar 도입
긴 형식의 설정
호환성을 깨는 변경 사항
향후 로드맵
문제가 발생하셨나요?

WordPress 5.8 지원

WordPress 5.8은 이 플러그인에서 사용하는 allowed_block_types 및 block_categories를 포함한 여러 필터 훅을 더 이상 사용하지 않도록 지정했습니다.

영향을 받는 훅은 다음과 같이 대체되었습니다:

allowed_block_types => allowed_block_types_all
block_categories => block_categories_all

PHP 8.0 지원 개선

이번 릴리스는 PHP 8.0 사용 시 발생하는 몇 가지 문제를 수정합니다.

컨테이너 서비스를 전면적으로 사용한 코드베이스 간소화

GraphQL 서버의 코드베이스가 리팩토링되어, 스키마의 모든 요소(type resolver, field resolver, interface resolver, custom scalar resolver 등)를 등록하기 위해 서비스 컨테이너를 사용하게 되었습니다.

이것은 하나의 마일스톤으로, 플러그인과 그 확장 기능 개발을 위한 단일 접근 방식을 도입하여 코드와 문서를 크게 간소화합니다.

Gato GraphQL의 커스텀 확장 기능을 만드는 방법에 대한 문서를 이제 작성할 수 있게 되었습니다. 작업은 곧 시작되어 가이드 섹션에 게시될 예정입니다.

`wp-content` 하위에 캐시 저장

플러그인은 성능 최적화를 위해 결과를 디스크에 캐시합니다.

캐시된 파일은 이전에 관리자 사용자에게 보이지 않는 시스템 폴더 아래에 저장되었습니다. 이제부터는 wp-content/graphql-api/cache/ 하위에 저장됩니다.

WordPress 편집기를 구동하기 위한 「고정 스키마」GraphQL 엔드포인트 도입

이제 wp-admin에는 두 개의 엔드포인트가 있습니다:

GRAPHQL_API_ADMIN_CONFIGURABLESCHEMA_ENDPOINT
GRAPHQL_API_ADMIN_FIXEDSCHEMA_ENDPOINT

GRAPHQL_API_ADMIN_CONFIGURABLESCHEMA_ENDPOINT에서는 GraphQL 스키마가 네임스페이스 여부, 유형/디렉티브 활성화 여부 등 사용자 설정에 따라 변경됩니다.

GRAPHQL_API_ADMIN_FIXEDSCHEMA_ENDPOINT에서는 GraphQL 스키마가 사용자 설정에 따라 변경되지 않으며, 「무제한」관리자 필드를 포함하여 모든 유형, 필드, 디렉티브를 항상 노출합니다.

고정 엔드포인트를 통해 Gutenberg 블록은 사용자의 활성화/비활성화 설정에 관계없이 모든 필드를 무제한으로 쿼리할 수 있게 됩니다.

스키마에서 필드 유형 추가 지원

필드 유형으로서의 리스트 지원이 확장되어 다음 기능이 지원됩니다:

null을 허용하지 않는 항목의 리스트: [String!]
리스트의 리스트: [[String]]
이들의 임의 조합: [[String!]!]

입력 강제 변환: 리스트가 예상되는 경우 단일 값 허용

GraphQL 사양에 정의된 대로, 리스트가 예상되는 GraphQL 쿼리 위치에 단일 값을 입력할 수 있게 되었습니다.

예를 들어, 다음 쿼리들은 이제 동일합니다:

query InputSingleValue {
  posts(filter: { ids: 1 }) {
    title
  }
}
 
query InputListOfSingleItem {
  posts(filter: { ids: [1] }) {
    title
  }
}

WordPress 스키마 추가 완성

WordPress 데이터 모델의 추가 엔티티가 GraphQL 스키마에 추가되었습니다:

GraphQL schema

추가된 새로운 요소들을 살펴보겠습니다.

카테고리

카테고리가 새로운 PostCategory 유형과 다음 새로운 필드를 통해 매핑되었습니다:

Root.postCategories: [PostCategory]
Root.postCategory: PostCategory
Post.categories: [PostCategory]

예를 들어, 이 쿼리는 게시물의 카테고리를 가져옵니다:

{
  posts {
    id
    title
    categories {
      id
      name
      url
    }
  }
}

게시물에 카테고리를 할당하기 위한 mutation 필드도 추가되었습니다:

MutationRoot.setCategoriesOnPost: Post

또한 게시물 mutation 필드에 categories 입력이 추가되었습니다:

MutationRoot.createPost
MutationRoot.updatePost
Post.update (중첩 mutation이 활성화된 경우)

메타

커스텀 게시물, 사용자, 댓글, 분류 체계의 메타 값을 다음 새로운 필드를 통해 쿼리할 수 있게 되었습니다:

Post.metaValue: AnyScalar
Post.metaValues: [AnyScalar]
User.metaValue: AnyScalar
User.metaValues: [AnyScalar]
Comment.metaValue: AnyScalar
Comment.metaValues: [AnyScalar]
PostCategory.metaValue: AnyScalar
PostCategory.metaValues: [AnyScalar]
PostTag.metaValue: AnyScalar
PostTag.metaValues: [AnyScalar]

예를 들어, 이 쿼리는 사용자의 메타 last_name을 가져옵니다:

{
  users {
    id
    lastName: metaValue(key: "last_name")
  }
}

메타 값은 무엇이든 될 수 있으므로(string, integer, float, 또는 boolean), 새롭게 도입된 제네릭 스칼라 유형 AnyScalar를 통해 매핑되었습니다.

메타 값은 공개 또는 비공개일 수 있습니다. 어떤 메타 키를 쿼리할 수 있는지는 설정 페이지에서 명시적으로 구성해야 합니다:

기본적으로 허용된 메타 키 목록은 비어 있습니다.

메뉴

메뉴가 새로운 Menu 유형과 새로운 필드 Root.menu를 통해 매핑되었습니다.

{
  menu(by: { id: 176 }) {
    itemDataEntries
  }
}

설정

사이트 설정(테이블 wp_options에 저장됨)을 새로운 필드 Root.option: AnyScalar를 통해 쿼리할 수 있게 되었습니다.

예를 들어, 이 쿼리는 사이트 이름을 가져옵니다:

{
  siteName: optionValue(name: "blogname")
}

어떤 옵션에 접근할 수 있는지는 설정 페이지에서 명시적으로 구성해야 합니다:

Defining the entries for the Settings

기본적으로 다음 옵션만 쿼리할 수 있습니다:

"home"
"blogname"
"blogdescription"

사용자 게시물

로그인한 사용자는 다음 새로운 필드를 통해 임의의 상태(publish, pending, draft 또는 trash)의 자신의 게시물을 가져올 수 있게 되었습니다:

Root.myPosts: [Post]
Root.myPostCount: Int
Root.myPost: Post

예를 들어, 이제 이 쿼리를 실행할 수 있습니다:

# Log yourself in first
mutation LogIn {
  loginUser(usernameOrEmail: "test", password: "pass") {
    id
    name
  }
}
 
# Then retrieve your posts
query GetMyPosts {
  myPosts {
    id
    title
    url
    status
    author {
      name
    }
  }
}

GraphQL 스키마에 「무제한」관리자 필드 추가

GraphQL 스키마는 공개 API에서 개인 정보가 노출되지 않도록 공개 필드와 비공개 필드 간의 균형을 유지해야 합니다.

새로운 모듈 Schema for the Admin은 개인 데이터를 노출할 수 있는 「무제한」관리자 필드를 GraphQL 스키마에 추가합니다:

Root:

unrestrictedPost
unrestrictedPosts
unrestrictedPostCount
unrestrictedCustomPost
unrestrictedCustomPosts
unrestrictedCustomPostCount
unrestrictedGenericCustomPost
unrestrictedGenericCustomPosts
unrestrictedGenericCustomPostCount
unrestrictedPage
unrestrictedPages
unrestrictedPageCount
unrestrictedUsers
roles
capabilities

User:

unrestrictedPosts
unrestrictedPostCount
unrestrictedCustomPosts
unrestrictedCustomPostCount
roles
capabilities

PostCategory:

unrestrictedPosts
unrestrictedPostCount

PostTag:

unrestrictedPosts
unrestrictedPostCount

예를 들어, 게시물 데이터에 접근할 때 현재는 게시된 게시물을 가져오는 방식으로 공개 데이터만 노출하는 필드 posts가 있습니다.

이제부터는 필드 unrestrictedPosts를 통해서도 게시물 데이터에 접근할 수 있으며, 이는 임의의 상태("publish", "draft", "pending", "trash")의 게시물을 가져오는 방식으로 공개 및 비공개 데이터를 노출합니다.

{
  unrestrictedPosts(status: [draft, pending]) {
    id
    title
    status
    author {
      id
      name
    }
  }
}

스칼라 유형 `AnyScalar` 도입

스칼라 유형 AnyScalar는 내장 스칼라(String, Int, Boolean, Float 또는 ID) 중 하나를 나타냅니다.

새롭게 도입된 option 및 metaValue(s) 필드에서 사용됩니다. 반환되는 데이터의 유형을 사전에 알 수 없고, 스칼라 유형의 합집합이 GraphQL 사양에서 아직 지원되지 않기 때문입니다.

긴 형식의 설정

설정 페이지의 옵션은 탭으로 구분되어 있습니다. v0.8부터는 모두를 하나의 긴 페이지에 함께 표시하는 것도 가능합니다.

이 동작을 활성화하려면 설정에서 "Have all options in this Settings page be organized under tabs, one tab per module."의 체크를 해제하고 "Save Changes"를 누르십시오:

Checkbox to enable/disable tabs in Settings

그러면 모든 설정이 긴 형식으로 함께 표시됩니다:

Settings in long format

호환성을 깨는 변경 사항

릴리스 v0.8은 이전 버전과의 호환성을 깨는 변경 사항을 포함합니다.

설정 호환성 변경

다음 CPT의 「Options」 블록이 재구성되었습니다:

Schema Configurations
Custom Endpoints
Persisted Queries

이전 v0.7에서는 이러한 엔티티의 단일 Options 블록에 많은 구성 항목이 포함되었습니다. v0.8부터 이 블록은 각자의 구성을 가진 여러 독립적인 블록으로 분리되었습니다.

예를 들어 v0.7에서는 (엔드포인트 활성화/비활성화 외에도) Custom Endpoint Options 블록에서 GraphiQL 및 Interactive Schema 클라이언트를 구성할 수 있었습니다:

Options in Custom Endpoint

v0.8부터는 이 구성이 GraphiQL 및 Interactive Schema 블록을 통해 추가됩니다:

Options in Custom Endpoint

세 CPT 모두의 Options 블록에 저장된 구성은 새로운 형식으로 자동으로 마이그레이션되지 않습니다. 따라서 v0.8로 업그레이드하기 전에 저장된 구성을 기록해 두시고, 새 버전으로 업그레이드한 후에 다시 입력하시기 바랍니다.

불편을 드려서 죄송합니다.

또한 세 CPT의 모든 항목에 대해 WordPress 편집기에 표시되는 「Reset the template」 버튼을 클릭해야 합니다.

Reset the template in the WordPress editor

비표준 디렉티브 제거

비표준 디렉티브가 플러그인에서 제거되었습니다:

@default
@removeIfNull
@export

제거된 모듈

다음 모듈이 플러그인에서 제거되었습니다:

Field Deprecation
Configuration Cache
Schema Cache
Multiple Query Execution
Proactive Feedback
Schema Editing Access
Embeddable fields

향후 로드맵

v0.8이 출시되었으므로, 앞으로의 계획을 세울 수 있게 되었습니다.

현재 계획은 다음과 같습니다:

2021년 9월에 v0.9 출시 예정, 내용:

Custom scalars
적절한 경우 custom scalars를 사용한 업데이트된 GraphQL 스키마 (예: Post.date는 String 대신 Date 유형을 반환하게 됩니다)
확장 기능 지원을 위한 추가 개선 사항

그 후, 연말 또는 2022년 초에 v1.0 출시 예정, 내용:

확장 플러그인 데모
확장 기능 생성에 관한 완전한 문서 가이드
wp.org에서 Gato GraphQL 플러그인 출시

현재 상태에 대한 알림을 받으려면 뉴스레터를 구독하세요.

문제가 발생하셨나요?

v0.8을 설치하거나 실행하는 데 문제가 있으시면 저장소에서 이슈를 생성해 주세요.

🚀 Gato GraphQL 버전 0.8을 출시했습니다!

뉴스레터 구독하기