diff --git a/modules/ROOT/pages/8.9.0-release-notes.adoc b/modules/ROOT/pages/8.9.0-release-notes.adoc index 30243b6272..fa78cf33eb 100644 --- a/modules/ROOT/pages/8.9.0-release-notes.adoc +++ b/modules/ROOT/pages/8.9.0-release-notes.adoc @@ -71,6 +71,28 @@ The {productname} {release-version} release includes an accompanying release of For information on the **** plugin, see: xref:.adoc[]. +=== Comments + +The {productname} {release-version} release includes an accompanying release of the **Comments** premium plugin. + +**Comments** includes the following additions. + +==== New option `+tinycomments_always_show_highlights+` to keep comment highlights visible while the sidebar is closed +// #TINYMCE-14726 + +Previously, the Comments plugin highlighted commented content only while the Comments sidebar was open. Closing the sidebar removed the highlighting from the editor content, so commented content was easy to overlook and users could overwrite it without warning. + +In {productname} {release-version}, the Comments plugin offers the xref:comments-embedded-mode.adoc#tinycomments_always_show_highlights[`+tinycomments_always_show_highlights+`] option. When this option is set to `+true+`, commented content remains highlighted whether the Comments sidebar is open or closed. This option defaults to `+false+`, which preserves the existing behavior. + +==== Selecting a comment highlight opens the Comments sidebar +// #TINYMCE-14726 + +Previously, the Comments plugin removed the highlighting while the Comments sidebar was closed, so users could not reopen a conversation from the editor content. + +In {productname} {release-version}, when the xref:comments-embedded-mode.adoc#tinycomments_always_show_highlights[`+tinycomments_always_show_highlights+`] option is set to `+true+`, selecting highlighted content reopens the closed Comments sidebar. + +For information on the **Comments** plugin, see: xref:introduction-to-tiny-comments.adoc[Comments]. + [[accompanying-premium-plugin-end-of-life-announcement]] == Accompanying Premium plugin end-of-life announcement diff --git a/modules/ROOT/pages/comments-callback-mode.adoc b/modules/ROOT/pages/comments-callback-mode.adoc index 7f76a26891..9bb1da44bc 100644 --- a/modules/ROOT/pages/comments-callback-mode.adoc +++ b/modules/ROOT/pages/comments-callback-mode.adoc @@ -83,6 +83,8 @@ include::partial$configuration/fetch_users.adoc[leveloffset=+1] include::partial$configuration/tinycomments_fetch_author_info.adoc[leveloffset=+1] +include::partial$configuration/tinycomments_always_show_highlights.adoc[leveloffset=+1] + include::partial$plugins/comments-open-sidebar.adoc[] include::partial$plugins/comments-highlighting-css.adoc[] diff --git a/modules/ROOT/pages/comments-embedded-mode.adoc b/modules/ROOT/pages/comments-embedded-mode.adoc index 280630f5bf..f2845cc30c 100644 --- a/modules/ROOT/pages/comments-embedded-mode.adoc +++ b/modules/ROOT/pages/comments-embedded-mode.adoc @@ -64,6 +64,8 @@ include::partial$configuration/tinycomments_can_delete_comment.adoc[leveloffset= include::partial$configuration/tinycomments_can_edit_comment.adoc[leveloffset=+1] +include::partial$configuration/tinycomments_always_show_highlights.adoc[leveloffset=+1] + include::partial$plugins/comments-open-sidebar.adoc[] include::partial$plugins/comments-highlighting-css.adoc[] \ No newline at end of file diff --git a/modules/ROOT/partials/configuration/tinycomments_always_show_highlights.adoc b/modules/ROOT/partials/configuration/tinycomments_always_show_highlights.adoc new file mode 100644 index 0000000000..7d3372409d --- /dev/null +++ b/modules/ROOT/partials/configuration/tinycomments_always_show_highlights.adoc @@ -0,0 +1,28 @@ +[[tinycomments_always_show_highlights]] +== `+tinycomments_always_show_highlights+` + +_Optional_: The {pluginname} plugin offers the `+tinycomments_always_show_highlights+` option to keep the highlighting on commented content visible while the {pluginname} sidebar is closed. By default, {productname} highlights commented content only while the sidebar is open, and removes the highlighting from the editor content once the sidebar is closed. + +When this option is set to `+true+`, {productname} highlights commented content whether the sidebar is open or closed, and selecting highlighted content reopens the closed {pluginname} sidebar. + +*Type:* `+Boolean+` + +*Default value:* `+false+` + +*Possible values:* `+true+`, `+false+` + +=== Example: using `+tinycomments_always_show_highlights+` + +[source,js] +---- +const currentAuthor = 'embedded_journalist'; + +tinymce.init({ + selector: 'textarea', // change this value according to your html + plugins: 'tinycomments', + toolbar: 'addcomment showcomments', + tinycomments_mode: 'embedded', + user_id: currentAuthor, + tinycomments_always_show_highlights: true +}); +----