wieni / wmtwig
Improves the integration of Twig with component and entity-oriented projects
Installs: 2 207
Dependents: 2
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 2
Open Issues: 2
Type:drupal-module
Requires
- php: ^8.0
- drupal/core: ^9.1 || ^10 || ^11
Requires (Dev)
- composer-runtime-api: ^2.0
- ergebnis/composer-normalize: ^2.0
- wieni/wmcodestyle: ^1.3
This package is auto-updated.
Last update: 2024-12-12 20:16:04 UTC
README
Improves the integration of Twig with component and entity-oriented projects.
Why?
TODO
Installation
This package requires PHP 7.1 and Drupal 8 or higher. It can be installed using Composer:
composer require wieni/wmtwig
How does it work?
Registering Twig templates as theme implementations
This module automatically registers your Twig templates as theme implementations. Modules and themes can indicate in their info.yml file which paths should be included:
name: Some theme type: theme wmtwig: templates: pages
If the module or theme has multiple paths, an array can be passed:
name: Some theme type: theme wmtwig: templates: - components - pages
The advantage against the default way of rendering Twig templates
(see documentation)
is that you don't have to manually define every template in a theme hook. Also, the folder structure of your templates is respected. This makes it possible to refer to templates in the same
way as in Laravel projects, eg. node.product
for the node/product.html.twig
template.
It is recommended to not use the default templates
folder for these templates, because they might clash with other
Drupal theme implementations. Eg. when creating a template at path templates/node/page.html.twig
, it will override
the core page template.
Changelog
All notable changes to this project will be documented in the CHANGELOG file.
Security
If you discover any security-related issues, please email security@wieni.be instead of using the issue tracker.
License
Distributed under the MIT License. See the LICENSE file for more information.