openeuropa/ecl-twig-loader

Europa Component Library Twig loader.

Europa Component Library Twig loader

, _(*1)

Twig loader for Europa Component Library Twig implementation (ECL Twig), it allows to load components by accessing them via a configurable namespace., _(*2)

For example, given you have the following ECL twig components:, _(*3)

/path/to/components/
├── ec-component-link
│   └── ecl-link.html.twig
└── ec-component-language-list
    ├── ecl-language-list.html.twig
    ├── ecl-language-list-item.html.twig
    ├── ecl-language-list-overlay.html.twig
    └── ecl-language-list-splash.html.twig

If you setup the loader as follows:, _(*4)

<?php

use \OpenEuropa\Twig\Loader\EuropaComponentLibraryLoader;

$loader = new EuropaComponentLibraryLoader(['ecl-twig'], '/components', '/path/to');
$twig = new Twig_Environment($loader);

Then you can load the link component in the following way:, _(*5)

{% include '@ecl-twig/ec-component-link/ecl-link.html.twig' with {
  link: { 
    type: 'standalone',
    label: 'Standalone link',
    path: 'http://google.com',
    icon_position: 'after'
  }
} %}

You can also use a shorter form, based on implicit naming conventions:, _(*6)

{% include '@ecl-twig/link' with {
  link: {
    type: 'standalone',
    label: 'Standalone link',
    path: 'http://google.com',
    icon_position: 'after'
  }
} %}

To load sub-components append them after the component name:, _(*7)

{% include '@ecl-twig/language-list/language-list-splash' %}

Installation using Docker Compose

The setup procedure can be simplified by using Docker Compose., _(*8)

Requirements:, _(*9)

• Docker
• Docker-compose

Copy docker-compose.yml.dist into docker-compose.yml., _(*10)

You can make any alterations you need for your local Docker setup. However, the defaults should be enough to set the project up., _(*11)

Run:, _(*12)

$ docker-compose up -d

Then:, _(*13)

$ docker-compose exec web composer install