johnregan3/coding-challenge

Site Counts

A WordPress block showing counts of posts and taxonomies.

To test, add this 'Site Counts' block in the block editor.

Requirements

• WordPress 5.6+.
• PHP 7.3 or later, Composer and Node.js for dependency management.

We suggest using a software package manager for installing the development dependencies such as Homebrew on MacOS:

brew install php composer node

or Chocolatey for Windows:

choco install php composer node nodejs

Development

1. Clone the plugin repository.

2. Set up the development environment and tools using Node.js and Composer:

    npm install
   

   Note that both Node.js and PHP 7.3 or later are required on your computer for running the npm scripts.

Scripts

We use npm as the canonical task runner for the project. Some of the PHP related scripts are defined in composer.json.

• npm run build to build the plugin JavaScript file. Use npm run dev to watch and re-build as you work.

• npm run lint to lint both PHP and JS files. Use npm run lint:js and npm run lint:php to lint JS and PHP separately.

• npm run test to run both PHP and JS tests without coverage reporting. Use npm run test:js and npm run test:php to run tests for JS and PHP seperately.

• npm run test:coverage to run both PHP and JS tests with coverage reporting.

Continuous Integration

We use GitHub Actions to lint all code, run tests and report test coverage to Coveralls as defined in ci.yaml.