nuk-wp-phpcs-config

This library contains WordPress VIP PHPCS configuration for NewsUK plugins and themes.

Architecture

Project Structure

- .circleci          # CircleCI pipeline configuration files
- .github            # GitHub configuration files
- NewsPress          # NewsPress phpcs rulesets
- NewsUK             # NewsUK phpcs rulesets

Technical Documentation

• Package Extensibility

Contribution

More details on how to contribute to this package can be found in the CONTRIBUTING.md file.

Minimal requirements

• PHP 8.2
• WordPress 6.2

Development setup

To build the package

PHP setup

• composer install

Installation

Composer install:

composer require --dev newsuk/nuk-wp-phpcs-config

Usage

Using the ruleset

Create a phpcs.xml.dist file in your project and add the following to use NewsUK ruleset:

<?xml version="1.0"?>
<ruleset name="NewsUK WP PHPCS Rules">
	<rule ref="NewsUK"/>
</ruleset>

💡 It is recommended to use the NewsUK or NewsPress ruleset as it is without customising or overriding rules unless necessary.

Usage with Composer

Add the following to scripts section in composer.json file to run linting.

"lint": "phpcs .",
"lint:fix": "phpcbf .",

Tagging and releasing

The content schema uses Semantic Versioning semver for versioning. The package is released using GitHub Releases. The release process is automated in Circle CI build step. To create a new release, follow these steps:

• Update the relevant files with the new version. Commit the updated files.
• Push the changes to the main branch, by merging the associated pull request
• Create a release targeting the main branch within GitHub.