A simple yeoman generator for Wordpress projects.
npm install -g yo npm install -g generator-wordpress-starter
To generate a new project just type the string below, the generator will create the folder for you if not exists:
It will be made a bit of questions then you will have your project ready to go.
You can also generate plugins, by typing:
Generate a custom theme
The project allow you to generate custom WordPress themes from templates located in
- Create a
.wordpress-starterdirectory and place it inside your home folder.
- Place your themes inside that folder and follow some simple rules.
- When your template is ready you can use it with
You must create the folder if doesn't exist and place your themes inside like in this example:
tree ~/.wordpress-starter/ ├───Simple └───Advanced
Every theme folder must follow simple rules in order to been generated correctly.
tree ~/.wordpress-starter/Simple └───theme
In this example the Simple theme has only the theme directory where you should put all the theme files like in the default theme that comes with the generator.
Optionally you can also generate more complex projects, that uses build systems, for now the generator will support only gulp and grunt, if you are not familiar with them, be sure to check out the Getting Started guides. In order to archive this result you must follow this structure:
tree ~/.wordpress-starter/Simple ├───grunt ├───gulp └───theme
You can take a look at the example which is the default theme generated if you don't specify a custom one.
As you can see in the default template, you can access the prompt variables inside the template during render process.
This are all the variables available right now:
- projectName: The project name as slug
- projectTitle: The full project title as it appears on WordPress repositories
- projectDescription: A short project description
- projectManager: The build system used for the project (grunt, gulp)
- projectVersion: The version when the project has started
- projectAuthor: The project author name
Simply use it like this:
<%= projectName %> inside your files to have it rendered with the value.
Inside the theme folder you will always put all the themes related files (scripts, templates, assets, ...) while in the gulp/grunt folder you should put only the files that are related with your project build system configuration.
In the grunt/gulp folder, you must place only two files:
Gruntfile.js, any other file will be ignored.
package.json file will be rendered with EJS interpolation, while the other file will be simply copied since it uses itself ESJ during it's job.
To develop this package you must clone it with Git and than link it to your global npm modules by typing:
Than you can start editing the package by following the contribuing guidelines below and than testing with:
yo wordpress-starter, if you have any troubles please follow this guide, "Running the generator".
- Create an issue and describe your idea
- Fork the project (https://github.com/codekraft-studio/generator-wordpress-starter/fork)
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Publish the branch (
git push origin my-new-feature)
- Add some test for your new feature
- Create a new Pull Request
Getting To Know Yeoman
- Yeoman has a heart of gold.
- Yeoman is a person with feelings and opinions, but is very easy to work with.
- Yeoman can be too opinionated at times but is easily convinced not to be.
- Feel free to learn more about Yeoman.
Apache-2.0 © codekraft-studio