DownloadRecordList.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * 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!
 */
 
namespace ‪TYPO3\CMS\Backend\RecordList;
 
use ‪TYPO3\CMS\Backend\Configuration\TranslationConfigurationProvider;
use TYPO3\CMS\Backend\Utility\BackendUtility;
use ‪TYPO3\CMS\Core\Authentication\BackendUserAuthentication;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪DownloadRecordList
{
    protected ‪DatabaseRecordList ‪$recordList;
    protected ‪TranslationConfigurationProvider ‪$translationConfigurationProvider;
 
    public function ‪__construct(‪DatabaseRecordList ‪$recordList, ‪TranslationConfigurationProvider ‪$translationConfigurationProvider)
    {
        $this->recordList = ‪$recordList;
        $this->translationConfigurationProvider = ‪$translationConfigurationProvider;
    }
 
    public function ‪getHeaderRow(array $columnsToRender): array
    {
        $columnsToRender = array_combine($columnsToRender, $columnsToRender);
        $hooks = ‪$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['TYPO3\CMS\Recordlist\RecordList\DatabaseRecordList']['customizeCsvHeader'] ?? [];
        if (!empty($hooks)) {
            $hookParameters = [
                'fields' => &$columnsToRender,
            ];
            foreach ($hooks as $hookFunction) {
                GeneralUtility::callUserFunction($hookFunction, $hookParameters, $this->recordList);
            }
        }
        return $columnsToRender;
    }
 
    public function ‪getRecords(
        string $table,
        array $columnsToRender,
        ‪BackendUserAuthentication $backendUser,
        bool $hideTranslations = false,
        bool $rawValues = false
    ): array {
        // Creating the list of fields to include in the SQL query
        $selectFields = $this->recordList->getFieldsToSelect($table, $columnsToRender);
        $queryResult = $this->recordList->getQueryBuilder($table, $selectFields)->executeQuery();
        $l10nEnabled = BackendUtility::isTableLocalizable($table);
        $result = [];
        // Render items
        while ($row = $queryResult->fetchAssociative()) {
            // In offline workspace, look for alternative record
            BackendUtility::workspaceOL($table, $row, $backendUser->workspace, true);
            if (!is_array($row)) {
                continue;
            }
            $result[] = $this->‪prepareRow($table, $row, $columnsToRender, $this->recordList->id, $rawValues);
            if (!$l10nEnabled) {
                continue;
            }
            if ($hideTranslations) {
                continue;
            }
            // Guard clause so we can quickly return if a record is localized to "all languages"
            // It should only be possible to localize a record off default (uid 0)
            if ((int)$row[‪$GLOBALS['TCA'][$table]['ctrl']['languageField']] === -1) {
                continue;
            }
            $translationsRaw = $this->translationConfigurationProvider->translationInfo($table, $row['uid'], 0, $row, $selectFields);
            foreach ($translationsRaw['translations'] ?? [] as $languageId => $translationRow) {
                // In offline workspace, look for alternative record
                BackendUtility::workspaceOL($table, $translationRow, $backendUser->workspace, true);
                if (is_array($translationRow) && $backendUser->‪checkLanguageAccess($languageId)) {
                    $result[] = $this->‪prepareRow($table, $translationRow, $columnsToRender, $this->recordList->id, $rawValues);
                }
            }
        }
        return $result;
    }
 
    protected function ‪prepareRow(string $table, array $row, array $columnsToRender, int $pageId, bool $rawValues): array
    {
        foreach ($columnsToRender as $columnName) {
            if (!$rawValues) {
                if ($columnName === ‪$GLOBALS['TCA'][$table]['ctrl']['label']) {
                    $row[$columnName] = BackendUtility::getRecordTitle($table, $row);
                } elseif ($columnName !== 'pid') {
                    $row[$columnName] = BackendUtility::getProcessedValueExtra($table, $columnName, $row[$columnName], 0, $row['uid']);
                }
            }
        }
        $hooks = ‪$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['TYPO3\CMS\Recordlist\RecordList\DatabaseRecordList']['customizeCsvRow'] ?? [];
        if (!empty($hooks)) {
            $hookParameters = [
                'databaseRow' => &$row,
                'tableName' => $table,
                'pageId' => $pageId,
            ];
            foreach ($hooks as $hookFunction) {
                GeneralUtility::callUserFunction($hookFunction, $hookParameters, $this->recordList);
            }
        }
        return array_intersect_key($row, array_flip($columnsToRender));
    }
}