Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

if

The if function is perhaps the most difficult of all TypoScript functions. It does not work like the "if" construct known from most programming language and is thus very open to misuse. Hopefully the examples below will help you get it right.

Generally the if function returns true, if all conditions are fulfilled. This resembles a boolean AND combination. If what we would like returned is a false value, we can use the negate option to negate the result:

10 = TEXT
10 {

    # Content of the TEXT object.
    value = The L parameter is passed as GET variable.

    # Results in "true" and leads to rendering of the upper value, if the
    # GET/POST parameter is passed with a value, which is not 0.
    stdWrap.if.isTrue.data = GP:L
}

With the use of if it is also possible to compare values. For this purpose we use value property:

10 = TEXT
10 {

    # WARNING: This value resembles the value of the TEXT object, not that of the "if"!
    value = 3 is bigger than 2.

    # Compare parameter of the "if" function.
    stdWrap.if.value = 2

    # Please note: The sorting order is "backwards",
    # returning the sentence "3 is bigger than 2".
    stdWrap.if.isGreaterThan = 3
}

Because the properties of the if function implement stdWrap functions, all kinds of variables can be compared:

10 = TEXT
10 {
    # Value of the TEXT object.
    value = The record can be shown, because the starting date has passed.

    # Condition of the if clause (number of seconds since January 1st, 1970).
    stdWrap.if.value.data = date:U

    # Condition backwards again: Start time isLessThan date:U.
    stdWrap.if.isLessThan.field = starttime
}