From bad138ceb96ce6df1c6707c39a17e4f4ec179970 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 15 Jun 2026 09:29:37 +1000 Subject: [PATCH 1/3] DOC-3526: Add TinyMCE AI addition release note for tinymceai_reviews_change_tone_menu (TINY-14274) --- modules/ROOT/pages/8.7.0-release-notes.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/ROOT/pages/8.7.0-release-notes.adoc b/modules/ROOT/pages/8.7.0-release-notes.adoc index 60a84540ef..b8d610bf39 100644 --- a/modules/ROOT/pages/8.7.0-release-notes.adoc +++ b/modules/ROOT/pages/8.7.0-release-notes.adoc @@ -28,6 +28,19 @@ include::partial$misc/admon-releasenotes-for-stable.adoc[] The following premium plugin updates were released alongside {productname} {release-version}. +=== TinyMCE AI + +The {productname} {release-version} release includes an accompanying release of the **TinyMCE AI** premium plugin. + +**TinyMCE AI** includes the following addition. + +==== New `tinymceai_reviews_change_tone_menu` option to control the Change Tone review menu +// #TINY-14274 + +{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review menu. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones, and an empty array (`+[]+`) hides the Change Tone review. + +For information on the **TinyMCE AI** plugin, see: xref:tinymceai.adoc[TinyMCE AI]. + // === // The {productname} {release-version} release includes an accompanying release of the **** premium plugin. From 666a1584f73db10b3c9bd4f5aae1896e6ba433ab Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 15 Jun 2026 11:26:27 +1000 Subject: [PATCH 2/3] Docs: DOC-3526 - Document tinymceai_reviews_change_tone_menu option (TINY-14274) Add the tinymceai_reviews_change_tone_menu configuration option to the TinyMCE AI options reference and link to it from the 8.7.0 release note. Correct the release note: an empty array is accepted with a warning and does not hide the Change Tone review. --- modules/ROOT/pages/8.7.0-release-notes.adoc | 2 +- .../configuration/tinymceai_options.adoc | 49 +++++++++++++++++++ 2 files changed, 50 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/8.7.0-release-notes.adoc b/modules/ROOT/pages/8.7.0-release-notes.adoc index b8d610bf39..17ad168f93 100644 --- a/modules/ROOT/pages/8.7.0-release-notes.adoc +++ b/modules/ROOT/pages/8.7.0-release-notes.adoc @@ -37,7 +37,7 @@ The {productname} {release-version} release includes an accompanying release of ==== New `tinymceai_reviews_change_tone_menu` option to control the Change Tone review menu // #TINY-14274 -{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review menu. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones, and an empty array (`+[]+`) hides the Change Tone review. +{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review and their order. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones. For the full list of tone IDs and behavior, see the xref:tinymceai.adoc#tinymceai_reviews_change_tone_menu[`+tinymceai_reviews_change_tone_menu+`] option. For information on the **TinyMCE AI** plugin, see: xref:tinymceai.adoc[TinyMCE AI]. diff --git a/modules/ROOT/partials/configuration/tinymceai_options.adoc b/modules/ROOT/partials/configuration/tinymceai_options.adoc index fb0b72ba71..80b74f04c6 100644 --- a/modules/ROOT/partials/configuration/tinymceai_options.adoc +++ b/modules/ROOT/partials/configuration/tinymceai_options.adoc @@ -563,3 +563,52 @@ tinymce.init({ }); ---- +[[tinymceai_reviews_change_tone_menu]] +=== `+tinymceai_reviews_change_tone_menu+` + +Array of tone control IDs that define which tone options appear in the Change Tone review, and their order. Only the listed tones are available to users. + +This option applies only when `+'ai-reviews-change-tone'+` is included in the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option. + +*Type:* `+Array+` of `+String+` + +*Valid values:* + +* `+'ai-reviews-tone-casual'+`: Casual tone +* `+'ai-reviews-tone-direct'+`: Direct tone +* `+'ai-reviews-tone-friendly'+`: Friendly tone +* `+'ai-reviews-tone-confident'+`: Confident tone +* `+'ai-reviews-tone-professional'+`: Professional tone + +Duplicate IDs are removed, and the configured order is reflected in the menu. If the option contains any value that is not a valid tone ID, the configuration is rejected and the default tones are used. An empty array (`+[]+`) is accepted but logs a console warning. To remove the Change Tone review entirely, omit `+'ai-reviews-change-tone'+` from the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option. + +*Default value:* +[source,js] +---- +[ + 'ai-reviews-tone-casual', + 'ai-reviews-tone-direct', + 'ai-reviews-tone-friendly', + 'ai-reviews-tone-confident', + 'ai-reviews-tone-professional' +] +---- + +.Example +[source,js] +---- +tinymce.init({ + selector: 'textarea', + plugins: 'tinymceai', + toolbar: 'tinymceai-chat tinymceai-quickactions tinymceai-review', + tinymceai_reviews_change_tone_menu: [ + 'ai-reviews-tone-professional', + 'ai-reviews-tone-friendly' + ], + // Required for authentication + tinymceai_token_provider: () => { + return fetch('/api/token').then(r => r.json()); + } +}); +---- + From 55b44bd7b2fab8ce6827aeee4b0266087c8be2f9 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 15 Jun 2026 11:41:56 +1000 Subject: [PATCH 3/3] Docs: DOC-3526 - Refine TINY-14274 wording per style review --- modules/ROOT/pages/8.7.0-release-notes.adoc | 2 +- modules/ROOT/partials/configuration/tinymceai_options.adoc | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/8.7.0-release-notes.adoc b/modules/ROOT/pages/8.7.0-release-notes.adoc index 17ad168f93..d9f4a2b7e0 100644 --- a/modules/ROOT/pages/8.7.0-release-notes.adoc +++ b/modules/ROOT/pages/8.7.0-release-notes.adoc @@ -37,7 +37,7 @@ The {productname} {release-version} release includes an accompanying release of ==== New `tinymceai_reviews_change_tone_menu` option to control the Change Tone review menu // #TINY-14274 -{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review and their order. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones. For the full list of tone IDs and behavior, see the xref:tinymceai.adoc#tinymceai_reviews_change_tone_menu[`+tinymceai_reviews_change_tone_menu+`] option. +{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**. This option controls which tone options appear in the Change Tone review and their order. Only preset tone IDs are supported. Duplicate IDs are removed, and the menu displays tones in the configured order. If the option includes an invalid tone ID, the configuration is rejected and the default tones are used. For valid tone IDs and option details, see xref:tinymceai.adoc#tinymceai_reviews_change_tone_menu[`+tinymceai_reviews_change_tone_menu+`]. For information on the **TinyMCE AI** plugin, see: xref:tinymceai.adoc[TinyMCE AI]. diff --git a/modules/ROOT/partials/configuration/tinymceai_options.adoc b/modules/ROOT/partials/configuration/tinymceai_options.adoc index 80b74f04c6..681ec0ddb0 100644 --- a/modules/ROOT/partials/configuration/tinymceai_options.adoc +++ b/modules/ROOT/partials/configuration/tinymceai_options.adoc @@ -566,7 +566,7 @@ tinymce.init({ [[tinymceai_reviews_change_tone_menu]] === `+tinymceai_reviews_change_tone_menu+` -Array of tone control IDs that define which tone options appear in the Change Tone review, and their order. Only the listed tones are available to users. +Array of tone IDs that define which tone options appear in the Change Tone review and their order. Only the listed tones appear in the menu. This option applies only when `+'ai-reviews-change-tone'+` is included in the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option. @@ -580,7 +580,7 @@ This option applies only when `+'ai-reviews-change-tone'+` is included in the xr * `+'ai-reviews-tone-confident'+`: Confident tone * `+'ai-reviews-tone-professional'+`: Professional tone -Duplicate IDs are removed, and the configured order is reflected in the menu. If the option contains any value that is not a valid tone ID, the configuration is rejected and the default tones are used. An empty array (`+[]+`) is accepted but logs a console warning. To remove the Change Tone review entirely, omit `+'ai-reviews-change-tone'+` from the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option. +Duplicate IDs are removed, and the menu displays tones in the configured order. If the option includes an invalid tone ID, the configuration is rejected and the default tones are used. An empty array (`+[]+`) is accepted, but {productname} logs a console warning. To remove the Change Tone review entirely, omit `+'ai-reviews-change-tone'+` from the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option. *Default value:* [source,js]