RteHtmlAreaApi.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Rtehtmlarea;

/*
 * 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\FrontendEditing\FrontendEditingController;
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Lang\LanguageService;

abstract class RteHtmlAreaApi
{
    protected $extensionKey = 'rtehtmlarea';

    protected $pluginName;

    protected $relativePathToSkin = '';

    protected $toolbar;

    protected $pluginButtons = '';

    protected $pluginLabels = '';

    protected $pluginAddsButtons = true;

    protected $convertToolbarForHtmlAreaArray = [];

    protected $requiresClassesConfiguration = false;

    protected $requiredPlugins = '';

    protected $configuration;

    public function main(array $configuration)
    {
        $this->configuration = $configuration;
        // Set the value of this boolean based on the initial value of $this->pluginButtons
        $this->pluginAddsButtons = !empty($this->pluginButtons);
        // Check if the plugin should be disabled in frontend
        if ($this->isFrontend() && $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['rtehtmlarea']['plugins'][$this->pluginName]['disableInFE']) {
            return false;
        }
        return true;
    }

    public function buildJavascriptConfiguration()
    {
        $jsArray = [];
        $pluginButtons = GeneralUtility::trimExplode(',', $this->pluginButtons, true);
        foreach ($pluginButtons as $button) {
            if (in_array($button, $this->toolbar)) {
                if (!is_array($this->configuration['thisConfig']['buttons.']) || !is_array($this->configuration['thisConfig']['buttons.'][$button . '.'])) {
                    $jsArray[] = 'RTEarea[editornumber].buttons.' . $button . ' = new Object();';
                }
            }
        }
        return implode(LF, $jsArray);
    }

    public function getExtensionKey()
    {
        return $this->extensionKey;
    }

    public function addsButtons()
    {
        return $this->pluginAddsButtons;
    }

    public function getPluginButtons()
    {
        return $this->pluginButtons;
    }

    public function getPluginLabels()
    {
        return $this->pluginLabels;
    }

    public function getConvertToolbarForHtmlAreaArray()
    {
        return $this->convertToolbarForHtmlAreaArray;
    }

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

    public function getRequiredPlugins()
    {
        return $this->requiredPlugins;
    }

    public function setToolbar(array $toolbar)
    {
        $this->toolbar = $toolbar;
    }

    protected function cleanList($str)
    {
        if (strstr($str, '*')) {
            $str = '*';
        } else {
            $str = implode(',', array_unique(GeneralUtility::trimExplode(',', $str, true)));
        }
        return $str;
    }

    protected function getPageConfigLabel($string)
    {
        $label = $this->getLanguageService()->sL(trim($string));
        // @todo: find out why this is done and if it could be substituted with quoteJSvalue
        $label = str_replace('"', '\\"', str_replace('\\\'', '\'', $label));
        return $label;
    }

    protected function isFrontend()
    {
        return is_object($GLOBALS['TSFE'])
            && !$this->isFrontendEditActive()
            && TYPO3_MODE == 'FE';
    }

    protected function isFrontendEditActive()
    {
        return is_object($GLOBALS['TSFE'])
            && $GLOBALS['TSFE']->beUserLogin
            && $GLOBALS['BE_USER']->frontendEdit instanceof FrontendEditingController;
    }

    protected function getFullFileName($filename)
    {
        if (substr($filename, 0, 4) === 'EXT:') {
            // extension
            list($extKey, $local) = explode('/', substr($filename, 4), 2);
            $newFilename = '';
            if ((string)$extKey !== '' && ExtensionManagementUtility::isLoaded($extKey) && (string)$local !== '') {
                $newFilename = ($this->isFrontend() || $this->isFrontendEditActive()
                        ? ExtensionManagementUtility::siteRelPath($extKey)
                        : ExtensionManagementUtility::extRelPath($extKey))
                    . $local;
            }
        } else {
            $path = ($this->isFrontend() || $this->isFrontendEditActive() ? '' : '../');
            $newFilename = $path . ($filename[0] === '/' ? substr($filename, 1) : $filename);
        }
        return GeneralUtility::resolveBackPath($newFilename);
    }

    protected function writeTemporaryFile($label, $fileExtension = 'js', $contents = '')
    {
        $relativeFilename = 'typo3temp/RteHtmlArea/' . str_replace('-', '_', $label) . '_' . GeneralUtility::shortMD5($contents, 20) . '.' . $fileExtension;
        $destination = PATH_site . $relativeFilename;
        if (!file_exists($destination)) {
            $minifiedJavaScript = '';
            if ($fileExtension === 'js' && $contents !== '') {
                $minifiedJavaScript = GeneralUtility::minifyJavaScript($contents);
            }
            $failure = GeneralUtility::writeFileToTypo3tempDir($destination, $minifiedJavaScript ? $minifiedJavaScript : $contents);
            if ($failure) {
                throw new \RuntimeException($failure, 1294585668);
            }
        }
        if ($this->isFrontend() || $this->isFrontendEditActive()) {
            $fileName = $relativeFilename;
        } else {
            $fileName = '../' . $relativeFilename;
        }
        return GeneralUtility::resolveBackPath($fileName);
    }

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