PHP_CodeSniffer rules (sniffs) to verify theme compliance with the rules for theme hosting on wordpress.org
- Using the WPThemeReview standard
WordPress Themes for which a hosting application has been made for the theme to be hosted in the theme repository on wordpress.org have to comply with a set of requirements before such an application can be approved. Additionally, there are also recommendations for best practices for themes.
This project attempts to automate the code analysis part of the Theme Review Process as much as possible using static code analysis.
PHP_CodeSniffer is the base tool upon which this project is build and is a PHP command-line tool.
This project is a work in progress and passing the checks is no guarantee that your theme will be approved.
The WPThemeReview Standard requires:
- PHP 5.4 or higher.
- PHP_CodeSniffer version 3.3.1 or higher.
- WordPress Coding Standards version 2.1.0 or higher.
- PHPCompatibilityWP version 2.0.0 or higher.
The only supported installation method is via Composer.
- Make sure you have PHP installed on your system.
- If not installed yet, install Composer.
If you would like to have the WPThemeReview standard available to all projects on your system, you can install it in a central location.
From the command-line, run the following command:
$ php composer.phar global require wptrt/wpthemereview dealerdirect/phpcodesniffer-composer-installer
If you use Composer to manage dependencies from your project anyway or are considering using it, you can also choose to install the WPThemeReview standard for an individual project.
From the command-line, run the following command from the root directory of your project:
$ php composer.phar require --dev wptrt/wpthemereview:* dealerdirect/phpcodesniffer-composer-installer:^0.5.0
--devmeans that WPThemeReview will be installed as a development requirement, not as a requirement for using the Theme.
- The second package -
dealerdirect/phpcodesniffer-composer-installer-, is a Composer plugin which will automatically sort out that PHP_CodeSniffer recognizes the WPThemeReview standard and the various WordPress standards.
# For a global install: $ phpcs -i # For a project install: $ vendor/bin/phpcs -i
If everything went well, the output should look something like this:
The installed coding standards are MySource, PEAR, PSR1, PSR12, PSR2, Squiz, Zend, PHPCompatibility, PHPCompatibilityParagonieRandomCompat, PHPCompatibilityParagonieSodiumCompat, PHPCompatibilityWP, WordPress, WordPress-Core, WordPress-Docs, WordPress-Extra and WPThemeReview
You can now test your theme code against the WPThemeReview standard by running the following command from the root directory of your theme:
# For a global install: $ phpcs -p . --standard=WPThemeReview # For a project install: $ vendor/bin/phpcs -p . --standard=WPThemeReview
If any issues are found, PHP_CodeSniffer will display a report with all the errors (must fix) and warnings (recommended to fix) for each file.
More information about running PHP_CodeSniffer can be found in the PHP_CodeSniffer Wiki.
See LICENSE (MIT).