Skip to content

Commit d40a6bd

Browse files
authored
DOC-3469 - Fix incorrect plugin categorizations in migration guides (#4072)
* DOC-3469: Fix incorrect plugin categorizations in migration guides Correct three factual errors across the 4→8, 5→8, and 6→8 migration guides: - textcolor: move from "Removed" / "Now Premium Only" to "Integrated into core" — the plugin's functionality was absorbed into core via the forecolor and backcolor toolbar buttons - mediaembed: remove from "Now Premium Only" — it has always been a premium plugin and was never open-source - fullpage: move from "Removed Plugins" to "Now Premium Only" — it became the premium fullpagehtml plugin * DOC-3469: Fix fullpage version reference per review feedback Change "now premium in v6" to "now premium in v8" in the 4→8 and 5→8 migration guides.
1 parent 0cdd04f commit d40a6bd

3 files changed

Lines changed: 28 additions & 30 deletions

File tree

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

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,18 @@ tinymce.init({
3333
The {productname} plugin ecosystem was significantly restructured across versions 5, 6, and 7, with several plugins being removed, folded into the {productname} core, or reclassified as premium features. The following breakdown clarifies the status of each affected plugin.
3434

3535
* **Removed Plugins** (no longer available as of {productname} 6.0):
36-
** `bbcode`, `fullpage`, `legacyoutput`: Deprecated in 5.9.0. Removed in 6.0.
36+
** `bbcode`, `legacyoutput`: Deprecated in 5.9.0. Removed in 6.0.
3737
** `imagetools`: Removed in 6.0. Replaced by the premium xref:editimage.adoc[Enhanced Image Editing] feature, available via the `+editimage+` plugin introduced in {productname} 6.0.
38-
** `textcolor`: Removed in 6.0. Use the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality instead.
3938

4039
* **Integrated into {productname} core**:
4140
** `paste`, `hr`, `noneditable`, `table`, `print`, `colorpicker` and `contextmenu`: These plugins were absorbed into {productname} core and no longer require separate installation. See xref:copy-and-paste.adoc[Copy and Paste], xref:non-editable-content-options.adoc[Non-editable Content], xref:table.adoc[Table], and xref:contextmenu.adoc[Context Menu] for more information.
41+
** `textcolor`: Removed as a separate plugin in 6.0. Text color functionality is now part of {productname} core via the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
4242
** `contextmenu`: Deprecated in version 5.0 following the integration of context menu functionality into {productname} core editor. Removed in version 6.0. For more information, see xref:contextmenu.adoc[contextmenu documentation].
4343
** `tabfocus`: Removed in 6.0. Keyboard navigation via Tab is now handled by the browser and {productname} core.
4444

4545
* **Now Premium Only**:
46-
** `mediaembed`, `tableofcontents`: These features are available through premium plugins. See xref:introduction-to-mediaembed.adoc[Media Embed] and xref:tableofcontents.adoc[Table of Contents] for more information.
46+
** `fullpage`: Removed in 6.0. Replaced by the premium xref:fullpagehtml.adoc[Full Page HTML] plugin (`+fullpagehtml+`).
47+
** `tableofcontents`: Previously available as the open-source `toc` plugin. Renamed to `tableofcontents` and now available as a premium plugin. See xref:tableofcontents.adoc[Table of Contents] for more information.
4748
** `spellchecker`: Deprecated in 5.9.0. Removed in 6.0.
4849
*** Use xref:spelling.adoc#browser_spellcheck[`browser_spellcheck: true`] or the premium xref:introduction-to-tiny-spellchecker.adoc[Spell Checker] plugin.
4950
** `advtemplate`: Replaces the `template` plugin for advanced templating use cases.
@@ -56,12 +57,12 @@ The {productname} plugin ecosystem was significantly restructured across version
5657
** Consider using xref:apis/tinymce.editor.ui.registry.adoc#addContextMenu[`editor.ui.registry.addContextMenu`] for custom right-click actions. See xref:contextmenu.adoc[Context menus] for more information.
5758
* `bbcode` (removed in v6):
5859
** Implement custom parsing or server-side processing if BBCode support is required.
59-
* `fullpage` (removed in v6):
60-
** Use custom templates or server-side logic to handle full HTML documents.
60+
* `fullpage` (now premium in v8):
61+
** Use the premium xref:fullpagehtml.adoc[Full Page HTML] plugin (`+fullpagehtml+`) for full HTML document editing.
6162
* `template` (removed in v7):
6263
** Use the premium xref:advanced-templates.adoc[advtemplate] plugin or implement custom modal dialogs.
63-
* `textcolor` (removed in v6):
64-
** Use the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons for text color functionality.
64+
* `textcolor` (integrated into core in v6):
65+
** Text color functionality is now built into {productname} core. Use the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
6566
* `imagetools`: (removed in v6):
6667
** Use the premium xref:editimage.adoc[Enhanced Image Editing] or xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] plugin for image editing capabilities.
6768

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,22 +34,22 @@ tinymce.init({
3434
The {productname} plugin ecosystem underwent a significant overhaul starting in version 6.0, with many plugins either removed, integrated into the core, or made premium-only. The following summarizes these changes.
3535

3636
* **Removed Plugins** (no longer available as of {productname} 6.0):
37-
** `bbcode`, `fullpage`, `legacyoutput`: Deprecated in 5.9.0. Removed in 6.0.
37+
** `bbcode`, `legacyoutput`: Deprecated in 5.9.0. Removed in 6.0.
3838
** `imagetools`: Removed in 6.0. Replaced by the premium xref:editimage.adoc[Enhanced Image Editing] feature, available via the `+editimage+` plugin introduced in TinyMCE 6.0.
39-
** `textcolor`: Removed in 6.0. Use the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality instead.
4039

4140
* **Integrated into {productname} core**:
4241
** `paste`, `hr`, `table`, `noneditable`, `nonbreaking`, `print`, `colorpicker` and `contextmenu`: These plugins were absorbed into {productname} core and no longer require separate installation. See xref:copy-and-paste.adoc[Copy and Paste], xref:table.adoc[Table], xref:non-editable-content-options.adoc[Non-editable Content], and xref:contextmenu.adoc[Context Menu] for more information.
42+
** `textcolor`: Removed as a separate plugin in 6.0. Text color functionality is now part of {productname} core via the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
4343
** `contextmenu`: Deprecated in version 5.0 following the integration of context menu functionality into {productname} core editor. Removed in version 6.0. For more information, see xref:contextmenu.adoc[contextmenu documentation].
4444
** `tabfocus`: Removed in 6.0. Keyboard navigation via Tab is now handled by the browser and {productname} core.
4545

4646
* **Now Premium Only**:
47-
** `mediaembed`, `tableofcontents`: These features are available through premium plugins. See xref:introduction-to-mediaembed.adoc[Media Embed] and xref:tableofcontents.adoc[Table of Contents] for more information.
47+
** `fullpage`: Removed in 6.0. Replaced by the premium xref:fullpagehtml.adoc[Full Page HTML] plugin (`+fullpagehtml+`).
48+
** `tableofcontents`: Previously available as the open-source `toc` plugin. Renamed to `tableofcontents` and now available as a premium plugin. See xref:tableofcontents.adoc[Table of Contents] for more information.
4849
** `spellchecker`: Deprecated in 5.9.0. Removed in 6.0.
4950
*** Use `browser_spellcheck: true` or the premium xref:introduction-to-tiny-spellchecker.adoc[Spell Checker] plugin.
5051
** `advtemplate`: Replaces the `template` plugin for advanced templating use cases.
5152
** `template`: Removed in 7.0. Replaced by the premium xref:advanced-templates.adoc[Templates] plugin.
52-
** `toc`: Renamed to `tableofcontents` and now premium.
5353

5454
==== Plugin Migration Examples
5555

@@ -58,12 +58,12 @@ The {productname} plugin ecosystem underwent a significant overhaul starting in
5858
** Consider using xref:apis/tinymce.editor.ui.registry.adoc#addContextMenu[`editor.ui.registry.addContextMenu`] for custom right-click actions. See xref:contextmenu.adoc[Context menus] for more information.
5959
* `bbcode` (removed in v6):
6060
** Implement custom parsing or server-side processing if BBCode support is required.
61-
* `fullpage` (removed in v6):
62-
** Use custom templates or server-side logic to handle full HTML documents.
61+
* `fullpage` (now premium in v8):
62+
** Use the premium xref:fullpagehtml.adoc[Full Page HTML] plugin (`+fullpagehtml+`) for full HTML document editing.
6363
* `template` (removed in v7):
6464
** Use the premium xref:advanced-templates.adoc[advtemplate] plugin or implement custom modal dialogs.
65-
* `textcolor` (removed in v6):
66-
** Use the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons for text color functionality.
65+
* `textcolor` (integrated into core in v6):
66+
** Text color functionality is now built into {productname} core. Use the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
6767
* `imagetools`: (removed in v6):
6868
** Use the premium xref:editimage.adoc[Enhanced Image Editing] or xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] plugin for image editing capabilities.
6969

modules/ROOT/pages/migration-from-6x-to-8x.adoc

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,15 @@ The {productname} plugin ecosystem underwent changes starting in version 7.0, wi
2020
* **Removed Plugins** (no longer available as of {productname} 7.0):
2121
** `template`: Removed in 7.0. Replaced by the premium xref:advanced-templates.adoc[Templates] plugin.
2222

23+
* **Integrated into {productname} core** (removed in 6.0, before this migration path):
24+
** `textcolor`: Removed as a separate plugin in 6.0. Text color functionality is now part of {productname} core via the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
25+
2326
* **Now Premium Only** (removed in 6.0, before this migration path):
2427
** `imagetools`: Removed in 6.0. Replaced by the premium xref:editimage.adoc[Enhanced Image Editing] feature, available via the `+editimage+` plugin introduced in TinyMCE 6.0.
25-
** `textcolor`: Removed in 6.0. Use the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality instead.
2628

2729
[NOTE]
2830
====
29-
If you're migrating from TinyMCE 6, these plugins (`imagetools` and `textcolor`) were already removed in version 6.0, so you won't need to migrate them. The sections below are included for reference only, in case you're upgrading from an older version or have legacy code.
31+
If migrating from TinyMCE 6, these plugins (`imagetools` and `textcolor`) were already removed in version 6.0, so they do not require migration. The sections below are included for reference only, in case the upgrade started from an older version or the codebase contains legacy references.
3032
====
3133

3234
==== Plugin Migration Examples
@@ -39,9 +41,8 @@ If you're migrating from TinyMCE 6, these plugins (`imagetools` and `textcolor`)
3941
** Use the premium xref:editimage.adoc[Enhanced Image Editing] feature.
4042
** Ensure you have a valid commercial license for the Enhanced Image Editing feature.
4143

42-
* `textcolor` (removed in v6):
43-
** Use the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality.
44-
** Ensure you have a valid commercial license for the Color Picker feature.
44+
* `textcolor` (integrated into core in v6):
45+
** Text color functionality is now built into {productname} core. Use the xref:available-toolbar-buttons.adoc[`forecolor` and `backcolor`] toolbar buttons, which are available without additional plugins.
4546

4647
=== Content Structure
4748

@@ -453,22 +454,19 @@ tinymce.init({
453454
});
454455
----
455456

456-
=== Text Color Plugin Removal
457+
=== Text Color Plugin (integrated into core)
457458

458459
[NOTE]
459460
====
460-
This section applies only if you're upgrading from TinyMCE 5 or earlier. The `textcolor` plugin was removed in TinyMCE 6.0, so if you're migrating from TinyMCE 6, this plugin was already unavailable.
461+
This section applies only when upgrading from TinyMCE 5 or earlier. The `textcolor` plugin was removed in TinyMCE 6.0, so migrating from TinyMCE 6 does not require action.
461462
====
462463

463-
The `textcolor` plugin was removed in TinyMCE 6.0. If you were using this plugin, you need to migrate to the xref:user-formatting-options.adoc#text-color-options[premium Color Picker] functionality.
464+
The `textcolor` plugin was removed as a separate plugin in TinyMCE 6.0 because its functionality was integrated into {productname} core. The `forecolor` and `backcolor` toolbar buttons are available without additional plugins.
464465

465466
**Migration checklist:**
466467

467-
* [ ] Remove `textcolor` from plugins list
468-
* [ ] Add `colorpicker` to plugins list (premium feature)
469-
* [ ] Ensure you have a valid commercial license for Color Picker
470-
* [ ] Update any custom color picker configurations
471-
* [ ] Test color picker functionality
468+
* [ ] Remove `textcolor` from the plugins list
469+
* [ ] The `forecolor` and `backcolor` toolbar buttons remain available as core toolbar buttons
472470

473471
.Example:
474472
[source,js]
@@ -480,10 +478,9 @@ tinymce.init({
480478
toolbar: "forecolor backcolor"
481479
});
482480
483-
// New TinyMCE 6+ configuration
481+
// New TinyMCE 6+ configuration (no plugin required)
484482
tinymce.init({
485483
selector: "textarea",
486-
plugins: "colorpicker",
487484
toolbar: "forecolor backcolor"
488485
});
489486
----

0 commit comments

Comments
 (0)