README.md

Docksal powered Drupal 7 Installation

This is a sample vanilla Drupal 7 installation pre-configured for use with Docksal.

Features:

• Vanilla Drupal 7
• fin init example
• Drupal multisite example
• Behat setup example and sample tests

Setup instructions

Step #1: Docksal environment setup

This is a one time setup - skip this if you already have a working Docksal environment.

Follow Docksal environment setup instructions

Step #2: Project setup

1. Clone this repo into your Projects directory

   git clone https://github.com/docksal/boilerplate-drupal7-advanced.git drupal7-advanced && cd drupal7-advanced
   

2. Initialize the site

   This will initialize local settings and install the site via drush

   fin init
   

3. Point your browser to

   http://drupal7-advanced.docksal.site
   

More automation with 'fin init'

Site provisioning can be automated using fin init, which calls the shell script in .docksal/commands/init.
This script is meant to be modified per project. The one in this repo will give you a good example of advanced init script.

Some common tasks that can be handled by the init script:

• initialize local settings files for Docker Compose, Drupal, Behat, etc.
• import DB or perform a site install
• compile Sass
• run DB updates, revert features, clear caches, etc.
• enable/disable modules, update variables values
• run Behat tests

Behat test examples

Behat tests are stored in tests/behat.

Example of running Behat tests:

fin behat features/blackbox.feature

Drupal multisite example

There is an additional site configured in this project: anothersite.drupal7-advanced.docksal

To have it installed during fin init

1. Uncomment the following block in .docksal/commands/init:

   # Multisite - install an additional site
   site_install_anothersite
   

2. Run fin init again