ROLI BLOG 2

This project is built from the Bedrock biolerplate. Which means we can control all our worpress dependencies with composer. Read this lovely article if you need to get familiar with managing wordpress this way. It is important that all plugins + updates are installed via composer rather than through wordpress.

Requirements

• PHP >= 5.5
• Composer - Install
• node.js and webpack

Installation

1. Clone the git repo

2. Run your db server mysql.server start

3. Create a database called roli_blog_dev echo "CREATE DATABASE roli_blog_dev" | mysql -u root

4. Run composer install

5. Copy .env.example to .env and update environment variables:

   • DB_NAME - 'roli_blog_dev'
   • DB_USER - 'root'
   • DB_PASSWORD - ''
   • DB_HOST - 'localhost'
   • WP_ENV - 'development'
   • WP_HOME - 'http://localhost:3000/'
   • AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT - Generate with wp-cli-dotenv-command or from the WordPress Salt Generator

6. Run the server from within the web folder cd web php -S localhost:3000

7. Go to http://localhost:3000/wp in your browser and you will go the the wordpress setup screen.

Development

Setup

1. Install web pack pack if you don't already have it npm install webpack -g
2. Go to the theme folder cd web/app/themes/roli.com
3. Run npm install if you haven't already

Work

1. Run watch within the webpack folder
2. cd webpack
3. webpack --progress --colors --watch

Plugins

1. Install new plugins with composer - packages for plugins can be found on http://wpackagist.org/.

Admin

1. Go to http://localhost:3000/wp/wp-admin for the wordpress admin panel

Deployment

Our site is currently hosted on WP-Engine. We will need to deploy only the contents of the web folder. Whether to do this with a subtree or a script or something else is TBD. See the this getting started article for more info on deploying to WPE with git.

Automatic Updates

When a new version of wordpress is released and passed beta testing, WP-engine will further test and automatically update the version of wordpress on their servers.

An email will be sent to the admin members of wp-engine when this is going to happen - and wordpress should also send an email to your wp-admin user email. **You should update the version of wordpress in this project in advance [using composer] to make sure it doesn't break anything, and apply the fix if it does.

You can also update wordpress early on wp-engine in the user portal. More info about wpengine's updates is here.