Skip to content
This repository has been archived by the owner on Mar 1, 2023. It is now read-only.
/ wp-vvv Public archive

A Vagrant configuration for WordPress.

License

Notifications You must be signed in to change notification settings

26B/wp-vvv

Repository files navigation

WP-VVV

This is a Vagrant configuration for WordPress.

Introduction

This guide assumes some basic familiarity with the command line, the Git version control system and Vagrant.

There are many graphical tools allowing you to achieve the same results as the ones described here, but a step-by-step guide for those is outside the scope of this document.

Requirements

Setup

This project should be added to the www directory in your VVV setup. If you've followed the guide to installing VVV, the directory may be reached by typing cd vagrant-local/www in the command line interface.

Now clone the project into the www folder:

$ git clone [email protected]:26B/wp-vvv.git my-project-name

This should create a new directory called my-project-name containing all the project files.

Add the site to your vvv-custom.yml (if you don't know what this is, check out the documentation):

my-project-name:
  hosts:
    - my-project-name.test

We're not done yet: VVV needs to setup and incorporate the project into its configuration. That is achieved by running:

$ vagrant provision --provision-with site-my-project-name

Further configuration

You can configure your site right from the YAML block you just entered, just use the custom: key to set your particular settings. For example, let's say you want a different database name (other than the default that is created using the site name):

my-project-name:
  hosts:
    - my-project-name.test
  custom:
    db_name: special_db_name

That's all you need!

The following table specifies all the variables you can set in vvv-custom.yml and their respective defaults.

Variable Description Possible Values Default
site_title The site's title Any string Primary domain
wp_type Type of installation single, subdirectory, subdomain single
db_name Database name Valid MySQL database name [escaped_vvv_site_name]_dev
db_user Database user wp
db_password Database password for user wp
db_host Database hostname Hostname localhost
db_charset Database charset MySQL Charset Sets and Collation utf8mb4
db_collate Database collation MySQL Charset Sets and Collation utf8mb4_general_ci
table_prefix Database table prefix wp_
wp_plugins The plugins to activate
wp_theme The theme to activate

What now?

This project is meant to be all about giving you a head start in setting up the WordPress environment for development. It also provides several helpful scripts and tries to make good choices in what is setup for you.

There's no theme dude!

You're darn right! There is no themes folder at all, so you are free to plug in any theme base/starter you'd like.