HistoryService.php

Go to the documentation of this file.

<?php
namespace ‪TYPO3\CMS\Workspaces\Service;
 
/*
 * 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\Backend\Avatar\Avatar;
use ‪TYPO3\CMS\Backend\History\RecordHistory;
use ‪TYPO3\CMS\Backend\Utility\BackendUtility;
use ‪TYPO3\CMS\Core\Localization\LanguageService;
use ‪TYPO3\CMS\Core\SingletonInterface;
use ‪TYPO3\CMS\Core\Utility\DiffUtility;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪HistoryService implements ‪SingletonInterface
{
    protected ‪$backendUserNames;
 
    protected ‪$historyEntries = [];
 
    protected ‪$differencesObject;
 
    public function ‪__construct()
    {
        $this->backendUserNames = ‪BackendUtility::getUserNames();
    }
 
    public function ‪getHistory($table, $id)
    {
        $history = [];
        $i = 0;
        foreach ((array)$this->‪getHistoryEntries($table, $id) as $entry) {
            if ($i++ > 20) {
                break;
            }
            $history[] = $this->‪getHistoryEntry($entry);
        }
        return $history;
    }
 
    protected function ‪getHistoryEntry(array $entry)
    {
        if (!empty($entry['action'])) {
            $differences = $entry['action'];
        } else {
            $differences = $this->‪getDifferences($entry);
        }
 
        $avatar = GeneralUtility::makeInstance(Avatar::class);
        $beUserRecord = ‪BackendUtility::getRecord('be_users', $entry['userid']);
 
        return [
            'datetime' => htmlspecialchars(‪BackendUtility::datetime($entry['tstamp'])),
            'user' => htmlspecialchars($this->‪getUserName($entry['userid'])),
            'user_avatar' => $avatar->render($beUserRecord),
            'differences' => $differences
        ];
    }
 
    protected function ‪getDifferences(array $entry)
    {
        $differences = [];
        $tableName = $entry['tablename'];
        if (is_array($entry['newRecord'])) {
            ‪$fields = array_keys($entry['newRecord']);
            foreach (‪$fields as $field) {
                if (!empty(‪$GLOBALS['TCA'][$tableName]['columns'][$field]['config']['type']) && ‪$GLOBALS['TCA'][$tableName]['columns'][$field]['config']['type'] !== 'passthrough') {
                    // Create diff-result:
                    $fieldDifferences = $this->‪getDifferencesObject()->‪makeDiffDisplay(
                        ‪BackendUtility::getProcessedValue($tableName, $field, $entry['oldRecord'][$field], 0, true),
                        ‪BackendUtility::getProcessedValue($tableName, $field, $entry['newRecord'][$field], 0, true)
                    );
                    if (!empty($fieldDifferences)) {
                        $differences[] = [
                            'label' => $this->‪getLanguageService()->‪sL((string)‪BackendUtility::getItemLabel($tableName, $field)),
                            'html' => nl2br(trim($fieldDifferences)),
                        ];
                    }
                }
            }
        }
        return $differences;
    }
 
    protected function ‪getUserName($user)
    {
        $userName = 'unknown';
        if (!empty($this->backendUserNames[$user]['username'])) {
            $userName = $this->backendUserNames[$user]['username'];
        }
        return $userName;
    }
 
    protected function ‪getHistoryEntries($table, $id)
    {
        if (!isset($this->historyEntries[$table][$id])) {
            $historyObject = GeneralUtility::makeInstance(RecordHistory::class);
            $this->historyEntries[$table][$id] = $historyObject->getHistoryDataForRecord($table, $id);
        }
        return $this->historyEntries[$table][$id];
    }
 
    protected function ‪getDifferencesObject()
    {
        if (!isset($this->differencesObject)) {
            $this->differencesObject = GeneralUtility::makeInstance(DiffUtility::class);
            $this->differencesObject->stripTags = false;
        }
        return ‪$this->differencesObject;
    }
 
    protected function ‪getLanguageService()
    {
        return ‪$GLOBALS['LANG'];
    }
}