gwa/bedrock-multisite-skeleton

A modern WordPress stack

v2.1.5 2016-02-01 13:57 UTC

Requires

• php: >=5.5
• anolilab/wordpress-salt-generator: ~1.2
• composer/installers: ~1.0.22
• gwa/multisite-directory-resolver: ~2.1
• gwa/wp-disable-auto-update: ~1.0
• johnpbloch/wordpress: 4.4
• koodimonni-language/core-de_de: 4.4
• koodimonni-language/core-en_gb: 4.4
• koodimonni/composer-dropin-installer: 0.2.4
• vlucas/phpdotenv: ~2.0.1

Requires (Dev)

• fabpot/php-cs-fixer: ~1.11
• wpackagist-plugin/debug-bar: ~0.8.2
• wpackagist-plugin/debug-bar-post-types: ~1.2
• wpackagist-plugin/log-deprecated-notices: ~0.3

MIT

• Great White Ark
• Scott Walkinshaw
• Ben Word

• twig
• composer
• wordpress
• developer
• vagrant
• stack
• multisite
• dev
• wp
• roots
• bedrock

README

A WordPress Bedrock multisite skeleton. This project is trying to simplify the way we're setting up a new WordPress project. Don't repeat yourself.

Much of the philosophy behind Bedrock is inspired by the Twelve-Factor App methodology including the WordPress specific version.

Features

• Dependency management with Composer
• Better folder structure
• Easy WordPress configuration with environment specific files
• Environment variables with Dotenv
• Whoops is a nice little library that helps you deal with errors and exceptions in a less painful way.
• Autoloader for mu-plugins (use regular plugins as mu-plugins)
• Debug Bar Adds a debug menu to the admin bar that shows query, cache, and other helpful debugging information.
• Developer A plugin, which helps WordPress developers develop.
• [Stage Switcher] Detects all the enviroments in WordPress.
• MultisiteDirectoryResolver Adds filters that correct directory paths in a Wordpress multisite install with the WordPress installation in a custom subfolder.
• Koodimonni composer lang support

Plugins & Themes

We are using WordPress Packagist for plugins. To add a plugin from the WordPress Plugin Directory add the to the required array in the composer.json file. Specify them with wpackagist-plugin following by the plugin slug name. Example below.

"wpackagist-plugin/plugin-name": "~1.0.1"

Please note that this also works with themes and WordPress multi-site plugins.

Requirements

• PHP >= 5.4

Installation

Install Bedrock Multisite by issuing the Composer create-project command in your terminal:

1. composer create-project gwa/bedrock-multisite-skeleton
2. Copy .env.example to .env and update environment variables:

• DB_NAME - Database name
• DB_USER - Database user
• DB_PASSWORD - Database password
• DB_HOST - Database host
• WP_ENV - Set to environment (development, staging, production)
• WP_HOME - Full URL to WordPress home (http://example.com)
• WP_SITEURL - Full URL to WordPress including subdirectory (http://example.com/wp)

1. Access WP admin at http://example.com/wp/wp-admin

Read more about setting up Bedrock Multisite on our installation documentation page.

Deploys

Any other deployment method can be used as well with one requirement:

composer install must be run as part of the deploy process.

Documentation

• Folder structure
• Configuration files
• Environment variables
• Composer
• wp-cron
• mu-plugins autoloader

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Keep track of development and community news.

• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter