Skip to content

PHP_CodeSniffer rules (sniffs) to enforce BuddyPress minimum coding conventions.

Notifications You must be signed in to change notification settings

buddypress/bp-coding-standards

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BuddyPress Coding Standards

PHP_CodeSniffer rules (sniffs) to enforce BuddyPress minimum coding conventions.

Minimal requirements

Installation

To use this standard in a project, declare it as a dependency.

composer require buddypress/bp-coding-standards

This will install the latest compatible version of PHPCS and WPCS to your vendor directory in order to run sniffs locally.

You can also manually add this to your project's composer.json file as part of the require property:

"require": {
    "buddypress/bp-coding-standards": "^0.2.0"
}

Using PHPCS

To use this standard with phpcs directly from your command line, use the command:

vendor/bin/phpcs --standard=BuddyPress .

Alternatively, you can set this as a composer script, which will automatically reference the correct version of phpcs and the dependent standards.

"scripts": {
    "phpcs" : "phpcs --standard=BuddyPress ."
}

Then use the following command:

composer run phpcs

You can also pass arguments to the composer phpcs script, following a -- operator like this:

composer run phpcs -- --report=summary

Extending the ruleset

You can create a custom ruleset for your project that extends or customizes these rules by creating your own phpcs.xml or phpcs.xml.dist file in your project, which references these rules, like this:

<?xml version="1.0"?>
<ruleset>
    <description>Example project ruleset</description>

    <!-- Include BuddyPress Rules -->
    <rule ref="BuddyPress" />

    <!-- Project customizations go here -->

</ruleset>

Change Log

Change log under CHANGELOG.md.