SingleFieldContainer.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Backend\Form\Container;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

use TYPO3\CMS\Backend\Form\InlineStackProcessor;
use TYPO3\CMS\Backend\Form\Utility\FormEngineUtility;
use TYPO3\CMS\Backend\Utility\BackendUtility;
use TYPO3\CMS\Core\Authentication\BackendUserAuthentication;
use TYPO3\CMS\Core\Imaging\Icon;
use TYPO3\CMS\Core\Imaging\IconFactory;
use TYPO3\CMS\Core\Type\Bitmask\JsConfirmation;
use TYPO3\CMS\Core\Utility\DiffUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Utility\MathUtility;
use TYPO3\CMS\Lang\LanguageService;

class SingleFieldContainer extends AbstractContainer
{
    public function render()
    {
        $backendUser = $this->getBackendUserAuthentication();
        $languageService = $this->getLanguageService();
        $resultArray = $this->initializeResultArray();

        $table = $this->data['tableName'];
        $row = $this->data['databaseRow'];
        $fieldName = $this->data['fieldName'];

        // @todo: it should be safe at this point, this array exists ...
        if (!is_array($this->data['processedTca']['columns'][$fieldName])) {
            return $resultArray;
        }

        $parameterArray = [];
        $parameterArray['fieldConf'] = $this->data['processedTca']['columns'][$fieldName];

        $isOverlay = false;

        // This field decides whether the current record is an overlay (as opposed to being a standalone record)
        // Based on this decision we need to trigger field exclusion or special rendering (like readOnly)
        if (isset($this->data['processedTca']['ctrl']['transOrigPointerField'])
            && is_array($this->data['processedTca']['columns'][$this->data['processedTca']['ctrl']['transOrigPointerField']])
        ) {
            $parentValue = $row[$this->data['processedTca']['ctrl']['transOrigPointerField']];
            if (MathUtility::canBeInterpretedAsInteger($parentValue)) {
                $isOverlay = (bool)$parentValue;
            } elseif (is_array($parentValue)) {
                // This case may apply if the value has been converted to an array by the select data provider
                $isOverlay = !empty($parentValue) ? (bool)$parentValue[0] : false;
            } elseif (is_string($parentValue) && $parentValue !== '') {
                // This case may apply if a group definition is used in TCA and the group provider builds a weird string
                $recordsReferencedInField = GeneralUtility::trimExplode(',', $parentValue);
                // Pick the first record because if you set multiple records you're in trouble anyways
                $recordIdentifierParts = GeneralUtility::trimExplode('|', $recordsReferencedInField[0]);
                list(, $refUid) = BackendUtility::splitTable_Uid($recordIdentifierParts[0]);
                $isOverlay = MathUtility::canBeInterpretedAsInteger($refUid) ? (bool)$refUid : false;
            } else {
                throw new \InvalidArgumentException('The given value for the original language field '
                                                    . $this->data['processedTca']['ctrl']['transOrigPointerField']
                                                    . ' of table ' . $table . ' contains an invalid value.', 1470742770);
            }
        }

        // A couple of early returns in case the field should not be rendered
        // Check if this field is configured and editable according to exclude fields and other configuration
        if (// Return if BE-user has no access rights to this field, @todo: another user access rights check!
            $parameterArray['fieldConf']['exclude'] && !$backendUser->check('non_exclude_fields', $table . ':' . $fieldName)
            || $parameterArray['fieldConf']['config']['type'] === 'passthrough'
            // @todo: Drop option "showIfRTE" ?
            || !$backendUser->isRTE() && $parameterArray['fieldConf']['config']['showIfRTE']
            // Return if field should not be rendered in translated records
            || $isOverlay && empty($parameterArray['fieldConf']['l10n_display']) && $parameterArray['fieldConf']['l10n_mode'] === 'exclude'
            // @todo: localizationMode still needs handling!
            || $isOverlay && $this->data['localizationMode'] && $this->data['localizationMode'] !== $parameterArray['fieldConf']['l10n_cat']
            || $this->inlineFieldShouldBeSkipped()
        ) {
            return $resultArray;
        }

        $parameterArray['fieldTSConfig'] = [];
        if (isset($this->data['pageTsConfig']['TCEFORM.'][$table . '.'][$fieldName . '.'])
            && is_array($this->data['pageTsConfig']['TCEFORM.'][$table . '.'][$fieldName . '.'])
        ) {
            $parameterArray['fieldTSConfig'] = $this->data['pageTsConfig']['TCEFORM.'][$table . '.'][$fieldName . '.'];
        }
        if ($parameterArray['fieldTSConfig']['disabled']) {
            return $resultArray;
        }

        // Override fieldConf by fieldTSconfig:
        $parameterArray['fieldConf']['config'] = FormEngineUtility::overrideFieldConf($parameterArray['fieldConf']['config'], $parameterArray['fieldTSConfig']);
        $parameterArray['itemFormElName'] = 'data[' . $table . '][' . $row['uid'] . '][' . $fieldName . ']';
        $parameterArray['itemFormElID'] = 'data_' . $table . '_' . $row['uid'] . '_' . $fieldName;
        $newElementBaseName = $this->data['elementBaseName'] . '[' . $table . '][' . $row['uid'] . '][' . $fieldName . ']';

        // The value to show in the form field.
        $parameterArray['itemFormElValue'] = $row[$fieldName];
        // Set field to read-only if configured for translated records to show default language content as readonly
        if ($parameterArray['fieldConf']['l10n_display']
            && GeneralUtility::inList($parameterArray['fieldConf']['l10n_display'], 'defaultAsReadonly')
            && $isOverlay
        ) {
            $parameterArray['fieldConf']['config']['readOnly'] = true;
            $parameterArray['itemFormElValue'] = $this->data['defaultLanguageRow'][$fieldName];
        }

        if (strpos($this->data['processedTca']['ctrl']['type'], ':') === false) {
            $typeField = $this->data['processedTca']['ctrl']['type'];
        } else {
            $typeField = substr($this->data['processedTca']['ctrl']['type'], 0, strpos($this->data['processedTca']['ctrl']['type'], ':'));
        }
        // Create a JavaScript code line which will ask the user to save/update the form due to changing the element.
        // This is used for eg. "type" fields and others configured with "requestUpdate"
        if (!empty($this->data['processedTca']['ctrl']['type'])
            && $fieldName === $typeField
            || !empty($this->data['processedTca']['ctrl']['requestUpdate'])
            && GeneralUtility::inList(str_replace(' ', '', $this->data['processedTca']['ctrl']['requestUpdate']), $fieldName)
        ) {
            if ($backendUser->jsConfirmation(JsConfirmation::TYPE_CHANGE)) {
                $alertMsgOnChange = 'top.TYPO3.Modal.confirm(TBE_EDITOR.labels.refreshRequired.title, TBE_EDITOR.labels.refreshRequired.content).on("button.clicked", function(e) { if (e.target.name == "ok" && TBE_EDITOR.checkSubmit(-1)) { TBE_EDITOR.submitForm() } top.TYPO3.Modal.dismiss(); });';
            } else {
                $alertMsgOnChange = 'if (TBE_EDITOR.checkSubmit(-1)){ TBE_EDITOR.submitForm() };';
            }
        } else {
            $alertMsgOnChange = '';
        }

        // JavaScript code for event handlers:
        $parameterArray['fieldChangeFunc'] = [];
        $parameterArray['fieldChangeFunc']['TBE_EDITOR_fieldChanged'] = 'TBE_EDITOR.fieldChanged(' . GeneralUtility::quoteJSvalue($table) . ',' . GeneralUtility::quoteJSvalue($row['uid']) . ',' . GeneralUtility::quoteJSvalue($fieldName) . ',' . GeneralUtility::quoteJSvalue($parameterArray['itemFormElName']) . ');';
        if ($alertMsgOnChange) {
            $parameterArray['fieldChangeFunc']['alert'] = $alertMsgOnChange;
        }

        // If this is the child of an inline type and it is the field creating the label
        if ($this->isInlineChildAndLabelField($table, $fieldName)) {
            $inlineStackProcessor = GeneralUtility::makeInstance(InlineStackProcessor::class);
            $inlineStackProcessor->initializeByGivenStructure($this->data['inlineStructure']);
            $inlineDomObjectId = $inlineStackProcessor->getCurrentStructureDomObjectIdPrefix($this->data['inlineFirstPid']);
            $inlineObjectId = implode(
                '-',
                [
                    $inlineDomObjectId,
                    $table,
                    $row['uid']
                ]
            );
            $parameterArray['fieldChangeFunc']['inline'] = 'inline.handleChangedField(' . GeneralUtility::quoteJSvalue($parameterArray['itemFormElName']) . ',' . GeneralUtility::quoteJSvalue($inlineObjectId) . ');';
        }

        // Based on the type of the item, call a render function on a child element
        $options = $this->data;
        $options['parameterArray'] = $parameterArray;
        $options['elementBaseName'] = $newElementBaseName;
        if (!empty($parameterArray['fieldConf']['config']['renderType'])) {
            $options['renderType'] = $parameterArray['fieldConf']['config']['renderType'];
        } else {
            // Fallback to type if no renderType is given
            $options['renderType'] = $parameterArray['fieldConf']['config']['type'];
        }
        $resultArray = $this->nodeFactory->create($options)->render();

        // If output is empty stop further processing.
        // This means there was internal processing only and we don't need to add additional information
        if (empty($resultArray['html'])) {
            return $resultArray;
        }

        $html = $resultArray['html'];

        // @todo: the language handling, the null and the placeholder stuff should be embedded in the single
        // @todo: element classes. Basically, this method should return here and have the element classes
        // @todo: decide on language stuff and other wraps already.

        // Add language + diff
        $renderLanguageDiff = true;
        if ($parameterArray['fieldConf']['l10n_display'] && (GeneralUtility::inList($parameterArray['fieldConf']['l10n_display'], 'hideDiff')
            || GeneralUtility::inList($parameterArray['fieldConf']['l10n_display'], 'defaultAsReadonly'))
        ) {
            $renderLanguageDiff = false;
        }
        if ($renderLanguageDiff) {
            $html = $this->renderDefaultLanguageContent($table, $fieldName, $row, $html);
            $html = $this->renderDefaultLanguageDiff($table, $fieldName, $row, $html);
        }

        $fieldItemClasses = [
            't3js-formengine-field-item'
        ];

        // NULL value and placeholder handling
        $nullControlNameEscaped = htmlspecialchars('control[active][' . $table . '][' . $row['uid'] . '][' . $fieldName . ']');
        if (!empty($parameterArray['fieldConf']['config']['eval']) && GeneralUtility::inList($parameterArray['fieldConf']['config']['eval'], 'null')
            && (empty($parameterArray['fieldConf']['config']['mode']) || $parameterArray['fieldConf']['config']['mode'] !== 'useOrOverridePlaceholder')
        ) {
            // This field has eval=null set, but has no useOverridePlaceholder defined.
            // Goal is to have a field that can distinct between NULL and empty string in the database.
            // A checkbox and an additional hidden field will be created, both with the same name
            // and prefixed with "control[active]". If the checkbox is set (value 1), the value from the casual
            // input field will be written to the database. If the checkbox is not set, the hidden field
            // transfers value=0 to DataHandler, the value of the input field will then be reset to NULL by the
            // DataHandler at an early point in processing, so NULL will be written to DB as field value.

            // If the value of the field *is* NULL at the moment, an additional class is set
            // @todo: This does not work well at the moment, but is kept for now. see input_14 of ext:styleguide as example
            $checked = ' checked="checked"';
            if ($this->data['databaseRow'][$fieldName] === null) {
                $fieldItemClasses[] = 'disabled';
                $checked = '';
            }

            $formElementName = 'data[' . $table . '][' . $row['uid'] . '][' . $fieldName . ']';
            $onChange = htmlspecialchars(
                'typo3form.fieldSetNull(' . GeneralUtility::quoteJSvalue($formElementName) . ', !this.checked)'
            );

            $nullValueWrap = [];
            $nullValueWrap[] = '<div class="' . implode(' ', $fieldItemClasses) . '">';
            $nullValueWrap[] =    '<div class="t3-form-field-disable"></div>';
            $nullValueWrap[] =    '<div class="checkbox t3-form-field-eval-null-checkbox">';
            $nullValueWrap[] =        '<label for="' . $nullControlNameEscaped . '">';
            $nullValueWrap[] =            '<input type="hidden" name="' . $nullControlNameEscaped . '" value="0" />';
            $nullValueWrap[] =            '<input type="checkbox" name="' . $nullControlNameEscaped . '" id="' . $nullControlNameEscaped . '" value="1" onchange="' . $onChange . '"' . $checked . ' /> &nbsp;';
            $nullValueWrap[] =        '</label>';
            $nullValueWrap[] =    '</div>';
            $nullValueWrap[] =    $html;
            $nullValueWrap[] = '</div>';

            $html = implode(LF, $nullValueWrap);
        } elseif (isset($parameterArray['fieldConf']['config']['mode']) && $parameterArray['fieldConf']['config']['mode'] === 'useOrOverridePlaceholder') {
            // This field has useOverridePlaceholder set.
            // Here, a value from a deeper DB structure can be "fetched up" as value, and can also be overridden by a
            // local value. This is used in FAL, where eg. the "title" field can have the default value from sys_file_metadata,
            // the title field of sys_file_reference is then set to NULL. Or the "override" checkbox is set, and a string
            // or an empty string is then written to the field of sys_file_reference.
            // The situation is similar to the NULL handling above, but additionally a "default" value should be shown.
            // To achieve this, again a hidden control[hidden] field is added together with a checkbox with the same name
            // to transfer the information whether the default value should be used or not: Checkbox checked transfers 1 as
            // value in control[active], meaning the overridden value should be used.
            // Additionally to the casual input field, a second field is added containing the "placeholder" value. This
            // field has no name attribute and is not transferred at all. Those two are then hidden / shown depending
            // on the state of the above checkbox in via JS.

            $placeholder = empty($parameterArray['fieldConf']['config']['placeholder']) ? '' : $parameterArray['fieldConf']['config']['placeholder'];
            $onChange = 'typo3form.fieldTogglePlaceholder(' . GeneralUtility::quoteJSvalue($parameterArray['itemFormElName']) . ', !this.checked)';
            $checked = $parameterArray['itemFormElValue'] === null ? '' : ' checked="checked"';

            $resultArray['additionalJavaScriptPost'][] = 'typo3form.fieldTogglePlaceholder('
                . GeneralUtility::quoteJSvalue($parameterArray['itemFormElName']) . ', ' . ($checked ? 'false' : 'true') . ');';

            // Renders an input or textarea field depending on type of "parent"
            $options = [];
            $options['databaseRow'] = [];
            $options['table'] = '';
            $options['parameterArray'] = $parameterArray;
            $options['parameterArray']['itemFormElValue'] = GeneralUtility::fixed_lgd_cs($placeholder, 30);
            $options['renderType'] = 'none';
            $noneElementResult = $this->nodeFactory->create($options)->render();
            $noneElementHtml = $noneElementResult['html'];

            $placeholderWrap = [];
            $placeholderWrap[] = '<div class="' . implode(' ', $fieldItemClasses) . '">';
            $placeholderWrap[] =    '<div class="t3-form-field-disable"></div>';
            $placeholderWrap[] =    '<div class="checkbox">';
            $placeholderWrap[] =        '<label for="' . $nullControlNameEscaped . '">';
            $placeholderWrap[] =            '<input type="hidden" name="' . $nullControlNameEscaped . '" value="0" />';
            $placeholderWrap[] =            '<input type="checkbox" name="' . $nullControlNameEscaped . '" id="' . $nullControlNameEscaped . '" value="1" id="tce-forms-textfield-use-override-' . $fieldName . '-' . $row['uid'] . '" onchange="' . htmlspecialchars($onChange) . '"' . $checked . ' />';
            $placeholderWrap[] =            sprintf($languageService->sL('LLL:EXT:lang/locallang_core.xlf:labels.placeholder.override'), BackendUtility::getRecordTitlePrep($placeholder, 20));
            $placeholderWrap[] =        '</label>';
            $placeholderWrap[] =    '</div>';
            $placeholderWrap[] =    '<div class="t3js-formengine-placeholder-placeholder">';
            $placeholderWrap[] =        $noneElementHtml;
            $placeholderWrap[] =    '</div>';
            $placeholderWrap[] =    '<div class="t3js-formengine-placeholder-formfield">';
            $placeholderWrap[] =        $html;
            $placeholderWrap[] =    '</div>';
            $placeholderWrap[] = '</div>';

            $html = implode(LF, $placeholderWrap);
        } elseif ($parameterArray['fieldConf']['config']['type'] !== 'user' || empty($parameterArray['fieldConf']['config']['noTableWrapping'])) {
            // Add a casual wrap if the field is not of type user with no wrap requested.
            $standardWrap = [];
            $standardWrap[] = '<div class="' . implode(' ', $fieldItemClasses) . '">';
            $standardWrap[] =    '<div class="t3-form-field-disable"></div>';
            $standardWrap[] =    $html;
            $standardWrap[] = '</div>';

            $html = implode(LF, $standardWrap);
        }

        $resultArray['html'] = $html;
        return $resultArray;
    }

    protected function renderDefaultLanguageContent($table, $field, $row, $item)
    {
        if (is_array($this->data['defaultLanguageRow'])) {
            $defaultLanguageValue = BackendUtility::getProcessedValue(
                $table,
                $field,
                $this->data['defaultLanguageRow'][$field],
                0,
                true,
                false,
                $this->data['defaultLanguageRow']['uid'],
                true,
                $this->data['defaultLanguageRow']['pid']
            );
            $fieldConfig = $this->data['processedTca']['columns'][$field];
            // Don't show content if it's for IRRE child records:
            if ($fieldConfig['config']['type'] !== 'inline') {
                $iconFactory = GeneralUtility::makeInstance(IconFactory::class);
                if ($defaultLanguageValue !== '') {
                    $item .= '<div class="t3-form-original-language" title="' . $this->getLanguageService()->sL('LLL:EXT:lang/locallang_misc.xlf:localizeMergeIfNotBlank', true) . '">'
                        . $iconFactory->getIcon($this->data['systemLanguageRows'][0]['flagIconIdentifier'], Icon::SIZE_SMALL)->render()
                        . $this->getMergeBehaviourIcon($fieldConfig['l10n_mode'])
                        . $this->previewFieldValue($defaultLanguageValue, $fieldConfig, $field) . '</div>';
                }
                $additionalPreviewLanguages = $this->data['additionalLanguageRows'];
                foreach ($additionalPreviewLanguages as $previewLanguage) {
                    $defaultLanguageValue = BackendUtility::getProcessedValue(
                        $table,
                        $field,
                        $previewLanguage[$field],
                        0,
                        true
                    );
                    if ($defaultLanguageValue !== '') {
                        $item .= '<div class="t3-form-original-language" title="' . $this->getLanguageService()->sL('LLL:EXT:lang/locallang_misc.xlf:localizeMergeIfNotBlank', true) . '">'
                            . $iconFactory->getIcon($this->data['systemLanguageRows'][$previewLanguage['sys_language_uid']]['flagIconIdentifier'], Icon::SIZE_SMALL)->render()
                            . $this->getMergeBehaviourIcon($fieldConfig['l10n_mode'])
                            . $this->previewFieldValue($defaultLanguageValue, $fieldConfig, $field) . '</div>';
                    }
                }
            }
        }
        return $item;
    }

    protected function getMergeBehaviourIcon($l10nMode)
    {
        $icon = '';
        if ($l10nMode === 'mergeIfNotBlank') {
            $iconFactory = GeneralUtility::makeInstance(IconFactory::class);
            $icon = $iconFactory->getIcon('actions-edit-merge-localization', Icon::SIZE_SMALL)->render();
        }
        return $icon;
    }

    protected function renderDefaultLanguageDiff($table, $field, $row, $item)
    {
        if (is_array($this->data['defaultLanguageDiffRow'][$table . ':' . $row['uid']])) {
            // Initialize:
            $dLVal = [
                'old' => $this->data['defaultLanguageDiffRow'][$table . ':' . $row['uid']],
                'new' => $this->data['defaultLanguageRow']
            ];
            // There must be diff-data:
            if (isset($dLVal['old'][$field])) {
                if ((string)$dLVal['old'][$field] !== (string)$dLVal['new'][$field]) {
                    // Create diff-result:
                    $diffUtility = GeneralUtility::makeInstance(DiffUtility::class);
                    $diffUtility->stripTags = false;
                    $diffres = $diffUtility->makeDiffDisplay(
                        BackendUtility::getProcessedValue($table, $field, $dLVal['old'][$field], 0, 1),
                        BackendUtility::getProcessedValue($table, $field, $dLVal['new'][$field], 0, 1)
                    );
                    $item .= '
                        <div class="t3-form-original-language-diff">
                            <div class="t3-form-original-language-diffheader">'
                                . htmlspecialchars($this->getLanguageService()->sL('LLL:EXT:lang/locallang_core.xlf:labels.changeInOrig'))
                            . '</div>
                            <div class="t3-form-original-language-diffcontent">
                                <div class="diff">
                                    <div class="diff-item">
                                        <div class="diff-item-result diff-item-result-inline">' . $diffres . '</div>
                                    </div>
                                </div>
                            </div>
                        </div>
                    ';
                }
            }
        }
        return $item;
    }

    protected function isInlineChildAndLabelField($table, $field)
    {
        $inlineStackProcessor = GeneralUtility::makeInstance(InlineStackProcessor::class);
        $inlineStackProcessor->initializeByGivenStructure($this->data['inlineStructure']);
        $level = $inlineStackProcessor->getStructureLevel(-1);
        if ($level['config']['foreign_label']) {
            $label = $level['config']['foreign_label'];
        } else {
            $label = $this->data['processedTca']['ctrl']['label'];
        }
        return $level['config']['foreign_table'] === $table && $label === $field;
    }

    protected function inlineFieldShouldBeSkipped()
    {
        $table = $this->data['tableName'];
        $row = $this->data['databaseRow'];
        $fieldName = $this->data['fieldName'];
        $fieldConfig = $this->data['processedTca']['columns'][$fieldName]['config'];

        $inlineStackProcessor = GeneralUtility::makeInstance(InlineStackProcessor::class);
        $inlineStackProcessor->initializeByGivenStructure($this->data['inlineStructure']);
        $structureDepth = $inlineStackProcessor->getStructureDepth();

        $skipThisField = false;
        if ($structureDepth > 0) {
            $searchArray = [
                '%OR' => [
                    'config' => [
                        0 => [
                            '%AND' => [
                                'foreign_table' => $table,
                                '%OR' => [
                                    '%AND' => [
                                        'appearance' => ['useCombination' => true],
                                        'foreign_selector' => $fieldName
                                    ],
                                    'MM' => $fieldConfig['MM']
                                ]
                            ]
                        ],
                        1 => [
                            '%AND' => [
                                'foreign_table' => $fieldConfig['foreign_table'],
                                'foreign_selector' => $fieldConfig['foreign_field']
                            ]
                        ]
                    ]
                ]
            ];
            // Get the parent record from structure stack
            $level = $inlineStackProcessor->getStructureLevel(-1);
            // If we have symmetric fields, check on which side we are and hide fields, that are set automatically:
            if ($this->data['isOnSymmetricSide']) {
                $searchArray['%OR']['config'][0]['%AND']['%OR']['symmetric_field'] = $fieldName;
                $searchArray['%OR']['config'][0]['%AND']['%OR']['symmetric_sortby'] = $fieldName;
            } else {
                $searchArray['%OR']['config'][0]['%AND']['%OR']['foreign_field'] = $fieldName;
                $searchArray['%OR']['config'][0]['%AND']['%OR']['foreign_sortby'] = $fieldName;
            }
            $skipThisField = $this->arrayCompareComplex($level, $searchArray);
        }
        return $skipThisField;
    }

    protected function arrayCompareComplex($subjectArray, $searchArray, $type = '')
    {
        $localMatches = 0;
        $localEntries = 0;
        if (is_array($searchArray) && !empty($searchArray)) {
            // If no type was passed, try to determine
            if (!$type) {
                reset($searchArray);
                $type = key($searchArray);
                $searchArray = current($searchArray);
            }
            // We use '%AND' and '%OR' in uppercase
            $type = strtoupper($type);
            // Split regular elements from sub elements
            foreach ($searchArray as $key => $value) {
                $localEntries++;
                // Process a sub-group of OR-conditions
                if ($key === '%OR') {
                    $localMatches += $this->arrayCompareComplex($subjectArray, $value, '%OR') ? 1 : 0;
                } elseif ($key === '%AND') {
                    $localMatches += $this->arrayCompareComplex($subjectArray, $value, '%AND') ? 1 : 0;
                } elseif (is_array($value) && $this->isAssociativeArray($searchArray)) {
                    $localMatches += $this->arrayCompareComplex($subjectArray[$key], $value, $type) ? 1 : 0;
                } elseif (is_array($value)) {
                    $localMatches += $this->arrayCompareComplex($subjectArray, $value, $type) ? 1 : 0;
                } else {
                    if (isset($subjectArray[$key]) && isset($value)) {
                        // Boolean match:
                        if (is_bool($value)) {
                            $localMatches += !($subjectArray[$key] xor $value) ? 1 : 0;
                        } elseif (is_numeric($subjectArray[$key]) && is_numeric($value)) {
                            $localMatches += $subjectArray[$key] == $value ? 1 : 0;
                        } else {
                            $localMatches += $subjectArray[$key] === $value ? 1 : 0;
                        }
                    }
                }
                // If one or more matches are required ('OR'), return TRUE after the first successful match
                if ($type === '%OR' && $localMatches > 0) {
                    return true;
                }
                // If all matches are required ('AND') and we have no result after the first run, return FALSE
                if ($type === '%AND' && $localMatches == 0) {
                    return false;
                }
            }
        }
        // Return the result for '%AND' (if nothing was checked, TRUE is returned)
        return $localEntries === $localMatches;
    }

    protected function isAssociativeArray($object)
    {
        return is_array($object) && !empty($object) && array_keys($object) !== range(0, count($object) - 1);
    }

    protected function getBackendUserAuthentication()
    {
        return $GLOBALS['BE_USER'];
    }

    protected function getLanguageService()
    {
        return $GLOBALS['LANG'];
    }
}