BackendLayoutView.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Backend\View;

use TYPO3\CMS\Backend\Utility\BackendUtility;
use TYPO3\CMS\Core\Utility\ArrayUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class BackendLayoutView implements \TYPO3\CMS\Core\SingletonInterface {

    protected $dataProviderCollection;

    protected $selectedCombinedIdentifier = array();

    protected $selectedBackendLayout = array();

    public function __construct() {
        $this->initializeDataProviderCollection();
    }

    protected function initializeDataProviderCollection() {
        $dataProviderCollection = GeneralUtility::makeInstance(
            'TYPO3\\CMS\\Backend\\View\\BackendLayout\\DataProviderCollection'
        );

        $dataProviderCollection->add(
            'default',
            'TYPO3\\CMS\\Backend\\View\\BackendLayout\\DefaultDataProvider'
        );

        if (!empty($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['BackendLayoutDataProvider'])) {
            $dataProviders = (array) $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['BackendLayoutDataProvider'];
            foreach ($dataProviders as $identifier => $className) {
                $dataProviderCollection->add($identifier, $className);
            }
        }

        $this->setDataProviderCollection($dataProviderCollection);
    }

    public function setDataProviderCollection(BackendLayout\DataProviderCollection $dataProviderCollection) {
        $this->dataProviderCollection = $dataProviderCollection;
    }

    public function getDataProviderCollection() {
        return $this->dataProviderCollection;
    }

    public function addBackendLayoutItems(array $parameters) {
        $pageId = $this->determinePageId($parameters['table'], $parameters['row']);
        $pageTsConfig = (array) BackendUtility::getPagesTSconfig($pageId);
        $identifiersToBeExcluded = $this->getIdentifiersToBeExcluded($pageTsConfig);

        $dataProviderContext = $this->createDataProviderContext()
            ->setPageId($pageId)
            ->setData($parameters['row'])
            ->setTableName($parameters['table'])
            ->setFieldName($parameters['field'])
            ->setPageTsConfig($pageTsConfig);

        $backendLayoutCollections = $this->getDataProviderCollection()->getBackendLayoutCollections($dataProviderContext);
        foreach ($backendLayoutCollections as $backendLayoutCollection) {
            $combinedIdentifierPrefix = '';
            if ($backendLayoutCollection->getIdentifier() !== 'default') {
                $combinedIdentifierPrefix = $backendLayoutCollection->getIdentifier() . '__';
            }

            foreach ($backendLayoutCollection->getAll() as $backendLayout) {
                $combinedIdentifier = $combinedIdentifierPrefix . $backendLayout->getIdentifier();

                if (in_array($combinedIdentifier, $identifiersToBeExcluded, TRUE)) {
                    continue;
                }

                $parameters['items'][] = array(
                    $this->getLanguageService()->sL($backendLayout->getTitle()),
                    $combinedIdentifier,
                    $backendLayout->getIconPath(),
                );
            }
        }
    }

    protected function determinePageId($tableName, array $data) {
        $pageId = NULL;

        if (strpos($data['uid'], 'NEW') === 0) {
            // negative uid_pid values of content elements indicate that the element has been inserted after an existing element
            // so there is no pid to get the backendLayout for and we have to get that first
            if ($data['pid'] < 0) {
                $existingElement = $this->getDatabaseConnection()->exec_SELECTgetSingleRow(
                    'pid', $tableName, 'uid='  . abs($data['pid'])
                );
                if ($existingElement !== NULL) {
                    $pageId = $existingElement['pid'];
                }
            } else {
                $pageId = $data['pid'];
            }
        } elseif ($tableName === 'pages') {
            $pageId = $data['uid'];
        } else {
            $pageId = $data['pid'];
        }

        return $pageId;
    }

    public function getSelectedCombinedIdentifier($pageId) {
        if (!isset($this->selectedCombinedIdentifier[$pageId])) {
            $page = $this->getPage($pageId);
            $this->selectedCombinedIdentifier[$pageId] = (string) $page['backend_layout'];

            if ($this->selectedCombinedIdentifier[$pageId] === '-1') {
                // If it is set to "none" - don't use any
                $this->selectedCombinedIdentifier[$pageId] = FALSE;
            } elseif ($this->selectedCombinedIdentifier[$pageId] === '' || $this->selectedCombinedIdentifier[$pageId] === '0') {
                // If it not set check the root-line for a layout on next level and use this
                // (root-line starts with current page and has page "0" at the end)
                $rootLine = $this->getRootLine($pageId);
                // Remove first and last element (current and root page)
                array_shift($rootLine);
                array_pop($rootLine);
                foreach ($rootLine as $rootLinePage) {
                    $this->selectedCombinedIdentifier[$pageId] = (string) $rootLinePage['backend_layout_next_level'];
                    if ($this->selectedCombinedIdentifier[$pageId] === '-1') {
                        // If layout for "next level" is set to "none" - don't use any and stop searching
                        $this->selectedCombinedIdentifier[$pageId] = FALSE;
                        break;
                    } elseif ($this->selectedCombinedIdentifier[$pageId] !== '' && $this->selectedCombinedIdentifier[$pageId] !== '0') {
                        // Stop searching if a layout for "next level" is set
                        break;
                    }
                }
            }
        }
        // If it is set to a positive value use this
        return $this->selectedCombinedIdentifier[$pageId];
    }

    protected function getIdentifiersToBeExcluded(array $pageTSconfig) {
        $identifiersToBeExcluded = array();

        if (ArrayUtility::isValidPath($pageTSconfig, 'options./backendLayout./exclude')) {
            $identifiersToBeExcluded = GeneralUtility::trimExplode(
                ',',
                ArrayUtility::getValueByPath($pageTSconfig, 'options./backendLayout./exclude'),
                TRUE
            );
        }

        return $identifiersToBeExcluded;
    }

    public function colPosListItemProcFunc(array $parameters) {
        $pageId = $this->determinePageId($parameters['table'], $parameters['row']);

        if ($pageId !== NULL) {
            $parameters['items'] = $this->addColPosListLayoutItems($pageId, $parameters['items']);
        }
    }

    protected function addColPosListLayoutItems($pageId, $items) {
        $layout = $this->getSelectedBackendLayout($pageId);
        if ($layout && $layout['__items']) {
            $items = $layout['__items'];
        }
        return $items;
    }

    public function getColPosListItemsParsed($id) {
        $tsConfig = BackendUtility::getModTSconfig($id, 'TCEFORM.tt_content.colPos');
        $tcaConfig = $GLOBALS['TCA']['tt_content']['columns']['colPos']['config'];
        $tceForms = GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Form\\FormEngine');
        $tcaItems = $tcaConfig['items'];
        $tcaItems = $tceForms->addItems($tcaItems, $tsConfig['properties']['addItems.']);
        if (isset($tcaConfig['itemsProcFunc']) && $tcaConfig['itemsProcFunc']) {
            $tcaItems = $this->addColPosListLayoutItems($id, $tcaItems);
        }
        foreach (GeneralUtility::trimExplode(',', $tsConfig['properties']['removeItems'], TRUE) as $removeId) {
            foreach ($tcaItems as $key => $item) {
                if ($item[1] == $removeId) {
                    unset($tcaItems[$key]);
                }
            }
        }
        return $tcaItems;
    }

    public function getSelectedBackendLayout($pageId) {
        if (isset($this->selectedBackendLayout[$pageId])) {
            return $this->selectedBackendLayout[$pageId];
        }
        $backendLayoutData = NULL;

        $selectedCombinedIdentifier = $this->getSelectedCombinedIdentifier($pageId);
        // If no backend layout is selected, use default
        if (empty($selectedCombinedIdentifier)) {
            $selectedCombinedIdentifier = 'default';
        }

        $backendLayout = $this->getDataProviderCollection()->getBackendLayout($selectedCombinedIdentifier, $pageId);
        // If backend layout is not found available anymore, use default
        if (is_null($backendLayout)) {
            $selectedCombinedIdentifier = 'default';
            $backendLayout = $this->getDataProviderCollection()->getBackendLayout($selectedCombinedIdentifier, $pageId);
        }

        if (!empty($backendLayout)) {
            $parser = GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\TypoScript\\Parser\\TypoScriptParser');
            $conditionMatcher = GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Configuration\\TypoScript\\ConditionMatching\\ConditionMatcher');
            $parser->parse($parser->checkIncludeLines($backendLayout->getConfiguration()), $conditionMatcher);

            $backendLayoutData = array();
            $backendLayoutData['config'] = $backendLayout->getConfiguration();
            $backendLayoutData['__config'] = $parser->setup;
            $backendLayoutData['__items'] = array();
            $backendLayoutData['__colPosList'] = array();

            // create items and colPosList
            if (!empty($backendLayoutData['__config']['backend_layout.']['rows.'])) {
                foreach ($backendLayoutData['__config']['backend_layout.']['rows.'] as $row) {
                    if (!empty($row['columns.'])) {
                        foreach ($row['columns.'] as $column) {
                            $backendLayoutData['__items'][] = array(
                                GeneralUtility::isFirstPartOfStr($column['name'], 'LLL:') ? $this->getLanguageService()->sL($column['name']) : $column['name'],
                                $column['colPos'],
                                NULL
                            );
                            $backendLayoutData['__colPosList'][] = $column['colPos'];
                        }
                    }
                }
            }

            $this->selectedBackendLayout[$pageId] = $backendLayoutData;
        }

        return $backendLayoutData;
    }

    static public function getDefaultColumnLayout() {
        return '
        backend_layout {
            colCount = 4
            rowCount = 1
            rows {
                1 {
                    columns {
                        1 {
                            name = LLL:EXT:cms/locallang_ttc.xlf:colPos.I.0
                            colPos = 1
                        }
                        2 {
                            name = LLL:EXT:cms/locallang_ttc.xlf:colPos.I.1
                            colPos = 0
                        }
                        3 {
                            name = LLL:EXT:cms/locallang_ttc.xlf:colPos.I.2
                            colPos = 2
                        }
                        4 {
                            name = LLL:EXT:cms/locallang_ttc.xlf:colPos.I.3
                            colPos = 3
                        }
                    }
                }
            }
        }
        ';
    }

    protected function getPage($pageId) {
        $page = $this->getDatabaseConnection()->exec_SELECTgetSingleRow(
            'uid, pid, backend_layout',
            'pages',
            'uid=' . (int)$pageId
        );
        BackendUtility::workspaceOL('pages', $page);
        return $page;
    }

    protected function getRootLine($pageId) {
        return BackendUtility::BEgetRootLine($pageId, '', TRUE);
    }

    protected function createDataProviderContext() {
        return GeneralUtility::makeInstance(
            'TYPO3\\CMS\\Backend\\View\\BackendLayout\\DataProviderContext'
        );
    }

    protected function getDatabaseConnection() {
        return $GLOBALS['TYPO3_DB'];
    }

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

}