generator-plugin-wp

Yeoman WordPress Plugin Generator

2 years after

generator-plugin-wp Build Status

Yeoman generator for WordPress plugins.

Getting Started

Pre-requisites: You'll need node which comes with npm.

If you don't have Yeoman installed:

npm install -g yo

To install generator-plugin-wp from npm, run:

npm install -g generator-plugin-wp

To use generator-plugin-wp, cd to your WordPress plugins folder and:

yo plugin-wp

You'll be prompted with steps for creating your plugin.

Sub-generators

Once your nifty new plugin has been generated, cd into your new plugin's directory. While in the plugin directory, you can run additional commands called sub-generators to automatically generate files to enhance your plugin.

For the names of the include, cpt, options, and widget subgenerators remember that the plugin prefix will be added to the class name so no need to include the original plugin name there. Think of it as the file name for each instead.

Tests

By default the plugin generator adds some built in tests for you to add on to as you develop your plugin. To run these tests run the install-wp-tests.sh script in the bin folder with the proper database details for your local setup.

Once you've run the install-wp-tests.sh script you can run just phpunit in the main folder of your plugin.

If you don't want tests included in your plugin when it is generated run the main generator with the --notests option.

PHP 5.2

By default PHP 5.2 is not supported in the generated plugin. To generate a plugin with PHP 5.2 support, run the main generator with the --php52 option.

Adding Packages with Composer

If you chose composer as the autoloader option during the plugin's initiation, you can use composer to add additional dependencies.

Let's cd into our new plugin's directory and add CMB2:

composer require webdevstudios/cmb2

CMB2 will now appear under vendor

-plugins
  -wds-foo-plugin
    -vendor
      -webdevstudios
        -cmb2

Contributors

The following humans contributed to this awesome generator:

CamdenSegal, jtsternberg, jazzsequence, binarygary, bradp, JeffreyNaval, gregrickaby, DevNIX, JPry, RC Lations, tnorthcutt, aubreypwd

Related Repositories

grunt-wp-plugin

grunt-wp-plugin

WordPress Plugin Project Templates ...

generator-wp-make

generator-wp-make

A Yeoman generator for making WordPress things ...

WordPress-Plugin-Boilerplate-Powered

WordPress-Plugin-Boilerplate-Powered

Wordpress Plugin Boilerplate with steroids! ...

Wordpress-Sidebar-Generator

Wordpress-Sidebar-Generator

Generate unlimited sidebars in Wordpress ...

generator-chisel

generator-chisel

Chisel is a Yeoman generator for scaffolding front-end and WordPress projects ...