cObject ViewHelper <f:cObject>

This ViewHelper renders CObjects from the global TypoScript configuration.

Examples

Render lib object

<f:cObject typoscriptObjectPath="lib.someLibObject" />
Copied!

Rendered lib.someLibObject.

Specify cObject data & current value

<f:cObject typoscriptObjectPath="lib.customHeader" data="{article}" currentValueKey="title" />
Copied!

Rendered lib.customHeader. Data and current value will be available in TypoScript.

Inline notation

{article -> f:cObject(typoscriptObjectPath: 'lib.customHeader')}
Copied!

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
}
Copied!

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.