Skip to content
/ wpcs Public

📃 Check WordPress Coding Standards in Node.js

License

Notifications You must be signed in to change notification settings

oknoorap/wpcs

Repository files navigation

📃 wpcs

Check WordPress Coding Standards quickly with Node.js without installing any PHP dependencies.

💻 Install

Using NPM

$ npm install wpcs --save

Using Yarn

$ yarn add wpcs

If you want to use CLI version, please install it globally.

# NPM
$ npm install wpcs -g

# Yarn
$ yarn global add wpcs

🐘 PHP Scripts

This module depends on these scripts below, using git subtree method under scripts directory.

📚 Usage Example as Module

const WPCS = require('wpcs')

const wpcs = new WPCS(path, rule)

wpcs.on('start', () => {
  // Your script here
})

wpcs.on('scan', filename => {
  // Filename
})

wpcs.on('error', (filename, info) => {
  // Filename, {line: Number, column: Number, message: Number}
})

wpcs.on('warning', (filename, info) => {
  // Filename, {line: Number, column: Number, message: Number}
})

wpcs.on('done', totals => {
  // {errors: Number, warnings: Numbers, files: Numbers}
})

// Get error process
wpcs.process.on('error', err => {
  console.log(err)
})

⚡ CLI

https://gyazo.com/e655bf900ae1693d6d98bcbb1d447d5c

wpcs - Check WordPress Coding Standard

  USAGE
    wpcs [path]

  ARGUMENTS
    [path]    Script path could be a directory or filename. optional

  OPTIONS
    --rule <rulename>   Default rule is WordPress-Extra + WordPress-Docs. WordPress | WordPress-Core | WordPress-Docs | WordPress-Extra | WordPress-VIP. optional
    --autofix           Auto fix errors. optional
    --skip-warning      Skip Warning. optional
    --excludes          Excludes Path. optional

License

MIT © oknoorap