Browse Source

Merge branch 'feature/TCLOUD-2861' into feature/TCLOUD-2861-2

pull/1056/head
Dylan Just 6 years ago
parent
commit
c8dbf3185f
  1. 16
      cloud-deployment-guide/editor-and-features.md
  2. 56
      cloud-deployment-guide/editor-plugin-version.md
  3. 6
      cloud-deployment-guide/features-only.md
  4. 5
      cloud-deployment-guide/plugin-editor-version-compatibility.md
  5. BIN
      images/scripttag.png
  6. 4
      migration-from-4x.md
  7. 4
      quick-start.md

16
cloud-deployment-guide/editor-and-features.md

@ -18,12 +18,22 @@ All Tiny Cloud accounts include a free, pre-configured cloud image proxy service
Insert the TinyMCE editor code into the application to load TinyMCE for the first time. The code inserting is done by adding the following script tag into your app, or in the case of a web page the `<head>` of the page:
The following example adds a script tag into the application that inserts the code. Use the `<head>` of the page on a web page.
The following example adds a script tag into the application that inserts the code. Use the `<head>` of the page on a web page. Be sure to substitute 'no-api-key' with your api key.
```js
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
||Value|Description|
|---|---|---|
|1|no-api-key|Replace with your api key|
|2|origin=|A `referrerpolicy` specifies how much of the current page's URL is sent in the `Referer` header when the browser fetches page resources (for example, the TinyMCE editor). The use of the `Referer` header ensures API keys are only used on domains registered to their owners. We only care about the domain portion however (similar to the operation of `Origin` header), so for improved performance and privacy always set the `referrerpolicy` to `origin` when requesting Tiny resources.|
![Script Tag Description]({{ site.baseurl }}/images/scripttag.png)
### Step 2: Load, customize and interact with TinyMCE
There are more than 40 open source plugins that enhance the editing experience in addition to the advanced content create solutions on Tiny Cloud. A range of [simple examples]({{ site.baseurl }}/demo/basic-example/) are available. Refer to the [Quick start]({{ site.baseurl }}/quick-start) section for more information.
@ -80,7 +90,7 @@ Migrating from a self-hosted environment to Tiny Cloud is easy. Remove the exist
Replace the script tag with the following:
```js
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
### Step 2: Update custom plugin paths

56
cloud-deployment-guide/editor-plugin-version.md

@ -13,7 +13,7 @@ Use the URL provided to specify the TinyMCE version when deploying via Tiny Clou
The following example is the default for loading TinyMCE 5.0 via Tiny Cloud:
```js
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
This URL specifies the latest and quality assured release of TinyMCE.
@ -35,7 +35,7 @@ This channel deploys the absolute latest version of TinyMCE as documented in [Ti
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-dev/tinymce.min.js"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-dev/tinymce.min.js" referrerpolicy="origin"></script>
```
#### testing release channel
@ -45,7 +45,7 @@ This channel deploys the current release candidate for the `stable` channel. The
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-testing/tinymce.min.js"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-testing/tinymce.min.js" referrerpolicy="origin"></script>
```
#### stable release channel
@ -55,7 +55,7 @@ This channel deploys the latest release of TinyMCE that has passed our quality a
##### Example
```js
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
## Specifying the version of features/plugins deployed from Tiny Cloud
@ -70,7 +70,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mentions=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mentions=2.0.0" referrerpolicy="origin"></script>
```
#### Tiny Drive
@ -81,7 +81,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinydrive=1.1.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinydrive=1.1.0" referrerpolicy="origin"></script>
```
#### Comments 2.0
@ -92,7 +92,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinycomments=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinycomments=2.0.0" referrerpolicy="origin"></script>
```
#### Page Embed
@ -103,7 +103,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&pageembed=1.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&pageembed=1.0.0" referrerpolicy="origin"></script>
```
#### Permanent Pen
@ -114,7 +114,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&permanentpen=1.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&permanentpen=1.0.0" referrerpolicy="origin"></script>
```
#### Format Painter
@ -125,7 +125,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&formatpainter=1.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&formatpainter=1.0.0" referrerpolicy="origin"></script>
```
#### PowerPaste
@ -136,7 +136,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&powerpaste=4.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&powerpaste=4.0.0" referrerpolicy="origin"></script>
```
#### Spell Checker Pro
@ -147,7 +147,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinymcespellchecker=1.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinymcespellchecker=1.0.0" referrerpolicy="origin"></script>
```
#### Accessibility Checker
@ -158,7 +158,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&a11ychecker=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&a11ychecker=2.0.0" referrerpolicy="origin"></script>
```
#### Advanced Code Editor
@ -169,7 +169,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&advcode=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&advcode=2.0.0" referrerpolicy="origin"></script>
```
#### Enhanced Media Embed
@ -180,7 +180,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mediaembed=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mediaembed=2.0.0" referrerpolicy="origin"></script>
```
#### Link Checker
@ -191,7 +191,7 @@ Use the URL query parameters to specify the version of each premium plugin. This
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&linkchecker=2.0.0"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&linkchecker=2.0.0" referrerpolicy="origin"></script>
```
## Specifying a self-hosted deployment of features/plugins
@ -209,7 +209,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mentions=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mentions=sdk" referrerpolicy="origin"></script>
```
#### Tiny Drive
@ -219,7 +219,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinydrive=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinydrive=sdk" referrerpolicy="origin"></script>
```
#### Comments 2.0
@ -229,7 +229,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinycomments=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinycomments=sdk" referrerpolicy="origin"></script>
```
#### Page Embed
@ -239,7 +239,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&pageembed=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&pageembed=sdk" referrerpolicy="origin"></script>
```
#### Permanent Pen
@ -249,7 +249,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&permanentpen=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&permanentpen=sdk" referrerpolicy="origin"></script>
```
#### Format Painter
@ -259,7 +259,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&formatpainter=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&formatpainter=sdk" referrerpolicy="origin"></script>
```
#### PowerPaste
@ -269,7 +269,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&powerpaste=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&powerpaste=sdk" referrerpolicy="origin"></script>
```
#### Spell Checker Pro
@ -279,7 +279,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinymcespellchecker=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&tinymcespellchecker=sdk" referrerpolicy="origin"></script>
```
#### Accessibility Checker
@ -289,7 +289,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&a11ychecker=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&a11ychecker=sdk" referrerpolicy="origin"></script>
```
#### Advanced Code Editor
@ -299,7 +299,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&advcode=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&advcode=sdk" referrerpolicy="origin"></script>
```
#### Enhanced Media Embed
@ -309,7 +309,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mediaembed=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&mediaembed=sdk" referrerpolicy="origin"></script>
```
#### Link Checker
@ -319,7 +319,7 @@ The "SDK" version lets the TinyMCE Plugin Manager know that you're not using Tin
##### Example
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&linkchecker=sdk"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?&linkchecker=sdk" referrerpolicy="origin"></script>
```

6
cloud-deployment-guide/features-only.md

@ -12,10 +12,10 @@ Sign up for a free API key provides entitlements to premium [Image Tools]({{ si
## Step 1: Insert the custom script tag into the webpage
Add the following script in the webpage once the script tag to load TinyMCE has been specified:
Add the following script in the webpage once the script tag to load TinyMCE has been specified. Be sure to substitute 'no-api-key' with your api key.
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js" referrerpolicy="origin"></script>
```
## Step 2: Specify purchased TinyMCE plugins and toolbar buttons
@ -56,7 +56,7 @@ The example below has the following:
<html>
<head>
<script src="https://your_server/tinymce.min.js"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js" referrerpolicy="origin"></script>
</head>
<body>
<textarea><p>test textarea</p></textarea>

5
cloud-deployment-guide/plugin-editor-version-compatibility.md

@ -11,6 +11,11 @@ Specific versions of TinyMCE are compatible with premium plugins.
Use the following matrix in conjunction with the optional parameters for specifying editor version and [plugin version]({{ site.baseurl }}/cloud-deployment-guide/editor-plugin-version) to ensure compatibility.
> Important: Ensure the plugins are supported in your editor version when deploying premium plugins only[^footnote] via [Tiny Cloud]({{ site.baseurl }}/cloud-deployment-guide/features-only).
> Also ensure you are using the latest script tag and substitute 'no-api-key' with your api key.
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js" referrerpolicy="origin></script>
```
| **Plugins** | **TinyMCE 4.x** | **TinyMCE 5.x** |
| :-----: | :---------: | :---------: |

BIN
images/scripttag.png

After

Width: 928  |  Height: 92  |  Size: 16 KiB

4
migration-from-4x.md

@ -18,13 +18,13 @@ This chapter describes the migration process and workarounds for customers using
To serve TinyMCE 5 from the cloud, include this in your html page:
```js
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
To serve the latest nightlies and testing builds refer to the [cloud deployment guide](/cloud-deployment-guide/editor-and-features/)
```js
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-dev/tinymce.min.js"></script>
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-dev/tinymce.min.js" referrerpolicy="origin"></script>
```
### Initialization

4
quick-start.md

@ -16,7 +16,7 @@ TinyMCE 5.0 is perfect for developers who want to see how the new version of Tin
Include this line of code in the `<head>` of the HTML page and link to the tinymce.min.js source file:
```html
<script src="{{ site.cdnurl }}"></script>
<script src="{{ site.cdnurl }}" referrerpolicy="origin"></script>
```
> Tip: A complete HTML snippet is provided in Step 2.
@ -34,7 +34,7 @@ In this example, replace `<textarea id='mytextarea'>` with a TinyMCE 5.0 editor
<!DOCTYPE html>
<html>
<head>
<script src='{{ site.cdnurl }}'></script>
<script src='{{ site.cdnurl }}' referrerpolicy="origin></script>
<script>
tinymce.init({
selector: '#mytextarea'

Loading…
Cancel
Save