Release Notes

Chores / Bugfixes

• #2792: fix: uri field is null when querying the page for posts uri

Release Notes

New Features

• #2763: feat: add shouldShowAdminToolbar field to the User type, resolving from the "show_admin_bar_front" meta value. Thanks @blakewilson!

Chores / Bugfixes

• #2758: fix: Allow post types and taxonomies to be registered without "graphql_plural_name".
• #2762: Bump webpack version.
• #2770: fix: wrong order in term/post ancestor queries. Thanks @creative-andrew!
• #2775: fix: properly resolve when querying terms filtered by multiple taxonomies. Thanks @thecodeassassin!
• #2776: chore: remove internal usage of deprecated functions. Thanks @justlevine!
• #2777: chore: update composer dev-deps (not PHPStan). Thanks @justlevine!
• #2778: fix: Update PHPStan and fix smells. Thanks @justlevine!
• #2779: ci: test against WordPress 6.2. Thanks @justlevine!
• #2781: chore: call _doing_it_wrong() when using deprecated PostOjectUnion and TermObjectUnion. Thanks @justlevine!
• #2782: ci: fix deprecation warnings in Github workflows. Thanks @justlevine!
• #2786: fix: early return for HTTP OPTIONS requests.

Release Notes

New Features

• #2745: feat: Allow fields, connections and mutations to optionally be registered with undersores in the field name.
• #2651: feat: Add deregister_graphql_mutation() and graphql_excluded_mutations filter. Thanks @justlevine!
• #2652: feat: Add deregister_graphql_connection and graphql_excluded_connections filter. Thanks @justlevine!
• #2680: feat: Refactor the NodeResolver::resolve_uri to use WP_Query. Thanks @justlevine!
• #2643: feat: Add post_lock check on edit/delete mutation. Thanks @markkelnar!
• #2649: feat: Add pageInfo field to the Connection type.

Chores / Bugfixes

• #2752: fix: handle 404s in NodeResolver.php. Thanks @justlevine!
• #2735: fix: Explicitly check for DEBUG enabled value for tests. Thanks @markkelnar!
• #2659: test: Add tests for nodeByUri. Thanks @justlevine!
• #2724: test: Add test for graphql:Query key in headers. Thanks @markkelnar!
• #2718: fix: deprecation notice. Thanks @decodekult!
• #2705: chore: Use fully qualified classnames in PHPDoc annotations. Thanks @justlevine!
• #2706: chore: update PHPStan and fix newly surfaced sniffs. Thanks @justlevine!
• #2698: chore: bump simple-get from 3.15.1 to 3.16.0. Thanks @dependabot!
• #2701: fix: navigation url. Thanks @jiwon-mun!
• #2704: fix: missing apostrophe after escape. Thanks @i-mann!
• #2709: chore: update http-cache-semantics. Thanks @dependabot!
• #2707: ci: update and fix Lint PR workflow. Thanks @justlevine!
• #2689: fix: prevent infinite recursion for interfaces that implement themselves as an interface.
• #2691: fix: prevent non-node types from being output in the query analyzer lis-type
• #2684: chore: remove deprecated use of WPGraphQL\Data\DataSource::resolve_user(). Thanks @renatonascalves
• #2675: ci: keep the develop branch in sync with master.

Release Notes

Chores / Bugfixes

• #2741: Change the plugin name from "WP GraphQL" to "WPGraphQL". Thanks @josephfusco!
• #2742: Update Stalebot rules. Thanks @justlevine!

Release Notes

Chores / Bugfixes

• #2726: fix: invalid schema when custom post types and custom taxonomies are registered with underscores in the "graphql_single_name" / "graphql_plural_name"

Release Notes

Chores / Bugfixes

• #2712: fix: query analyzer outputting unexpected list types

Release Notes

Chores / Bugfixes

• (#2661): chore(deps): bump simple-git from 3.10.0 to 3.15.1
• (#2665): chore(deps): bump decode-uri-component from 0.2.0 to 0.2.2
• (#2668): test: Multiple domain tests. Thanks @markkelnar!
• (#2669): ci: Use last working version of xdebug for php7. Thanks @markkelnar!
• (#2671): fix: correct regressions to field formatting forcing snake_cace and UcFirst fields to be lcfirst/camelCase
• (#2672): chore: update lint-pr workflow

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.6...v1.13.7

Release Notes

New Features

• (#2657): feat: pass unfiltered args through to filters in the ConnectionResolver classes. Thanks @kidunot89!
• (#2655): feat: add includeDefaultInterfaces to connection config, allowing connections to be registered without the default Connection and Edge interfaces applied.. Thanks @justlevine!

Chores / Bugfixes

• (#2656): chore: clean up NodeResolver::resolve_uri() logic. Thanks @justlevine!

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.5...v1.13.6

Release Notes

Chores / Bugfixes

• (#2645) fix: regression where fields on an object type are forced to be camelCase (snake_case) should still be allowed by @jasonbahl in
• (#2647) fix: properly register node field on $toType . ConnectionEdge interfaces by @jasonbahl

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.4...v1.13.5

Release Notes

Chores / Bugfixes

• (#2631): simplify (DRY up) connection interface registration.
• (#2627): fix: removed connection classes as deprecated wrappers (regression). Thanks @justlevine!

NOTE: (#2627) was supposed to have been released in 1.13.2, and is listed in the changelog for that version, but I botched that release and only released the changelog without the actual changes 🤦🏻‍♂️

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.3...v1.13.4

Release Notes

Chore:

update versions for WordPress.org deploys

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.2...v1.13.3

Release Notes

Chores / Bugfixes

• (#2625): fix: Fixes a regression of v1.13.0 where mutations registered with an uppercase first letter weren't properly being transformed to a lowercase first letter when the field is added to the Schema.

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.13.0...v1.13.1

Release Notes

Possible Breaking Change for some users

The work to introduce the Connection and Edge (and other) Interfaces required the User.revisions and RootQuery.revisions connection to
change from resolving to the ContentRevisionUnion type and instead resolve to the ContentNode type.

We believe that it's highly likely that most users will not be impacted by this change.

Any queries that directly reference the following types:

• ...on UserToContentRevisionUnionConnection
• ...on RootQueryToContentRevisionUnionConnection

Would need to be updated to reference these types instead:

• ...on UserToRevisionsConnection
• ...on RootQueryToRevisionsConnection

For example:

BEFORE

{
  viewer {
    revisions {
      ... on UserToContentRevisionUnionConnection {
        nodes {
          __typename
          ... on Post {
            id
            uri
            isRevision
          }
          ... on Page {
            id
            uri
            isRevision
          }
        }
      }
    }
  }
  revisions {
    ... on RootQueryToContentRevisionUnionConnection {
      nodes {
        __typename
        ... on Post {
          id
          uri
          isRevision
        }
        ... on Page {
          id
          uri
          isRevision
        }
      }
    }
  }
}

AFTER

{
  viewer {
    revisions {
      ... on UserToRevisionsConnection {
        nodes {
          __typename
          ... on Post {
            id
            uri
            isRevision
          }
          ... on Page {
            id
            uri
            isRevision
          }
        }
      }
    }
  }
  revisions {
    ... on RootQueryToRevisionsConnection {
      nodes {
        __typename
        ... on Post {
          id
          uri
          isRevision
        }
        ... on Page {
          id
          uri
          isRevision
        }
      }
    }
  }
}

New Features

• (#2617: feat: Introduce Connection, Edge and other common Interfaces.
• (#2563: feat: refactor mutation registration to use new WPMutationType. Thanks @justlevine!
• (#2557: feat: add deregister_graphql_type() access function and corresponding graphql_excluded_types filter. Thanks @justlevine!
• (#2546: feat: Add new register_graphql_edge_fields() and register_graphql_connection_where_args() access functions. Thanks @justlevine!

Chores / Bugfixes

• (#2622: fix: deprecate the previews field for non-publicly queryable post types, and limit the Previewable Interface to publicly queryable post types.
• (#2614: chore(deps): bump loader-utils from 2.0.3 to 2.0.4.
• (#2540: fix: deprecate Comment.approved field in favor of Comment.status: CommentStatusEnum. Thanks @justlevine!
• (#2542: Move parse_request logic in NodeResolver::resolve_uri() to its own method. Thanks @justlevine!

Full Changelog

https://github.com/wp-graphql/wp-graphql/compare/v1.12.3...v1.13.0

Release Notes

Chores / Bugfixes

• chore: update github workflow that deploys docker images so that extending plugins can use latest versions of WordPress + PHP + WPGraphQL in their tests

Release Notes

New Features:

• (#2541): feat: Obfuscate SendPasswordResetEmail response. Thanks @justlevine!

Chores / Bugfixes

• (#2544): chore: log and cleanup deprecations. Thanks @justlevine!
• (#2605): chore: bump tested version of WordPress to 6.1. Thanks @justlevine!
• (#2606): fix: update resolver in post->author connection to be more strict about the value of the author ID
• (#2609): chore(deps): bump loader-utils from 2.0.2 to 2.0.3

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.12.1...v1.12.2

What's Changed

• chore: Prepare docs for new site by @moonmeister in https://github.com/wp-graphql/wp-graphql/pull/2583
• Docs/new site by @moonmeister in https://github.com/wp-graphql/wp-graphql/pull/2591
• fix: Add list of node types as X-GraphQL-Keys instead of list of edge types by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2590
• feat: use sha256 instead of md5 for hashing the queryId by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2593
• docs: fix contributing doc render errors by @moonmeister in https://github.com/wp-graphql/wp-graphql/pull/2600
• fix: Only use Appsero add_plugin_data if the Appsero Client is v1.2.1 or higher by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2599
• feat: support deprecation reason on connections by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2581
• fix(noderesolver): adding extra_query_vars in graphql_pre_resolve_uri… by @yanmorinokamca in https://github.com/wp-graphql/wp-graphql/pull/2582
• feat: Add operation name to X-GraphQL-Keys by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2603
• release: v1.12.1 by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2604

New Contributors

• @yanmorinokamca made their first contribution in https://github.com/wp-graphql/wp-graphql/pull/2582

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.12.0...v1.12.1

Release Notes

Upgrading

This release removes the ContentNode and DatabaseIdentifier interfaces from the NodeWithFeaturedImage Interface.

This is considered a breaking change for client applications using a ...on NodeWithFeaturedImage fragment that reference fields applied by those interfaces. If you have client applications doing this (or are unsure if you do) you can use the following filter to bring back the previous behavior:

add_filter( 'graphql_wp_interface_type_config', function( $config ) {
	if ( $config['name'] === 'NodeWithFeaturedImage' ) {
		$config['interfaces'][] = 'ContentNode';
		$config['interfaces'][] = 'DatabaseIdentifier';
	}
	return $config;
}, 10, 1 );

New Schema Customization APIs

WPGraphQL simplifies adding Custom Post Types and Taxonomies to the WPGraphQL Schema.

In this release, there are new options that allow for greater customization into how Post Types and Taxonomies interact with the WPGraphQL Schema.

We've written 2 blog posts about this:

• Overview of the new Schema Customization APIs
• Tutorial: Registering a Custom Post Type as a GraphQL Interface

What's Changed

• feat: add X-GraphQL-URL to headers of GraphQL Responses by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2565
• feat: schema customization with post type args by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2399
• docs: Correct typo by @altearius in https://github.com/wp-graphql/wp-graphql/pull/2568
• chore: update Appsero SDK to 1.2.1 by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2569
• chore(deps): bump got and @wordpress/env by @dependabot in https://github.com/wp-graphql/wp-graphql/pull/2571
• fix: GraphiQL Query Composer update to FieldView for union type by @chrisherold in https://github.com/wp-graphql/wp-graphql/pull/2572
• chore: use ENV variables for installing WordPress test environment by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2556
• chore: update phpstan and fix surfaced issues by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2538
• chore: add WPBrowser v3.1.x compatibility by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2545
• fix: (phpstan) check if wp_parse_url() returns array by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2573
• chore: cleanup and update version tags by @justlevine in https://github.com/wp-graphql/wp-graphql/pull/2574
• release: v1.12.0 by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2566

New Contributors

• @altearius made their first contribution in https://github.com/wp-graphql/wp-graphql/pull/2568
• @chrisherold made their first contribution in https://github.com/wp-graphql/wp-graphql/pull/2572

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.11.3...v1.12.0

Release Notes

Chores / Bugfixes

• (#2555): Further changes to X-GraphQL-Keys header output. Truncate keys based on a filterable max length. Output the skipped keys in extensions payload for debugging, and add skipped:$type keys to the X-GraphQL-Keys header for nodes that are skipped.

Release Notes

Chores / Bugfixes

• (#2551): Chunks X-GraphQL-Keys header into multiple headers under a set max header limit length.
• (#2539): Set IDE direction to prevent breaks in RTL mode. Thanks @justlevine!
• (#2549): Fix bug_report.yml field to be textarea instead of input. Thanks @justlevine!

What's Changed

• fix: regression to menuItem queries when parentId is 0 by @jasonbahl in https://github.com/wp-graphql/wp-graphql/pull/2532

Full Changelog: https://github.com/wp-graphql/wp-graphql/compare/v1.11.0...v1.11.1