DEPRECATED: Please use https://github.com/10up/generator-wp-make instead.
Deprecated: Please use generator-wp-make instead.
Create a WordPress plugin with grunt-init.
If you haven't already done so, install grunt-init.
Once grunt-init is installed, place this template in your
~/.grunt-init/directory. It's recommended that you use git to clone this template into that directory, as follows:
git clone https://github.com/10up/grunt-wp-plugin ~/.grunt-init/wp-plugin
git clone https://github.com/10up/grunt-wp-plugin %USERPROFILE%/.grunt-init/wp-plugin
At the command-line, cd into an empty directory, run this command and follow the prompts.
Note that this template will generate files in the current directory, so be sure to change to a new directory first if you don't want to overwrite existing files.
Install the NPM modules required to actually process your newly-created project by running:
After running the init command above, you will be presented with a standard directory structure similar to:
/plugin .. /assets .. .. /css .. .. .. /src .. .. .. /sass .. .. .. /less .. .. /js .. .. .. /src .. /images .. .. /src .. /includes .. /languages .. .. plugin.pot .. .gitignore .. Gruntfile.js .. plugin.php .. readme.php
Depending on how you answer the prompt regarding the use of a preprocessor, you will either have a
/srcdirectory (CSS), a
/sassdirectory (Sass), or a
/lessdirectory (LESS) under your normal
/cssdirectory. The goal here is that you only ever edit files in the related source directory and Grunt will automatically build and minify your final stylesheets directly in
If you're using Sass or Less, the raw files will be processed into
/css/filename.cssand minified into
If you're using vanilla CSS, the source files will be minified into
You should only ever be modifying script files in the
/js/srcdirectory. Grunt will automatically concatenate and minify your scripts into
/js/filename.min.js. These generated files should never be modified directly.
/images/srcdirectory exists only to allow you to keep track of source files (like PSDs or separate images that have been merged into sprites). This helps keep source files under version control, and allows you to bundle them with the distribution of your new GPL plugin.