9.0 KiB
layout | title | description_short | description | keywords |
---|---|---|---|---|
default | Specify Editor & Plugin Versions | Specifying editor and plugin versions for Cloud deployments. | Specifying editor and plugin versions for Cloud deployments. | tinymce cloud script textarea apiKey |
Specifying the TinyMCE editor version deployed from Cloud
When deploying the [TinyMCE editor via the Cloud]({{ site.baseurl }}/get-started-cloud/editor-and-features), you’re able to specify the editor version via the provided for URL.
Our documented default for loading TinyMCE via our Cloud is:
<script src="{{ site.cdnurl }}?apiKey=your_API_key"></script>
The stable
in this URL specifies the latest release of TinyMCE that successfully completed our quality assurance testing process. If it is necessary to not use the latest, stable TinyMCE version, you can customize this value. You'll find all supported versions here.
Selecting specific version numbers
You can specify a Major version number, a Major.Minor version number or a Major.Minor.Patch version number. If the Minor or Patch versions numbers are not present, it will default to the latest Minor and Patch version released.
Example
Major version number (e.g. "4").
The following would load TinyMCE 4.latest.latest:
<script src="https://cloud.tinymce.com/4/tinymce.min.js?apiKey=your_API_key"></script>
Example
Major.Minor version number (e.g. "4.3").
The following would load TinyMCE 4.3.latest:
<script src="https://cloud.tinymce.com/4.3/tinymce.min.js?apiKey=your_API_key"></script>
Example
Major.Minor.Patch version number (e.g. "4.3.2").
The following would load TinyMCE 4.3.2:
<script src="https://cloud.tinymce.com/4.3.2/tinymce.min.js?apiKey=your_API_key"></script>
If you enter a version that doesn’t exist, you will get a HTTP 404 response.
dev, testing and stable releases
Rather than specifying a specific TinyMCE version to load from the Cloud, you can choose to select from our dev
, testing
and stable
release channels.
Updates to these channels will be automatic, providing you and your users with the latest TinyMCE version matching the criteria below.
dev release channel
This channel will deploy the absolute latest released TinyMCE version seen in the [TinyMCE changelog]({{ site.baseurl }}/changelog/). The current version of TinyMCE available through the dev
channel can be found at here.
Example
<script src="https://cloud.tinymce.com/dev/tinymce.min.js?apiKey=your_API_key"></script>
testing release channel
This channel will deploy the current candidate for release to the stable
channel. This TinyMCE build will be next in line for our quality assurance testing process. The current version of TinyMCE available through the testing
channel can be found at here.
Example
<script src="https://cloud.tinymce.com/testing/tinymce.min.js?apiKey=your_API_key"></script>
stable release channel
This channel will deploy the latest release of TinyMCE that has passed our quality assurance process. The current version of TinyMCE available through the stable
channel can be found here.
Example
<script src="{{ site.cdnurl }}?apiKey=your_API_key"></script>
Specifying the version of features/plugins deployed from the Cloud
Whether you’re deploying both the [TinyMCE editor and premium plugins via the Cloud]({{ site.baseurl }}/get-started-cloud/editor-and-features) or deploying [only premium plugins from the Cloud]({{ site.baseurl }}/get-started-cloud/features-only), you can use URL query parameters to specify the version of each premium plugin.
PowerPaste
- [Developer documentation]({{ site.baseurl }}/plugins/powerpaste)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=2.1.8"></script>
Spell Checker Pro
- [Developer documentation]({{ site.baseurl }}/plugins/tinymcespellchecker)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&tinymcespellchecker=0.9.6"></script>
Accessibility Checker
- [Developer documentation]({{ site.baseurl }}/plugins/a11ychecker)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&a11ychecker=1.0.2"></script>
Advanced Code Editor
- [Developer documentation]({{ site.baseurl }}/plugins/advcode/)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&advcode=1.0.2"></script>
Enhanced Media Embed
- [Developer documentation]({{ site.baseurl }}/plugins/mediaembed/)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&mediaembed=0.0.1"></script>
Link Checker
- [Developer documentation]({{ site.baseurl }}/plugins/linkchecker/)
- Supported versions
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&linkchecker=1.0.0"></script>
Specifying a Self-hosted deployment of features/plugins
If you're deploying [only premium plugins from the Cloud]({{ site.baseurl }}/get-started-cloud/features-only), you may want to have some features served from the Cloud and some features served from your own Self-hosted installation. This is also possible with URL query parameters and the special version name "sdk".
The "sdk" version lets the TinyMCE Plugin Manager know that you're not using the Cloud version of a particular plugin and that it shouldn't serve the plugin from the Cloud. It also won't display any warning or error messages if you're not entitled to it.
PowerPaste
- [Developer documentation]({{ site.baseurl }}/plugins/powerpaste)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=sdk"></script>
Spell Checker Pro
- [Developer documentation]({{ site.baseurl }}/plugins/tinymcespellchecker)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&tinymcespellchecker=sdk"></script>
Accessibility Checker
- [Developer documentation]({{ site.baseurl }}/plugins/a11ychecker)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&a11ychecker=sdk"></script>
Advanced Code Editor
- [Developer documentation]({{ site.baseurl }}/plugins/advcode/)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&advcode=sdk"></script>
Enhanced Media Embed
- [Developer documentation]({{ site.baseurl }}/plugins/mediaembed/)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&mediaembed=sdk"></script>
Link Checker
- [Developer documentation]({{ site.baseurl }}/plugins/linkchecker/)
Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&linkchecker=sdk"></script>
Examples
Featuring declared editor and plugin versions
The following example would load:
- TinyMCE 4.5.0
- PowerPaste version 2.1.8
- Advanced Code Editor 1.0.2
<html>
<head>
<script src="https://cloud.tinymce.com/4.5.0/tinymce.min.js?apiKey=your_API_key&powerpaste=2.1.8&advcode=1.0.2"></script>
</head>
<body>
<textarea><p>test textarea</p></textarea>
<script>
tinymce.init({
selector: 'textarea',
height: 500,
theme: 'modern',
plugins: [
'advlist autolink lists link image charmap print preview hr anchor pagebreak',
'tinymcespellchecker']
});
</script>
</body>
<html>
Featuring a combination of Self-hosted and Cloud features
The following example would load:
- TinyMCE from your Self-hosted installation
- PowerPaste version 2.1.8 from the Cloud
- Advanced Code Editor from your Self-hosted installation
<html>
<head>
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=2.1.8&advcode=sdk"></script>
</head>
<body>
<textarea><p>test textarea</p></textarea>
<script>
tinymce.init({
selector: 'textarea',
height: 500,
theme: 'modern',
plugins: [
'advlist autolink lists link image charmap print preview hr anchor pagebreak',
'tinymcespellchecker']
});
</script>
</body>
<html>