SplitProcessor¶

The SplitProcessor allows split values separated with a delimiter inside a single database field to be put into an array and looped over. Whitespaces will be automatically trimmed.

Options:¶

if¶

Required:	false
Type:	if condition
Default:	’’

If the condition is not met the data is not processed

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’s 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 an 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 splitted 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: