From d1965bd8a447e386e7c4f2e0f2e0d55bebf1b580 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Wed, 6 Dec 2023 13:11:02 +1000 Subject: [PATCH] DOC-2181: TinyMCE 6.8.1 release notes. (#2956) * DOC-2181: TinyMCE 6.8 release notes. * DOC-2181: add changelog entry for 6.8. * DOC-2181: add fix documentation to TINY-10154 to the 6.8 release notes. (#2957) * DOC-2181: add fix documentation for TINY-10133 to the 6.8 release notes. (#2958) * DOC-2181: add fix documentation for TINY-10133 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: vpyshnenko --------- Co-authored-by: vpyshnenko * DOC-2181: add fix documentation for TINY-10254 to the 6.8 release notes. (#2978) * DOC-2181: add fix documentation for TINY-10088 to the 6.8 release notes. (#2963) * DOC-2181: add fix documentation for TINY-10088 to the 6.8 release notes. * add ref link * DOC-2181: add addition `new feature` documentation for TINY-9974 in the 6.8 release notes. (#2959) * DOC-2181: add addition documentation for TINY-9974 in the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: vpyshnenko --------- Co-authored-by: vpyshnenko * DOC-2181: add improvement documentation for TINY-9963 to the release notes. (#2967) * DOC-2181: fix documentation for TINY-10209 in the 6.8 release notes. (#2961) * DOC-2181: add fix documentation for TINY-10162 to the 6.8 release notes. (#2968) * DOC-2181: add change documentation for TINY-10237 to the 6.8 release notes. (#2970) * DOC-2181: add fix documentation for TINY-10289 in the 6.8 release notes. (#2971) * DOC-2181: add fix documentation for TINY-10289 in the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: fix documentation for TINY-10153 to the 6.8 release notes. (#2965) * DOC-2181: add improvement documentation for TINY-10147 to the 6.8 release notes. (#2972) * DOC-2181: add improvement documentation for TINY-10155 in the 6.8 release notes. (#2962) * DOC-2181: add improvement documentation for TINY-10155 in the 6.8 release notes.' * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: mkzhx * Update modules/ROOT/pages/6.8-release-notes.adoc --------- Co-authored-by: mkzhx * DOC-2181: add fix documentation for TINY-10177 to the 6.8 release notes. (#2969) * DOC-2181: add fix documenation for TINY-10177 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: vpyshnenko * Update modules/ROOT/pages/6.8-release-notes.adoc --------- Co-authored-by: vpyshnenko * DOC-2181: fix documentation for TINY-10178 to the release notes. (#2966) * DOC-2181: fix documentation for TINY-10178 to the release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: Hamza Benkhaldoun * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: Hamza Benkhaldoun --------- Co-authored-by: Hamza Benkhaldoun * DOC-2181: add fix documentation for TINY-10139 to the release notes. (#2975) * DOC-2181: add fix documentation for TINY-10139 to the release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: add fix documentation for TINY-10132 to the 6.8 release notes. (#2973) * DOC-2181: add fix documentation for TINY-10118 to the release notes. (#2964) * DOC-2181: add fix documentation for TINY-10285 to the 6.8 release notes. (#2977) * DOC-2181: add fix documentation for TINY-10285 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * Update changelog.md * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: add fix documentation for TINY-10316 to the 6.8 release notes. (#2994) * DOC-2181: add fix documentation for TINY-10173 to the 6.7 release notes. (#2989) * DOC-2181: add fix documentation for TINY-10173 to the 6.7 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: lorenzo-pomili * Update changelog.md --------- Co-authored-by: lorenzo-pomili * DOC-2181: add fix documentation for TINY-10330 to the 6.8 release notes. (#2988) * DOC-2181: add fix documentation for TINY-10330 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: lorenzo-pomili --------- Co-authored-by: lorenzo-pomili * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: add improvement documentation for TINY-10348 & TINY-10349 to the 6.8 release notes. (#2999) * DOC-2181: add improvement documentation for TINY-10348 & TINY-10349 to the 6.8 release notes, & added new to file. * DOC-2181: update heading for Securing embedded external resources. * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: mkzhx * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: mkzhx * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: mkzhx * Update modules/ROOT/partials/security/securing-embedded-external-resources.adoc Co-authored-by: mkzhx * Update modules/ROOT/partials/security/securing-embedded-external-resources.adoc Co-authored-by: mkzhx * Update modules/ROOT/partials/security/securing-embedded-external-resources.adoc Co-authored-by: mkzhx * Update modules/ROOT/partials/security/securing-embedded-external-resources.adoc Co-authored-by: mkzhx --------- Co-authored-by: mkzhx * DOC-2181: add fix documentation for TINY-9393 to the 6.8 release notes. (#3005) * DOC-2181: add documentation for TINY-10159 to the 6.8 release notes. (#3004) * DOC-2181: add documentation for TINY-10159 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: Mitchell Crompton --------- Co-authored-by: Mitchell Crompton * DOC-2181: add fix documentation for TINY-9796 to the 6.8 release notes. (#2990) * DOC-2181: add fix documentation for TINY-9796 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: shanmen-tiny --------- Co-authored-by: shanmen-tiny * DOC-2181: add fix documentation for TINY-10172 to the 6.8 release notes. (#2991) * DOC-2181: added fix documentation for TINY-10229 to the 6.8 release notes. (#2992) * DOC-2181: added fix documentation for TINY-10229 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: Hamza Benkhaldoun --------- Co-authored-by: Hamza Benkhaldoun * DOC-2181: add fix documentation for TINY-10174 to the 6.8 release notes. (#3003) * DOC-2181: add fix documentation for TINY-10174 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: Mitchell Crompton * Update 6.8-release-notes.adoc Co-authored-by: Mitchell Crompton --------- Co-authored-by: Mitchell Crompton * DOC-2181: add fix documentation for TINY-10343 to the 6.8 release notes. (#3006) * DOC-2181: add fix documentation for TINY-10343 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: lorenzo-pomili --------- Co-authored-by: lorenzo-pomili * DOC-2181: add fix documentation for TINY-10291 to the 6.8 release notes. (#2995) * DOC-2181: add fix documentation for TINY-10367 to the 6.8 release notes. (#3002) * DOC-2181: add fix documentation for TINY-10367 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc Co-authored-by: vpyshnenko --------- Co-authored-by: vpyshnenko * DOC-2181: add fix documentation for TINY-10292 to the 6.8 release notes. (#3007) * DOC-2181: add fix documentation for TINY-10241 to the 6.8 release notes. (#3009) * DOC-2181: add fix documentation for TINY-10282 to the 6.8 release notes. (#2986) * DOC-2181: add fix documentation for TINY-10282 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: add fix documentation for TINY-9819 to the 6.8 release notes. (#2996) * DOC-2181: add improvement documentation for TINY-9287 to the 6.8 release notes. (#2987) * DOC-2181: add improvement documentation for TINY-9287 to the 6.8 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: add improvement documentation for TINY-10141 to the 6.8.1 release notes. (#3008) * DOC-2181: add improvement documentation for TINY-10141 to the 6.8.1 release notes. * Update modules/ROOT/pages/6.8-release-notes.adoc * DOC-2181: tinymce docs bump to , and various copy edit/changes. * DOC-2181: update changelog.md entries from 6.8.0 to 6.8.1. * DOC-2181: copy edits, and minor changes. * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Apply suggestions from code review Co-authored-by: tiny-ben-tran * DOC-2181: add fix documentation for TINY-10385 to the 6.8.1 release notes (#3019) * DOc-2181: add fix documentation for TINY-10385 to the 6.8.1 release notes. * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/partials/configuration/force_hex_color.adoc Co-authored-by: spocke * Update modules/ROOT/pages/6.8.1-release-notes.adoc * Update modules/ROOT/partials/configuration/force_hex_color.adoc * Update modules/ROOT/pages/6.8.1-release-notes.adoc Co-authored-by: vpyshnenko * DOC-2181: add documentation for TINY-10290 to the 6.8.1 release notes. (#3021) * Update changelog.md --------- Co-authored-by: vpyshnenko Co-authored-by: mkzhx Co-authored-by: Hamza Benkhaldoun Co-authored-by: lorenzo-pomili Co-authored-by: Mitchell Crompton Co-authored-by: shanmen-tiny Co-authored-by: tiny-ben-tran Co-authored-by: spocke --- changelog.md | 49 +- modules/ROOT/nav.adoc | 7 + modules/ROOT/pages/6.8.1-release-notes.adoc | 575 ++++++++++++++++++ modules/ROOT/pages/content-formatting.adoc | 2 + modules/ROOT/pages/release-notes.adoc | 6 + modules/ROOT/pages/security.adoc | 6 + .../configuration/force_hex_color.adoc | 25 + .../securing-embedded-external-resources.adoc | 43 ++ 8 files changed, 712 insertions(+), 1 deletion(-) create mode 100644 modules/ROOT/pages/6.8.1-release-notes.adoc create mode 100644 modules/ROOT/partials/configuration/force_hex_color.adoc create mode 100644 modules/ROOT/partials/security/securing-embedded-external-resources.adoc diff --git a/changelog.md b/changelog.md index 4a749072a5..62b6338e62 100644 --- a/changelog.md +++ b/changelog.md @@ -6,6 +6,53 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/ ### Unreleased + +### 2023-12-06 + +- DOC-2181: add `new feature` documentation for TINY-10290 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10385 to the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-10141 to the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-9287 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-9819 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10282 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10241 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10292 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10367 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10291 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10343 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10174 to the 6.8.1 release notes. +- DOC-2181: added fix documentation for TINY-10229 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10172 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-9796 to the 6.8.1 release notes. +- DOC-2181: add `new feature` documentation for TINY-10159 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-9393 to the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-10348 & TINY-10349 to the 6.8.1 release notes, & added new `options` to `security/securing-embedded-external-resources.adoc` file. +- DOC-2181: add fix documentation for TINY-10330 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10173 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10316 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10285 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10118 to the release notes. +- DOC-2181: add fix documentation for TINY-10132 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10139 to the release notes. +- DOC-2181: fix documentation for TINY-10178 to the release notes. +- DOC-2181: add fix documentation for TINY-10177 to the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-10155 in the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-10147 to the 6.8.1 release notes. +- DOC-2181: fix documentation for TINY-10153 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10289 in the 6.8.1 release notes. +- DOC-2181: add change documentation for TINY-10237 to the 6.8.1 release notes. +- DOC-2181: fix documentation for TINY-10209 in the 6.8.1 release notes. +- DOC-2181: add improvement documentation for TINY-9963 to the release notes. +- DOC-2181: add addition `new feature` documentation for TINY-9974 in the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10088 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10254 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10133 to the 6.8.1 release notes. +- DOC-2181: add fix documentation for TINY-10154 to the 6.8.1 release notes. +- DOC-2181: the TinyMCE 6.8.1 release notes plus 6.8.1-specific changes to the TinyMCE documentation. +- DOC-2075: remove `tinymcespellchecker` configuration workaround from full-featured-demo with Premium plugins examples: `/modules/ROOT/examples/live-demos/full-featured/example.js` and `/modules/ROOT/examples/live-demos/full-featured/index.js`. +- DOC-2182: added file, `/modules/ROOT/partials/configuration/indent.adoc`, documenting the `indent` option. Added `include::` statement to `/modules/ROOT/pages/content-filtering.adoc` pointing to this file. +- DOC-2189: added template files with instructions to `-new-material-templates/plugin-documentation-templates/ROOT/pages`. Added further boilerplate — a generic version-required include statement — and instructions regarding this boilerplate to `pluginpage.adoc`. Added new template file-and-folder infrastructure, `/-new-material-templates/configuration-options-templates`. Added boilerplate and documentation to the files in this new infrastructure. Also corrected markup typo in `modules/ROOT/pages/available-menu-items.adoc`. +- DOC-2177: Added documentation of the `picker_text` property to the `urlinput` dialog component of `dialog-components.adoc`. - DOC-2228: Updates new bundling with `js` feature, `additional` copy edits to bundling with es6 vite documentation. - DOC-2215: add new feature `mce-clipboard` to 6.8.1 release project for AdvTemplate. - DOC-2216: add new single `js` bundling feature example for `Bundling an npm version of TinyMCE with ES6 and Vite`. @@ -19,7 +66,7 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/ ### 2023-11-22 -- DOC-2180: Added 6.8-specific entry to `changelog.adoc`. +- DOC-2180: Added 6.8.0-specific entry to `changelog.adoc`. ### 2023-11-15 diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 418c5240f2..92e7321f0b 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -405,6 +405,13 @@ ** xref:tinymce-and-cors.adoc[Cross-Origin Resource Sharing (CORS)] * Release information ** xref:release-notes.adoc[Release notes for TinyMCE 6] +*** TinyMCE 6.8.1 +**** xref:6.8.1-release-notes.adoc#overview[Overview] +**** xref:6.8.1-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes] +**** xref:6.8.1-release-notes.adoc#accompanying-premium-skins-and-icon-packs-changes[Accompanying Premium Skins and Icon Packs changes] +**** xref:6.8.1-release-notes.adoc#improvements[Improvements] +**** xref:6.8.1-release-notes.adoc#additions[Additions] +**** xref:6.8.1-release-notes.adoc#bug-fixes[Bug fixes] *** TinyMCE 6.7.3 **** xref:6.7.3-release-notes.adoc#overview[Overview] **** xref:6.7.3-release-notes.adoc#security-fix[Security fix] diff --git a/modules/ROOT/pages/6.8.1-release-notes.adoc b/modules/ROOT/pages/6.8.1-release-notes.adoc new file mode 100644 index 0000000000..e87e26a63c --- /dev/null +++ b/modules/ROOT/pages/6.8.1-release-notes.adoc @@ -0,0 +1,575 @@ += TinyMCE 6.8.1 +:navtitle: TinyMCE 6.8.1 +:description: Release notes for TinyMCE 6.8.1 +:keywords: releasenotes, new, changes, bugfixes +:page-toclevels: 1 + +include::partial$misc/admon-releasenotes-for-stable.adoc[] + +[[overview]] +== Overview + +{productname} 6.8.1 was released for {enterpriseversion} and {cloudname} on Wednesday, December 06 ^th^, 2023. These release notes provide an overview of the changes for {productname} 6.8.1, including: + +* xref:accompanying-premium-plugin-changes[Accompanying Premium plugin changes] +* xref:accompanying-premium-skins-and-icon-packs-changes[Accompanying Premium Skins and Icon Packs changes] +* xref:improvements[Improvements] +* xref:additions[Additions] +* xref:bug-fixes[Bug fixes] + + +[[accompanying-premium-plugin-changes]] +== Accompanying Premium plugin changes + +The following premium plugin updates were released alongside {productname} 6.8.1. + +=== Advanced Templates 1.4.0 + +The {productname} 6.8.1 release includes an accompanying release of the **Advanced Templates** premium plugin. + +**Advanced Templates** 1.4.0 includes the following improvement and fix. + +==== New `{{mce-clipboard}}` marker as a placeholder within template content, indicating the location where clipboard content will be inserted +// #TINY-9974 +**Advanced Template** 1.4.0 introduces a new feature that allows templates to now include special markers, denoted as `+{{mce-clipboard}}+`. These markers serve as placeholders that indicate where clipboard content should be inserted once the template is added to the editor's content. + +The string to add is as follows: `+{{mce-clipboard}}+`. + +.Example +[source, javascript] +---- +tinymce.init({ + selector: "textarea", + plugins: [ "code", "advtemplate", "undo", "redo", "mergetags", ], + toolbar: "inserttemplate | undo redo | mergetags", + advtemplate_templates: [ + { + title: 'mce-clipboard template', + items: [ + { + id: '1', + title: 'clipboard', + content: '{{mce-clipboard}}' + }, + ], + }, + ], +}); +---- + +As a result, when a user inserts a template containing the `+{{mce-clipboard}}+` marker, the editor will replace these markers with the actual content from the clipboard. This dynamic replacement ensures that users can effortlessly integrate clipboard content into their templates without the need for additional copy-pasting steps. + +NOTE: when the host browser is **FireFox**, the user will be prompted with a notification error, as it currently does not support clipboard reading. + +==== The functionality of the `{{mce-cursor}}` marker feature was broken after the upgrade to {productname} 6.7.3 +// #TINY-10367 +Security patch for {productname} 6.7.3, made changes to **ZWNBSP** characters so they are now removed from any content passed via the `insertContent` API. **ZWNBSP** characters were used to add padding to the marker to avoid it cleaning out the empty content. + +As a consequence, the `+{{mce-cursor}}+` marker functionality for the Advanced Templates plugin stopped working. + +{productname} 6.8.1 addresses this issue, by replacing the **ZWNBSP** character with a `data-mce-bookmark` attribute to the marker, thus preserving them in the inserted template content. + +As a result, the `+{{mce-cursor}}+` marker functionality is now working as expected. + +For information on the **Advanced Templates** plugin, see: xref:advanced-templates.adoc[Advanced Templates]. + +=== AI Assistant 1.2.0 + +The {productname} 6.8.1 release includes an accompanying release of the **AI Assistant** premium plugin. + +**AI Assistant** 1.2.0 includes the following improvement: + +==== Add selection-based option to ai shortcuts to restrict shortcut misuse +//#TINY-10159 +In **AI Assistant 1.2.0**, the new selection property is available for shortcuts with prompts in the xref:ai.adoc#ai_shortcuts[`+ai_shortcuts+` option]. This `+boolean+` property controls when that shortcut is enabled based on the current selection within the editor. + +For a shortcut with a prompt, when the property is: + +* `+true+`: this shortcut will _only_ be enabled when user _has_ made a selection in the editor; +* `+false+`: this shortcut will _only_ be enabled when the user _has not_ made a selection in the editor; +* `+undefined+`: or _not set_, this shortcut will _always_ be enabled. + +This property allows the definition of shortcuts which should only operate when the user has selected content, requiring the selection as context to the AI when the property is `+true+`. Additionally, shortcuts that are intended to generate specific content will not be enabled with any selection when the property if `+false+`. + +As part of this update, all of the default shortcuts available in **AI Assistant 1.2.0** now have the property `+selection: false+`, as they are all shortcuts that require a selection context to generate content correctly. + +For information on the **AI Assistant** plugin, see: xref:ai.adoc[AI Assistant]. + +=== Comments 3.3.4 + +The {productname} 6.8.1 release includes an accompanying release of the **Comments** premium plugin. + +**Comments** 3.3.4 includes the following fix: + +=== Switching from an empty paragraph to a section with a comment didn't enable `Add comment...` textarea +//#TINY-10173 +In previous versions of {productname}, occasionally the sidebar would unexpectedly be set as readonly due to an invalid selection state. + +As a consequence, when the user moved the cursor from an empty element to a commented text selection, the sidebar and comments section would change to be readonly. + +{productname} 6.8.1 addresses this issue, now, when the editor verifies that the sidebar state should set as readonly `false`, it also update invalid selection to `false`, so both states do not affect the sidebar state. + +For information on the **Comments** plugin, see: xref:introduction-to-tiny-comments.adoc[Comments plugin]. + +=== PowerPaste 6.2.3 + +The {productname} 6.8.1 release includes an accompanying release of the **PowerPaste** premium plugin. + +**PowerPaste** 6.2.3 includes the following fixes: + +=== Safari - Improve pasting content with sidebar comments from the Word document +// TINY-10229 +Previously, when copying content, including comments, and subsequently pasting it into a {productname} document, the comments were also unintentionally included in the pasted data. + +{productname} 6.8.1 addresses this issue, now, when a user copies and pastes content from Word with the inclusion of comments, the **Powerpaste** plugin now excludes these comments from the pasted content. + +=== Pasting underlined content from MS Word with PowerPaste results in empty rows being underlined +// TINY-10178 +Previously, when a user pasted content from Word, the pasted content would be converted to: + +[source, html] +---- +

Sold out on tickets.

+

 

+

Sorry!

+---- + +As a consequence, two distinct behaviors were apparent. + +. Firstly, the content displayed in Word did **not** render an underline for the second line, but only as an empty line. +. In {productname} the same content renders an underline in the second line. + +To fix this, when a paragraph contains no content except for a `+ +`, then PowerPaste would unwrap that specific paragraph so that it becomes: + +[source, html] +---- +

 

+---- + +Instead of: + +[source, html] +---- +

 

+---- +**Powerpaste 6.4.2** addresses this issue, now, when a paragraph contains a `+ +` within the copied text content, the inner `s` tags, `u` tags and `spans` are removed on paste. + +=== Powerpaste pasting causes window to be scrolled when editor isn't fully visible +// TINY-10172 +Previously, when the `setProgressState(true)` API was invoked while the editor is **not** completely visible, it would trigger the editor to `focus`. + +As a consequence, the page automatically scrolls until the editor is fully visible. + +{productname} 6.8.1 addresses this issue, now, the editor retains the focus functionality whilst eliminating the need for the automatic scrolling behavior. + +As a result, the editor will still receive `focus` as intended, but the page will no longer scroll unnecessarily when pasted content is inserted. + +=== Reset table border width when the paste source is Excel from .5pt to 1px +// #TINY-10241 +Previously, when pasting a table from a Microsoft Excel document that had a solid thin border of (.5pt) such as `border: 0.5px solid #000;` into the editor when powerpaste was enabled would result in the table rendering as a `dashed` border instead of the solid border. + +{productname} 6.8.1 addresses this by updating the default table border width for tables within {productname} from `.5pt` to `1px`. + +As a result, pasting tables now retains its original solid border on paste. + +=== Spell Checker Pro 3.3.1 + +The {productname} 6.7.0 release includes an accompanying release of the **Spell Checker Pro** premium plugin. + +**Spell Checker Pro** 3.3.1 includes the following fixes: + +=== Spellchecker does not trigger on shift+enter +// TINY-10285 +Previously, while pressing **Enter**, **Spacebar** or changing context within the editor after an incorrectly spelled word would trigger the **Spell Checker Pro** plugin. Although it was discovered that after pressing **Shift+Enter**, the plugin failed to trigger, as the initial implementation did not consider this keypress as a space, or as a change to the context. + +{productname} 6.8.1 addresses this issue, now, the **Spell Checker Pro** mechanism is triggered by either **Space**, **Enter** or **Shift+Enter**. + +=== As-you-type spellechecking would sometimes interrupt composing in certain languages +// #TINY-10292 +Spell Checker Pro would in some situations be interrupted while composing when the user selects a suggestion with a `space`. + +As a consequence, issues such as duplication or other unintended outcomes would occur. + +{productname} 6.8.1 addresses this issue, by introducing a new check that prevents **as-you-type** checks from being performed if composing is already in progress. + +As a result, composing can now be done safely. + +For information on the **Spell Checker Pro** plugin, see: xref:introduction-to-tiny-spellchecker.adoc[Spell Checker Pro plugin] + +=== Advanced Typography 1.1.3 + +The {productname} 6.8.1 release includes an accompanying release of the **Advanced Typography** premium plugin. + +**Advanced Typography** 1.1.3 includes one fix: + +==== If tinymcespellchecker and typography are both loaded, tinymcespellchecker prevents typography from transforming the string, (tm) into the character ‚Ñ¢ +//#TINY-9963 +Previously when the {productname} **Spell Checker Pro** plugin and the **Advanced Typography** plugin were both loaded, the **Spell Checker Pro** plugin would prevent the **Advanced Typography** plugin from transforming the string, `(tm)` into the character `™`. + +The **Spell Checker Pro** originally would wrap elements with a fake element to underline misspelled words, and as the **Advanced Typography** plugin is designed to detect wrapped elements from the spellchecker, this resulted in it parsing 'tm' instead of `(tm)`. + +{productname} 6.8.1 addresses this issue, now, the **Advanced Typography** parser utilizes functionality provided by internal library, which enables it to identify both the prefix and suffix of an element. + +As a result when the **Advanced Typography** plugin encounters a string 'tm' the system also checks for the presence of parentheses before and after, to ensure it correctly transform's any instance of `(tm)` to `™`. + +For information on the **Advanced Typography** plugin, see: xref:advanced-typography.adoc[Advanced Typography]. + + +[[accompanying-premium-skins-and-icon-packs-changes]] +== Accompanying Premium Skins and Icon Packs changes + +The {productname} 6.8.1 release includes an accompanying release of the **Premium Skins and Icon Packs**. + +=== Premium Skins and Icon Packs + +The **Premium Skins and Icon Packs** release includes the following updates: + +The **Premium Skins and Icon Packs** were rebuilt to pull in the changes also incorporated into the default {productname} 6.8.1 skin, Oxide. + +For information on using premium skins and icon packs, see: xref:premium-skins-and-icons.adoc[Premium Skins and Icon Packs]. + + +[[improvements]] +== Improvements + +{productname} 6.8.1 also includes the following improvements: + +=== Colorpicker now includes the Brightness/Saturation selector and hue slider in the keyboard navigable items +// #TINY-9287 +As a result of an accessibility report for {productname}, it was discovered that the color picker dialog scored lower than expected, specifically when the user attempted to interact with the brightness/saturation selector and the hue slider when selecting a foreground or background color. + +As a consequence, it was noted that the color picker was not fully accessible via keyboard. + +{productname} 6.8.1.1 addresses this issue, now, when navigating through the dialog using the keyboard, the focus will be on the brightness/saturation pane, this allows the user to use the arrow keys to navigate in all four directions when selection a color. In addition when holding the "shift" key down, the navigation speed will be increased. This functionality has also been applied to the hue slider for added benefit for accessibility. + +=== Improved the tooltips of picker buttons for the urlinput components in the "Insert/Edit Image" and "Insert/Edit Link" dialogs +// #TINY-10155 +In previous versions of {productname}, the tooltips of file picker buttons of `urlinput` dialog components assumed the label of the component. + +Consequently, the tooltip does not always clearly indicate the functionality of the file picker button. This affected the `urlinput` dialog components in the **Insert/Edit Link**, **Insert/Edit Image**, and **Insert/Edit Media** dialogs. + +In {productname} 6.8.1, the tooltips of `urlinput` file picker buttons on affected dialogs have been improved as follows: + +[cols="h,1,1,1",options="header"] +|=============================================================== +| | Insert/Edit Link | Insert/Edit Image | Insert/Edit Media +| Old | "URL" | "Source" | "Source" +| New | "Browse links" | "Browse files" | "Browse files" +|=============================================================== + +=== Inline dialog will now respect size: 'large' argument in the dialog spec +// #TINY-10209 +In previous versions of {productname}, when a dialog was redialed with a new `size` value, that value would have no effect on the size of the dialog. + +In {productname} 6.8.1, now, the size of the dialog is updated when the dialog is redialed with a spec containing a new `size` that is different from the current size. + +=== Bespoke dropdown toolbar buttons including align, fontfamily, fontsize, blocks, and styles did not include their visible text labels in their accessible names +// #TINY-10147 +Prior to {productname} 6.8.1, accessibility labels of bespoke dropdown buttons only announced the name of the button, and not the visible text label of the selected option. + +For example, when the `fontfamily` dropdown button selection was set to “Verdana”, the accessibility name was set as “Fonts”. However, it should have been set as “Fonts Verdana” as the selected option is also visible on the button. + +In {productname} 6.8.1, the visible text label _(or icon name where icons are present instead)_ of selected options of bespoke dropdown buttons are appended to the accessible name. This ensures that the accessible name of the above scenario is announced as “Fonts Verdana”, improving accessibility. + + +[[additions]] +== Additions + +{productname} 6.8.1 also includes the following additions: + +=== Added `default_font_stack` editor option that makes it possible to define what is considered a system font stack. +// #TINY-10290 + +include::partial$misc/admon-requires-6.8v.adoc[] + +{productname} 6.8.1 introduces a new option `default_font_stack`, that allows integrators to define the default font stack for the "System Font" stack in the fontfamily toolbar and menu items. + +The array should contain a font family name that matches the default fonts configured in the `content_css` CSS file. + +.Example +[source,js] +---- +tinymce.init({ + selector: 'textarea', // change this value according to your HTML + toolbar: 'fontsize', + default_font_stack: [ '-apple-system', 'Arial' ] +}); +---- + +For information on the **user formatting options**, see: xref:user-formatting-options.adoc#default_font_stack[user formatting options]. + +=== Added `force_hex_color` editor option. Option `'always'` converts all RGB & RGBA colours to hex, `'rgb_only'` will only convert RGB and *not* RGBA colours to hex, `'off'` won't convert any colours to hex +// #TINY-9819 +Previously, when applying colors to content within the editor via the `forecolor` and `backcolor`, HEX colors were always converted to RGB. + +{productname} 6.8.1 addresses this issue, by adding the new editor option `force_hex_color: 'off'` which is set as **default**, can now be added to the {productname} config by; + +* **force_hex_color: 'always'**: all colors are converted and applied as HEX format. +* **force_hex_color: 'rgb_only'**: only RGB and not RGBA colors are converted and applied as HEX. +* **force_hex_color: 'off'**: (default option) no conversion to hex is applied, and they are left as their input format. + +=== New `sandbox_iframes` option that controls whether iframe elements will be added a `sandbox=""` attribute to mitigate malicious intent +// #TINY-10348 +Recently it was discovered that iframes could embed resources that can cause nefarious effects when inserted into the editor via scripting and other mechanisms. This was especially problematic if the iframe had scripts that triggered automatic downloads of malicious files, or if the iframe resource is hosted on the same origin as the editor, which could lead to highly impactful scripting in the same context. In addition, since iframes can be modified to have very small, near-invisible dimensions, they could be unintentionally copied and pasted by users into the editor. + +{productname} 6.8.1 addresses this, by introducing a new `sandbox_iframes` boolean option. When set to `true`, it will add a `sandbox=""` attribute to all iframes inserted into the editor. According to https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#sandbox[MDN docs], this will restrict the iframe's embedded resource from performing potentially malicious actions including scripting, file downloads, browser popups, passing the same-origin policy, among others. + +NOTE: `sandbox_iframes`: is set to `false` by default, which is the existing behavior. This is because enabling `sandbox_iframes` may break **existing media embeds** such as YouTube, Vimeo, and Codepen, as actions such as scripting and same-origin access are prevented. + +=== New `convert_unsafe_embeds` option that controls whether `` and `` elements will be converted to more restrictive alternatives, namely `` for image MIME types, `