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-custom.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.test

Setting	Value
Domain	my-site.test
Site Title	my-site.test
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.test
  custom:
    wp_version: nightly

Setting	Value
Domain	foo.test
Site Title	foo.test
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.test
    - site1.multisite.test
    - site2.multisite.test
  custom:
    wp_type: subdomain

Setting	Value
Domain	multisite.test
Site Title	multisite.test
DB Name	my-site
Site Type	Subdomain Multisite

Configuration Options

hosts:
    - foo.test
    - bar.test
    - baz.test

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.

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.

custom:
    repo_content: the repo of your WP site.

Defines where to find the WP site code to clone through SSH.

custom:
    repo-key: the name of your private key.

Defines the name of your private key to connect to the WP site repo pointed in "repo_content" variable. You should save your private key under VVV/config/certs-config.

custom:
    repo_domain: the domain of the WP repo to clone.

Defines the domain of the WP repo to clone and it's related to "repo_content" variable. It's used to get the public key of the domain to add into the know hosts of your VM box before cloning.

custom:
    production_domain: the domain of the production WP site.

Defines the domain of the production WP site to proxy media files from when you won't copy them locally.

custom:
    media_folders: the folders to copy media files from.

On a source/destination basis, it defines a list of sets of media files to save in the cloned site. Notice that /srv/config points to VVV/config.

custom:
    replace_strings: the strings to replace in the db.

On a "string to find"/"string to replace" basis, it defines a list of values to replace in all fields from all the tables of the WP database.