🚀 Gato GraphQL バージョン 0.8 をリリースしました！

Gato GraphQL バージョン 0.8 がダウンロード可能になりました！ 🎉

これは非常に大きなリリースで、以下の3つの領域に焦点を当てています：

1. 拡張機能を有効にするためのコードベースのリファクタリング
2. GraphQL 仕様のさらなる準拠
3. 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 を含むいくつかのフィルターフックを非推奨化しました。

影響を受けるフックは以下のように置き換えられました：

1. allowed_block_types => allowed_block_types_all
2. 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 には2つのエンドポイントがあります：

1. GRAPHQL_API_ADMIN_CONFIGURABLESCHEMA_ENDPOINT
2. 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
  }
}Copy

​

WordPress スキーマのさらなる完成

WordPress データモデルから追加のエンティティが GraphQL スキーマに追加されました：

追加された新しい要素を見てみましょう。

​

カテゴリー

カテゴリーが新しい PostCategory 型と以下の新しいフィールドを通じてマッピングされました：

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

たとえば、このクエリは投稿のカテゴリーを取得します：

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

投稿にカテゴリーを割り当てるための 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")
  }
}Copy

メタ値は何でもあり得る（string、integer、float、または boolean）ため、新しく導入されたジェネリックスカラー型 AnyScalar を通じてマッピングされています。

メタ値はパブリックまたはプライベートになります。どのメタキーをクエリできるかは、設定ページで明示的に設定する必要があります：

デフォルトでは、許可されたメタキーのリストは空です。

​

メニュー

メニューが新しい Menu 型と新しいフィールド Root.menu を通じてマッピングされました。

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

​

設定

サイトの設定（テーブル wp_options に保存されている）が新しいフィールド Root.option: AnyScalar を通じてクエリできるようになりました。

たとえば、このクエリはサイト名を取得します：

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

どのオプションにアクセスできるかは、設定ページで明示的に設定する必要があります：

デフォルトでは、以下のオプションのみクエリできます：

• "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
    }
  }
}Copy

​

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
    }
  }
}Copy

​

スカラー型 AnyScalar の導入

スカラー型 AnyScalar は、組み込みスカラーのいずれか（String、Int、Boolean、Float、または ID）を表します。

新しく導入された option および metaValue(s) フィールドで使用されています。これは、返されるデータの型を事前に知ることができず、スカラー型の共用体が GraphQL 仕様でまだサポートされていないためです。

​

長形式の設定

設定ページのオプションはタブで分割されています。v0.8 からは、すべてを1つの長いページにまとめて表示することもできます。

この動作を有効にするには、設定の "Have all options in this Settings page be organized under tabs, one tab per module." のチェックを外し、"Save Changes" を押してください：

すると、すべての設定が長形式でまとめて表示されます：

​

破壊的変更

リリース v0.8 は以前のバージョンとの破壊的変更を引き起こします。

​

設定の破壊的変更

以下の CPT の「Options」ブロックが再構築されました：

• Schema Configurations
• Custom Endpoints
• Persisted Queries

以前の v0.7 では、これらのエンティティの単一の Options ブロックに多くの設定項目が含まれていました。v0.8 からは、このブロックはそれぞれ独自の設定を持つ複数の独立したブロックに分割されました。

たとえば、v0.7 では（エンドポイントの有効/無効に加えて）Custom Endpoint Options ブロックで GraphiQL および Interactive Schema クライアントを設定できました：

v0.8 からは、この設定は GraphiQL および Interactive Schema ブロックを通じて追加されます：

3つの CPT すべての Options ブロックに保存された設定は、新しい形式に自動的に移行されません。そのため、v0.8 にアップグレードする前に、保存された設定を書き留めておき、新しいバージョンにアップグレードした後で複製してください。

ご不便をおかけして申し訳ありません。

また、3つの CPT のすべてのエントリについて、WordPress エディタに表示される「Reset the template」ボタンをクリックする必要があります。

​

非標準ディレクティブの削除

非標準ディレクティブがプラグインから削除されました：

• @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 のインストールまたは実行に問題がある場合は、リポジトリで issue を作成してください。