automattic/vipwpcs

PHP_CodeSniffer rules (sniffs) to enforce WordPress VIP minimum coding conventions

Installs: 494 917

Dependents: 47

Suggesters: 0

Security: 0

Stars: 119

Watchers: 12

Forks: 20

Open Issues: 101

Type:phpcodesniffer-standard

2.2.0 2020-09-07 10:45 UTC

README

This project contains PHP_CodeSniffer (PHPCS) sniffs and rulesets to validate code developed for WordPress VIP.

This project contains two rulesets:

  • WordPressVIPMinimum - for use with projects on the (older) WordPress.com VIP platform.
  • WordPress-VIP-Go - for use with projects on the (newer) VIP Go platform.

These rulesets contain only the rules which are considered to be "errors" and "warnings" according to the WordPress VIP Go documentation

The rulesets use rules from the WordPress Coding Standards (WPCS) project, as well as the VariableAnalysis standard.

Go to https://wpvip.com/documentation/phpcs-review-feedback/ to learn about why violations are flagged as errors vs warnings and what the levels mean.

Minimal requirements

Installation

composer require automattic/vipwpcs, or composer g require automattic/vipwpcs if installing globally.

This will install the latest compatible versions of PHPCS, WPCS and VariableAnalysis and register the external standards with PHP_CodeSniffer.

Please refer to the installation instructions for installing PHP_CodeSniffer for WordPress.com VIP for more details.

As of VIPCS version 2.3.0, there is no need to require the PHP_CodeSniffer Standards Composer Installer Plugin anymore as it is now a requirement of VIPCS itself.

Contribution

Please see CONTRIBUTION.md.

License

Licensed under GPL-2.0-or-later.