Attention

TYPO3 v9 has reached its end-of-life September 30th, 2021 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.

if

Allows you to check multiple conditions.

This function returns true, if ALL of the present conditions are met (they are connected with an "AND", a logical conjunction). If a single condition is false, the value returned is false.

The returned value may still be negated by the negate-property.

There is no else property available. The else branch of an if statement is a missing feature. You can implement a workaround by a logic based on the Override and conditions .

Also check the explanations and the examples further below!

directReturn

Property

directReturn

Data type

boolean

Description

If this property exists, no other conditions will be checked. Instead the true/false of this value is returned. Can be used to set true/false with a TypoScript constant.

isNull

Property

isNull

Data type

stdWrap

Description

If the resulting content of the stdWrap is null (NULL type in PHP).

Since null values cannot be assigned in TypoScript, only the stdWrap features are available below this property.

Example
page.10 = COA_INT
page.10.10 = TEXT
page.10.10 {
      stdWrap.if.isNull.field = description
      value = No description available.
}

This example returns "No description available.", if the content of the field "description" is NULL.

isTrue

Property

isTrue

Data type

string / stdWrap

Description

If the content is "true", which is not empty string and not zero.

isFalse

Property

isFalse

Data type

string / stdWrap

Description

If the content is "false", which is empty or zero.

isPositive

Property

isPositive

Data type

integer / stdWrap + Calc

Description

Returns true, if the content is positive.

isGreaterThan

Property

isGreaterThan

Data type

value / stdWrap

Description

Returns true, if the content is greater than value.

isLessThan

Property

isLessThan

Data type

value / stdWrap

Description

Returns true, if the content is less than value.

equals

Property

equals

Data type

value / stdWrap

Description

Returns true, if the content is equal to value.

Example
if.equals = POST
if.value.data = GETENV:REQUEST_METHOD

isInList

Property

isInList

Data type

value / stdWrap

Description

Returns true, if the content is in the comma-separated list .value.

Note: The list in value may not have spaces between elements!

Example
if.isInList.field = uid
if.value = 1,2,34,50,87

This returns true, if the uid is part of the list in value.

value

Property

value

Data type

value / stdWrap

Description

The value to check. This is the comparison value mentioned above.

negate

Property

negate

Data type

boolean

Description

This property is checked after all other properties. If set, it negates the result, which is present before its execution.

So if all other conditions, which were used, returned true, with this property the overall return ends up being false. If at least one of the other conditions, which were used, returned false, the overall return ends up being true.

Default

0

Explanation

The "if"-function is a very odd way of returning true or false! Beware!

"if" is normally used to decide whether to render an object or to return a value (see the cObject and stdWrap).

Here is how it works:

The function returns true or false. Whether it returns true or false depends on the properties of this function. Say if you set isTrue = 1 then the result is true. If you set isTrue.field = header, the function returns true if the field "header" in $cObj->data is set!

If you want to compare values, you must load a base-value in the value-property. Example:

.value = 10
.isGreaterThan = 11

This would return true because the value of isGreaterThan is greater than 10, which is the base-value.

More complex is this:

.value = 10
.isGreaterThan = 11
.isTrue.field = header
.negate = 1

There are two conditions - isGreaterThan and isTrue. If they are both true, the total is true (both are connected with an AND). BUT(!) then the result of the function in total would be false because the negate-flag inverts the result!

Examples

This is a GIFBUILDER object that will write "NEW" on a menu-item if the field "newUntil" has a date less than the current date!

30 = TEXT
30.text = NEW!
30.offset = 10,10
30.if {
    value.data = date: U
    isLessThan.field = newUntil
    negate = 1
}