The officially un-official Yeoman Generator for WordPress. I magically take you from scratching your head wondering where to start, all the way to running the famous 5-minute install. I have configuration options that will WOW you. If you use Git, I can git you off the ground with WordPress as a submodule just by following a couple of prompts. Have a custom base theme you always start your projects off with? You can install that too, either straight from GitHub or by pointing me to a tarball. Other things I do:
.yeopress
fileslocal-config.php
If you do not already have the Yeoman toolset installed do so now, and might as well install me at the same time (NOTE: don't type the $
):
$ npm install -g yo generator-wordpress
While running if you get errors try running as super user:
$ sudo npm install -g yo generator-wordpress
And run me:
$ yo wordpress
Follow my prompts and WA-BAM....ASCII art!!!!
By specifying the --advanced
flag you get access to more features:
WP_HTTP_BLOCK_EXTERNAL
setting to config to lock down the admin.gitignore
file for the WordPress core filesYou probably want to be able to quickly zip through your install with similar settings for every project. For example, you probably always want to use git but the default is no git. You can define any custom defaults you want in ~/.yeopress
. This file is just a json file with key-value pairs for the config settings you want. Here is an example:
{
"git": true,
"dbHost": "localhost",
"dbName": "yeopress",
"dbUser": "yeopress",
"dbPass": "yeopress"
}
For a full example, open up the local .yeopress
file that is created by the generator. This file is located in the directory you ran yo wordpress
in.
New with v1.4.0
is a subgenerator for installing plugins, yo wordpress:plugin
. You can supply a comma delimited list of plugin slugs to download. YeoPress will download and unzip those plugins into your content directory.
ADD Visual Learner? Watch the shorter video.
And here is the boring write-up...
Custom themes can be installed from GitHub or a Tarball. Once installed, they are responsible for their own Gruntfile and related tasks. A basic example template can be found in the template branch of this repo. The example template comes with a few grunt tasks pre-configured: