This is the WordPress layout we use at Delicious Media as a starting point for most of our projects.
It has been tested with WordPress 5.0+ and is written for PHP 7.x.
wp-config.php
is in the root directory along withlocal-config.php
file which holds environmet specific information such as database credentials and salts.- WordPress iteself is installed in
/wp/
for neatness. - The WordPress content folder is
/content/
(rather than wp-content) the themes, plugins and mu-plugins folder live here. - The WordPress uploads folder is stored in
/shared/content/uploads/
and symlinked from/content/uploads/
. Similarly a static folder in/shared/content/static/
is symlinked to from/static/
. This allows easy backups/synchronisation between multiple servers.
A composer.json file in the root will include the following:
- DM-MuLoader - Automagically includes plugins from subdirectories under the mu-plugins folder.
- Extended CPTs - Configure custom post types & taxonomies with less code.
- DM Base - Customisations to WP to suit our projects.
- Mailgun - A plugin to allow sending email via the Mailgun transactional SMTP service.
- ACF Pro - You'll need to add a .env file with a licence key; note the version number needs to be incremented in composer.json manually.
If you are going to use Composer to bring in the extra components, you'll also need composer-wp available - you can install it with composer global require balbuf/composer-wp
.
The best way to setup a project with this layout is to use VVV our provisioning script which will setup a new VVV site using this WordPress layout along with our starter theme and various other customisations.
You can set one up manually by cloning this repository, copying local-config-sample.php
to local-config.php
and editing the relevant settings there. You'll also need to create the "shared" folders with mkdir -p shared/content/uploads && mkdir -p shared/content/static
and install the WordPress core files with wp core download
(to avoid leaving any redundant code on your site, also remove the /wp/wp-content/ folder) then run composer install
.
Built by the team at Delicious Media, a specialist WordPress development agency based in Sheffield, UK.