YeoPress
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:
- Custom directory configuration
- Install WordPress as a Git submodule for easy version controlled updates
- Theme init hook for when you install a new theme
- Permission setting on install
- Create your database, all you have to do is make me a user
- Built in Vagrant configuration
- New Set custom defaults with
.yeopress
files - New Environment based wp-config files,
local-config.php
How To Use
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!!!!
Advanced Usage
By specifying the --advanced
flag you get access to more features:
- Vagrant: Sets up a Vagrant box using Puppet with all the requirements for running a WordPress site.
- WP version: Select a specific WordPress version to install
- Block external requests: Adds the
WP_HTTP_BLOCK_EXTERNAL
setting to config to lock down the admin - Add core files to gitignore: Adds rules to the
.gitignore
file for the WordPress core files
Reusing common settings
You 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:
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.
Installing WordPress Plugins
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.
Visual Learner??
ADD Visual Learner? Watch the shorter video.
And here is the boring write-up...
Themes
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:
- Regarde (grunt-regarde)
- Live Reload (grunt-contrib-livereload)
- Sass (grunt-contrib-sass)
- JSHint (grunt-contrib-jshint)
- Bower (grunt-bower-requirejs)
- RequireJS (grunt-contrib-requirejs)