Skip to content

Commit ee579b0

Browse files
committed
DOC-3202: Update migration guides: refine plugin migration examples and clarify default changes for TinyMCE 7.0
1 parent c2cb082 commit ee579b0

File tree

2 files changed

+14
-12
lines changed

2 files changed

+14
-12
lines changed

modules/ROOT/pages/migration-from-4x.adoc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The {productname} plugin ecosystem was significantly restructured in version 6.0
4848
* **Now Premium Only**:
4949
** `spellchecker`, `editimage`, `mediaembed`, `tableofcontents`: These features are available through premium plugins.
5050

51-
.Plugin Migration Examples
51+
==== Plugin Migration Tips
5252

5353
* `contextmenu` (removed in v6):
5454
** Use browser-native context menus or custom logic.
@@ -120,12 +120,12 @@ forced_root_block: "p"
120120

121121
* **Removed in {productname} 6.0**: Legacy mobile theme was removed, but mobile-specific configuration is still supported through the `mobile` option.
122122
* **Default Changes in TinyMCE 7.0**:
123-
* xref:content-filtering.adoc#sandbox-iframes[sandbox iframes]: Now defaults to `true` (adds sandbox attribute to iframes)
124-
* xref:content-filtering.adoc#convert-unsafe-embeds[convert_unsafe_embeds]: Now defaults to `true` (converts object/embed elements to safer alternatives)
125-
* xref:accessibility.adoc#highlight_on_focus[highlight_on_focus]: Now defaults to `true` (adds focus outline to editors)
123+
** xref:content-filtering.adoc#sandbox-iframes[sandbox iframes]: Now defaults to `true` (adds sandbox attribute to iframes)
124+
** xref:content-filtering.adoc#convert-unsafe-embeds[convert_unsafe_embeds]: Now defaults to `true` (converts object/embed elements to safer alternatives)
125+
** xref:accessibility.adoc#highlight_on_focus[highlight_on_focus]: Now defaults to `true` (adds focus outline to editors)
126126
* **New Options in {productname} 7.0**:
127-
* xref:license-key.adoc[license_key]: Must be set to `gpl` or a valid license key
128-
* xref:content-filtering.adoc#sandbox-iframes-exclusions[`sandbox_iframes_exclusions`]: List of URL hosts to exclude from iframe sandboxing
127+
** xref:license-key.adoc[license_key]: Must be set to `gpl` or a valid license key
128+
** xref:content-filtering.adoc#sandbox-iframes-exclusions[`sandbox_iframes_exclusions`]: List of URL hosts to exclude from iframe sandboxing
129129

130130
.Example:
131131
[source,js]

modules/ROOT/pages/migration-from-5x.adoc

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The {productname} plugin ecosystem underwent a significant overhaul starting in
4949
** `toc`: Renamed to `tableofcontents` and now premium.
5050
** `advtemplate`: Replaces the `template` plugin for advanced templating use cases.
5151

52-
.Plugin Migration Examples
52+
==== Plugin Migration Examples
5353

5454
* `contextmenu` (removed in v6):
5555
** Use browser-native context menus or custom logic.
@@ -133,13 +133,13 @@ tinymce.init({
133133
** `table_responsive_width` replaced by `table_sizing_mode`.
134134

135135
* **Default Changes in TinyMCE 7.0**:
136-
* xref:content-filtering.adoc#sandbox-iframes[sandbox iframes]: Now defaults to `true` (adds sandbox attribute to iframes)
137-
* xref:content-filtering.adoc#convert-unsafe-embeds[convert_unsafe_embeds]: Now defaults to `true` (converts object/embed elements to safer alternatives)
138-
* xref:accessibility.adoc#highlight_on_focus[highlight_on_focus]: Now defaults to `true` (adds focus outline to editors)
136+
** xref:content-filtering.adoc#sandbox-iframes[sandbox iframes]: Now defaults to `true` (adds sandbox attribute to iframes)
137+
** xref:content-filtering.adoc#convert-unsafe-embeds[convert_unsafe_embeds]: Now defaults to `true` (converts object/embed elements to safer alternatives)
138+
** xref:accessibility.adoc#highlight_on_focus[highlight_on_focus]: Now defaults to `true` (adds focus outline to editors)
139139

140140
* **New Options in {productname} 7.0**:
141-
* xref:license-key.adoc[license_key]: Must be set to `gpl` or a valid license key
142-
* xref:content-filtering.adoc#sandbox-iframes-exclusions[`sandbox_iframes_exclusions`]: List of URL hosts to exclude from iframe sandboxing
141+
** xref:license-key.adoc[license_key]: Must be set to `gpl` or a valid license key
142+
** xref:content-filtering.adoc#sandbox-iframes-exclusions[`sandbox_iframes_exclusions`]: List of URL hosts to exclude from iframe sandboxing
143143

144144
.Example:
145145
[source,js]
@@ -166,6 +166,7 @@ TIP: For up-to-date plugin availability and configuration references, see link:h
166166
Refer to version-specific release notes for changes in toolbar button names and command availability across versions 5, 6, and 7. For example:
167167
168168
{productname} 5 → {productname} 6:
169+
169170
* `formatselect` → `blocks`
170171
* `styleselect` → `styles`
171172
* `fontselect` → `fontfamily`
@@ -174,6 +175,7 @@ Refer to version-specific release notes for changes in toolbar button names and
174175
* `toc` → `tableofcontents`
175176
176177
{productname} 6 → {productname} 7:
178+
177179
* `InsertOrderedList` / `InsertUnorderedList` commands removed from core (use `lists` plugin).
178180
* Default text pattern triggers updated from `Enter` to `Space`, configurable via `trigger`.
179181
====

0 commit comments

Comments
 (0)