Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/docksal/boilerplate-drupal7-advanced

Drupal 7 boilerplate project with advanced configuration powered by Docksal
https://github.com/docksal/boilerplate-drupal7-advanced

Last synced: 7 days ago
JSON representation

Drupal 7 boilerplate project with advanced configuration powered by Docksal

Awesome Lists containing this project

README

        

# 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](https://github.com/docksal/docksal/blob/develop/docs/env-setup.md)

### 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](.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](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](.docksal/commands/init):

```
# Multisite - install an additional site
site_install_anothersite
```

2. Run `fin init` again