SilverStripe\Forms\HTMLEditor\TinyMCEConfig

Complexity

Total Complexity

65

Size/Duplication

Total Lines	710
Duplicated Lines	4.37 %

Coupling/Cohesion

Components	1
Dependencies	13

Importance

Changes

0

26 Methods

Rating	Name	Duplication	Size	Complexity
A	getTheme()	0	4	1
A	setTheme()	0	5	1
A	getOption()	0	7	2
A	setOption()	0	5	1
A	setOptions()	0	7	2
A	getSettings()	0	4	1
A	getAttributes()	0	7	1
B	enablePlugins()	0	18	5
A	disablePlugins()	0	11	3
A	getPlugins()	0	4	1
A	getInternalPlugins()	0	11	3
A	getButtons()	0	4	1
A	setButtonsForLine()	0	9	3
A	addButtonsToLine()	0	14	4
A	modifyButtons()	0	14	4
A	insertButtonsBefore()	10	11	3
A	insertButtonsAfter()	10	11	3
A	removeButtons()	11	12	4
B	getConfig()	0	60	8
A	getEditorCSS()	0	15	2
B	getScriptURL()	0	26	3
A	init()	0	5	1
A	get_tinymce_lang()	0	9	2
A	getAdminPath()	0	8	2
A	getTinyMCEPath()	0	17	3
A	getAdminModule()	0	4	1

<?php

namespace SilverStripe\Forms\HTMLEditor;

use SilverStripe\Core\Convert;
use SilverStripe\Control\Controller;
use SilverStripe\Control\Director;
use SilverStripe\Core\Manifest\ModuleLoader;
use SilverStripe\i18n\i18n;
use SilverStripe\View\Requirements;
use SilverStripe\View\SSViewer;
use SilverStripe\View\ThemeResourceLoader;
use TinyMCE_Compressor;
use Exception;

/**
 * Default configuration for HtmlEditor specific to tinymce
 */
class TinyMCEConfig extends HTMLEditorConfig
{
    /**
     * @config
     * @var array
     */
    private static $tinymce_lang = [
        'ar_EG' => 'ar',
        'ca_AD' => 'ca',
        'ca_ES' => 'ca',
        'cs_CZ' => 'cs',
        'cy_GB' => 'cy',
        'da_DK' => 'da',
        'da_GL' => 'da',
        'de_AT' => 'de',
        'de_BE' => 'de',
        'de_CH' => 'de',
        'de_DE' => 'de',
        'de_LI' => 'de',
        'de_LU' => 'de',
        'de_BR' => 'de',
        'de_US' => 'de',
        'el_CY' => 'el',
        'el_GR' => 'el',
        'es_AR' => 'es',
        'es_BO' => 'es',
        'es_CL' => 'es',
        'es_CO' => 'es',
        'es_CR' => 'es',
        'es_CU' => 'es',
        'es_DO' => 'es',
        'es_EC' => 'es',
        'es_ES' => 'es',
        'es_GQ' => 'es',
        'es_GT' => 'es',
        'es_HN' => 'es',
        'es_MX' => 'es',
        'es_NI' => 'es',
        'es_PA' => 'es',
        'es_PE' => 'es',
        'es_PH' => 'es',
        'es_PR' => 'es',
        'es_PY' => 'es',
        'es_SV' => 'es',
        'es_UY' => 'es',
        'es_VE' => 'es',
        'es_AD' => 'es',
        'es_BZ' => 'es',
        'es_US' => 'es',
        'fa_AF' => 'fa',
        'fa_IR' => 'fa',
        'fa_PK' => 'fa',
        'fi_FI' => 'fi',
        'fi_SE' => 'fi',
        'fr_BE' => 'fr',
        'fr_BF' => 'fr',
        'fr_BI' => 'fr',
        'fr_BJ' => 'fr',
        'fr_CA' => 'fr_ca',
        'fr_CF' => 'fr',
        'fr_CG' => 'fr',
        'fr_CH' => 'fr',
        'fr_CI' => 'fr',
        'fr_CM' => 'fr',
        'fr_DJ' => 'fr',
        'fr_DZ' => 'fr',
        'fr_FR' => 'fr',
        'fr_GA' => 'fr',
        'fr_GF' => 'fr',
        'fr_GN' => 'fr',
        'fr_GP' => 'fr',
        'fr_HT' => 'fr',
        'fr_KM' => 'fr',
        'fr_LU' => 'fr',
        'fr_MA' => 'fr',
        'fr_MC' => 'fr',
        'fr_MG' => 'fr',
        'fr_ML' => 'fr',
        'fr_MQ' => 'fr',
        'fr_MU' => 'fr',
        'fr_NC' => 'fr',
        'fr_NE' => 'fr',
        'fr_PF' => 'fr',
        'fr_PM' => 'fr',
        'fr_RE' => 'fr',
        'fr_RW' => 'fr',
        'fr_SC' => 'fr',
        'fr_SN' => 'fr',
        'fr_SY' => 'fr',
        'fr_TD' => 'fr',
        'fr_TG' => 'fr',
        'fr_TN' => 'fr',
        'fr_VU' => 'fr',
        'fr_WF' => 'fr',
        'fr_YT' => 'fr',
        'fr_GB' => 'fr',
        'fr_US' => 'fr',
        'he_IL' => 'he',
        'hu_HU' => 'hu',
        'hu_AT' => 'hu',
        'hu_RO' => 'hu',
        'hu_RS' => 'hu',
        'is_IS' => 'is',
        'it_CH' => 'it',
        'it_IT' => 'it',
        'it_SM' => 'it',
        'it_FR' => 'it',
        'it_HR' => 'it',
        'it_US' => 'it',
        'it_VA' => 'it',
        'ja_JP' => 'ja',
        'ko_KP' => 'ko',
        'ko_KR' => 'ko',
        'ko_CN' => 'ko',
        'mi_NZ' => 'mi_NZ',
        'nb_NO' => 'nb',
        'nb_SJ' => 'nb',
        'nl_AN' => 'nl',
        'nl_AW' => 'nl',
        'nl_BE' => 'nl',
        'nl_NL' => 'nl',
        'nl_SR' => 'nl',
        'nn_NO' => 'nn',
        'pl_PL' => 'pl',
        'pl_UA' => 'pl',
        'pt_AO' => 'pt',
        'pt_BR' => 'pt',
        'pt_CV' => 'pt',
        'pt_GW' => 'pt',
        'pt_MZ' => 'pt',
        'pt_PT' => 'pt',
        'pt_ST' => 'pt',
        'pt_TL' => 'pt',
        'ro_MD' => 'ro',
        'ro_RO' => 'ro',
        'ro_RS' => 'ro',
        'ru_BY' => 'ru',
        'ru_KG' => 'ru',
        'ru_KZ' => 'ru',
        'ru_RU' => 'ru',
        'ru_SJ' => 'ru',
        'ru_UA' => 'ru',
        'si_LK' => 'si',
        'sk_SK' => 'sk',
        'sk_RS' => 'sk',
        'sq_AL' => 'sq',
        'sr_BA' => 'sr',
        'sr_ME' => 'sr',
        'sr_RS' => 'sr',
        'sv_FI' => 'sv',
        'sv_SE' => 'sv',
        'tr_CY' => 'tr',
        'tr_TR' => 'tr',
        'tr_DE' => 'tr',
        'tr_MK' => 'tr',
        'uk_UA' => 'uk',
        'vi_VN' => 'vi',
        'vi_US' => 'vi',
        'zh_CN' => 'zh-cn',
        'zh_HK' => 'zh-cn',
        'zh_MO' => 'zh-cn',
        'zh_SG' => 'zh-cn',
        'zh_TW' => 'zh-tw',
        'zh_ID' => 'zh-cn',
        'zh_MY' => 'zh-cn',
        'zh_TH' => 'zh-cn',
        'zh_US' => 'zn-cn',
    ];

    /**
     * Location of module relative to BASE_DIR. This must contain the following dirs
     * - plugins
     * - themes
     * - skins
     *
     * If left blank defaults to [admin dir]/tinyme
     *
     * @config
     * @var string
     */
    private static $base_dir = null;

    /**
     * TinyMCE JS settings
     *
     * @link https://www.tinymce.com/docs/configure/
     *
     * @var array
     */
    protected $settings = array(
        'fix_list_elements' => true, // https://www.tinymce.com/docs/configure/content-filtering/#fix_list_elements
        'friendly_name' => '(Please set a friendly name for this config)',
        'priority' => 0, // used for Per-member config override
        'browser_spellcheck' => true,
        'body_class' => 'typography',
        'elementpath' => false, // https://www.tinymce.com/docs/configure/editor-appearance/#elementpath
        'relative_urls' => true,
        'remove_script_host' => true,
        'convert_urls' => false, // Prevent site-root images being rewritten to base relative
        'menubar' => false,
        'language' => 'en',
    );

    /**
     * Holder list of enabled plugins
     *
     * @var array
     */
    protected $plugins = array(
        'table' => null,
        'emoticons' => null,
        'paste' => null,
        'code' => null,
        'link' => null,
        'importcss' => null,
    );

    /**
     * Theme name
     *
     * @var string
     */
    protected $theme = 'modern';

    /**
     * Get the theme
     *
     * @return string
     */
    public function getTheme()
    {
        return $this->theme;
    }

    /**
     * Set the theme name
     *
     * @param string $theme
     * @return $this
     */
    public function setTheme($theme)
    {
        $this->theme = $theme;
        return $this;
    }

    /**
     * Holder list of buttons, organised by line. This array is 1-based indexed array
     *
     * {@link https://www.tinymce.com/docs/advanced/editor-control-identifiers/#toolbarcontrols}
     *
     * @var array
     */
    protected $buttons = array(
        1 => array(
            'bold', 'italic', 'underline', 'removeformat', '|',
            'alignleft', 'aligncenter', 'alignright', 'alignjustify', '|',
            'bullist', 'numlist', 'outdent', 'indent',
        ),
        2 => array(
            'formatselect', '|',
            'paste', 'pastetext', '|',
            'table', 'sslink', 'unlink', '|',
            'code'
        ),
        3 => array()
    );

    public function getOption($key)
    {
        if (isset($this->settings[$key])) {
            return $this->settings[$key];
        }
        return null;
    }

    public function setOption($key, $value)
    {
        $this->settings[$key] = $value;
        return $this;
    }

    public function setOptions($options)
    {
        foreach ($options as $key => $value) {
            $this->settings[$key] = $value;
        }
        return $this;
    }

    /**
     * Get all settings
     *
     * @return array
     */
    protected function getSettings()
    {
        return $this->settings;
    }

    public function getAttributes()
    {
        return [
            'data-editor' => 'tinyMCE', // Register ss.editorWrappers.tinyMCE
            'data-config' => Convert::array2json($this->getConfig())
        ];
    }

    /**
     * Enable one or several plugins. Will maintain unique list if already
     * enabled plugin is re-passed. If passed in as a map of plugin-name to path,
     * the plugin will be loaded by tinymce.PluginManager.load() instead of through tinyMCE.init().
     * Keep in mind that these externals plugins require a dash-prefix in their name.
     *
     * @see http://wiki.moxiecode.com/index.php/TinyMCE:API/tinymce.PluginManager/load
     *
     * If passing in a non-associative array, the plugin name should be located in the standard tinymce
     * plugins folder.
     *
     * If passing in an associative array, the key of each item should be the plugin name.
     * The value of each item is one of:
     *  - null - Will be treated as a stardard plugin in the standard location
     *  - relative path - Will be treated as a relative url
     *  - absolute url - Some url to an external plugin
     *
     * @param string|array $plugin,... a string, or several strings, or a single array of strings - The plugins to enable

There is no parameter named $plugin,.... Did you maybe mean $plugin?

     * @return $this
     */
    public function enablePlugins($plugin)

The parameter $plugin is not used and could be removed.

    {
        $plugins = func_get_args();
        if (is_array(current($plugins))) {
            $plugins = current($plugins);
        }
        foreach ($plugins as $name => $path) {
            // if plugins are passed without a path
            if (is_numeric($name)) {
                $name = $path;
                $path = null;
            }
            if (!array_key_exists($name, $this->plugins)) {
                $this->plugins[$name] = $path;
            }
        }
        return $this;
    }

    /**
     * Enable one or several plugins. Will properly handle being passed a plugin that is already disabled
     * @param string $plugin,... a string, or several strings, or a single array of strings - The plugins to enable

There is no parameter named $plugin,.... Did you maybe mean $plugin?

     * @return $this
     */
    public function disablePlugins($plugin)

The parameter $plugin is not used and could be removed.

    {
        $plugins = func_get_args();
        if (is_array(current($plugins))) {
            $plugins = current($plugins);
        }
        foreach ($plugins as $name) {
            unset($this->plugins[$name]);
        }
        return $this;
    }

    /**
     * Gets the list of all enabled plugins as an associative array.
     * Array keys are the plugin names, and values are potentially the plugin location
     *
     * @return array
     */
    public function getPlugins()
    {
        return $this->plugins;
    }

    /**
     * Get list of plugins without custom locations, which is the set of
     * plugins which can be loaded via the standard plugin path, and could
     * potentially be minified
     *
     * @return array
     */
    public function getInternalPlugins()
    {
        // Return only plugins with no custom url
        $plugins = [];
        foreach ($this->getPlugins() as $name => $url) {
            if (empty($url)) {
                $plugins[] = $name;
            }
        }
        return $plugins;
    }

    /**
     * Get all button rows, skipping empty rows
     *
     * @return array
     */
    public function getButtons()
    {
        return array_filter($this->buttons);
    }

    /**
     * Totally re-set the buttons on a given line
     *
     * @param int $line The line number to redefine, from 1 to 3
     * @param string $buttons,... A string or several strings, or a single array of strings.

There is no parameter named $buttons,.... Did you maybe mean $buttons?

     * The button names to assign to this line.
     * @return $this
     */
    public function setButtonsForLine($line, $buttons)
    {
        if (func_num_args() > 2) {
            $buttons = func_get_args();
            array_shift($buttons);
        }
        $this->buttons[$line] = is_array($buttons) ? $buttons : array($buttons);
        return $this;
    }

    /**
     * Add buttons to the end of a line
     * @param int $line The line number to redefine, from 1 to 3
     * @param string $buttons,... A string or several strings, or a single array of strings.

There is no parameter named $buttons,.... Did you maybe mean $buttons?

     * The button names to add to this line
     * @return $this
     */
    public function addButtonsToLine($line, $buttons)
    {
        if (func_num_args() > 2) {
            $buttons = func_get_args();
            array_shift($buttons);
        }
        if (!is_array($buttons)) {
            $buttons = [$buttons];
        }
        foreach ($buttons as $button) {
            $this->buttons[$line][] = $button;
        }
        return $this;
    }

    /**
     * Internal function for adding and removing buttons related to another button
     * @param string $name The name of the button to modify
     * @param int $offset The offset relative to that button to perform an array_splice at.
     * 0 for before $name, 1 for after.
     * @param int $del The number of buttons to remove at the position given by index(string) + offset
     * @param mixed $add An array or single item to insert at the position given by index(string) + offset,
     * or null for no insertion
     * @return bool True if $name matched a button, false otherwise
     */
    protected function modifyButtons($name, $offset, $del = 0, $add = null)
    {
        foreach ($this->buttons as &$buttons) {
            if (($idx = array_search($name, $buttons)) !== false) {
                if ($add) {
                    array_splice($buttons, $idx + $offset, $del, $add);
                } else {
                    array_splice($buttons, $idx + $offset, $del);
                }
                return true;
            }
        }
        return false;
    }

    /**
     * Insert buttons before the first occurance of another button
     * @param string $before the name of the button to insert other buttons before
     * @param string $buttons,... a string, or several strings, or a single array of strings.

There is no parameter named $buttons,.... Did you maybe mean $buttons?

     * The button names to insert before that button
     * @return bool True if insertion occured, false if it did not (because the given button name was not found)
     */
    public function insertButtonsBefore($before, $buttons)

This method seems to be duplicated in your project.

    {
        if (func_num_args() > 2) {
            $buttons = func_get_args();
            array_shift($buttons);
        }
        if (!is_array($buttons)) {
            $buttons = [$buttons];
        }
        return $this->modifyButtons($before, 0, 0, $buttons);
    }

    /**
     * Insert buttons after the first occurance of another button
     * @param string $after the name of the button to insert other buttons before
     * @param string $buttons,... a string, or several strings, or a single array of strings.

There is no parameter named $buttons,.... Did you maybe mean $buttons?

     * The button names to insert after that button
     * @return bool True if insertion occured, false if it did not (because the given button name was not found)
     */
    public function insertButtonsAfter($after, $buttons)

This method seems to be duplicated in your project.

    {
        if (func_num_args() > 2) {
            $buttons = func_get_args();
            array_shift($buttons);
        }
        if (!is_array($buttons)) {
            $buttons = [$buttons];
        }
        return $this->modifyButtons($after, 1, 0, $buttons);
    }

    /**
     * Remove the first occurance of buttons
     * @param string $buttons,... one or more strings - the name of the buttons to remove

There is no parameter named $buttons,.... Did you maybe mean $buttons?

     */
    public function removeButtons($buttons)

This method seems to be duplicated in your project.

    {
        if (func_num_args() > 1) {
            $buttons = func_get_args();
        }
        if (!is_array($buttons)) {
            $buttons = [$buttons];
        }
        foreach ($buttons as $button) {
            $this->modifyButtons($button, 0, 1);
        }
    }

    /**
     * Generate the JavaScript that will set TinyMCE's configuration:
     * - Parse all configurations into JSON objects to be used in JavaScript
     * - Includes TinyMCE and configurations using the {@link Requirements} system
     *
     * @return array
     */
    protected function getConfig()
    {
        $settings = $this->getSettings();

        // https://www.tinymce.com/docs/configure/url-handling/#document_base_url
        $settings['document_base_url'] = Director::absoluteBaseURL();

        // https://www.tinymce.com/docs/api/class/tinymce.editormanager/#baseURL
        $tinyMCEBaseURL = Controller::join_links(
            Director::absoluteBaseURL(),
            $this->getTinyMCEPath()
        );
        $settings['baseURL'] = $tinyMCEBaseURL;

        // map all plugins to absolute urls for loading
        $plugins = array();
        foreach ($this->getPlugins() as $plugin => $path) {
            if (!$path) {
                // Empty paths: Convert to urls in standard base url
                $path = Controller::join_links(
                    $tinyMCEBaseURL,
                    "plugins/{$plugin}/plugin.min.js"
                );
            } elseif (!Director::is_absolute_url($path)) {
                // Non-absolute urls are made absolute
                $path = Director::absoluteURL($path);
            }
            $plugins[$plugin] = $path;
        }

        // https://www.tinymce.com/docs/configure/integration-and-setup/#external_plugins
        if ($plugins) {

The expression $plugins of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            $settings['external_plugins'] = $plugins;
        }

        // https://www.tinymce.com/docs/configure/editor-appearance/#groupingtoolbarcontrols
        $buttons = $this->getButtons();
        $settings['toolbar'] = [];
        foreach ($buttons as $rowButtons) {
            $row = implode(' ', $rowButtons);
            if (count($buttons) > 1) {
                $settings['toolbar'][] = $row;
            } else {
                $settings['toolbar'] = $row;
            }
        }

        // https://www.tinymce.com/docs/configure/content-appearance/#content_css
        $settings['content_css'] = $this->getEditorCSS();

        // https://www.tinymce.com/docs/configure/editor-appearance/#theme_url
        $theme = $this->getTheme();
        if (!Director::is_absolute_url($theme)) {
            $theme = Controller::join_links($tinyMCEBaseURL, "themes/{$theme}/theme.min.js");
        }
        $settings['theme_url'] = $theme;

        // Send back
        return $settings;
    }

    /**
     * Get location of all editor.css files
     *
     * @return array
     */
    protected function getEditorCSS()
    {
        $editor = array();

        // Add standard editor.css
        $editor[] = Director::absoluteURL(ltrim($this->getAdminPath() . '/client/dist/styles/editor.css', '/'));

        // Themed editor.css
        $themedEditor = ThemeResourceLoader::instance()->findThemedCSS('editor', SSViewer::get_themes());
        if ($themedEditor) {

The expression $themedEditor of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

            $editor[] = Director::absoluteURL($themedEditor, Director::BASE);
        }

        return $editor;
    }

    /**
     * Generate gzipped TinyMCE configuration including plugins and languages.
     * This ends up "pre-loading" TinyMCE bundled with the required plugins
     * so that multiple HTTP requests on the client don't need to be made.
     *
     * @return string
     */
    public function getScriptURL()
    {
        // If gzip is disabled just return core script url
        $useGzip = HTMLEditorField::config()->get('use_gzip');
        if (!$useGzip) {
            return $this->getTinyMCEPath() . '/tinymce.min.js';
        }

        // tinyMCE JS requirement
        $gzipPath = BASE_PATH . '/' . $this->getTinyMCEPath() . '/tiny_mce_gzip.php';
        if (!file_exists($gzipPath)) {
            throw new Exception("HTMLEditorField.use_gzip enabled, but file $gzipPath does not exist!");
        }

        require_once $gzipPath;

        $tag = TinyMCE_Compressor::renderTag(array(
            'url' => $this->getTinyMCEPath() . '/tiny_mce_gzip.php',
            'plugins' => implode(',', $this->getInternalPlugins()),
            'themes' => $this->getTheme(),
            'languages' => $this->getOption('language')
        ), true);
        preg_match('/src="([^"]*)"/', $tag, $matches);

        return html_entity_decode($matches[1]);
    }

    public function init()
    {
        // include TinyMCE Javascript
        Requirements::javascript($this->getScriptURL());
    }


    /**
     * Get the current tinyMCE language
     *
     * @return string Language
     */
    public static function get_tinymce_lang()
    {
        $lang = static::config()->get('tinymce_lang');
        $locale = i18n::get_locale();
        if (isset($lang[$locale])) {
            return $lang[$locale];
        }
        return 'en';
    }

    /**
     * @return string|false
     */
    public function getAdminPath()
    {
        $module = $this->getAdminModule();
        if ($module) {
            return $module->getRelativePath();
        }
        return false;
    }

    /**
     * @return string|false
     */
    public function getTinyMCEPath()
    {
        $configDir = static::config()->get('base_dir');
        if ($configDir) {
            return $configDir;
        }

        if ($admin = $this->getAdminModule()) {
            return $admin->getResourcePath('thirdparty/tinymce');
        }

        throw new Exception(sprintf(
            'If the silverstripe/admin module is not installed, 
            you must set the TinyMCE path in %s.base_dir',
            __CLASS__
        ));
    }

    /**
     * @return \SilverStripe\Core\Manifest\Module
     */
    protected function getAdminModule()
    {
        return ModuleLoader::instance()->getManifest()->getModule('silverstripe/admin');
    }
}