diff --git a/modules/ROOT/pages/8.7.0-release-notes.adoc b/modules/ROOT/pages/8.7.0-release-notes.adoc index 60a84540ef..d9f4a2b7e0 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**. 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]. + // === // The {productname} {release-version} release includes an accompanying release of the **** premium plugin. diff --git a/modules/ROOT/partials/configuration/tinymceai_options.adoc b/modules/ROOT/partials/configuration/tinymceai_options.adoc index fb0b72ba71..681ec0ddb0 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 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. + +*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 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] +---- +[ + '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()); + } +}); +---- +