Version: 1.7.6

Update Note: Version 1.7 brings lots of new settings. Check out the configuration file documentation.

What/How/Why

WP Distillery does all the work for you when setting up a new WordPress project with Scotch Box. Simply add your preferred theme, plugins, options etc. into config.yml and your good to go. With WPDistillery it won't take you no longer than 5 minutes until you can start working on your new WordPress project. Executing setup.sh then will

• download/install/configure WordPress
• set WordPress options
• install/activate your favorite WordPress theme (default WPSeed).
• install/activate the plugins you defined in the config
• clean WordPress defaults (contents, plugins, themes, unused files)

You're able to adjust wich of the above tasks will be executed. Simply set the desired tasks to true/false in the "Setup Options" section at the bottom of config.yml

Now you can use your config.yml as a template for every new project and save a lot of time clicking, dragging, editing and configuring.

Watch WPDistillery in action or see this Screenshot for a preview of how the setup will look like.

Dependencies

• ssh access to your VM/host
• wp cli 0.23+ on your VM/host

WP Distillery is designed for Scotch Box. Since WPDistillery Version 1.3.1+ you can edit the WordPress root folder so you should be able to run it with any other vagrantbox or webhost.

Setup

To setup a new project running Scotch Box and WordPress simply follow these steps:

1. Run the following command inside your project root to install both Scotch Box & WPDistillery:

git clone https://github.com/scotch-io/scotch-box.git && mv scotch-box/public public && mv scotch-box/Vagrantfile Vagrantfile && rm -rf scotch-box && git clone --depth 1 https://github.com/flurinduerst/WPDistillery.git && mv WPDistillery/config.yml config.yml && mv WPDistillery/setup.sh setup.sh && rm -rf WPDistillery 2. add environment variables and your preferred options into config.yml (see configuration file documentation for additional info on config.yml) 3. vagrant up 4. vagrant ssh 5. update wp cli sudo wp cli update --allow-root see Known Issues 6. execute setup.sh cd ../../var/www && bash setup.sh 7. access your project at http://192.168.33.10/

If you're using Windows, replace step #6 with the following:

sudo apt-get install -y dos2unix
cd ../../var/www
dos2unix config.yml
dos2unix setup.sh
bash setup.sh

Thanks to @rowboat85 and @ShaneShipston for pointing this out.

Known Issues

• Currently Scotch Box comes with WP-CLI 0.20.3 The WP-CLI released compatibility updates for WordPress 4.4 and now requires Version 0.20.4+. Please update wp cli on the VM with sudo wp cli update --allow-root. See issue#158
• When using Wordmove (install it with gem install wordmove on the VM) you have to complete the locale settings by adding them to .bashrc:

echo "export LANGUAGE=en_US.UTF-8">>~/.bashrc
echo "export LC_ALL=en_US.UTF-8 ">>~/.bashrc

then exit and vagrant ssh and you're good to go. (This is a ScotchBox issue but I wanted to clarify this for everyone using Wordmove.)

About

• Author: Flurin Dürst
• Contact: [email protected]
• Twitter: @flurinduerst

Contribution

Feel free to contact me or add issues/pull-requests.

License

WPDistillery is released under an edited version of the MIT License. Please see License.

Like it? Awesome!

If you find this tool useful, consider supporting WP Distillery or buying me a beer respectively a glass of single malt scotch whiskey :)