process-variables

Class: \CPSIT\Typo3Handlebars\DataProcessing\ProcessVariablesProcessor

Processes a variables configuration block — exactly like the top-level variables of HANDLEBARSTEMPLATE — within a data processor chain. This is most useful when combined with other processors such as database-query, allowing per-record variable processing.

Data sources

All options are read from this processor's own configuration block. table additionally falls back to a same-named key in processedData, and finally to the table of the current content object.

The preProcessing and postProcessing hooks have access to all data sources (see DataSourceAwareProcessor).

Choosing which record to process

By default, the field option of a variables entry resolves against the current content element's own record. Configure dataSource (or an inline data array) to process a different record or array instead — see Referencing data for how it is resolved, and Using the current value for dataSource.current. If the resolved payload is not an array, it is ignored and the current record's own field values are used instead.

Standalone usage

tt_content.my_element = HANDLEBARSTEMPLATE
tt_content.my_element {
    templateName = MyElement

    dataProcessing {
        10 = process-variables
        10 {
            variables {
                header = TEXT
                header.field = header

                teaser = TEXT
                teaser.field = bodytext
                teaser.parseFunc =< lib.parseFunc_RTE
            }
        }
    }
}

Nested inside another processor

dataProcessing {
    10 = database-query
    10 {
        table = tx_myext_domain_model_item
        as = items

        dataProcessing {
            10 = process-variables
            10 {
                as = item
                variables {
                    title = TEXT
                    title.field = title

                    body = TEXT
                    body.field = bodytext
                    body.parseFunc =< lib.parseFunc_RTE
                }
            }
        }
    }
}

Properties

variables: Variables to process. Same syntax as the top-level variables in HANDLEBARSTEMPLATE.
table: Database table of the record to use as the data source for field lookups. Defaults to the current table in content object renderer.
data: Inline data used as the field-lookup source for variables, if dataSource is not configured (see Choosing which record to process).
dataSource: Data source(s) to use as the field-lookup source for variables, instead of the current record (see Choosing which record to process).
as: Target key in the processed data array. When set, the processed variables are stored under this key. When omitted, the processed variables replace (or merge into) the root of the processed data.
merge: Boolean. When 1 and as is omitted, the processed variables are merged into the existing processed data rather than replacing it. When as is set and the key already holds an array, the processed variables are merged into that array. Default: 0.
if: Standard TypoScript if condition. When the condition evaluates to false, the processor is skipped and the processed data is returned unchanged.
preProcessing: Data source aware processors run before variables are processed.
postProcessing: Data source aware processors run after variables are processed.