linkabi9 / mg-press

Wordpress + Composer + Twig

mg-press

Wordpress + Composer + Twig

Installation

1) Install Using Composer
    composer create-project mindgruve/mg-press path/to/project "dev-master"

2) Ignore the following files and directories:
    application/config/wpConfig.yml
    application/vendor
    web/wp

3) Update your configuration file located at config/wpConfig.yml with your 
    database parameters, theme name, and updated secure hashes.

4) Complete the WP Installation.  For example, using localhost
    http://localhost/wp/wp-admin/install.php

5) Login to to WP Admin and go to Settings > General
    update the Site Address (URL) to be at your web root.
    For example, using localhost your site address setting would be: http://localhost/

WordPress Configuration

MgPress uses a YAML to configure your WordPress installation.
The config file is located at [project-root]/config/wpConfig.yml
If the wpConfig.yml file doesn't exist, it will be copied over from wpConfig.yml.dist when you perform a composer install or update.

Environmental Variables

You can also set configuration by using environmental variable substitution.
This is helpful if you need to package your application in a docker container or if you utilize continuous integration.

MgPress follows the same syntax as Apache - ${ENVIRONMENTAL_VARIABLE}
For example if you had the following entries in your wpConfig.yml..

DB_NAME:          '$(DATABASE_NAME)'
DB_USER:          '$(DATABASE_USER)'
DB_PASSWORD:      '$(DATABASE_PASSWORD)'
DB_HOST:          '$(DATABASE_HOST)'

Then the environmental variables DATABASE_NAME, DATABASE_USER, DATABASE_PASSWORD, and DATABASE_HOST will be used.

Included Libraries

Wordpress 4.2.2 - https://wordpress.org/
Timber - http://upstatement.com/timber/
Twig - http://twig.sensiolabs.org/
Symfony YAML - http://symfony.com/doc/current/components/yaml/introduction.html
Symfony FileSystem - http://symfony.com/doc/current/components/filesystem/introduction.html
Symfony Finder - http://symfony.com/doc/current/components/finder.html
Woops - http://filp.github.io/whoops/
Wordpress Search Replace Database - https://interconnectit.com/products/search-and-replace-for-wordpress-databases/
Symfony Console Component - http://symfony.com/doc/current/components/console/introduction.html
WP CLI - http://wp-cli.org/

Project Layout

composer.json
README.md
config/wpConfig.yml
src/Mindgruve/WPContent
src/Mindgruve/WPContent/languages
src/Mindgruve/WPContent/plugins
src/Mindgruve/WPContent/mu-plugins
src/Mindgruve/WPContent/themes
web/wp
vendor

Upgrading WordPress

composer update wordpress
composer update-wp-db