-
Notifications
You must be signed in to change notification settings - Fork 220
DOC-3505: TinyMCE 8.6.0 Documentation #4134
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 5 commits
Commits
Show all changes
17 commits
Select commit
Hold shift + click to select a range
f508cb1
DOC-3505: Add self-hosted trial with cloud services page
kemister85 7406e65
DOC-3505: Address feedback from product review
kemister85 7274368
DOC-3505: Simplify network requirements to *.tiny.cloud
kemister85 e472689
DOC-3505: Add 8.6.0 release notes and version infrastructure
kemister85 99868d4
DOC-3505: Update self-hosted trial docs with confirmed option name an…
kemister85 dac2250
DOC-3505: Remove Tiny Drive from cloud features, add HTTPS prerequisite
kemister85 15665f0
DOC-3505: Update license-key page to document ONLINE+ trial keys and …
ltrouton f236133
DOC-3505: Document 8.6.0 DOMPurify update and AI quick actions fix
kemister85 81ccbae
Merge remote-tracking branch 'origin/tinymce/8' into hotfix/8/DOC-3505
kemister85 3f7b696
Update modules/ROOT/pages/self-hosted-trial.adoc
kemister85 4842a52
Update modules/ROOT/pages/self-hosted-trial.adoc
kemister85 f693b64
DOC-3505: Add AI token provider to trial snippet, merge cloud service…
kemister85 cb5524c
DOC-3505: Clarify trial license key and Cloud API key in self-hosted …
kemister85 1b72d55
Update modules/ROOT/pages/self-hosted-trial.adoc
kemister85 5f7b592
Update modules/ROOT/pages/self-hosted-trial.adoc
kemister85 91c9e8c
DOC-3505: Update changelog.adoc file.
kemister85 157755f
DOC-3505: Bump API version to 8.6.0 and correct 8.6 support end date
kemister85 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Some comments aren't visible on the classic Files Changed page.
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| = {productname} {release-version} | ||
| :release-version: 8.6.0 | ||
| :navtitle: {productname} {release-version} | ||
| :description: Release notes for {productname} {release-version} | ||
| :keywords: releasenotes, new, changes, bugfixes | ||
| :page-toclevels: 1 | ||
|
|
||
| include::partial$misc/admon-releasenotes-for-stable.adoc[] | ||
|
|
||
|
|
||
| [[overview]] | ||
| == Overview | ||
|
|
||
| {productname} {release-version} was released for {enterpriseversion} and {cloudname} on Wednesday, May 27^th^, 2026. These release notes provide an overview of the changes for {productname} {release-version}, including: | ||
|
|
||
| * xref:additions[Additions] | ||
|
|
||
|
|
||
| [[additions]] | ||
| == Additions | ||
|
|
||
| {productname} {release-version} includes the following addition: | ||
|
|
||
| === Self-hosted trial with cloud services | ||
|
|
||
| {productname} {release-version} introduces self-hosted trials with optional access to cloud-powered premium features. Integrators can install {productname} and premium plugins via NPM, configure a trial license key, and optionally enable a connection to {cloudname} services by setting `+online_license_services_opt_in+` to `+true+`. | ||
|
|
||
| When enabled, cloud-powered features such as Spell Checker Pro, Link Checker, Enhanced Media Embed, Export to PDF, Export to Word, Import from Word, Image Editing, TinyMCE AI, and Tiny Drive become available during the trial period without requiring a separate API key or cloud deployment. | ||
|
|
||
| Without the `+online_license_services_opt_in+` option, the trial license key still validates and the editor is fully operational. All premium plugins that do not depend on cloud services continue to function. Cloud-dependent plugins are not auto-configured but can be configured manually. | ||
|
|
||
| For setup instructions, see xref:self-hosted-trial.adoc[Self-hosted trial with cloud services]. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,176 @@ | ||
| = Self-hosted trial with cloud services | ||
| :navtitle: Self-hosted trial | ||
| :description: Set up a self-hosted {productname} trial with access to cloud-powered premium features using NPM. | ||
| :keywords: trial, self-hosted, npm, cloud services, premium plugins, license key, tinymce-premium | ||
|
|
||
| == Overview | ||
|
|
||
| A self-hosted trial provides access to {productname} premium plugins in a self-hosted environment. Integrators can optionally connect to {cloudname} services during the trial to evaluate cloud-powered features such as Spell Checker Pro, Export to PDF, and TinyMCE AI, without requiring a separate cloud deployment or additional scripts. | ||
|
|
||
| Connecting to cloud services is opt-in. Setting the `+online_license_services_opt_in+` option to `+true+` enables the connection. Without this option, the editor is licensed and operational but cloud-dependent premium plugins are not auto-configured. No separate API key is required. | ||
|
|
||
| [NOTE] | ||
| ==== | ||
| Only new customers can start a self-hosted trial. For trial duration and entitlement details, see the link:https://www.tiny.cloud/my-account[Tiny Cloud Account] portal. | ||
| ==== | ||
|
|
||
| == Prerequisites | ||
|
|
||
| * A {productname} trial account with "self-hosted" selected as the deployment option. Sign up at link:https://www.tiny.cloud/get-tiny/[Get {productname}]. | ||
|
kemister85 marked this conversation as resolved.
Outdated
|
||
| * A trial license key, issued after sign-up. | ||
|
kemister85 marked this conversation as resolved.
Outdated
|
||
| * https://nodejs.org/[Node.js (and npm)] installed. | ||
| * A project directory with a `+package.json+` file. Initialize one by running `+npm init+` if needed. | ||
|
|
||
| == Setup | ||
|
|
||
| === Step 1: Install {productname} and premium plugins | ||
|
|
||
| Install both the core editor and premium plugins package: | ||
|
|
||
| [source,sh,subs="attributes+"] | ||
| ---- | ||
| npm install tinymce@^{productmajorversion} tinymce-premium@^{productmajorversion} | ||
| ---- | ||
|
|
||
| === Step 2: Configure the editor with the trial license key | ||
|
|
||
| Add the trial license key to the {productname} configuration using the `+license_key+` option: | ||
|
|
||
| [source,js] | ||
| ---- | ||
| tinymce.init({ | ||
| selector: 'textarea', // change this value according to the HTML | ||
| license_key: 'your-trial-license-key', | ||
| plugins: [ | ||
| 'advlist', 'autolink', 'lists', 'link', 'image', 'charmap', 'preview', | ||
| 'anchor', 'searchreplace', 'visualblocks', 'code', 'fullscreen', | ||
| 'insertdatetime', 'media', 'table', 'help', 'wordcount', | ||
| 'tinymcespellchecker', 'exportpdf', 'exportword', 'importword', | ||
| 'linkchecker', 'mediaembed', 'editimage', 'autocorrect', 'tinymceai' | ||
| ], | ||
| toolbar: 'undo redo | blocks | bold italic | alignleft aligncenter alignright | bullist numlist outdent indent | help', | ||
| online_license_services_opt_in: true | ||
| }); | ||
|
kemister85 marked this conversation as resolved.
|
||
| ---- | ||
|
|
||
| Replace the `+'your-trial-license-key'+` placeholder with the trial license key provided during sign-up. | ||
|
|
||
| === Step 3: Enable cloud services | ||
|
kemister85 marked this conversation as resolved.
Outdated
|
||
|
|
||
| Set the `+online_license_services_opt_in+` option to `+true+` in the editor configuration. This option enables automatic configuration of cloud service URLs for all cloud-dependent premium plugins during the trial. | ||
|
|
||
| Without this option, the trial license key still validates and the editor is fully functional, but cloud-dependent plugins (such as Spell Checker Pro, Link Checker, and Export to PDF) are not auto-configured and will report that their service URL is not set. | ||
|
|
||
| [IMPORTANT] | ||
| ==== | ||
| Setting `+online_license_services_opt_in+` to `+true+` enables a network connection from the editor to {cloudname}. Remove or set this option to `+false+` to disable the cloud connection at any time. | ||
| ==== | ||
|
|
||
| === Step 4: Ensure the license key manager is available | ||
|
|
||
| The `+tinymce-premium+` NPM package includes the license key manager. If bundling {productname}, ensure the license key manager is imported: | ||
|
|
||
| [source,javascript] | ||
| ---- | ||
| import 'tinymce-premium/plugins/licensekeymanager'; | ||
| ---- | ||
|
|
||
| For hosting setups, ensure the `+licensekeymanager+` folder is present in the `+plugins+` directory alongside all other plugins. For more details, see xref:license-key.adoc#_setting_up_the_commercial_license_key_manager[Setting up the Commercial License Key Manager]. | ||
|
|
||
| == Cloud-powered features | ||
|
|
||
| The following premium features require a connection to {cloudname} services and will only function when `+online_license_services_opt_in+` is set to `+true+`: | ||
|
|
||
| [cols="1,2", options="header"] | ||
| |=== | ||
| | Feature | Description | ||
|
|
||
| | xref:introduction-to-tiny-spellchecker.adoc[Spell Checker Pro] | ||
| | Real-time spellchecking powered by cloud-based language services. | ||
|
|
||
| | xref:linkchecker.adoc[Link Checker] | ||
| | Validates hyperlinks within content using a cloud-based link validation service. | ||
|
|
||
| | xref:introduction-to-mediaembed.adoc[Enhanced Media Embed] | ||
| | Rich media previews for URLs using a cloud-based media resolution service. | ||
|
|
||
| | xref:exportpdf.adoc[Export to PDF] | ||
| | Converts editor content to PDF format using a cloud-based conversion service. | ||
|
|
||
| | xref:exportword.adoc[Export to Word] | ||
| | Converts editor content to DOCX format using a cloud-based conversion service. | ||
|
|
||
| | xref:importword.adoc[Import from Word] | ||
| | Imports DOCX content into the editor using a cloud-based conversion service. | ||
|
|
||
| | xref:editimage.adoc[Image Editing] | ||
| | Advanced image editing with cloud-based image proxy support. | ||
|
|
||
| | xref:tinymceai.adoc[TinyMCE AI] | ||
| | AI-powered content generation and editing. | ||
|
|
||
| | xref:tinydrive-introduction.adoc[Tiny Drive] | ||
| | Cloud-based file management and storage service. | ||
| |=== | ||
|
|
||
| All other premium plugins included in the `+tinymce-premium+` package function during the trial without a cloud connection. | ||
|
|
||
| For the full list of features included in a trial, see the link:https://www.tiny.cloud/my-account[Tiny Cloud Account] portal. | ||
|
|
||
| == Network requirements | ||
|
|
||
| When `+online_license_services_opt_in+` is enabled, the editor connects to {cloudname} services at `+*.api.tiny.cloud+`. Ensure that this domain pattern is allowed for outbound HTTPS access if the network uses a forward proxy or firewall. | ||
|
|
||
| For detailed Content Security Policy (CSP) configuration, see xref:tinymce-and-csp.adoc[{productname} and Content Security Policy]. | ||
|
|
||
| == Trial limitations | ||
|
|
||
| [cols="1,2", options="header"] | ||
| |=== | ||
| | Limitation | Details | ||
|
|
||
| | Duration | ||
| | The trial period begins at sign-up. For the current trial duration, see the link:https://www.tiny.cloud/my-account[Tiny Cloud Account] portal. | ||
|
|
||
| | Eligibility | ||
| | New customers only. Existing customers with an active subscription are not eligible for a self-hosted trial. | ||
|
|
||
| | After expiry | ||
| | The editor ceases to function when the trial license key expires. Purchase a commercial license to continue using {productname}. | ||
|
|
||
| | Cloud services | ||
| | Cloud-powered features require an active internet connection and the `+online_license_services_opt_in+` option set to `+true+`. Without this option, cloud-dependent plugins are not auto-configured. | ||
| |=== | ||
|
|
||
| == After the trial | ||
|
|
||
| To continue using {productname} after the trial period: | ||
|
|
||
| * *Purchase a commercial license:* Visit link:https://www.tiny.cloud/pricing[{productname} Pricing] to select a plan. A commercial license key is provided for ongoing self-hosted use. | ||
| * *Self-hosted premium services:* For production use of features such as Spell Checker, Export to PDF, and Import from Word, self-host the required server-side services or use a {cloudname} plan. See xref:bundle-intro-setup.adoc[Premium server-side services] for self-hosting options. | ||
| * *Cloud deployment:* Alternatively, switch to a fully cloud-hosted deployment. See xref:editor-and-features.adoc[Cloud deployment] for setup instructions. | ||
|
|
||
| == FAQ | ||
|
|
||
| [cols="1,2", options="header"] | ||
| |=== | ||
| | Question | Answer | ||
|
|
||
| | Does the trial require an API key? | ||
| | No. The trial license key is the only key required. There is no need to configure a separate API key for cloud services during the trial. | ||
|
|
||
| | Can the cloud connection be disabled? | ||
| | Yes. Remove the `+online_license_services_opt_in+` option or set it to `+false+`. Cloud-powered features will not be auto-configured, but the editor and all self-hosted plugins will continue to operate. | ||
|
|
||
| | What happens when the trial expires? | ||
| | {productname} disables the editor and displays a notification indicating that the license key has expired. Purchase a commercial license to continue use. | ||
|
|
||
| | Is a separate script tag required for cloud services? | ||
| | No. Unlike a hybrid deployment, the self-hosted trial does not require an additional script tag. The `+online_license_services_opt_in+` option and the trial license key handle all cloud service connectivity. | ||
|
|
||
| | Which plugins work without cloud services? | ||
| | All premium plugins that do not depend on an external service function during the trial regardless of the `+online_license_services_opt_in+` option value. Only the features listed in <<Cloud-powered features>> require the cloud connection to be enabled. | ||
|
|
||
| | Can the trial be extended? | ||
| | Trial extensions are not available through self-service. Contact link:https://support.tiny.cloud[{productname} Support] for assistance. | ||
| |=== | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.