‪TYPO3CMS  10.4
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor Class Reference

Public Member Functions

 __construct (array $dataMap, BackendUserAuthentication $backendUser, ReferenceIndexUpdater $referenceIndexUpdater=null)
 
array process ()
 

Static Public Member Functions

static DataMapProcessor instance (array $dataMap, BackendUserAuthentication $backendUser, ReferenceIndexUpdater $referenceIndexUpdater=null)
 

Protected Member Functions

array purgeDataMap (array $dataMap)
 
 collectItems (string $tableName, array $idValues)
 
 sanitize (array $items)
 
 enrich (array $items)
 
 sanitizeTranslationItem (DataMapItem $item)
 
 synchronizeTranslationItem (DataMapItem $item, array $fieldNames, $fromId)
 
 populateTranslationItem (DataMapItem $item)
 
 finishTranslationItem (DataMapItem $item)
 
 synchronizeFieldValues (DataMapItem $item, string $fieldName, array $fromRecord, array $forRecord)
 
 synchronizeDirectRelations (DataMapItem $item, string $fieldName, array $fromRecord)
 
 synchronizeInlineRelations (DataMapItem $item, string $fieldName, array $fromRecord, array $forRecord)
 
int[] string[] resolveSuggestedInlineRelations (DataMapItem $item, string $fieldName, array $fromRecord)
 
bool isSetInDataMap (string $tableName, $id, string $fieldName)
 
 modifyDataMap (string $tableName, $id, array $values)
 
 addNextItem (DataMapItem $item)
 
array fetchTranslationValues (string $tableName, array $fieldNames, array $ids)
 
DataMapItem[][] fetchDependencies (string $tableName, array $ids)
 
array fetchDependentIdMap (string $tableName, array $ids, int $desiredLanguage)
 
array fetchDependentElements (string $tableName, array $ids, array $fieldNames)
 
DataMapItem[] filterItemsByType (string $type, array $items)
 
int[] filterNumericIds (array $ids)
 
array filterNewItemIds (string $tableName, array $ids)
 
string[] mapRelationItemId (array $relationItems)
 
int null resolveAncestorId (array $fieldNames, array $element)
 
array buildElementAncestorIdMap (array $fieldNames, array $elements)
 
DataMapItem null findItem (string $tableName, $id)
 
array duplicateFromDataMap (string $tableName, $fromId, int $language, array $fieldNames, bool $localize)
 
array applyLocalizationReferences (string $tableName, $fromId, int $language, array $fieldNames, array $data)
 
array prefixLanguageTitle (string $tableName, $fromId, int $language, array $data)
 
string[] getFieldNamesForItemScope (DataMapItem $item, string $scope, bool $modified)
 
string[] getLocalizationModeExcludeFieldNames (string $tableName)
 
string[] getFieldNamesToBeHandled (string $tableName)
 
array getPrefixLanguageTitleFieldNames (string $tableName)
 
bool isRelationField (string $tableName, string $fieldName)
 
bool isInlineRelationField (string $tableName, string $fieldName)
 
bool isApplicable (string $tableName)
 
RelationHandler createRelationHandler ()
 
LanguageService null getLanguageService ()
 

Protected Attributes

array $allDataMap = array( )
 
array $modifiedDataMap = array( )
 
array $sanitizationMap = array( )
 
BackendUserAuthentication $backendUser
 
ReferenceIndexUpdater $referenceIndexUpdater
 
DataMapItem[] $allItems = array( )
 
DataMapItem[] $nextItems = array( )
 

Private Member Functions

int[] resolvePersistedInlineRelations (DataMapItem $item, string $fieldName, array $forRecord)
 

Detailed Description

This processor analyzes the provided data-map before actually being process in the calling DataHandler instance. Field names that are configured to have "allowLanguageSynchronization" enabled are either synchronized from there relative parent records (could be a default language record, or a l10n_source record) or to their dependent records (in case a default language record or nested records pointing upwards with l10n_source).

Except inline relational record editing, all modifications are applied to the data-map directly, which ensures proper history entries as a side-effect. For inline relational record editing, this processor either triggers the copy or localize actions by instantiation a new local DataHandler instance.

Namings in this class:

  • ‪forTableName, forId always refers to dependencies data is provided for
  • ‪fromTableName, fromId always refers to ancestors data is retrieved from

should only be used by the TYPO3 Core

Definition at line 51 of file DataMapProcessor.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::__construct ( array  $dataMap,
BackendUserAuthentication  $backendUser,
ReferenceIndexUpdater  $referenceIndexUpdater = null 
)
Parameters
array$dataMap‪The submitted data-map to be worked on
BackendUserAuthentication$backendUser‪Forwarded backend-user scope
ReferenceIndexUpdater | null$referenceIndexUpdater‪Forward reference index updater to sub DataHandler instances

Definition at line 107 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\$backendUser, and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\$referenceIndexUpdater.

Member Function Documentation

◆ addNextItem()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::addNextItem ( DataMapItem  $item)
protected
Parameters
DataMapItem$item

Definition at line 848 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems().

◆ applyLocalizationReferences()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::applyLocalizationReferences ( string  $tableName,
  $fromId,
int  $language,
array  $fieldNames,
array  $data 
)
protected

Applies localization references to given raw data-map item.

Parameters
string$tableName
string | int$fromId
int$language
array$fieldNames
array$data
Returns
‪array

Definition at line 1304 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesToBeHandled().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\duplicateFromDataMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ buildElementAncestorIdMap()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::buildElementAncestorIdMap ( array  $fieldNames,
array  $elements 
)
protected

Builds a map from ancestor ids to accordant localization dependents.

The result of e.g. [5 => [6, 7]] refers to ids 6 and 7 being dependents (either used in parent or source field) of the ancestor with id 5.

Parameters
array$fieldNames
array$elements
Returns
‪array

Definition at line 1246 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveAncestorId().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap().

◆ collectItems()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::collectItems ( string  $tableName,
array  $idValues 
)
protected

Create data map items of all affected rows

Parameters
string$tableName
array$idValues

Definition at line 179 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\addNextItem(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\build(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependencies(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchTranslationValues(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNewItemIds(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNumericIds(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\findItem(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isApplicable().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\process().

◆ createRelationHandler()

RelationHandler TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::createRelationHandler ( )
protected
Returns
‪RelationHandler

Definition at line 1540 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolvePersistedInlineRelations(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveSuggestedInlineRelations(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeDirectRelations().

◆ duplicateFromDataMap()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::duplicateFromDataMap ( string  $tableName,
  $fromId,
int  $language,
array  $fieldNames,
bool  $localize 
)
protected

Duplicates an item from data-map and prefixes language title, if applicable for the accordant field name.

Parameters
string$tableName
string | int$fromId
int$language
array$fieldNames
bool$localize
Returns
‪array
Deprecated:
‪Not used anymore, split into applyLocalizationReferences() and prefixLanguageTitle()

Definition at line 1282 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\applyLocalizationReferences(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\prefixLanguageTitle().

◆ enrich()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::enrich ( array  $items)
protected

Handle synchronization of an item list

Parameters
DataMapItem[]$items

Definition at line 262 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterItemsByType(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\finishTranslationItem(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesForItemScope(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\populateTranslationItem(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeTranslationItem().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\process().

◆ fetchDependencies()

DataMapItem [][] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::fetchDependencies ( string  $tableName,
array  $ids 
)
protected

Fetches translation dependencies for a given parent/source record ids.

Existing records in database:

  • ‪[uid:5, l10n_parent=0, l10n_source=0, sys_language_uid=0]
  • ‪[uid:6, l10n_parent=5, l10n_source=5, sys_language_uid=1]
  • ‪[uid:7, l10n_parent=5, l10n_source=6, sys_language_uid=2]

Input $ids and their results:

  • ‪[5] -> [DataMapItem(6), DataMapItem(7)] # since 5 is parent/source
  • ‪[6] -> [DataMapItem(7)] # since 6 is source
  • ‪[7] -> [] # since there's nothing
Parameters
string$tableName
int[] | string[]$ids
Returns
‪DataMapItem[][]

Definition at line 913 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\build(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentElements(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNumericIds(), TYPO3\CMS\Backend\Utility\BackendUtility\isTableLocalizable(), TYPO3\CMS\Core\DataHandling\Localization\State\STATE_PARENT, and TYPO3\CMS\Core\DataHandling\Localization\State\STATE_SOURCE.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems().

◆ fetchDependentElements()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::fetchDependentElements ( string  $tableName,
array  $ids,
array  $fieldNames 
)
protected

Fetch all elements that depend on given record id's in either their parent or source field for translatable tables or their origin field for non-translatable tables.

Parameters
string$tableName
array$ids
array$fieldNames
Returns
‪array
Exceptions

Definition at line 1075 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNumericIds().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependencies(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap().

◆ fetchDependentIdMap()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::fetchDependentIdMap ( string  $tableName,
array  $ids,
int  $desiredLanguage 
)
protected

Fetches dependent records that depend on given record id's in in either their parent or source field for translatable tables or their origin field for non-translatable tables and creates an id mapping.

This method expands the search criteria by expanding to ancestors.

Existing records in database:

  • ‪[uid:5, l10n_parent=0, l10n_source=0, sys_language_uid=0]
  • ‪[uid:6, l10n_parent=5, l10n_source=5, sys_language_uid=1]
  • ‪[uid:7, l10n_parent=5, l10n_source=6, sys_language_uid=2]

Input $ids and $desiredLanguage and their results:

  • ‪$ids=[5], $lang=1 -> [5 => 6] # since 5 is source of 6
  • ‪$ids=[5], $lang=2 -> [] # since 5 is parent of 7, but different language
  • ‪$ids=[6], $lang=1 -> [] # since there's nothing
  • ‪$ids=[6], $lang=2 -> [6 => 7] # since 6 has source 5, which is ancestor of 7
  • ‪$ids=[7], $lang=* -> [] # since there's nothing
Parameters
string$tableName
array$ids
int$desiredLanguage
Returns
‪array

Definition at line 990 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\buildElementAncestorIdMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentElements(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchTranslationValues(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNumericIds(), TYPO3\CMS\Backend\Utility\BackendUtility\isTableLocalizable(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveAncestorId().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ fetchTranslationValues()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::fetchTranslationValues ( string  $tableName,
array  $fieldNames,
array  $ids 
)
protected

Fetches translation related field values for the items submitted in the data-map.

Parameters
string$tableName
array$fieldNames
array$ids
Returns
‪array

Definition at line 866 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap().

◆ filterItemsByType()

DataMapItem [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::filterItemsByType ( string  $type,
array  $items 
)
protected

Return array of data map items that are of given type

Parameters
string$type
DataMapItem[]$items
Returns
‪DataMapItem[]

Definition at line 1156 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getType().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\sanitize().

◆ filterNewItemIds()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::filterNewItemIds ( string  $tableName,
array  $ids 
)
protected

Return only ids that don't have an item equivalent in $this->allItems.

Parameters
string$tableName
int[]$ids
Returns
‪array

Definition at line 1190 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\findItem().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems().

◆ filterNumericIds()

int [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::filterNumericIds ( array  $ids)
protected

Return only ids that are integer - so no "NEW..." values

Parameters
string[] | int[]$ids
Returns
‪int[]

Definition at line 1172 of file DataMapProcessor.php.

References TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependencies(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentElements(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ findItem()

DataMapItem null TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::findItem ( string  $tableName,
  $id 
)
protected

See if an items is in item list and return it

Parameters
string$tableName
string | int$id
Returns
‪DataMapItem|null

Definition at line 1265 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNewItemIds(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\populateTranslationItem().

◆ finishTranslationItem()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::finishTranslationItem ( DataMapItem  $item)
protected

Finishes a translation item by updating states to be persisted.

Parameters
DataMapItem$item

Definition at line 394 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\State\export(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getState(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\State\isApplicable(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\isParentType().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich().

◆ getFieldNamesForItemScope()

string [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::getFieldNamesForItemScope ( DataMapItem  $item,
string  $scope,
bool  $modified 
)
protected

Field names we have to deal with

Parameters
DataMapItem$item
string$scope
bool$modified
Returns
‪string[]

Definition at line 1383 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\State\filterFieldNames(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getLocalizationModeExcludeFieldNames(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getState(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\State\isApplicable(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_EXCLUDE, TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_PARENT, and TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_SOURCE.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\populateTranslationItem(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\sanitizeTranslationItem().

◆ getFieldNamesToBeHandled()

string [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::getFieldNamesToBeHandled ( string  $tableName)
protected

Gets a list of field names which have to be handled. Basically this includes fields using allowLanguageSynchronization or l10n_mode=exclude.

Parameters
string$tableName
Returns
‪string[]

Definition at line 1436 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\State\getFieldNames(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getLocalizationModeExcludeFieldNames().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\applyLocalizationReferences().

◆ getLanguageService()

LanguageService null TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::getLanguageService ( )
protected
Returns
‪LanguageService|null

Definition at line 1550 of file DataMapProcessor.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\prefixLanguageTitle().

◆ getLocalizationModeExcludeFieldNames()

string [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::getLocalizationModeExcludeFieldNames ( string  $tableName)
protected

Field names of TCA table with columns having l10n_mode=exclude

Parameters
string$tableName
Returns
‪string[]

Definition at line 1411 of file DataMapProcessor.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesForItemScope(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesToBeHandled(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isApplicable().

◆ getPrefixLanguageTitleFieldNames()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::getPrefixLanguageTitleFieldNames ( string  $tableName)
protected

Field names of TCA table with columns having l10n_mode=prefixLangTitle

Parameters
string$tableName
Returns
‪array

Definition at line 1450 of file DataMapProcessor.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\prefixLanguageTitle().

◆ instance()

static DataMapProcessor TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::instance ( array  $dataMap,
BackendUserAuthentication  $backendUser,
ReferenceIndexUpdater  $referenceIndexUpdater = null 
)
static

Class generator

Parameters
array$dataMap‪The submitted data-map to be worked on
BackendUserAuthentication$backendUser‪Forwarded backend-user scope
ReferenceIndexUpdater | null$referenceIndexUpdater‪Forward reference index updater to sub DataHandler instances
Returns
‪DataMapProcessor

Definition at line 89 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\$backendUser, and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\$referenceIndexUpdater.

Referenced by TYPO3\CMS\Core\DataHandling\DataHandler\process_datamap().

◆ isApplicable()

bool TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::isApplicable ( string  $tableName)
protected

Determines whether the table can be localized and either has fields with allowLanguageSynchronization enabled or l10n_mode set to exclude.

Parameters
string$tableName
Returns
‪bool

Definition at line 1528 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getLocalizationModeExcludeFieldNames(), TYPO3\CMS\Core\DataHandling\Localization\State\isApplicable(), and TYPO3\CMS\Backend\Utility\BackendUtility\isTableLocalizable().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems().

◆ isInlineRelationField()

bool TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::isInlineRelationField ( string  $tableName,
string  $fieldName 
)
protected

True if we're dealing with an inline field

Parameters
string$tableName
string$fieldName
Returns
‪bool TRUE if field is of type inline with foreign_table set

Definition at line 1506 of file DataMapProcessor.php.

References $GLOBALS.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isRelationField(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

◆ isRelationField()

bool TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::isRelationField ( string  $tableName,
string  $fieldName 
)
protected

True if we're dealing with a field that has foreign db relations

Parameters
string$tableName
string$fieldName
Returns
‪bool True if field is type=group with internalType === db or select with foreign_table

Definition at line 1477 of file DataMapProcessor.php.

References $GLOBALS, and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isInlineRelationField().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

◆ isSetInDataMap()

bool TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::isSetInDataMap ( string  $tableName,
  $id,
string  $fieldName 
)
protected

Determines whether a combination of table name, id and field name is set in data-map. This method considers null values as well, that would not be considered by a plain isset() invocation.

Parameters
string$tableName
string | int$id
string$fieldName
Returns
‪bool

Definition at line 793 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveSuggestedInlineRelations(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeDirectRelations(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

◆ mapRelationItemId()

string [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::mapRelationItemId ( array  $relationItems)
protected

Flatten array

Parameters
array$relationItems
Returns
‪string[]

Definition at line 1206 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolvePersistedInlineRelations(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveSuggestedInlineRelations().

◆ modifyDataMap()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::modifyDataMap ( string  $tableName,
  $id,
array  $values 
)
protected

Applies modifications to the data-map, calling this method is essential to determine new data-map items to be process for synchronizing chained record localizations.

Parameters
string$tableName
string | int$id
array$values
Exceptions

Definition at line 814 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeDirectRelations(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ populateTranslationItem()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::populateTranslationItem ( DataMapItem  $item)
protected

Populates values downwards, either from a parent language item or a source language item to an accordant dependent translation item.

Parameters
DataMapItem$item

Definition at line 361 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\findDependencies(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\findItem(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesForItemScope(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_EXCLUDE, TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_PARENT, TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\SCOPE_SOURCE, and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeTranslationItem().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich().

◆ prefixLanguageTitle()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::prefixLanguageTitle ( string  $tableName,
  $fromId,
int  $language,
array  $data 
)
protected

Prefixes language title if applicable for the accordant field name in raw data-map item.

Parameters
string$tableName
string | int$fromId
int$language
array$data
Returns
‪array

Definition at line 1340 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getLanguageService(), TYPO3\CMS\Backend\Utility\BackendUtility\getPagesTSconfig(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getPrefixLanguageTitleFieldNames(), TYPO3\CMS\Backend\Utility\BackendUtility\getRecord(), and TYPO3\CMS\Backend\Utility\BackendUtility\getTSCpid().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\duplicateFromDataMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ process()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::process ( )

Processes the submitted data-map and returns the sanitized and enriched version depending on accordant localization states and dependencies.

Returns
‪array

Definition at line 127 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\$allDataMap, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\collectItems(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\purgeDataMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\sanitize().

Referenced by TYPO3\CMS\Core\DataHandling\DataHandler\process_datamap().

◆ purgeDataMap()

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::purgeDataMap ( array  $dataMap)
protected

Purges superfluous empty data-map sections.

Parameters
array$dataMap
Returns
‪array

Definition at line 158 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\process().

◆ resolveAncestorId()

int null TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::resolveAncestorId ( array  $fieldNames,
array  $element 
)
protected
Parameters
array<string,string>‪$fieldNames
array<string,mixed>‪$element
Returns
‪int|null either a (non-empty) ancestor uid, or null if unresolved

Definition at line 1221 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\buildElementAncestorIdMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap().

◆ resolvePersistedInlineRelations()

int [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::resolvePersistedInlineRelations ( DataMapItem  $item,
string  $fieldName,
array  $forRecord 
)
private

Determine persisted inline relations for current data-map-item.

Parameters
DataMapItem$item
string$fieldName
array$forRecord
Returns
‪int[]

Definition at line 759 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\createRelationHandler(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\isNew(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\mapRelationItemId().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ resolveSuggestedInlineRelations()

int [] string [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::resolveSuggestedInlineRelations ( DataMapItem  $item,
string  $fieldName,
array  $fromRecord 
)
protected

Determines suggest inline relations of either translation parent or source record from data-map or storage in case records have been persisted already.

Parameters
DataMapItem$item
string$fieldName
array$fromRecord
Returns
‪int[]|string[]

Definition at line 718 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\createRelationHandler(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isSetInDataMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\mapRelationItemId(), and TYPO3\CMS\Core\Utility\GeneralUtility\trimExplode().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

◆ sanitize()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::sanitize ( array  $items)
protected

Sanitizes the submitted data-map items and removes fields which are not defined as custom and thus rely on either parent or source values.

Parameters
DataMapItem[]$items

Definition at line 248 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterItemsByType(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\sanitizeTranslationItem().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\process().

◆ sanitizeTranslationItem()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::sanitizeTranslationItem ( DataMapItem  $item)
protected

Sanitizes the submitted data-map for a particular item and removes fields which are not defined as custom and thus rely on either parent or source values.

Parameters
DataMapItem$item

Definition at line 287 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getApplicableScopes(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\getFieldNamesForItemScope(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\sanitize().

◆ synchronizeDirectRelations()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::synchronizeDirectRelations ( DataMapItem  $item,
string  $fieldName,
array  $fromRecord 
)
protected

Synchronize select and group field localizations

Parameters
DataMapItem$item
string$fieldName
array$fromRecord

Definition at line 456 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\createRelationHandler(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isSetInDataMap(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\modifyDataMap().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

◆ synchronizeFieldValues()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::synchronizeFieldValues ( DataMapItem  $item,
string  $fieldName,
array  $fromRecord,
array  $forRecord 
)
protected

Synchronize simple values like text and similar

Parameters
DataMapItem$item
string$fieldName
array$fromRecord
array$forRecord

Definition at line 414 of file DataMapProcessor.php.

References TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isInlineRelationField(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isRelationField(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\isSetInDataMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\modifyDataMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeDirectRelations(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeInlineRelations().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeTranslationItem().

◆ synchronizeInlineRelations()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::synchronizeInlineRelations ( DataMapItem  $item,
string  $fieldName,
array  $fromRecord,
array  $forRecord 
)
protected

Handle synchronization of inline relations. Inline Relational Record Editing ("IRRE") always is modelled as 1:n composite relation - which means that direct(!) children cannot exist without their parent. Removing a relative parent results in cascaded removal of all direct(!) children as well.

Parameters
DataMapItem$item
string$fieldName
array$fromRecord
array$forRecord
Exceptions

Definition at line 529 of file DataMapProcessor.php.

References $GLOBALS, TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\applyLocalizationReferences(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\fetchDependentIdMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\filterNumericIds(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getLanguage(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\Utility\StringUtility\getUniqueId(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\isNew(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\modifyDataMap(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\prefixLanguageTitle(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolvePersistedInlineRelations(), TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\resolveSuggestedInlineRelations(), and TYPO3\CMS\Core\Utility\GeneralUtility\trimExplode().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

◆ synchronizeTranslationItem()

TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::synchronizeTranslationItem ( DataMapItem  $item,
array  $fieldNames,
  $fromId 
)
protected

Synchronize a single item

Parameters
DataMapItem$item
array$fieldNames
string | int$fromId

Definition at line 317 of file DataMapProcessor.php.

References TYPO3\CMS\Core\Utility\MathUtility\canBeInterpretedAsInteger(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getId(), TYPO3\CMS\Backend\Utility\BackendUtility\getRecordWSOL(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\getTableName(), TYPO3\CMS\Core\DataHandling\Localization\DataMapItem\isNew(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\synchronizeFieldValues().

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\enrich(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\populateTranslationItem().

Member Data Documentation

◆ $allDataMap

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$allDataMap = array( )
protected

Definition at line 55 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\process().

◆ $allItems

DataMapItem [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$allItems = array( )
protected

Definition at line 75 of file DataMapProcessor.php.

◆ $backendUser

BackendUserAuthentication TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$backendUser
protected

Definition at line 67 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\__construct(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\instance().

◆ $modifiedDataMap

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$modifiedDataMap = array( )
protected

Definition at line 59 of file DataMapProcessor.php.

◆ $nextItems

DataMapItem [] TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$nextItems = array( )
protected

Definition at line 79 of file DataMapProcessor.php.

◆ $referenceIndexUpdater

ReferenceIndexUpdater TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$referenceIndexUpdater
protected

Definition at line 71 of file DataMapProcessor.php.

Referenced by TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\__construct(), and TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor\instance().

◆ $sanitizationMap

array TYPO3\CMS\Core\DataHandling\Localization\DataMapProcessor::$sanitizationMap = array( )
protected

Definition at line 63 of file DataMapProcessor.php.