Skip to content
This repository has been archived by the owner on Nov 9, 2023. It is now read-only.
/ wp-php-standards Public archive

PHP Code Sniffer Standards for Bluehost WordPress projects. Replaced with Newfold equivalent.

Notifications You must be signed in to change notification settings

bluehost/wp-php-standards

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WordPress PHP Standards

PHP Code Sniffer Standards for Bluehost WordPress projects.

Installation

Add this Satis repository to your composer.json file:

"repositories": [
    {
      "type": "composer",
      "url": "https://bluehost.github.io/satis/"
    }
  ],

Run composer require bluehost/wp-php-standards from your project root.

Usage

Run vendor/bin/phpcs . --standard=Bluehost from your project root to check your code.

Optionally, add a script to your composer.json file so you can just run composer run lint to check your code.

    "scripts": {
        "lint": [
          "vendor/bin/phpcs . --standard=Bluehost"
        ],
	"clean": [
            "vendor/bin/phpcbf . --standard=Bluehost"
        ]
    }

Additional Notes

  • Append the -s flag to see the internal names of the rules.
  • Add --runtime-set testVersion 5.2- to check PHP version 5.2 or greater.
  • Add a custom phpcs.xml file to your project to customize the ruleset or your desired configuration.
<?xml version="1.0"?>
<ruleset name="Project Rules">
  <rule ref="Bluehost" />
  <config name="testVersion" value="5.2-"/>
  <config name="minimum_supported_wp_version" value="4.7"/>
</ruleset>

Additional Documentation

IDE Integration

Some IDE integrations of PHPCS will fail to register your ruleset since it doesn't live in your project root. In order to rectify this, place phpcs.xml at your project root:

<?xml version="1.0"?>
<ruleset name="Project Rules">
	<rule ref="Bluehost" />
</ruleset>

PHPStorm Setup

  1. Open up the preferences panel.
  2. Go to "Languages & Frameworks" > "PHP" > "Code Sniffer".
  3. Ensure the "Configuration" section has "Local" set in the dropdown. Click the "..." button.
  4. Set the "PHP Code Sniffer path" to be "{projectRoot}/vendor/bin/phpcs" where "{projectRoot}" is the actual path of your project root.
  5. Hit "OK".
  6. Go to "Editor" > "Inspections" in the preference panel.
  7. Click on "PHP Code Sniffer validation" under the "PHP" > "Quality tools" section.
  8. Hit the refresh button next to the "Coding Standard" field on the right.
  9. Select "Bluehost" from the dropdown.
  10. Hit "OK" to exit the preferences panel.