The Autolink plugin automatically creates hyperlinks when a user inputs a valid, complete URL. For example `www.example.com` is converted to `http://www.example.com`.
Note that this option won't convert incomplete URLs, for example `example.com` would remain as unlinked text. i.e. URLs must include `www` to be automatically converted.
Note that this option won't convert incomplete URLs. For example `example.com` would remain as unlinked text and URLs must include `www` to be automatically converted.
These settings affect the execution of the Autoresize plugin, including changes to the minimum width, height, bottom margin and default initialization state.
These settings affect the execution of the Autoresize plugin, including changes to the minimum width, height, bottom margin, and default initialization state.
This plugin allows a user to edit certain document properties (such as `title`, `keywords`, `description`) via a dialog box after pressing a control added to the toolbar. If the `code` plugin is enabled `fullpage` exposes `<head>`, `<body>` and various `meta` tags in source code view.
This plugin allows a user to edit certain document properties such as `title`, `keywords`, and `description`. This is done via a dialog box which appears after pressing a control added to the toolbar. If the `code` plugin is enabled `fullpage` exposes `<head>`, `<body>` and various `meta` tags in source code view.
The plugin also adds a `Document properties` menu under the `File` menu and button to the toolbar.
@ -8,7 +8,7 @@ keywords: photo insert edit style format image_caption image_list image_advtab i
This plugin enables the user to insert an image into TinyMCE's editable area.
> Note that this is not drag-drop functionality and the user is required to enter the path to the image (and optionally the image description, dimensions and whether image proportions should be constrained (via a checkbox)). Some of these settings can be preset using the plugin's configuration options.
> Note that this is not drag-drop functionality and the user is required to enter the path to the image. Optionally the user can also enter the image description, dimensions, and whether image proportions should be constrained (selected via a checkbox). Some of these settings can be preset using the plugin's configuration options.
The plugin also adds a toolbar button and an `Insert/edit image` menu item under the `Insert` menu.
@ -69,7 +69,7 @@ Below is an example of the HTML created when a user selects the caption checkbox
</figure>
```
Note that the `figure` element needs some custom CSS added to render properly. This is what we use in the internal `content.css` within TinyMCE, which can be overridden with your own custom [`content_css`]({{ site.baseurl }}/configure/content-appearance/#content_css) stylesheet.
Note that the `figure` element needs some custom CSS added to render properly. This is what we use in the internal `content.css` within TinyMCE, and can be overridden with your own custom [`content_css`]({{ site.baseurl }}/configure/content-appearance/#content_css) stylesheet.
The Image Tools (`imagetools`) plugin adds a contextual image editing toolbar to images inserted into the editable area. This works on modern browsers that let you edit images inline.
Note that this feature requires at least Internet Explorer 10 as it uses the `HTML5 File API`. Also note that if the `imagetools` inline toolbar isn't appearing you may need to enable `imagetools_cors_hosts` or `imagetools_proxy`.
Note that this feature requires at least Internet Explorer 10 as it uses the `HTML5 File API`. Also, if the `imagetools` inline toolbar isn't appearing you may need to enable `imagetools_cors_hosts` or `imagetools_proxy`.
@ -7,7 +7,7 @@ keywords: video youtube vimeo mp3 mp4 mov movie clip film media_live_embeds audi
controls: toolbar button, menu item
---
The `media` plugin adds the ability for users to be able to add HTML5 video and audio elements to the editable area. It also adds the menu item `Insert/edit video` under the `Insert` menu as well as a toolbar button.
The `media` plugin adds the ability for users to be able to add HTML5 video and audio elements to the editable area. It also adds the item `Insert/edit video` under the `Insert` menu as well as a toolbar button.
**Type:** `String`
@ -24,7 +24,7 @@ tinymce.init({
### Options
These settings affect the execution of the `media` plugin, namely the ability to disable parts of the media dialog box when inserting/editing media items. In addition, the user may disable the cross-site scripting sanitation filter for video/object elements here.
These settings affect the execution of the `media` plugin. Namely the ability to disable parts of the media dialog box when inserting/editing media items. In addition, the user may disable the cross-site scripting sanitation filter for video/object elements here.
### `media_live_embeds`
@ -140,7 +140,7 @@ tinymce.init({
### `media_filter_html`
This option allows you disable the XSS sanitation filter for video/object elements. Scripts, conditional comments, etc, can't be used within these elements by default for security reasons. If you want to include that and have server side sanitizers, or you trust your users, then you can disable this feature.
This option allows you disable the XSS sanitation filter for video/object elements. Scripts, conditional comments, etc, can't be used within these elements by default for security reasons. If you want to include that and have server side sanitizers or if you trust your users, then you can disable this feature.
@ -33,7 +33,7 @@ These configuration options affect the execution of the `mentions` plugin. The m
### `mentions_fetch`
This option lets you request your server for a list of uses matching a search query. The callback gets passed two parameters: one is the search query object and the other is the success callback to execute with the results. The query object has a term property that contains what the user has typed after the "@" sign. The success call should contain an array of users with the required properties "id", "name" and "fullName".
This option lets you request a list of uses from your server that match a search query. The callback gets passed two parameters: one is the search query object, the other is the success callback to execute with the results. The query object has a term property that contains what the user has typed after the "@" sign. The success call should contain an array of users with the required properties "id", "name" and "fullName".
**Type:** `function`
@ -171,7 +171,7 @@ tinymce.init({
### `getUsers`
You can retrieve the inserted users by calling `getUsers` on the plugin instance object of an editor. This will return an array of users that the author `@mentioned` in the content, but only the ones currently present in the content (i.e. not any existing before the content was created). It will also exclude duplicate inserts by using the `userinfo` objects id property.
You can retrieve the inserted users by calling `getUsers` on the plugin instance object of an editor. This will return an array of users that the author `@mentioned` in the content, but only the ones currently present in the content and will exclude any existing before the content was created. It will also exclude duplicate inserts by using the `userinfo` objects id property.
> **Updated in 4.3!** The `noneditable` plugin has been rewritten from scratch to use stability improvements to the TinyMCE core released in version 4.3. It is now more reliable and has fewer browser-specific quirks.
This plugin enables you to prevent users from being able to change (i.e. edit) content within elements assigned the `mceNonEditable` class.
This plugin enables you to prevent users from being able to edit content within elements assigned the `mceNonEditable` class.
@ -9,7 +9,7 @@ controls: toolbar button, menu item
> Looking for more advanced Microsoft Word importing and pasting? Try the [PowerPaste](../powerpaste/) plugin.
This plugin will filter/cleanup content pasted from Microsoft Word. The power of the plugin is in its options, so please take the time to learn more about these below.
This plugin will filter/cleanup content pasted from Microsoft Word. The power of the plugin is in its options, so please take the time to learn more about them below.
The plugin also adds a menu item `Paste as text` under the `Edit` menu dropdown and a toolbar button.
@ -38,7 +38,7 @@ This option specifies whether `data:url` images (inline images) should be remove
Setting `paste_data_images` to `"true"` will allow the pasted images, while setting it to `"false"` will disallow pasted images.
For example, Firefox enables you to paste images directly into any `contentEditable` field. This is normally not something people want, so this option is `"false"` by default since, say, a 600kb embedded image blocks page loads and prevents it form being cached on multiple pages.
For example, Firefox enables you to paste images directly into any `contentEditable` field. This is normally not something people want, so this option is `"false"` by default. For example, a 600kb embedded image would block page loads and prevents it form being cached on multiple pages.
**Type:** `Boolean`
@ -166,7 +166,7 @@ tinymce.init({
### `paste_word_valid_elements`
This option enables you to configure the `valid_elements` specific to MS Office. Word produces a lot of junk HTML so when users paste things from Word we do extra restrictive filtering on it to remove as much of this as possible. This option enables you to specify which elements and attributes you want to include when Word contents are intercepted.
This option enables you to configure the `valid_elements` specific to MS Office. Word produces a lot of junk HTML, so when users paste things from Word we do extra restrictive filtering on it to remove as much of this as possible. This option enables you to specify which elements and attributes you want to include when Word contents are intercepted.
@ -25,7 +25,7 @@ This setting affects the execution of the `tabfocus` plugin. This setting can be
### `tabfocus_elements`
This option enables you to specify an element `ID` to focus, when the user pressed the tab key inside the editor. You can also use the special `":prev"` and `":next"` values. It will then place the focus on either the previous or next input element placed before/after the TinyMCE instance in the DOM.
This option enables you to specify an element `ID` to focus when the user presses the tab key inside the editor. You can also use the special `":prev"` and `":next"` values. It will then place the focus on either the previous or next input element placed before/after the TinyMCE instance in the DOM.
These settings affect the execution of the `table` plugin and let you modify the default styles and attributes for tables, preset class lists and table behavior.
These settings affect the execution of the `table` plugin and let you modify the default styles and attributes for tables, preset class lists, and table behavior.
### `table_toolbar`
This option allows you to specify the buttons and the order that they will appear on TinyMCE's inline contextual toolbar for tables. To specify the controls that should appear on TinyMCE's table toolbar, the `table_toolbar` option should be provided with a space separated list of toolbar controls. To create groups within this list, please add `|` pipe characters between the groups of controls that you would like to create. If you want to disable this toolbar simply set the value to an empty string.
This option allows you to specify the buttons and the order that they will appear on within TinyMCE's inline contextual toolbar for tables. To specify the controls that should appear on TinyMCE's table toolbar, the `table_toolbar` option should be provided with a space separated list of toolbar controls. To create groups within this list, please add `|` pipe characters between the groups of controls that you would like to create. If you want to disable this toolbar simply set the value to an empty string.
**Type:** `String`
@ -81,7 +81,7 @@ tinymce.init({
This option allows you disable the table grid feature of the table menu. The grid feature (which is enabled by default) consists of a dragable matrix that a user can interact with to automatically create a table of x-rows by x-columns based upon their input.
However, if you set this option to `false` the dragable matrix will be replaced with a table dialog box into which a user can enter various parameters to create a table (e.g. cols, rows, width, height, cell spacing, cell padding, border, caption and alignment). There are also advanced style options available in the dialog.
However, if you set this option to `false` the dragable matrix will be replaced with a table dialog box into which a user can enter various parameters to create a table cols, rows, width, height, cell spacing, cell padding, border, caption and alignment). There are also advanced style options available in the dialog.
This plugin allows a user to see block level elements in the editable area. It is similar to WYSIWYG hidden character functionality but (of course) at block level. It also adds a toolbar button and a menu item `Show blocks` under the `View` menu dropdown.
This plugin allows a user to see block level elements in the editable area. It is similar to WYSIWYG hidden character functionality, but at block level. It also adds a toolbar button and a menu item `Show blocks` under the `View` menu dropdown.
It's worth noting that at present the toolbar button icon is the same for both `visualblocks` and `visualchars`.
Nicholas Considine
9 years ago