DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Usage¶

Render templates in TypoScript¶

You can render Twig templates the exact same way you would render Fluid templates using TypoScript.

See the example below to see how to render a simple text on the page.

page.10 = TWIG
page.10 {
        variables {
                foo = TEXT
                foo.value = BAZ!
        }
        template = EXT:twig_for_typo3/Resources/Private/template.html.twig
}

Render templates in an Extbase controller¶

You can also use Twig templates for your Extbase controller actions:

<?php

class MyAwesomeController extends \TYPO3\CMS\Extbase\Mvc\Controller\ActionController
{
        // setting the default view object class to TwigView will enable the Twig templates
        protected $defaultViewObjectName = \Comwrap\Typo3\TwigForTypo3\Mvc\View\TwigView::class;

        public function contentelementAction()
        {
                $this->view->setTemplatePathAndFilename('EXT:twig_for_typo3/Resources/Private/template.html.twig');
                $this->view->assign('foo', 'BAZ!');
        }
}

Add your own custom template loader¶

If you have a self written loader to retrieve templates you can register a custom loader:

$GLOBALS['TYPO3_CONF_VARS']['EXT']['twig_for_typo3']['twig']['loader'][] = MyLoader::class;

The loader will be instantiated using the GeneralUtility class.

Custom loaders take precedence over the build in Typo3Loader.