Merge branch 'feature/7.5/DOC-2498' into feature/7.5/DOC-2498_TINY-11389

Author: kemister85

antora.yml

@@ -38,6 +38,7 @@ asciidoc:
     communityname: TinyMCE Community
     accountpage: Tiny Account
     supportname: Tiny Support
+    contactsales: Contact Sales
     betaprogram: Tiny Insights Program
     #### some plugin names
     prem_skins_icons: Enhanced Skins & Icon Packs

modules/ROOT/pages/7.4-release-notes.adoc

@@ -368,7 +368,7 @@ tinycomments_author_name: '',
 
 Previously, instead of assigning default user/author values as in `7-stable` (7.3), the latest release {release-version} disables all comment features when these fields are empty.
 
-**Status**: Currently under investigation.
+**Status**: This issue has been resolved in xref:7.5-release-notes.adoc#use-default-anon-value-for-tinycomments_author-and-tinycomments_author_name-options-when-the-provided-value-is-an-empty-string[{productname} 7.5.0].
 
 === Comment card not removed after deleting content
 // #TINY-11366
@@ -377,4 +377,4 @@ Currently, after deleting content that has related comments, the corresponding c
 
 This behavior is inconsistent with the expected behavior, where the comment card should be removed automatically after deleting the content.
 
-**Status**: Currently under investigation.
+**Status**: This issue has been resolved in xref:7.5-release-notes.adoc#removing-annotated-content-now-removes-associated-conversation-card-from-the-sidebar[{productname} 7.5.0].

modules/ROOT/pages/7.5-release-notes.adoc

@@ -69,19 +69,115 @@ The {productname} {release-version} release includes an accompanying release of
 
 For information on the **<Premium plugin name 1>** plugin, see: xref:<plugincode>.adoc[<Premium plugin name 1>].
 
+=== Export to PDF
+
+The {productname} {release-version} release includes an accompanying release of the **Export to PDF** premium plugin.
+
+**Export to PDF** Premium plugin includes the following improvement.
+
+=== Added a default value for the `exportpdf_converter_options` option.
+// #TINY-11396
+
+As of {productname} {release-version}, the **Export to PDF** Plugin now defaults to U.S. letter page size and applies standard 1-inch margins, ensuring consistency in document formatting out of the box for integrators. The following settings have been applied:
+
+[source,js]
+----
+exportpdf_converter_options: {
+  format: 'Letter',
+  margin_top: '1in',
+  margin_right: '1in',
+  margin_bottom: '1in',
+  margin_left: '1in'
+}
+----
+
+For information on the **Export to PDF** plugin, see: xref:exportpdf.adoc[Export to PDF].
+
+=== Export to Word
+
+The {productname} {release-version} release includes an accompanying release of the **Export to Word** premium plugin.
+
+**Export to Word** Premium plugin includes the following improvement.
+
+=== Added a default value for the `exportword_converter_options` option.
+// #TINY-11396
+
+As of {productname} {release-version}, the **Export to Word** Plugin has been updated to default to the U.S. letter page size, improving compatibility with standard document formats, providing a better out-of-the-box experience for integrators. The following setting has been applied:
+
+[source,js]
+----
+exportword_converter_options: {
+  document: {
+    size: 'letter'
+  }
+}
+----
+
+For information on the **Export to Word** plugin, see: xref:exportword.adoc[Export to Word].
+
+=== Import from Word
+
+The {productname} {release-version} release includes an accompanying release of the **Import from Word** premium plugin.
+
+**Import from Word** Premium plugin includes the following improvement.
+
+=== Added a default value for the `importword_converter_options` option.
+// #TINY-11396
+
+As of {productname} {release-version}, the **Import from Word** Plugin now defaults to retaining as much original Word document styling as possible, using the following settings:
+
+[source,js]
+----
+importword_converter_options: {
+  formatting: {
+    styles: 'inline',
+    resets: 'inline',
+    defaults: 'inline',
+  }
+}
+----
+
+For information on the **Import from Word** plugin, see: xref:importword.adoc[Import from Word].
+
+=== Markdown
+
+The {productname} {release-version} release includes an accompanying release of the **Markdown** premium plugin.
+
+This **Markdown** premium plugin release includes the following improvement:
+
+==== The command `MarkdownInsert` is now registered immediately and operates in an async manner, instead of waiting for resources before registering the command.
+// #TINY-11280
+
+In {productname} {release-version}, the `MarkdownInsert` command is now registered immediately and operates asynchronously upon execution, rather than waiting for resources to register during initialization. Previously, the command required loading external content, which delayed its availability. By making the command async on execution instead of on loading, it is now accessible at initialization, improving responsiveness without the need for additional loading time.
+
+==== Markdown command `MarkdownInsert` fires new event `MarkdownInserted` when completed.
+// #TINY-11280
+
+In {productname} {release-version}, the `MarkdownInsert` command now triggers a new event, `MarkdownInserted`, upon completion. This event provides a notification when the markdown insertion process has finished, enabling better tracking and handling of post-insertion actions within the editor.
+
+For information on the **Markdown** plugin, see xref:markdown.adoc[Markdown].
+
 === Comments
 
 The {productname} {release-version} release includes an accompanying release of the **Comments** premium plugin.
 
-**Comments** Premium plugin includes the following fix.
+**Comments** Premium plugin includes the following fixes.
 
 ==== The `conversationAuthor` property was missing from 'create` conversation events in the EventLog API.
+// #TINY-11352
 
 In previous versions of the tinycomments plugin, the `conversationAuthor` property was missing from 'create' events within the event log, which led to incomplete tracking of user interactions when retrieving data through the `+getEventLog()+` API.
 
 {productname} {release-version} addresses this issue. Now, the `conversationAuthor` property is included in 'create' events in the event log.
 
-For information on the **Comments** plugin, see: xref:introduction-to-tiny-comments.adoc[Introduction to {companyname} Comments].
+==== Removing annotated content, now, removes associated conversation card from the sidebar.
+// #TINY-11366
+
+Previously, in xref:7.4-release-notes.adoc#comment-card-not-removed-after-deleting-content[{productname} 7.4.0], an issue was identified where deleting annotated content did not remove the corresponding conversation card from the sidebar, resulting in outdated or irrelevant cards persisting in the user interface.
+
+This behavior led to confusion and increased the risk of interacting with obsolete comments.
+
+In {productname} {release-version}, this issue has been resolved. Now, when annotated content is deleted, the associated conversation card is automatically removed from the sidebar.
 
 === PowerPaste
 
@@ -99,6 +195,15 @@ As a result, the `mceInsertClipboardContent` command now always executes synchro
 
 For information on the **PowerPaste** plugin, see: xref:introduction-to-powerpaste.adoc[Introduction to PowerPaste].
 
+==== Use default 'Anon' value for `tinycomments_author` and `tinycomments_author_name` options when the provided value is an empty string.
+// #TINY-11323
+
+Previously in xref:7.4-release-notes.adoc#comments-not-functional-with-empty-tinycomments_author-and-tinycomments_author_name[{productname} 7.4.0], an issue was identified in **Embedded mode** where the commenting functionality became non-operational when either the `tinycomments_author` or the `tinycomments_author_name` options were configured as empty strings `""`. As a consequence, users were unable to create comments when these options were empty.
+
+In {productname} {release-version}, the `tinycomments_author` and `tinycomments_author_name` options now default to "Anon" when the provided value is an empty string. As a result, the commenting functionality is now operational even when these options are empty.
+
+For information on the **Comments** plugin, see: xref:introduction-to-tiny-comments.adoc[Introduction to {companyname} Comments].
+
 [[accompanying-premium-plugin-end-of-life-announcement]]
 == Accompanying Premium plugin end-of-life announcement
 
@@ -187,12 +292,66 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a
 
 // CCFR here.
 
+=== Closing a nested modal dialog would lose focus from the editor.
+// #TINY-11153
+
+Previously in {productname}, closing a nested dialog (such as the color picker dialog within the Table Properties dialog) would cause the editor to lose focus on the parent dialog and shift focus to the editor content in the background.
+
+This issue impacted keyboard users, preventing them from navigating or closing the parent dialog since the focus was no longer on the dialog. Additionally, in inline mode editors, the dialog UI would disappear entirely when focus shifted to the editor area, giving the impression that the dialog had closed unexpectedly.
+
+This issue has been resolved by ensuring focus returns to the parent dialog when a nested dialog is closed. As a result, keyboard users can now navigate and close dialogs as expected, and the dialog UI remains visible in inline mode editors.
+
+=== Autocompleter would not activate after applying an inline format like font size in some cases.
+// #TINY-11273
+
+Previously, when formatting was applied, a span with a zero-width no-break space `+U+FEFF+` was added to the editor. This character was not considered whitespace; as a result, the autocompleter did not trigger as expected. 
+
+{productname} {release-version} addresses this issue by updating the function to include `+U+FEFF+` as a valid character. 
+
+As a result, the autocompleter now triggers as expected after applying formatting.
+
+=== Forecolor and backcolor toolbar buttons were not completely greyed out while in readonly mode.
+// #TINY-11313
+
+In previous versions of {productname}, an issue was identified where the `backcolor` and `forecolor` toolbar buttons were not completely greyed out while in readonly mode due to an incorrect CSS selector.
+
+This led to a visual inconsistency in the readonly editor state.
+
+{productname} {release-version} addresses this issue. Now, the CSS selector has been corrected, ensuring that both `backcolor` and `forecolor` buttons are now completely greyed out, providing a consistent user experience when the editor is in readonly mode.
+
+=== Improved color picker aria support.
+// #TINY-11291
+
+In previous versions of {productname}, an issue was identified where screen readers would inconsistently announce the original R/G/B component string in the color picker, leading to a lack of context for visually impaired users. The root cause was an incorrect placement of the `aria-label` attribute, which was initially applied to the label element instead of the input field.
+
+{productname} {release-version} addresses this issue. Now, the `aria-label` attribute has been moved to the input field to ensure it is correctly associated. Additionally, the descriptive text was updated from "Red/Green/Blue component" to "Red/Green/Blue channel" to provide clearer information for assistive technologies. These changes ensure that screen readers consistently and accurately announce the relevant RGB channels, significantly improving accessibility.
+
+=== The `toolbar-sticky-offset` would still be applied after entering fullscreen mode.
+// #TINY-11137
+
+In previous versions of {productname}, an issue was identified where the toolbar offset was incorrectly applied in fullscreen mode, causing the toolbar to overlap with the editor area.
+
+{productname} {release-version} addresses this issue, by implementing a check to verify that the editor is **not** in fullscreen mode before applying the toolbar offset. As a result, the toolbar now appears in the correct position when in fullscreen mode, even with the `toolbar_sticky_offset` option defined.
+
 === Corrected focus highlight visibility in `Statusbar` path
+// #TINY-11381
 
 A visual bug introduced in {productname} version xref:7.2.1-release-notes.adoc#long-translations-of-the-bottom-help-text-would-cause-minor-graphical-issues[7.1.2] caused the focus highlight to appear behind the tag name in the statusbar path, making it difficult for users to visually track their focus.
 
-In {productname} {release-version}, this has been corrected. The focus highlight is now correctly displayed above the tag name when navigating through the statusbar path, ensuring a clear and visible focus indication. 
+In {productname} {release-version}, this has been corrected. The focus highlight is now correctly displayed above the tag name when navigating through the statusbar path, ensuring a clear and visible focus indication.
+
+=== Added new default `li` element styles to the content CSS to prevent child list elements from inheriting certain parent list item styles.
+// #TINY-11217
+
+In previous versions of {productname}, child `+<li>+` elements could inherit inline CSS styles from their parent list items, causing unexpected styling behavior in nested lists. This issue was due to native CSS behavior, where child list items would inherit certain parent styles upon post-content insertion.
 
+{productname} {release-version} addresses this issue. Now, new default CSS styles were added for `+<li>+` elements to prevent inheritance of specific parent styles. This ensures that list items in nested structures render independently, maintaining consistent visual formatting.
+
+=== Inability to type `{` character on German keyboard layouts
+
+In previous versions of {productname}, an issue was identified on German Mac keyboard layouts where the `+Option+8+` keyboard combination, used to type the opening curved bracket `{`, conflicted with the `+Alt+F12+` shortcut, which is used to focus notifications in the {productname} editor. This conflict occurred because, on German Mac keyboards, `+Option+8+` generated a key code that overlapped with the `+Alt+F12+` function, preventing users from typing `{` in the editor.
+
+To address this, {productname} {release-version} updates the keyboard event handling, implementing the `event.key` property rather than relying on numeric key codes. This solution ensures that the `{` character can be typed using `+Option+8+` on German Mac keyboards without interfering with the `+Alt+F12+` notification focus shortcut.
 
 [[security-fixes]]
 == Security fixes
@@ -222,7 +381,13 @@ This section describes issues that users of {productname} {release-version} may
 
 There <is one | are <number> known issue<s> in {productname} {release-version}.
 
-=== <TINY-vwxyz 1 changelog entry>
-// #TINY-vwxyz1
+== Known Issues
+
+=== Screenreader on safari has poor consistency of announcing aria-label
+// #TINY-11291 & #TINY-11430
+
+In Safari, when using a screen reader on the color picker, the focus is mistakenly placed on the content within the input field rather than the field itself. This causes the screen reader to bypass announcing the aria-label associated with the field.
+
+As a consequence, users who rely on screen readers may not hear the intended description provided by the aria-label, potentially causing confusion or reducing accessibility.
 
-// CCFR here.
+**Status**: Currently under investigation.

modules/ROOT/partials/configuration/exportpdf.adoc

@@ -28,9 +28,22 @@ tinymce.init({
 
 This option allows the editor to download a PDF document containing its content, along with the specified options defined in the `exportpdf_converter_options`.
 
-*Type:* `+Object+`
+**Type:** `+Object+`
 
-*Default value:* `{}`
+[NOTE]
+As of {productname} 7.5.0, the `exportpdf_converter_options` setting now comes with a default value set to the following:
+
+.**Default value:**
+[source,js]
+----
+exportpdf_converter_options: {
+  format: 'Letter',
+  margin_top: '1in',
+  margin_right: '1in',
+  margin_bottom: '1in',
+  margin_left: '1in'
+}
+----
 
 === Example: using `exportpdf_converter_options`
 

modules/ROOT/partials/configuration/exportword.adoc

@@ -31,9 +31,20 @@ tinymce.init({
 
 The `exportword_converter_options` option, is used to specify and configure various options related to the process of converting and exporting content from the editor to `.docx` Word file.
 
-*Type:* `+Object+`
+**Type:** `+Object+`
 
-*Default value:* `{}`
+[NOTE]
+As of {productname} 7.5.0, the default value of the `exportword_converter_options` setting has been updated to the following:
+
+.**Default value:**
+[source,js]
+----
+exportword_converter_options: {
+  document: {
+    size: 'letter'
+  }
+}
+----
 
 === Example: using `exportword_converter_options`
 

modules/ROOT/partials/configuration/importword-converter-options.adoc

@@ -3,6 +3,21 @@
 
 **Type:** `String`
 
+[NOTE]
+As of {productname} 7.5.0, the default value of the `importword_converter_options` setting has been updated to the following:
+
+.**Default value:** 
+[source,js]
+----
+importword_converter_options: {
+  formatting: {
+    styles: 'inline',
+    resets: 'inline',
+    defaults: 'inline',
+  }
+}
+----
+
 The `importword_converter_options` setting allows you to customize the behavior of the {pluginname} plugin when converting Word documents to HTML.
 
 .Example: using `importword_converter_options`

modules/ROOT/partials/integrations/swing-quick-start.adoc

@@ -4,7 +4,7 @@ Users can easily configure the {productname} editor in Swing through the *{produ
 
 To start using {productname} for Swing as your new rich text editor, the first step is to obtain a copy of the *Integration*.
 
-Contact link:{supporturl}[{supportname}] to discuss how to get started with our latest release.
+link:{contactpage}[{contactsales}] to discuss how to get started with our latest release.
 
 == Get started with our TinyMCE in Swing integration