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.

Source code

Go to the source code of this ViewHelper: CObjectViewHelper.php (GitHub).

Arguments

The following arguments are available for the cObject ViewHelper:

data
Type
mixed
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
Type
string
Required
1
the TypoScript setup path of the TypoScript object to render
currentValueKey
Type
string
currentValueKey
table
Type
string
Default
''
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.