SectionFrameToFrameClassUpdate.php

Go to the documentation of this file.

<?php
namespace ‪TYPO3\CMS\Install\Updates;
 
/*
 * 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\Core\Database\ConnectionPool;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪SectionFrameToFrameClassUpdate implements ‪UpgradeWizardInterface
{
    public function ‪getIdentifier(): string
    {
        return 'sectionFrameToFrameClassUpdate';
    }
 
    public function ‪getTitle(): string
    {
        return 'Migrate the field "section_frame" for all content elements to "frame_class"';
    }
 
    public function ‪getDescription(): string
    {
        return 'Section frames were used to control the wrapping of each content element in the frontend '
            . 'output, stored as integers in the database. To get rid of a nessesary mapping of those values we '
            . 'are now storing strings you can easily adjust that will simply passed to the rendering.';
    }
 
    public function ‪updateNecessary(): bool
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tt_content');
        $tableColumns = $connection->getSchemaManager()->listTableColumns('tt_content');
        // Only proceed if section_frame field still exists
        if (!isset($tableColumns['section_frame'])) {
            return false;
        }
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('tt_content');
        $queryBuilder->getRestrictions()->removeAll();
        $elementCount = $queryBuilder->count('uid')
            ->from('tt_content')
            ->where(
                $queryBuilder->expr()->gt('section_frame', 0)
            )
            ->execute()
            ->fetchColumn(0);
        return (bool)$elementCount;
    }
 
    public function ‪getPrerequisites(): array
    {
        return [
            DatabaseUpdatedPrerequisite::class
        ];
    }
 
    public function ‪executeUpdate(): bool
    {
        $connection = GeneralUtility::makeInstance(ConnectionPool::class)->getConnectionForTable('tt_content');
        $queryBuilder = $connection->createQueryBuilder();
        $queryBuilder->getRestrictions()->removeAll();
        $statement = $queryBuilder->select('uid', 'section_frame')
            ->from('tt_content')
            ->where(
                $queryBuilder->expr()->gt('section_frame', 0)
            )
            ->execute();
        while ($record = $statement->fetch()) {
            $queryBuilder = $connection->createQueryBuilder();
            $queryBuilder->update('tt_content')
                ->where(
                    $queryBuilder->expr()->eq(
                        'uid',
                        $queryBuilder->createNamedParameter($record['uid'], \PDO::PARAM_INT)
                    )
                )
                ->set('section_frame', 0, false)
                ->set('frame_class', $this->‪mapSectionFrame($record['section_frame']));
            $queryBuilder->execute();
        }
        return true;
    }
 
    protected function ‪mapSectionFrame($sectionFrame)
    {
        $mapping = [
            0 => 'default',
            5 => 'ruler-before',
            6 => 'ruler-after',
            10 => 'indent',
            11 => 'indent-left',
            12 => 'indent-right',
            66 => 'none'
        ];
        if (array_key_exists($sectionFrame, $mapping)) {
            return $mapping[$sectionFrame];
        }
        return 'custom-' . (int)$sectionFrame;
    }
}