菜单

FLUIDTEMPLATE Content Object

2011年04月2日 - typo3

With TYPO3 v4.5 the TypoScript Content Object FLUIDTEMPLATE is available.
It works similar to the regular TEMPLATE cObject but instead of the marker and subpart based templates it expects a Fluid style templates.

Note: Currently the extensions Fluid and Extbase have to be installed for this Content Object to work.

Usage

Using this Content Object is as simple as:

10 = FLUIDTEMPLATE
10.file = fileadmin/templates/MyTemplate.html

 

With the variables key you are able to set values that will be available within your Fluid template:

10 = FLUIDTEMPLATE
10 {
    file = fileadmin/templates/MyTemplate.html
    variables {
        foo = TEXT
        foo.value = Hello World!
    }
}

 

Reference

Further properties of the FLUIDTEMPLATE cObject are:

Furthermore you can specify the default plugin values that are mainly used to search layouts/partials
(if layoutRootPath/partialRootPath have not been specified) and to resolve extension/controller in Fluid links.
Available extbase properties are:

Note: All properties of the FLUIDTEMPLATE cObject support stdWrap

A fully fledged example

10 = FLUIDTEMPLATE
10 {
    file = MyTemplate.html
    file.wrap = fileadmin/templates/ |
    layoutRootPath = fileadmin/templates/layouts
    partialRootPath = fileadmin/templates/partials
    format = xml
    extbase {
        pluginName = SomePlugin
        controllerExtensionName = SomeExtension
        controllerName = SomeController
        controllerActionName = someAction
    }
    variables {
        title = TEXT
        title.value = Some Title
        mainNavigation < lib.mainNavigation
    }
}

The corresponding Fluid template (fileadmin/templates/MyTemplate.html) could look like this:

 1 <f:layout name="Default" />
 2 
 3 <f:section name="header">
 4     <f:render partial="GraphicalHeader" arguments="{header: title}" />
 5 </f:section>
 6 <f:section name="body">
 7     <div id="mainNavigation">
 8         <f:format.html>{mainNavigation}</f:format.html>
 9     </div>
10     <div id="content">
11         <f:format.html>{data.bodytext}</f:format.html>
12     </div>
13 </f:section>

 

Fluid Standalone View

The FLUIDTEMPLATE content object internally uses the Fluid Standalone View, which can also be used by your own code
if you need to render Fluid (f.e. to render an e-mail text), as in the following example:

1 $view = t3lib_div::makeInstance('Tx_Fluid_View_StandaloneView');
2 $view->setTemplatePathAndFilename('foo/Bar.html');
3 $view->assign('key', 'value');
4 print $view->render();

 

发表评论

电子邮件地址不会被公开。 必填项已用*标注