FIX Update config to support tinymce6

This commit is contained in:
Guy Sartorelli 2022-09-19 17:00:10 +12:00
parent 433926fc11
commit ef8a02dfdc
No known key found for this signature in database
GPG Key ID: F313E3B9504D496A
3 changed files with 101 additions and 46 deletions

View File

@ -24,18 +24,23 @@ use SilverStripe\View\ThemeResourceLoader;
class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
{ {
/** /**
* Map of locales to tinymce's supported languages
*
* @link https://www.tiny.cloud/get-tiny/language-packages/
* @config * @config
* @var array * @var array
*/ */
private static $tinymce_lang = [ private static $tinymce_lang = [
'ar_EG' => 'ar', 'ar_EG' => 'ar',
'az_AZ' => 'az',
'bg_BG' => 'bg_BG',
'ca_AD' => 'ca', 'ca_AD' => 'ca',
'ca_ES' => 'ca', 'ca_ES' => 'ca',
'cs_CZ' => 'cs', 'cs_CZ' => 'cs',
'cy_GB' => 'cy', 'cy_GB' => 'cy',
'da_DK' => 'da', 'da_DK' => 'da',
'da_GL' => 'da', 'da_GL' => 'da',
'de_AT' => 'de_AT', 'de_AT' => 'de',
'de_BE' => 'de', 'de_BE' => 'de',
'de_CH' => 'de', 'de_CH' => 'de',
'de_DE' => 'de', 'de_DE' => 'de',
@ -70,9 +75,12 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'es_AD' => 'es', 'es_AD' => 'es',
'es_BZ' => 'es', 'es_BZ' => 'es',
'es_US' => 'es', 'es_US' => 'es',
'fa_AF' => 'fa_IR', 'et_EE' => 'et',
'fa_IR' => 'fa_IR', 'eo_XX' => 'eo',
'fa_PK' => 'fa_IR', 'fa_AF' => 'fa',
'fa_IR' => 'fa',
'fa_PK' => 'fa',
'ff_FI' => 'fi',
'fr_BE' => 'fr_FR', 'fr_BE' => 'fr_FR',
'fr_BF' => 'fr_FR', 'fr_BF' => 'fr_FR',
'fr_BI' => 'fr_FR', 'fr_BI' => 'fr_FR',
@ -117,10 +125,14 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'fr_GB' => 'fr_FR', 'fr_GB' => 'fr_FR',
'fr_US' => 'fr_FR', 'fr_US' => 'fr_FR',
'he_IL' => 'he_IL', 'he_IL' => 'he_IL',
'hi_IN' => 'hi',
'hr_HR' => 'hr',
'hu_HU' => 'hu_HU', 'hu_HU' => 'hu_HU',
'hu_AT' => 'hu_HU', 'hu_AT' => 'hu_HU',
'hu_RO' => 'hu_HU', 'hu_RO' => 'hu_HU',
'hu_RS' => 'hu_HU', 'hu_RS' => 'hu_HU',
'id_ID' => 'id',
'is_IS' => 'is_IS',
'it_CH' => 'it', 'it_CH' => 'it',
'it_IT' => 'it', 'it_IT' => 'it',
'it_SM' => 'it', 'it_SM' => 'it',
@ -132,23 +144,27 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'ko_KP' => 'ko_KR', 'ko_KP' => 'ko_KR',
'ko_KR' => 'ko_KR', 'ko_KR' => 'ko_KR',
'ko_CN' => 'ko_KR', 'ko_CN' => 'ko_KR',
'lt_LT' => 'lt',
'lv_LV' => 'lv',
'nb_NO' => 'nb_NO', 'nb_NO' => 'nb_NO',
'nb_SJ' => 'nb_NO', 'nb_SJ' => 'nb_NO',
'ne_NP' => 'ne',
'nl_AN' => 'nl', 'nl_AN' => 'nl',
'nl_AW' => 'nl', 'nl_AW' => 'nl',
'nl_BE' => 'nl', 'nl_BE' => 'nl_BE',
'nl_NL' => 'nl', 'nl_NL' => 'nl',
'nl_SR' => 'nl', 'nl_SR' => 'nl',
'pl_PL' => 'pl', 'pl_PL' => 'pl',
'pl_UA' => 'pl', 'pl_UA' => 'pl',
'pt_AO' => 'pt_PT', // Note: All of the pt_* except pt_BR should map to pt_PT but that translation isn't available for tinymce6 yet.
'pt_AO' => 'pt_BR',
'pt_BR' => 'pt_BR', 'pt_BR' => 'pt_BR',
'pt_CV' => 'pt_PT', 'pt_CV' => 'pt_BR',
'pt_GW' => 'pt_PT', 'pt_GW' => 'pt_BR',
'pt_MZ' => 'pt_PT', 'pt_MZ' => 'pt_BR',
'pt_PT' => 'pt_PT', 'pt_PT' => 'pt_BR',
'pt_ST' => 'pt_PT', 'pt_ST' => 'pt_BR',
'pt_TL' => 'pt_PT', 'pt_TL' => 'pt_BR',
'ro_MD' => 'ro', 'ro_MD' => 'ro',
'ro_RO' => 'ro', 'ro_RO' => 'ro',
'ro_RS' => 'ro', 'ro_RS' => 'ro',
@ -160,24 +176,27 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'ru_UA' => 'ru', 'ru_UA' => 'ru',
'sk_SK' => 'sk', 'sk_SK' => 'sk',
'sk_RS' => 'sk', 'sk_RS' => 'sk',
'sl_SI' => 'sl_SI',
'sr_RS' => 'sr',
'sv_FI' => 'sv_SE', 'sv_FI' => 'sv_SE',
'sv_SE' => 'sv_SE', 'sv_SE' => 'sv_SE',
'th_TH' => 'th_TH',
'tr_CY' => 'tr', 'tr_CY' => 'tr',
'tr_TR' => 'tr_TR', 'tr_TR' => 'tr',
'tr_DE' => 'tr', 'tr_DE' => 'tr',
'tr_MK' => 'tr', 'tr_MK' => 'tr',
'uk_UA' => 'uk_UA', 'uk_UA' => 'uk',
'vi_VN' => 'vi_VN', 'vi_VN' => 'vi',
'vi_US' => 'vi_VN', 'vi_US' => 'vi',
'zh_CN' => 'zh_CN', 'zh_CN' => 'zh_Hans',
'zh_HK' => 'zh_CN', 'zh_HK' => 'zh_Hans',
'zh_MO' => 'zh_CN', 'zh_MO' => 'zh_Hans',
'zh_SG' => 'zh_CN', 'zh_SG' => 'zh_Hans',
'zh_TW' => 'zh_TW', 'zh_TW' => 'zh_Hans',
'zh_ID' => 'zh_CN', 'zh_ID' => 'zh_Hans',
'zh_MY' => 'zh_CN', 'zh_MY' => 'zh_Hans',
'zh_TH' => 'zh_CN', 'zh_TH' => 'zh_Hans',
'zh_US' => 'zh_CN', 'zh_US' => 'zh_Hans',
]; ];
/** /**
@ -193,6 +212,16 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
*/ */
private static $base_dir = null; private static $base_dir = null;
/**
* Location of tinymce translation files relative to BASE_DIR.
*
* Supports vendor/module:path
*
* @config
* @var string
*/
private static $lang_dir = null;
/** /**
* Extra editor.css file paths. * Extra editor.css file paths.
* *
@ -226,12 +255,12 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
/** /**
* TinyMCE JS settings * TinyMCE JS settings
* *
* @link https://www.tinymce.com/docs/configure/ * @link https://www.tiny.cloud/docs/tinymce/6/tinydrive-getting-started/#configure-the-required-tinymce-options
* *
* @var array * @var array
*/ */
protected $settings = [ protected $settings = [
'fix_list_elements' => true, // https://www.tinymce.com/docs/configure/content-filtering/#fix_list_elements 'fix_list_elements' => true, // https://www.tiny.cloud/docs/tinymce/6/content-filtering/#fix_list_elements
'formats' => [ 'formats' => [
'alignleft' => [ 'alignleft' => [
[ [
@ -275,14 +304,16 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'browser_spellcheck' => true, 'browser_spellcheck' => true,
'body_class' => 'typography', 'body_class' => 'typography',
'statusbar' => true, 'statusbar' => true,
'elementpath' => true, // https://www.tinymce.com/docs/configure/editor-appearance/#elementpath 'elementpath' => true, // https://www.tiny.cloud/docs/tinymce/6/statusbar-configuration-options/#elementpath
'relative_urls' => true, 'relative_urls' => true,
'remove_script_host' => true, 'remove_script_host' => true,
'convert_urls' => false, // Prevent site-root images being rewritten to base relative 'convert_urls' => false, // Prevent site-root images being rewritten to base relative
'menubar' => false, 'menubar' => false,
'language' => 'en', 'language' => 'en',
'branding' => false, 'branding' => false,
'promotion' => false,
'upload_folder_id' => null, // Set folder ID for insert media dialog 'upload_folder_id' => null, // Set folder ID for insert media dialog
'link_default_target' => '_blank', // https://www.tiny.cloud/docs/tinymce/6/autolink/#example-using-link_default_target
]; ];
/** /**
@ -293,10 +324,13 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
protected $plugins = [ protected $plugins = [
'table' => null, 'table' => null,
'emoticons' => null, 'emoticons' => null,
'paste' => null,
'code' => null, 'code' => null,
'importcss' => null, 'importcss' => null,
'lists' => null, 'lists' => null,
'autolink' => null,
'searchreplace' => null,
'visualblocks' => null,
'wordcount' => null,
]; ];
/** /**
@ -304,7 +338,7 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
* *
* @var string * @var string
*/ */
protected $theme = 'modern'; protected $theme = 'silver';
/** /**
* Get the theme * Get the theme
@ -331,7 +365,7 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
/** /**
* Holder list of buttons, organised by line. This array is 1-based indexed array * 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} * {@link https://www.tiny.cloud/docs/tinymce/6/basic-setup/#toolbar-configuration}
* *
* @var array * @var array
*/ */
@ -342,10 +376,10 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
'bullist', 'numlist', 'outdent', 'indent', 'bullist', 'numlist', 'outdent', 'indent',
], ],
2 => [ 2 => [
'formatselect', '|', 'blocks', '|',
'paste', 'pastetext', '|', 'pastetext', '|',
'table', 'sslink', 'unlink', '|', 'table', 'sslink', 'unlink', '|',
'code' 'code', 'visualblocks'
], ],
3 => [] 3 => []
]; ];
@ -396,7 +430,7 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
* the plugin will be loaded by tinymce.PluginManager.load() instead of through tinyMCE.init(). * 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. * 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 * @see https://www.tiny.cloud/docs/tinymce/6/editor-important-options/#external_plugins
* *
* If passing in a non-associative array, the plugin name should be located in the standard tinymce * If passing in a non-associative array, the plugin name should be located in the standard tinymce
* plugins folder. * plugins folder.
@ -619,10 +653,10 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
{ {
$settings = $this->getSettings(); $settings = $this->getSettings();
// https://www.tinymce.com/docs/configure/url-handling/#document_base_url // https://www.tiny.cloud/docs/tinymce/6/url-handling/#document_base_url
$settings['document_base_url'] = Director::absoluteBaseURL(); $settings['document_base_url'] = Director::absoluteBaseURL();
// https://www.tinymce.com/docs/api/class/tinymce.editormanager/#baseURL // https://www.tiny.cloud/docs/tinymce/6/apis/tinymce.root/#properties
$baseResource = $this->getTinyMCEResource(); $baseResource = $this->getTinyMCEResource();
if ($baseResource instanceof ModuleResource) { if ($baseResource instanceof ModuleResource) {
$tinyMCEBaseURL = $baseResource->getURL(); $tinyMCEBaseURL = $baseResource->getURL();
@ -649,12 +683,12 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
$plugins[$plugin] = $path; $plugins[$plugin] = $path;
} }
// https://www.tinymce.com/docs/configure/integration-and-setup/#external_plugins // https://www.tiny.cloud/docs/tinymce/6/editor-important-options/#external_plugins
if ($plugins) { if ($plugins) {
$settings['external_plugins'] = $plugins; $settings['external_plugins'] = $plugins;
} }
// https://www.tinymce.com/docs/configure/editor-appearance/#groupingtoolbarcontrols // https://www.tiny.cloud/docs/tinymce/6/basic-setup/#toolbar-configuration
$buttons = $this->getButtons(); $buttons = $this->getButtons();
$settings['toolbar'] = []; $settings['toolbar'] = [];
foreach ($buttons as $rowButtons) { foreach ($buttons as $rowButtons) {
@ -666,10 +700,10 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
} }
} }
// https://www.tinymce.com/docs/configure/content-appearance/#content_css // https://www.tiny.cloud/docs/tinymce/6/add-css-options/#content_css
$settings['content_css'] = $this->getEditorCSS(); $settings['content_css'] = $this->getEditorCSS();
// https://www.tinymce.com/docs/configure/editor-appearance/#theme_url // https://www.tiny.cloud/docs/tinymce/6/editor-theme/#theme_url
$theme = $this->getTheme(); $theme = $this->getTheme();
if (!Director::is_absolute_url($theme)) { if (!Director::is_absolute_url($theme)) {
$theme = Controller::join_links($tinyMCEBaseURL, "themes/{$theme}/theme.min.js"); $theme = Controller::join_links($tinyMCEBaseURL, "themes/{$theme}/theme.min.js");
@ -821,6 +855,22 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
return 'en'; return 'en';
} }
/**
* Get the URL for the language pack of the current language
*
* @return string Language
*/
public static function get_tinymce_lang_url(): string
{
$lang = static::get_tinymce_lang();
$dir = static::config()->get('lang_dir');
if ($lang !== 'en' && !empty($dir)) {
$resource = ModuleResourceLoader::singleton()->resolveResource($dir);
return Director::absoluteURL($resource->getRelativeResource($lang . '.js')->getURL());
}
return '';
}
/** /**
* Returns the full filesystem path to TinyMCE resources (which could be different from the original tinymce * Returns the full filesystem path to TinyMCE resources (which could be different from the original tinymce
* location in the module). * location in the module).
@ -893,7 +943,6 @@ class TinyMCEConfig extends HTMLEditorConfig implements i18nEntityProvider
return ModuleLoader::getModule('silverstripe/admin'); return ModuleLoader::getModule('silverstripe/admin');
} }
/** /**
* Sets the upload folder name used by the insert media dialog * Sets the upload folder name used by the insert media dialog
* *

View File

@ -58,7 +58,7 @@ class HTMLEditorConfigTest extends SapphireTest
$c = new TinyMCEConfig(); $c = new TinyMCEConfig();
$c->setTheme('modern'); $c->setTheme('modern');
$c->setOption('language', 'es'); $c->setOption('language', 'es');
$c->disablePlugins('table', 'emoticons', 'paste', 'code', 'link', 'importcss', 'lists'); $c->disablePlugins('table', 'emoticons', 'code', 'link', 'importcss', 'lists', 'autolink', 'searchreplace', 'visualblocks', 'wordcount');
$c->enablePlugins( $c->enablePlugins(
[ [
'plugin1' => 'mypath/plugin1.js', 'plugin1' => 'mypath/plugin1.js',

View File

@ -21,15 +21,20 @@ class TinyMCEConfigTest extends SapphireTest
*/ */
public function testLanguagesValid() public function testLanguagesValid()
{ {
$configDir = TinyMCEConfig::config()->get('base_dir'); $configDir = TinyMCEConfig::config()->get('lang_dir');
if (!$configDir) { if (!$configDir) {
$this->markTestSkipped("Test skipped without TinyMCE resources folder being installed"); $this->markTestSkipped("Test skipped without TinyMCE language resource folder being installed");
} }
$langs = Director::baseFolder() . '/' . ModuleResourceLoader::resourcePath($configDir) . '/langs'; $langs = Director::baseFolder() . '/' . ModuleResourceLoader::resourcePath($configDir);
// Test all langs exist as real files // Test all langs exist as real files
$checked = [];
foreach (TinyMCEConfig::config()->get('tinymce_lang') as $locale => $resource) { foreach (TinyMCEConfig::config()->get('tinymce_lang') as $locale => $resource) {
// No need to check the same file twice.
if (array_key_exists($resource, $checked)) {
continue;
}
// Check valid // Check valid
$this->assertFileExists( $this->assertFileExists(
"{$langs}/{$resource}.js", "{$langs}/{$resource}.js",
@ -42,6 +47,7 @@ class TinyMCEConfigTest extends SapphireTest
"Locale code {$locale} doesn't map to simple {$resource}.js when a better {$locale}.js is available" "Locale code {$locale} doesn't map to simple {$resource}.js when a better {$locale}.js is available"
); );
} }
$checked[$resource] = true;
} }
} }