heimrichhannot/contao-twig-templates-bundle

This bundle ships core contao templates as twig templates and additional templates using the latest Bootstrap framework's CSS for the Contao CMS.

Installs: 1 165

Dependents: 1

Suggesters: 0

Security: 0

Stars: 1

Watchers: 6

Forks: 0

Open Issues: 1

Language:Twig

Type:contao-bundle


README

Latest Stable Version Total Downloads

This bundle builds on top of Twig support bundle and replaces the most core templates with twig templates. In addition, it comes with an expandable frontend framework architecture that allows to select a frontend framework in your layout and automatically use customized templates instead of the core templates.

Features

  • replaces various core templates with twig templates
  • expandable frontend framework architecture to easily add your frontend framework without changing all templates in contao backend or override core templates
  • automatic usage of templates prepared for frontend frameworks, if set in settings (inspired by contao-bootstrap/templates)
  • bundles bootstrap 4 support with optional support for custom form controls

Installation

Install via composer: composer require heimrichhannot/contao-twig-templates-bundle and update your database.

Additional frontend frameworks

Available (known) extensions:

Usage

It's as simple as that: Check 'Use twig templates' in your page layout configuration. If your want to use a frontend framework like bootstrap, select the corresponding option in the 'Use framework' select. This way the automapping takes place and according to the current content element or module, the correct template is used.

Automapping order (check if template exists, else use the next one):

  1. Frontend framework twig template
  2. Core/custom twig template
  3. Default/Custom (contao html5) template

If you don't want to use automapping you can also assign the template you want in the ordinary way by selecting it in the customTpl field of your module or content element.

Additional dca configuration keys

These keys can be used in fields eval entry:

Key Description
inputPrepend Content to be added before the input (within input-group-prepend). Overrides other prepended elements.
inputAppend Content to be added after the input (within input-group-append). Overrides other appended elements.
inline Input will be displayed horizontal. Only for checkboxes and radio buttons.
groupClass Classes for outer form group wrapper (default: form-group)
inputGroupClass Classes for input group wrapper (input-group is always added)

Additional twig functions

Function Description
getCurrentLanguage Return the current language ($GLOBALS['TL_LANGUAGE'])

Bundled templates

Block templates

Template Bundled
block_searchable core
block_unsearchable core

Content elements

Content Element bundled core bundled bs4
Accordion Single x x
Accordion Start x x
Accordion Stop x x
Code x x
Download x x
Downloads x x
Gallery x x
Headline x x
HTML x
Hyperlink x
Image x
List x
Markdown x
Player x
Slider Start x
Slider Stop x
Table x
Teaser x
Text x
Toplink x
Vimeo x x
Youtube x x

Member elements

Content Element bundled core bundled bs4
Member default x
Member grouped x

Gallery

Content Element bundled core bundled bs4
Gallery default x x

Both version with minimal setting. You definitely need to change those templates to fit your requirements.

Modules

Modules bundled core bundled bs4 changes
Article x removed Gplus Button
Article List x
Article Nav x
Book Nav x
Breadcrumb x x
Change Password x
Close Account x
Custom Nav x
HTML x
Login x x
Lost Password x
Message x
Navigation x
Password x
Quicklink x
Quicknav x
Random Image x
Search x x
Sitemap x

Navigation

Modules bundled core bundled bs4
Nav Default x
Nav Inline x
Nav Tabs x
Nav Vertical x

Search

Modules bundled core bundled bs4
Search Default x x
Search List Group x

Developers

Events

To modify template data before parsing or rendering, use the events of twig support bundle with a priority lower than 100 (0 is default, so you don't need to set this value in most cases).

Add custom frontend frameworks

  1. Create a class which implements HeimrichHannot\TwigTemplatesBundle\FrontendFramework\FrontendFrameworkInterfacce

    Please read the method comments for implementation

  2. Register your newly created class as service with huh.contao_twig_templates.framework service tag

  3. For each template, you want to replace, create an html5 template (where filename suffix is the same as the identifier set in the class, example form_checkbox_bs4.html5) and call the template factory. Typical this code can be used without any adjustment:

    <?= \Contao\System::getContainer()->get('huh.utils.template')->renderTwigTemplate($this->getName(), $this->getData()); ?>
    • If your want to set template specific options (for example bootstrap 4 custom control support) you can use $template::addSupport(). Example:

       <?php 
      $template = \Contao\System::getContainer()->get('huh.twig.template.factory')->createInstance($this);
      $template->addSupport('custom-forms', true);
      echo $template->render();
      
  4. Create a twig template with the same name as the html5 template (e.g. form_checkbox_bs4.html.twig). This is the place where your custom template code will live. All template variable are given as twig variables. Please see bundle templates for some examples.

Template variables

Additional template variables

Name Type Default Description
groupClass string form-group The outer form group class
inputGroupClass string form-group The input group class
_entity object - The context entity object (e.g. \Contao\FormTextField)