Europa demo site

Europa demo site, based on OpenEuropa components.

Installation

The Europa demo site can be set up using Composer.

In the project root run:

$ composer install

Before setting up and installing the site make sure to copy ./runner.yml.dist to ./runner.yml and edit the values in it to match your environment. Typically you will have to change the value for the base_url as well as the database credentials.

To set up the site run:

$ ./vendor/bin/run drupal:site-setup

This will:

• Symlink the custom modules in ./build/modules
• Symlink the custom themes in ./build/themes
• Setup Drush and Drupal's setting files using values from ./runner.yml.dist or ./runner.yml
• Setup the Behat configuration file using values from ./runner.yml.dist or ./runner.yml

After a successful setup install the site by running:

$ ./vendor/bin/run drupal:site-install

This will install the site using the configuration exported in ./config/sync. And will import interface translations.

Using Docker Compose

The project offers a set of containers for software packages that are close to the versions that are in use on the production servers. If you want to run the site on an environment that closely mimics production, you can follow these steps to install it using Docker Compose.

Requirements:

• Docker
• Docker-compose

Run:

$ docker-compose up -d

Then:

$ docker-compose exec -u web web composer install
$ docker-compose exec -u web web ./vendor/bin/run drupal:site-install

Note that if you have compatible versions of PHP and Composer installed on your host system you can download the dependencies by running composer install on the host system instead of through docker-compose. This will greatly speed up the process since this will make use of the Composer cache on the host system.

The demo site will be available at http://localhost:8080/build.

Working with content

The Europa demo site ships with default content bundled in the Europa demo content module.

After adding or updating site content you can export it by running:

$ ./vendor/bin/run drupal:export-content

Content export/import functionality is provided by the Default Content module.

Update interface translations

Update .po files located in your modules/europa_demo_core/translations/ folder. And execute this:

$ docker-compose exec -u web web ./vendor/bin/run drupal:import-interface-translations

Webtools Analytics configuration

To setup the Webtools Analytics module add the following configuration to your runner.yml file before installing the site:

drupal:
  settings:
    config:
      oe_webtools_analytics.settings:
        siteID: '<your siteId>'
        sitePath: '<your sitePath>'

Tests

Run tests as follows:

./vendor/bin/behat

Or when using Docker Compose:

$ docker-compose exec -u web web ./vendor/bin/behat