f:cObject

This ViewHelper provides a connection to TypoScript. Pass in a TypoScript object path (lib.*) and let TypoScript do the work.

Properties

typoscriptObjectPath

Variable type

String

Description

The TypoScript object path

Default value

Mandatory

Yes

data

Variable type

Mixed

Description

Iterable variable containing values to use inside the object

Default value

NULL

Mandatory

No

currentValueKey

Variable type

String

Description

Key of the value mapped as current in the data. It will be used when using current=1

Default value

NULL

Mandatory

No

Simple example

TypoScript

lib.fluidText = TEXT
lib.fluidText {
  value = Text from TypoScript
}

Fluid template

<p><f:cObject typoscriptObjectPath="lib.fluidText" /></p>

Output

<p>Text from TypoScript</p>

Example for a localized date value

The f:format.date ViewHelper works with the PHP function date(), so it can only output English month names. It would be better if we could use strftime: TypoScript provides dates formatted using strftime. Here's an example, using the current date and a German date format.

TypoScript

lib.formattedDate = TEXT
lib.formattedDate {
  current = 1
  strftime = %d. %B %Y
}

Fluid template

<p><f:cObject typoscriptObjectPath="lib.formattedDate">{address.dayOfBirth}</f:cObject></p>

Output

<p>17. Januar 2013</p>

Example with an array or object

TypoScript

lib.address = COA
lib.address {
  10 = TEXT
  10.value.current = 1
  10.value.wrap = <p>First name: |</p>
  20 = TEXT
  20.value.dataWrap = <p>Full name: {field: firstName} {field: lastName}
}

Fluid template

<f:cObject typoscriptObjectPath="lib.address" data="{address}" currentValueKey="firstName" />

Output

<p>First name: Stefan</p><p>Full name: Stefan Froemken</p>

Tip

As explained above, you can use currentValueKey to define which value should be provided using current=1. You can access other values from the array using "field", as per the example.