GaryJones / custom-site-template

For when you just need a simple dev site

VVV Custom site template

For when you just need a simple dev site

Overview

This template will allow you to create a WordPress dev environment using only vvv-config.yml.

The supported environments are:

• A single site
• A subdomain multisite
• A subdirectory multisite

Configuration

The minimum required configuration:

my-site:
  repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
  hosts:
    - my-site.dev

Setting	Value
Domain	my-site.dev
Site Title	my-site.dev
DB Name	my-site
Site Type	Single
WP Version	Latest

Minimal configuration with custom domain and WordPress Nightly:

my-site:
  repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
  hosts:
    - foo.dev
  custom:
    wp_version: nightly

Setting	Value
Domain	foo.dev
Site Title	foo.dev
DB Name	my-site
Site Type	Single
WP Version	Nightly

WordPress Multisite with Subdomains:

my-site:
  repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
  hosts:
    - multisite.dev
    - site1.multisite.dev
    - site2.multisite.dev
  custom:
    wp_type: subdomain

Setting	Value
Domain	multisite.dev
Site Title	multisite.dev
DB Name	my-site
Site Type	Subdomain Multisite
WP Version	Nightly

Configuration Options

hosts:
    - foo.dev
    - bar.dev
    - baz.dev

Defines the domains and hosts for VVV to listen on. The first domain in this list is your sites primary domain.

custom:
    site_title: My Awesome Dev Site

Defines the site title to be set upon installing WordPress.

custom:
    wp_version: 4.6.4

Defines the WordPress version you wish to install. Valid values are:

• nightly
• latest
• a version number

Older versions of WordPress will not run on PHP7, see this page on how to change PHP version per site. // TODO: Add link.

custom:
    wp_type: single

Defines the type of install you are creating. Valid values are:

• single
• subdomain
• subdirectory

custom:
    db_name: super_secet_db_name

Defines the DB name for the installation.