SplitProcessor

The SplitProcessor allows to split values separated with a delimiter from a single database field. The result is an array that can be iterated over. Whitespaces are automatically trimmed.

Options

if
Required

false

Type

if condition

Default

''

Only if the condition is met the data processor is executed.

fieldName
Required

true

Type

string, stdWrap

Default

''

Name of the field to be used.

as
Required

false

Type

string

Default

defaults to the fieldName

The variable name to be used in the Fluid template.

delimiter
Required

false

Type

string(1), stdWrap

Default

Line Feed

Example

","

The field delimiter, a character separating the values.

filterIntegers
Required

false

Type

bool, stdWrap

Default

false

Example

true

If set to true, all values are being cast to int.

filterUnique
Required

false

Type

bool, stdWrap

Default

false

Example

true

All duplicates will be removed.

removeEmptyEntries
Required

false

Type

bool, stdWrap

Default

false

Example

true

All empty values will be removed.

Example: Splitting a URL

Please see also About the examples.

TypoScript

With the help of the SplitProcessor the following scenario is possible:

EXT:examples/Configuration/TypoScript/DataProcessors/Processors/SplitProcessor.typoscript
tt_content {
   examples_dataprocsplit =< lib.contentElement
   examples_dataprocsplit {
      templateName = DataProcSplit
      dataProcessing.10 = TYPO3\CMS\Frontend\DataProcessing\SplitProcessor
      dataProcessing.10 {
         as = urlParts
         delimiter = /
         fieldName = header_link
         removeEmptyEntries = 0
         filterIntegers = 0
         filterUnique = 0
      }
   }
}

The Fluid template

In the Fluid template then iterate over the split data:

EXT:examples/Resources/Private/Templates/ContentElements/DataProcSplit.html
<html data-namespace-typo3-fluid="true" xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers">
   <h2>Data in variable urlParts</h2>
   <f:debug inline="true">{urlParts}</f:debug>

   <h2>Output</h2>
   <f:for each="{urlParts}" as="part" iteration="i">
      <span class="text-primary">{part}</span>
      <f:if condition="{i.isLast} == false">/</f:if>
   </f:for>

</html>

Output

The array now contains the split strings:

../../../_images/SplitProcessor.png