v2.0.0 - 2025-02-15

This release marks the first stable release of the WPGraphQL Coding Standards. 🎉🎉

It updates the WPGraphQL-Core ruleset to match the latest changes included in WPGraphQL v2.0.0.

Note

While this v2.0 release coincides with WPGraphQL v2.0, it's more of a reflection of the stability of the rulesets that these were the only changes needed to WPGraphQL or these rulesets since April 2024.

Future releases will continue to use SemVer, and not necessarily align with WPGraphQL's core version.

What's changed

WPGraphQL-Core

• Added WordPress.NamingConventions.ValidFunctionName.MethodNameInvalid.
• Added SlevomatCodingStandard.TypeHints.NullableTypeForNullDefaultValue.NullabilityTypeMissing.

Full Changelog: 2.0.0-beta.3...2.0.0

2.0.0-beta.3

This release explicitly adds Squiz.WhiteSpace.SuperfluousWhitespace to the WPGraphQL-Extra ruleset, as it is silenced by VIPCS.

What's Changed

WPGraphQL-Extra

• Added Squiz.WhiteSpace.SuperfluousWhitespace and made explicit.

Full Changelog: 2.0.0-beta.2...2.0.0-beta.3

2.0.0-beta.2

This release updates the ruleset based on the latest changes to WPGraphQL core (v1.18.0). Specifically:

WPGraphQL-Minimum

• Added PHPCompatibility.Keywords.ForbiddenNamesAsDeclared.objectFound.
• Moved SlevomatCodingStandard.Classes.RequireSelfReference from WPGraphQL-Strict.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHint.LessSpecificNativeTypeHint from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.Variables.UselessVariable from WPGraphQL-Extra.

WPGraphQL-Strict

• Moved SlevomatCodingStandard.Namespaces.AlphabeticallySortedUses from WPGraphQL-Extra.
• Added SlevomatCodingStandard.TypeHints.NullableTypeForNullDefaultValue.
• Added SlevomatCodingStandard.TypeHints.NullTypeHintOnLastPosition.
• Moved SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingAnyTypeHint from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.PropertyTypeHint.MissingAnyTypeHint from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingAnyTypeHint from WPGraphQL-Extra and made explicit.

WPGraphQL-Docs

• AddedSquiz.Commenting subset of WordPress-Docs.
• Added SlevomatCodingStandard.TypeHints.LongTypeHints.
• Moved SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingTraversableTypeHintSpecification from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ParameterTypeHint.UselessAnnotation from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ParameterTypeHint.UselessSuppress from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ParameterTypeHintSpacing from WPGraphQL-Extra.
• Moved SlevomatCodingStandard.TypeHints.PropertyTypeHint.MissingTraversableTypeHintSpecification from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.PropertyTypeHint.UselessSuppress from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHint.UselessAnnotation from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHint.UselessSuppress from WPGraphQL-Extra and made explicit.
• Moved SlevomatCodingStandard.TypeHints.ReturnTypeHintSpacing from WPGraphQL-Extra.

WPGraphQL-Core

• Added WPGraphQL-Docs with some exceptions.

Full Changelog: 2.0.0-beta.1...2.0.0-beta.2

2.0.0-beta.1

This release requires WPCS 3.0.0 or higher. Please read the WordPressCS 3.0 upgrade guide for instructions on how to update your local rulesets and code annotations.

What's Changed

• feat!: Bumped minimum WPCS and VIPCS versions to 3.0.0.
• fix!: Remove unused WordPress.CodeAnalysis.AssignmentInCondition.Found exclusion from WPGraphQL-Minimum.
• feat!: Add Generic.CodeAnalysis.UnusedFunctionParameter and WordPress.WP.Capabilities.Undetermined sniffs to WPGraphQL-Strict. These sniffs are excluded from the WPGraphQL-Core standard.

Full Changelog: 1.0.0-beta.4...2.0.0-beta.1

1.0.0-beta.3 - 2023-08-04

What's Changed

• feat!: Move WordPress.WP.I18n.MissingTranslatorsComment from WPGraphQL-Strict to WPGraphQL-Minimum. (Added to WPGraphQL in wp-graphql/wp-graphql#2856)
• feat!: Move SlevomatCodingStandard.Functions.StaticClosure from WPGraphQL-Strict to WPGraphQL-Minimum. (Added to WPGraphQL in wp-graphql/wp-graphql#2855)
• chore: Update slevomat/coding-standard to 8.13.4.
• chore: Update Composer dev-deps.

Full Changelog: 1.0.0-beta.2...1.0.0-beta.3

1.0.0-beta.2 - 2023-06-17

What's changed

• dev: Remove Squiz.Commenting.FunctionComment.ParamCommentFullStop and Squiz.Commenting.FunctionComment.EmptyThrows from WPGraphQL-Strict.
• dev: Update minimum PHPUnit version to 8.5.0.
• chore: Update phpcs.xml.dist.example to set the schema location cache and severity values, and add additional inline-comments.

1.0.0-beta.1 - 2023-06-05

Initial beta release.

The WPGraphQL-Minimum ruleset should be considered production-ready.

The other rulesets have been tested extensively against AxePress' suite of WPGraphQL extensions and tools, and will be audited against WPGraphQL core during the beta period.