cObject¶
This ViewHelper renders CObjects from the global TypoScript configuration.
Note
You have to ensure proper escaping (htmlspecialchars/intval/etc.) on your own!
Examples¶
Render lib object¶
<f:cObject typoscriptObjectPath="lib.someLibObject" />
Rendered lib.someLibObject
.
Specify cObject data & current value¶
<f:cObject typoscriptObjectPath="lib.customHeader" data="{article}" currentValueKey="title" />
Rendered lib.customHeader
. Data and current value will be available in TypoScript.
Inline notation¶
{article -> f:cObject(typoscriptObjectPath: 'lib.customHeader')}
Rendered lib.customHeader
. Data will be available in TypoScript.
Accessing the data in TypoScript¶
lib.customHeader = COA
lib.customHeader {
10 = TEXT
10.field = author
20 = TEXT
20.current = 1
}
When passing an object with {data}
, the properties of the object are accessible with .field
in
TypoScript. If only a single value is passed or the currentValueKey
is specified, .current = 1
can be used in the TypoScript.
Arguments¶
data¶
- DataType
mixed
- Required
false
- Description
The data to be used for rendering the cObject. Can be an object, array or string. If this argument is not set, child nodes will be used
typoscriptObjectPath¶
- DataType
string
- Required
true
- Description
The TypoScript setup path of the TypoScript object to render
currentValueKey¶
- DataType
string
- Required
false
- Description
CurrentValueKey
table¶
- DataType
string
- Required
false
- Description
The table name associated with "data" argument. Typically tt_content or one of your custom tables. This argument should be set if rendering a FILES cObject where file references are used, or if the data argument is a database record.