DOC-2578: TinyMCE 7.6.0 Release Documentation and Community Changelog.

antora.yml

@@ -26,7 +26,7 @@ asciidoc:
     # product variables
     productname: TinyMCE
     productmajorversion: 7
-    productminorversion: '7.5'
+    productminorversion: '7.6'
     ##### product name in codeblock
     prodnamecode: tinymce
     #### more names

modules/ROOT/examples/live-demos/comments-callback/example.js

@@ -48,7 +48,11 @@ const tinycomments_reply = (req, done, fail) => {
     })
     .then((req2) => {
       const commentUid = req2.commentUid;
-      done({ commentUid });
+      done({
+        commentUid: replyUid,
+        author: currentUser.id,
+        authorName: currentUser.fullName
+      });
     })
     .catch((e) => {
       fail(e);

modules/ROOT/examples/live-demos/context-toolbar-labels/index.html

@@ -0,0 +1,9 @@
+<textarea id="context-toolbar-labels">
+  <p>Clicking on the example image below will show the newly configured context toolbar.</p>
+
+  {{logofordemoshtml}}
+
+  <p>Select a word in this sentence, to see the other newly configured context toolbar.</p>
+
+  <p>Clicking on text should not invoke the context toolbar</p>
+</textarea>

modules/ROOT/examples/live-demos/context-toolbar-labels/index.js

@@ -0,0 +1,34 @@
+tinymce.init({
+  selector: 'textarea#context-toolbar-labels',
+  height: 350,
+  setup: (editor) => {
+    editor.ui.registry.addContextToolbar('imagealignment', {
+      predicate: (node) => node.nodeName.toLowerCase() === 'img',
+      position: 'node',
+      scope: 'node',
+      items: [
+        {
+          name: 'Formatting',
+          items: ['alignleft', 'aligncenter', 'alignright']
+        },
+        {
+          label: 'Copy',
+          items: ['copy', 'paste']
+        }
+      ],
+    });
+
+    editor.ui.registry.addContextToolbar('textselection', {
+      predicate: (node) => !editor.selection.isCollapsed(),
+      position: 'selection',
+      scope: 'node',
+      items: [
+        {
+          name: 'Format',
+          items: ['bold', 'italic', 'underline']
+        },
+      ],
+    });
+  },
+  content_style: 'body { font-family:Helvetica,Arial,sans-serif; font-size:16px }'
+});

modules/ROOT/nav.adoc

@@ -411,18 +411,12 @@
 ** xref:release-notes.adoc[Release notes for {productname}]
 *** {productname} 7.6.0
 **** xref:7.6.0-release-notes.adoc#overview[Overview]
-**** xref:7.6.0-release-notes.adoc#new-premium-plugin<s>[New Premium plugin<s>]
-**** xref:7.6.0-release-notes.adoc#new-open-source-plugin<s>[New Open Source plugin<s>]
+**** xref:7.6.0-release-notes.adoc#new-premium-plugin[New Premium plugin]
 **** xref:7.6.0-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium plugin changes]
-**** xref:7.6.0-release-notes.adoc#accompanying-premium-plugin-end-of-life-announcement[Accompanying Premium plugin end-of-life announcement]
-**** xref:7.6.0-release-notes.adoc#accompanying-open-source-plugin-end-of-life-announcement[Accompanying open source plugin end-of-life-announcement]
 **** xref:7.6.0-release-notes.adoc#accompanying-enhanced-skins-and-icon-packs-changes[Accompanying Enhanced Skins & Icon Packs changes]
-**** xref:7.6.0-release-notes.adoc#improvements[Improvements]
+// **** xref:7.6.0-release-notes.adoc#improvements[Improvements]
 **** xref:7.6.0-release-notes.adoc#additions[Additions]
-**** xref:7.6.0-release-notes.adoc#changes[Changes]
 **** xref:7.6.0-release-notes.adoc#bug-fixes[Bug fixes]
-**** xref:7.6.0-release-notes.adoc#security-fixes[Security fixes]
-**** xref:7.6.0-release-notes.adoc#deprecated[Deprecated]
 **** xref:7.6.0-release-notes.adoc#known-issues[Known issues]
 *** {productname} 7.5.1
 **** xref:7.5.1-release-notes.adoc#overview[Overview]

modules/ROOT/pages/changelog.adoc

@@ -4,9 +4,45 @@
 
 NOTE: This is the {productname} Community version changelog. For information about the latest {cloudname} or {enterpriseversion} Release, see: xref:release-notes.adoc[{productname} Release Notes].
 
-== xref:7.6.0-release-notes.adoc[7.6.0 - 2024-12-04]
+== xref:7.6.0-release-notes.adoc[7.6.0 - 2024-12-11]
 
-//TODO
+=== Added
+* It is now possible to create labeled groups in context toolbars.
+// #TINY-11095
+// * New `contextsliderform` and `contextsizeinput` context form types.
+// #TINY-11342
+* New `back` function in `ContextFormApi` to go back to the previous toolbar.
+// #TINY-11344
+* New `QuickbarInsertImage` command that is executed by the `quickimage` button.
+// #TINY-11399
+* New `onSetup` function to the context form API.
+// #TINY-11494
+* New `placeholder` to the context form input field API.
+// #TINY-11459
+* New `disabled` option to restore the previous `readonly` mode behavior, allowing the editor to be displayed in a disabled state.
+// #TINY-11488
+
+// === Improved
+// * Base64 data was not properly decoded due to unhandled URL-encoded characters.
+// #TINY-9548
+// * The `latin` list style type is now recognized as an alias for the `alpha` list style type.
+// #TINY-11515
+
+=== Fixed
+*  Image selection was removed when calling `+editor.nodeChanged()+` while having focus inside the editor UI.
+// #TINY-11437
+*  Tooltip would not show for group toolbar button.
+// #TINY-11391
+*  Changing the table row type when a `+contenteditable=false+` cell was selected would not work as expected.
+// #TINY-11383
+// *  The `samp` format was being applied as a `block` level format, instead of an `inline` format.
+// #TINY-11390
+*  Removed title attribute from dialog tree elements as they already have a tooltip.
+// #TINY-11470
+*  Fixed CSS bundling for skin UI content CSS.
+// #TINY-11558
+*  Fixed incorrect resource keys for CSS bundling JS files.
+// #TINY-11558
 
 == xref:7.5-release-notes.adoc[7.5.0 - 2024-11-06]
 

modules/ROOT/pages/contextform.adoc

@@ -46,6 +46,11 @@ This relates to the form itself. The form specifications are:
 |`+position+` |This controls where the context toolbar will appear with regards to the current cursor.
 |`+scope+` |This controls whether the predicate (condition) is a `+node+`-based predicate, or an `+editor+`-based predicate. See context toolbar priority for more details.
 |`+commands+` |This is a list of the items to show in the context form. They can be either `+contextformbutton+` or `+contextformtogglebutton+`.
+|`+onSetup+`
+a|
+`+(ContextFormApi) => (ContextFormApi) => void+` 
+
+Optional default: `+() => () => {}+` - Function that's  executed when the form is rendered. Once rendered, it returns a function that is executed when the context form is closed.
 |===
 
 include::partial$context/positioning.adoc[leveloffset=+1]
@@ -100,12 +105,13 @@ Where the `+toggleButtonApi+` is the same as a regular toolbar toggle button.
 
 === formApi
 
-Both `+contextformbutton+` and `+contextformtogglebutton+` are passed `+formApi+` in their `+onAction+` callback. The `+formApi+` has two functions:
+Both `+contextformbutton+` and `+contextformtogglebutton+` are passed `+formApi+` in their `+onAction+` callback. The `+formApi+` has three functions:
 
 [cols="1,3",options="header"]
 |===
 |Functions |Description
 |`+hide+` |This will hide the form. By default, no button hides the form. It is the responsibility of the developer to hide the form in the `+onAction+` handler of buttons that require that the context form close after the action.
+|`+back+` |This will restore the previous toolbar. This is useful when you want to go back to the previous toolbar when you press back in the toolbar.
 |`+getValue+` |This will retrieve the value current typed in the input field.
 |===
 

modules/ROOT/pages/contexttoolbar.adoc

@@ -27,6 +27,41 @@ This example shows how the quickbars plugin adds the standard selection context
 
 liveDemo::context-toolbar[height="600", tab="js"]
 
+[[add-labels-and-groups-for-context-toolbar-buttons]]
+== Add labels and groups for context toolbar buttons
+
+From {productname} 7.6.0 onward, registering a context toolbar allows specifying `items` as an object that supports grouping with optional names and labels. This improvement enhances toolbar usability by organizing buttons into titled or labeled groups.
+
+The object structure takes two optional properties: `name` and `label`.
+
+* `name`: property is used as the group's title for the group that contains the buttons.
+* `label`: property is used as a label for each group of buttons.
+
+[NOTE]
+If neither `name` nor `label` are specified, the behavior defaults to ungrouped buttons.
+
+The object structure for `items` is as follows:
+
+.Example of a context toolbar configuration with groups and labels
+[source,js]
+----
+items: [
+  {
+    name: 'Formatting', // Optional, used as the group's title
+    items: [ 'bold', 'italic' ] // Array of registered button names
+  },
+  {
+    label: 'History', // Optional, used as a label for the group
+    items: [ 'undo', 'redo' ] // Array of registered button names
+  },
+  {
+    items: [ 'undo', 'italic' ] // No name or label specified, default behavior applies
+  }
+]
+----
+
+liveDemo::context-toolbar-labels[height="600", tab="js"]
+
 == Launching a context toolbar programmatically
 
 There is an `+editor+` event called `+contexttoolbar-show+` that can be fired to show a context toolbar at the current selection. The event takes a parameter `+toolbarKey+` which specifies the name of the registered context form or context toolbar to show.

modules/ROOT/pages/editor-important-options.adoc

@@ -35,6 +35,10 @@ include::partial$configuration/external_plugins.adoc[leveloffset=+1]
 
 include::partial$configuration/readonly.adoc[leveloffset=+1]
 
+== Setting the editor in a disabled state
+
+include::partial$configuration/disabled.adoc[leveloffset=+1]
+
 == Executing custom functions while the editor starts (initializes)
 
 include::partial$configuration/setup.adoc[leveloffset=+1]

modules/ROOT/pages/events.adoc

@@ -160,6 +160,7 @@ The following events are provided by the {productname} editor.
 |ObjectResized |`+{ target: HTMLElement, width: number, height: number, origin: string }+` |Fired when an object (such as an image) has finished being resized.
 |ObjectResizeStart |`+{ target: HTMLElement, width: number, height: number, origin: string }+` |Fired when an object (such as an image) is about to be resized.
 |SwitchMode |`+{ mode: string }+` |Fired when the editor mode is changed. The available modes are "design" and "readonly". Additional modes can be registered using {productname} API xref:apis/tinymce.editormode.adoc#register['tinymce.activeEditor.mode.register()'].
+|DisabledStateChange |+{ state: boolean }+ |Fired when the editor disabled mode state changes.
 |ScrollWindow |(Same data as the native https://developer.mozilla.org/en-US/docs/Web/API/Element/scroll_event[scroll event]) |Fired when the window has scrolled.
 |ResizeWindow |(Same data as the native https://developer.mozilla.org/en-US/docs/Web/API/Window/resize_event[resize event]) |Fired when the window is resized.
 |BeforeExecCommand |`+{ command: string, ui?: boolean, value?: any }+` |Fired before a command is executed.

modules/ROOT/partials/configuration/disabled.adoc

@@ -0,0 +1,23 @@
+[[disabled]]
+
+== `+disabled+`
+
+Disables all user interactions with the editor (including cursor placement, content modifications, UI components). This option provides behavior similar to the changes made to {productname} in 7.4.0 readonly mode. When enabled, the editor becomes completely non-interactive.
+
+To programmatically enable/disable the editor, use `+tinymce.activeEditor.options.set('disabled', false/true)+`.
+
+*Type:* `+Boolean+`
+
+*Default value:* `+false+`
+
+*Possible values:* `+true+`, `+false+`
+
+=== Example: using `+disabled+`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',  // change this value according to your HTML
+  disabled: true
+});
+----

modules/ROOT/partials/configuration/tinycomments_reply.adoc

@@ -16,7 +16,9 @@ The `+done+` callback should accept the following object:
 [source,js]
 ----
 {
-  commentUid: string // the value of the new comment uid
+  commentUid: string, // the value of the new comment uid
+  author: string, // the id of the current author
+  authorName: string // the name of the current author
 }
 ----
 
@@ -42,7 +44,11 @@ const reply_comment = (ref, done, fail) => {
     })
     .then((ref2) => {
       let commentUid = ref2.commentUid;
-      done({ commentUid: commentUid });
+      done({
+        commentUid: replyUid,
+        author: currentUser.id,
+        authorName: currentUser.fullName
+      });
     })
     .catch((e) => {
       fail(e);

modules/ROOT/partials/plugin-apis/comments-apis.adoc

@@ -63,6 +63,10 @@ The `getEventLog` returns a log that contains information and timestamps of all
   "conversationContent": "new comment (Edit comment)",
   "conversationCreatedAt": "2024-10-01T03:07:53.771Z",
   "commentContent": "reply to existing comment",
+  "commentAuthor": {
+      "author": "DEMO USER",
+      "authorName": "DEMO USER"
+  },
   "conversationAuthor": {
       "author": "DEMO USER",
       "authorName": "DEMO USER"