Wordpress-boilerplate

Getting the server up and running

Following the steps below will leave you with a fresh Wordpress install. Head over to the Halland theme repos for information on how to add our main theme to your site.

1. Make sure the following dependencies are installed on your computer:

• Virtualbox >= 4.3.10
• Vagrant >= 1.8.5
• Composer >= 1.6.2

2. Create a folder with the project name:

$ mkdir myproject && cd myproject

3. Clone this repo in your directory and remove the .git folder:

$ git clone https://github.com/RegionHalland/wordpress-boilerplate.git . && rm -rf .git

4. Initialize a new GitHub repos for your new site using the GitHub Desktop client.

5. Update the following files, replacing example.test with your local site name, like myproject.test and adding your ACF-key under ACF_PRO_KEY

./trellis/group_vars/development/wordpress_sites.yml
./trellis/group_vars/development/vault.yml

For more options, see Trellis documentation.

6. (Optional) Configure the IP address at the top of the ./trellis/vagrant.default.yml to allow for multiple vagrant boxes to be run concurrently (default is 192.168.50.5).

7. 🚨Are you going to run a multisite?

Follow the steps under ”Multisite”.

8. Provision your server from the ./trellis directory:

$ cd trellis && vagrant up

9. That's it. Your site should be up and running. Type in the local test URL (for example 'myproject.test') in your favourite browser to see it spinn.

10. Time to add your theme The site is up but it ain't good looking, add our theme to it. Head over to the Halland theme repos for information on how to make your site pop!

Setting up Advanced Custom Fields

TBD!

Multisite

It’s important to follow these steps before provisioning your server.

1. Update multisite settings in ./trellis/group_vars/development/wordpress_sites:

multisite:
  enabled: true
  subdomains: false

2. Add the following code somewhere in ./site/config/application.php:

/* Multisite */
define('WP_ALLOW_MULTISITE', true);
define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', false); // Set to true if using subdomains
define('DOMAIN_CURRENT_SITE', env('DOMAIN_CURRENT_SITE'));
define('PATH_CURRENT_SITE', env('PATH_CURRENT_SITE') ?: '/');
define('SITE_ID_CURRENT_SITE', env('SITE_ID_CURRENT_SITE') ?: 1);
define('BLOG_ID_CURRENT_SITE', env('BLOG_ID_CURRENT_SITE') ?: 1);

3. Provision your server from the ./trellis directory:

$ cd trellis && vagrant up

4. Install the multisite-url-fixer mu-plugin:

$ cd site && composer require roots/multisite-url-fixer

Component Library (WIP)

To use a local version of the Component Library, define COMPONENT_LIB_URL as en environment variable in ./trellis/group_vars/development/vault.yml and point it to your local installation of the component library:

vault_wordpress_sites:
  example.com:
    ...
    env:
      ...
      COMPONENT_LIB_URL: 'http://styleguide.test/temp/css/main.min.css'

Make sure your installation of the component library allows CORS by adding the following in the server block of your styleguides nginx config:

# Allow CORS 
location ~* \.(eot|ttf|woff|woff2)$ {
    add_header 'Access-Control-Allow-Methods' 'OPTIONS, GET, POST, PUT, PATCH, DELETE';
    add_header 'Access-Control-Allow-Origin' '*';
    add_header 'Access-Control-Allow-Credentials' 'true';
}