This TYPO3 extension allows you to use the fabulous Twig template engine within your TYPO3 project. You can use Twig templates in your Extbase controllers or in your TypoScript.
Twig is easy to learn and allows to write templates without hassle.
In comparison to Fluid, Twig is also used in other PHP frameworks like Symfony.
Twig is extendable using functions, filters and more writing simple PHP classes.
This extension can only be installed using composer.
composer require cvc/typo3-twigTwig provides a easy syntax to create templates. It not only used in a wide range of PHP frameworks, but also known outside the PHP community.
If you want to move from Fluid to Twig, you can learn about Twig and its build in extensions on Twig’s official website.
Rendering of Twig templates in TYPO3 works nearly exactly the same way as rendering Fluid templates. See the examples below how to render the templates within Extbase or within TypoScript.
The TWIGTEMPLATE Object Renderer allows you to render Twig template files.
Variables can be set using Content Objects. This allows you to use TEXT, COA or others.
You can pass a list of template directories to the engine. This allows to override templates from other extensions.
page.10 = TWIGTEMPLATE
page.10 {
templateName = example.html.twig
variables {
foo = TEXT
foo.value = Bar!
}
templateRootPaths {
10 = EXT:twig/Resources/Private/TwigTemplates
}
}<?php
// my_extension/Classes/Controller/MyFantasticalController.php
class MyFantasticalController extends \TYPO3\CMS\Extbase\Mvc\Controller\ActionController
{
// setting the default view object class to TwigView will enable the Twig templates
protected $defaultViewObjectName = \Cvc\Typo3\CvcTwig\Extbase\Mvc\View\TwigView::class;
public function someAwesomeAction()
{
// assign the variables as usual
$this->view->assign('foo', 'BAZ!');
}
} Let the TwigView automatically detect the right template for your action. As with using Fluid you simply have to configure the template root paths.
Have a look into the Documentation for more information.
The extension ships with functions and filters that will assist you in creating your templates.
<a href="{{ t3_uri_page(123) }}">Link to another page</a>{{ data.bodytext | t3_html }}{{ dump(variable) }}
This extension can be easily installed using composer. Read the "Get Started" guide to get more information about using Twig with TYPO3.
Found a bug? Missing a feature? We are happy about all types of contribution. Create an issue or a merge request on the GitHub project.
We are a web development agency based in Essen, Germany. Contact us if you would like to work with us.