Table Of Content 

Render templates in TypoScript 

To render a Twig template you can use the TWIGTEMPLATE content object.

page.10 = TWIGTEMPLATE
page.10 {
    templateName = example.html.twig
    variables {
        foo = TEXT
        foo.value = Bar!
    }
    templateRootPaths {
        10 = EXT:cvc_twig/Resources/Private/TwigTemplates/
    }
}

Render templates in an Extbase controller 

If you want to use twig from within your controller, you just have to switch the $defaultViewObjectName to \Cvc\Typo3\CvcTwig\Extbase\Mvc\View\TwigView. See the example below.

The template file will be automatically set to @controller/@action.@format.twig. The templateRootPaths that are defined for extbase will be respected. You should not forget to configure those using TypoScript.

Given you have the following controller; you just have to set the $defaultViewObjectName to the TwigView class.

<?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!');
    }
}

The templateRootPaths are configured using TypoScript:

plugin.tx_my_extension {
    view {
        templateRootPaths.0 = EXT:my_extension/Resources/Private/Templates/
    }
}

The Twig template has to be placed in my_extension/Resources/Private/Templates/ and has to be named MyFantastical/someAwesome.html.twig.

{# my_extension/Resources/Private/Templates/MyFantastical/someAwesome.html.twig #}

Foo: {{ foo }}

Develop Custom Twig Extensions 

Twig allows to extend the template language by adding custom functions, filters, tags, and some more. This TYPO3 extension currently only supports to add Twig Extensions (which include all mentioned). Please read in the official Twig documentation, how to create your own extension.

To register the Twig Extension in your TYPO3 Extension, there is nothing more needed than enabling auto wiring and auto configuration in the dependency injection service configuration:

services:
_defaults:
    autowire: true
    autoconfigure: true
    public: false

Vendor\Namespace\:
    resource: '../Classes/*'

All available Twig Extensions, that are covered by the above configuration, are automatically added to the Twig Environment.

Properties 

templateName

Type string / stdWrap

The template that is used for rendering.

templateRootPaths

Type string / stdWrap

The root directories for the loader to look in.

variables

Type cObject[]

Sets variables that should be available in the Twig template. The keys are the variable names.

Reserved variable names are data and current, which are filled automatically with the current data set.

settings

Type array

Sets the given settings array in the Twig template.

dataProcessing

Type array

Add one or multiple processors to manipulate the variables that will be passed to the template engine. The sub- property options can be used to pass parameters to the processor class.

Example:

page.10 = TWIGTEMPLATE
page.10 {
    templateName = EXT:site_package/Resources/Private/TwigTemplates/template.html.twig
    dataProcessing {
        1 = Vendor\YourExtensionKey\DataProcessing\MyFirstCustomProcessor
        2 = Vendor2\AnotherExtensionKey\DataProcessing\MySecondCustomProcessor
        2.options {
            myOption = SomeValue
        }
    }
}

Copied!

The build-in data processors are documented here.

namespaces

Type array

The file loader shipped with Twig allows to register namespaced folders. A namespace can be referenced with @namespace followed by the path to the template.

Example:

page.10 = TWIGTEMPLATE
page.10 {
    templateName = @myComponents/text_and_media.html.twig
    namespaces {
        myComponents {
            10 = EXT:example_site/Private/frontend/src/components
        }
    }
}

Copied!

The given code example defines a namespace called myComponents. A template that is located in EXT:example_site/Private/frontend/src/components can be referenced using the namespace. The template name will looks like @myComponents/text_and_media.html.twig.

dump 

{{ dump(vars) }}

Displays the content of the variable(s) on the screen.

The dump() functions prints the contents of a variable. This is useful for debugging. Please ensure that the frontend debug mode is on, because otherwise the function does not print anything. Internally DebuggerUtility::var_dump() is used.

{# print a single variable #}
{{ dump(foo) }}

{# print multiple variables #}
{{ dump(foo, bar, baz) }}

{# print all variables #}
{{ dump() }}

t3_cobject 

{{ t3_cobject(
    typoScriptObjectPath,
    data = null,
    currentValueKey = null,
    table = null
) }}

Renders a TypoScript object. The content object renderer can be populated using the data argument.

t3_form_render 

{{ t3_form_render(
    persistenceIdentifier = null,
    factoryClass = 'TYPO3\\CMS\\Form\\Domain\\Factory\\ArrayFormFactory',
    prototypeName = null,
    overrideConfiguration = []
) }}

Renders a form using the form framework.

tt_content {
    twig_testform = COA_INT
    twig_testform {
        20 = TWIGTEMPLATE
        20 {
            templateRootPaths {
                10 = EXT:ExtensionName/Resources/Private/TwigTemplates
            }
            templateName = TwigtestContentElement.html.twig

            settings {
                persistenceIdentifier = 1:/form_definitions/formIdentifier.form.yaml
            }

            extbase.pluginName = Formframework
            extbase.controllerExtensionName = Form
            extbase.controllerName = FormFrontend
            extbase.controllerActionName = perform
        }
    }
}

{{ t3_form_render(settings.persistenceIdentifier) }}

t3_uri_action 

{{ t3_uri_action(
    action,
    arguments = [],
    controller = null,
    extensionName = null,
    pluginName = null,
    pageUid = null,
    pageType = 0,
    noCache = false,
    section = '',
    format = '',
    linkAccessRestrictedPages = false,
    additionalParams = [],
    absolute = false,
    addQueryString = false,
    argumentsToBeExcludedFromQueryString = [],
    addQueryStringMethod = ''
) }}

t3_uri_image 

{{ t3_uri_image(
    src = null,
    treatIdAsReference = false,
    image = null,
    crop = null,
    cropVariant = 'default',
    width = '',
    height = '',
    minWidth = 0,
    minHeight = 0,
    maxWidth = 0,
    maxHeight = 0,
    absolute = false
) }}

Returns the URL to the given image. If an error occurs, then null is returned and no error is raised.

t3_uri_model 

{{ t3_uri_model(model) }}

Generates a link fro the given domain model.

A link handler must be configured for the mapped table.

t3_uri_page 

{{ t3_uri_page(
    pageUid = null,
    additionalParams = [],
    pageType = 0,
    noCache = false,
    section = '',
    linkAccessRestrictedPages = false,
    absolute = false,
    addQueryString = false,
    argumentsToBeExcludedFromQueryString = [],
    addQueryStringMethod = ''
) }}

t3_uri_record 

{{ t3_uri_record(table, recordUid) }}

Generates a link for the given record.

A link handler must be configured for the mapped table.

t3_uri_typolink 

{{ t3_uri_typolink(parameter, additionalParams = []) }}

t3_html 

{{ html | t3_html(parseFuncTSPath = 'lib.parseFunc_RTE') }}

Parses HTML that was created with an rich text editor.

t3_trans 

{{ key | t3_trans(arguments = [], extensionName = null) }}

Translates the given translation key into the active language.

t3_typolink 

{{ linkText | t3_typolink(
    parameter,
    target = '',
    class = '',
    title = '',
    additionalParams = '',
    additionalAttributes = [],
    useCacheHash = false,
    addQueryString = false,
    addQueryStringMethod = 'GET',
    addQueryStringExclude = '',
    absolute = false
) }}

Creates a link from fields supported by the link wizard.

The linkText will be wrapped within a link tag.

{# Create links from simple text. #}
{{ 'read_more' | t3_trans | t3_typolink('t3://record?identifier=123') }}

{# Create links around complex HTML structures. #}
{% filter t3_typolink('t3://record?identifier=123', target='_blank') %}
   <img src="read_more.png alt="read more"/>
{% endfilter %}