@ -3,13 +3,13 @@ The following new features were added to the TinyMCE 5.0 RC version.
### Comments 2.0
The [Comments 2.0]({{site.baseurl}}/enterprise/tiny-comments/) is a premium plugin built on the [Annotations API]({{site.baseurl}}/advanced/annotations/) to create comment threads (conversations). Comments 2.0 provides the ability to start or join a conversation by adding comments to the content within the TinyMCE editor.
The [Comments 2.0]({{site.baseurl}}/enterprise/tiny-comments/) is a premium plugin built on the [Annotations API]({{site.baseurl}}/advanced/annotations/) to create comment threads (conversations). Comments 2.0 provides the ability to start or join a conversation by adding comments to the content within the TinyMCE editor.
Refer to the [Comments 2.0]({{site.baseurl}}/plugins/comments/) documentation, for more information.
### Context menu
The [Context menu](https://www.tiny.cloud/docs/plugins/contextmenu/) is no longer a plugin, it is part of the core and always enabled. Where TinyMCE 4.x only supported adding registered menu items, the new context menu also allows plugins to register "sections" of the context menu. These sections are dynamic and may show or hide depending on the cursor position when the context menu is opened. For example, the default context menu config is now `'link image editimage table spelling'` which are all plugin section references, not menu items.
The [Context menu]({{site.url}}/docs-4x/plugins/contextmenu/) is no longer a plugin, it is part of the core and always enabled. Where TinyMCE 4.x only supported adding registered menu items, the new context menu also allows plugins to register "sections" of the context menu. These sections are dynamic and may show or hide depending on the cursor position when the context menu is opened. For example, the default context menu config is now `'link image editimage table spelling'` which are all plugin section references, not menu items.
The context menu supports both individual menu items and dynamic context menu sections. Refer to the [context menu]({{site.baseurl}}/ui-components/contextmenu/) documentation, for more information.
@ -25,7 +25,7 @@ The Custom Menu items configurations options have changed in TinyMCE 5.0. The `a
### Custom sidebars
Custom sidebars allow developers to add custom tools and widgets to a sidebar within the editor. In TinyMCE 5.0 the configuration has changed slightly. The method for registering custom sidebars is now `editor.ui.registry.addSidebar()` and `onrender` is now `onSetup`.
Custom sidebars allow developers to add custom tools and widgets to a sidebar within the editor. In TinyMCE 5.0 the configuration has changed slightly. The method for registering custom sidebars is now `editor.ui.registry.addSidebar()` and `onrender` is now `onSetup`.
Refer to the [Custom sidebars]({{site.baseurl}}/ui-components/customsidebar/) documentation for more information.
@ -47,11 +47,9 @@ TinyMCE is up-to-date with the latest accessibility standards. This includes the
A new experimental feature has been added that allows using the tab across all TinyMCE toolbars, sidebars, content, and footer bar. This allows more granular control to quickly jump to the appropriate editor control and then navigate down to its specific feature sets.
> TinyMCE is the only editor to have this feature!
### Mentions
The [Mentions]({{site.baseurl}}/enterprise/mentions/) plugin makes it possible for users to send notifications using **@username** in the document.
The [Mentions]({{site.baseurl}}/enterprise/mentions/) plugin makes it possible for users to send notifications using **@username** in the document.
Mentions is available for download through [TinyMCE Cloud]({{site.baseurl}}/cloud-deployment-guide/editor-and-features/). Include the mentions parameter in the tinymce.init script. Refer to the [Mentions]({{site.baseurl}}/plugins/mentions/) documentation, for more information on setup and configuration.
@ -101,7 +99,7 @@ Refer to the [Permanent Pen]({{site.baseurl}}/plugins/permanentpen/) documentati
### Tables
Tables are better in TinyMCE 5.0 editor. Creating and configuring tables in TinyMCE 5.0 is simpler.
Creating and configuring tables in TinyMCE 5.0 is simpler.
This feature has been enhanced by modifying the code to ensure the styles are correct and consistent. The **Styles** text field has been removed from the advanced table properties dialogs. The dialog configuration is now much less confronting and confusing for non-developers.
| [Mobile]({{site.url}}/docs-4x/themes/mobile/) | Silver (responsive to small screen touch devices) |
### Removed themes
@ -151,7 +151,7 @@ This will provide a similar but improved [distraction-free]({{site.baseurl}}/gen
#### Modern
The Modern theme is no longer supported in TinyMCE 5.0. The modern theme's UI library [`tinymce.ui.*`](https://www.tiny.cloud/docs-4x/api/tinymce.ui/) has also been deleted. This change may impact integrations depending upon the [level of customization]({{site.baseurl}}/migration-from-4x/#initialization).
The Modern theme is no longer supported in TinyMCE 5.0. The modern theme's UI library [`tinymce.ui.*`]({{site.url}}/docs-4x/api/tinymce.ui/) has also been deleted. This change may impact integrations depending upon the [level of customization](#initialization).
> Note: For support related issues such as problems while migrating and a workaround, please contact [support](https://support.tiny.cloud/hc/en-us/requests/new). Alternatively, track developer preview issues on GitHub, [here](https://github.com/tinymce/tinymce/labels/5.x).
@ -487,27 +487,9 @@ For more information about the new URL dialog configuration, see the [`URL dialo
Docs are coming soon! -->
### Custom context toolbars
The Context Toolbar accepts toolbar buttons that were previously added to the editor using the editor's `addButton`, `addToggleButton`, `addSplitButton` or a`ddMenuButton` functions. The method for creating custom context toolbars in TinyMCE 5.0 has also been changed from `editor.addContextToolbar()` to `editor.ui.registry.addContextToolbar()`.
For more information on Context Toolbars, see [docs]({{site.baseurl}}/ui-components/contexttoolbar).
### Custom context menus
The [Context menu](https://www.tiny.cloud/docs/plugins/contextmenu/) is no longer a plugin, it is part of the core and always enabled. Where TinyMCE 4.x only supported adding registered menu items, the new context menu also allows plugins to register "sections" of the context menu. These sections are dynamic and may show or hide depending on the cursor position when the context menu is opened. For example, the default context menu config is now `'link image editimage table spelling'` which are all plugin section references, not menu items. See [docs]({{site.baseurl}}/ui-components/contextmenu/)
##### New methods:
| **New method** | **Description** |
| ----------- | -------------- |
| editor.ui.registry.addContextMenu() | Adds a custom context menu. |
For more information on Context Menus, see the [docs]({{site.baseurl}}/ui-components/contextmenu).
### Custom context forms
ContextForm consists of an input field and a series of related buttons. Context forms can be shown wherever a context toolbar can be displayed. Also, when a context form is registered containing a `launch` configuration, a special context toolbar button with name **\`form:${name}\`** is registered which will launch that particular context form. ContextForms are a generalization of the `Insert Link` form that existed in the original [inlite](https://www.tiny.cloud/docs-4x/themes/inlite/#quicklink) theme from TinyMCE 4.
ContextForm consists of an input field and a series of related buttons. Context forms can be shown wherever a context toolbar can be displayed. Also, when a context form is registered containing a `launch` configuration, a special context toolbar button with name **\`form:${name}\`** is registered which will launch that particular context form. ContextForms are a generalization of the `Insert Link` form that existed in the original [inlite]({{site.url}}/docs-4x/themes/inlite/#quicklink) theme from TinyMCE 4.
## Plugins
@ -542,9 +524,27 @@ These features have either changed or have been deleted in TinyMCE 5.0.
| **Plugin name** | **Description** |
| --------------- | -------------- |
| [ContextMenu](https://www.tiny.cloud/docs/plugins/contextmenu/) | New API. See [docs]({{site.baseurl}}/ui-components/contextmenu/). |
| [ColorPicker](https://www.tiny.cloud/docs/plugins/colorpicker/) | Moved to the core. See [docs]({{site.baseurl}}/configure/content-appearance/#color_picker}}). |
| [Text Color](https://www.tiny.cloud/docs/plugins/textcolor/) | The `textcolor` plugin was removed and this setting is not required in TinyMCE 5.0. |
| [ContextMenu]({{site.url}}/docs-4x/plugins/contextmenu/) | New API. See the [docs]({{site.baseurl}}/ui-components/contextmenu/). |
| [ColorPicker]({{site.url}}/docs-4x/plugins/colorpicker/) | Moved to the core. See the [docs]({{site.baseurl}}/configure/content-appearance/#color_picker}}). |
| [Text Color]({{site.url}}/docs-4x/plugins/textcolor/) | The `textcolor` plugin was removed and this setting is not required in TinyMCE 5.0. |
#### Custom context toolbars
The Context Toolbar accepts toolbar buttons that were previously added to the editor using the editor's `addButton`, `addToggleButton`, `addSplitButton` or a`ddMenuButton` functions. The method for creating custom context toolbars in TinyMCE 5.0 has also been changed from `editor.addContextToolbar()` to `editor.ui.registry.addContextToolbar()`.
For information on Context Toolbars, see the [docs]({{site.baseurl}}/ui-components/contexttoolbar).
#### Custom context menus
The [Context menu]({{site.url}}/docs-4x/plugins/contextmenu/) is no longer a plugin, it is part of the core and always enabled. Where TinyMCE 4.x only supported adding registered menu items, the new context menu also allows plugins to register "sections" of the context menu. These sections are dynamic and may show or hide depending on the cursor position when the context menu is opened. For example, the default context menu config is now `'link image editimage table spelling'` which are all plugin section references, not menu items. For information on using context menus, see: [UI components - Context menu]({{site.baseurl}}/ui-components/contextmenu/).
##### New methods:
| **New method** | **Description** |
| ----------- | -------------- |
| editor.ui.registry.addContextMenu() | Adds a custom context menu. |
For more information on Context Menus, see the [docs]({{site.baseurl}}/ui-components/contextmenu).
### Table
@ -572,5 +572,5 @@ The table below shows UI configurations that have been removed. They are general
| pack | Emulates flex pack | Use CSS stylesheets for custom styling |
| no-wrap | Emulates CSS no line wrap | Use CSS stylesheet for custom styling |
Please see the [TinyMCE 4.x docs](https://www.tiny.cloud/docs-4x/) for more information on the above settings.
Please see the [TinyMCE 4.x docs]({{site.url}}/docs-4x/) for more information on the above settings.
Tyler Kelly
6 years ago