pantheon-systems/pantheon-wp-coding-standards

PHPCS Rulesets for WordPress projects on Pantheon.

2.0.1 2023-12-12 16:18 UTC

Requires

• automattic/vipwpcs: ^3.0
• fig-r/psr2r-sniffer: ^1.5
• phpcompatibility/phpcompatibility-wp: ^2.1
• wp-coding-standards/wpcs: ^3.0

Requires (Dev)

• phpunit/phpunit: 9.6.x-dev
• yoast/phpunit-polyfills: 1.x-dev

MIT

• Pantheon

README

PHPCS rulesets for WordPress projects on Pantheon.

Setup

The PHPCS ruleset can be installed via Composer:

composer require --dev pantheon-systems/pantheon-wp-coding-standards

Usage

Run the following command to run the standards checks:

vendor/bin/phpcs -s --standard=Pantheon-WP .

We recommend using the -s flag so that PHPCS will report the specific rule that was violated. This makes it easier to add exclusions or research possible solutions.

If you have a tests directory that you want to exclude from the sniffs, you can do so by adding the --ignore flag:

vendor/bin/phpcs -s --ignore=tests/* --standard=Pantheon-WP .

Extending

If you want to customize the defaults or add additional rules, you can create your own standard file (e.g. phpcs.ruleset.xml):

<?xml version="1.0"?>
<ruleset>
	<!-- Files or directories to check -->
	<file>.</file>

	<!-- Include the Pantheon-WP ruleset -->
	<rule ref="Pantheon-WP" />

	<!-- Add additional rules here -->
	<rule ref="WordPress.WP.I18n">
		<properties>
			<property name="text_domain" value="my-plugin" />
		</properties>
</ruleset>

You can then reference this file when running PHPCS:

vendor/bin/phpcs -s --standard=phpcs.ruleset.xml .

Included Checks

The Pantheon WP standard is based upon WordPress Coding Standards, VIP Coding Standards with some customizations based on Human Made's Coding Standards.