def

Returns a given default value for a variable in case the variable is not defined or empty.

@{ variable | def (value) }

Parameters

value: The default value to be returned in case the variable is not defined or empty.

Example

The following example demonstrates a standard use case for providing a default value. Let's assume a pagelist is sorted by the query string paramter sort. In case there is no query string parameters defined, the list is sorted by date desc — in other words "recent first".

<@ newPagelist {  
  sort: @{ ?sort | def ('date desc') }
} @>

dateFormat escape

The ceil filter rounds a variable up to the next highest integer value. This is useful when you need to ensure a number is always rounded up to the nearest whole number, regardless of its decimal portion. The filter requires no additional parameters.

Formats a date variable using a specified format string. The format string must be a valid DateTime format. Month and weekday names are automatically translated based on a given locale. To reference the current date, use the :now variable.

Escapes a string to be safely used in JSON formatted data or similar. This function doesn't expect any parameters.

Finds the first img tag in a rendered HTML string and returns the src attribute. This function can be used to extract the first image form a block variable to be used separately in any other place like a teaser section of a page card in a pagelist.

findFirstParagraph

Finds the first paragraph tag in a rendered HTML string and returns its content. This function can be used to extract the first text block form a block variable to be used separately as a teaser text for the page in a pagelist.

The floor filter rounds a variable down to the next lowest integer value. This is useful when you need to ensure a number is always rounded down to the nearest whole number, regardless of its decimal portion. The filter requires no additional parameters beyond the variable being processed.

Returns a rounded value of a variable as integer. This function doesn't expect any parameters.

Sanitizes a string for use in URLs or HTML attributes. The resulting string contains only lowercase letters a-z, numbers 0-9, hyphens -, and optionally dots .. This method is also suitable for filenames, as it preserves dots as file extension separators by default.