From f508cb1079b6bb469ed355e38795cd3aa19050ca Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 11 May 2026 11:02:56 +1000 Subject: [PATCH 1/4] DOC-3505: Add self-hosted trial with cloud services page New documentation page for self-hosted trial customers explaining setup, available cloud-powered features, network requirements, limitations, and FAQ. Adds nav entry and hub page link. --- modules/ROOT/nav.adoc | 1 + .../ROOT/pages/installation-self-hosted.adoc | 5 + modules/ROOT/pages/self-hosted-trial.adoc | 189 ++++++++++++++++++ 3 files changed, 195 insertions(+) create mode 100644 modules/ROOT/pages/self-hosted-trial.adoc diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index f9327d1f6f..b3ee18aacd 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -19,6 +19,7 @@ ***** xref:bootstrap-cloud.adoc[Bootstrap] *** xref:installation-self-hosted.adoc[Self-hosted] **** xref:npm-projects.adoc[Quick start guide] +**** xref:self-hosted-trial.adoc[Self-hosted trial] **** Supported Integrations ***** React ****** xref:react-pm-host.adoc[Using a package manager with hosting] diff --git a/modules/ROOT/pages/installation-self-hosted.adoc b/modules/ROOT/pages/installation-self-hosted.adoc index b4254b7777..a7f32ae1f6 100644 --- a/modules/ROOT/pages/installation-self-hosted.adoc +++ b/modules/ROOT/pages/installation-self-hosted.adoc @@ -13,7 +13,12 @@ xref:npm-projects.adoc[Quick start: NPM/Yarn] Install and configure {productname} using NPM or Yarn. + | +[.lead] +xref:self-hosted-trial.adoc[Self-hosted trial] + +Evaluate {productname} premium features and cloud services in a self-hosted environment using a trial license key. |=== == Integrations diff --git a/modules/ROOT/pages/self-hosted-trial.adoc b/modules/ROOT/pages/self-hosted-trial.adoc new file mode 100644 index 0000000000..7f65fc7a9e --- /dev/null +++ b/modules/ROOT/pages/self-hosted-trial.adoc @@ -0,0 +1,189 @@ += 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 + +// TODO: Update option name `cloud_services_trial` when final name is confirmed (TINY-14259). + +== Overview + +A self-hosted trial provides access to {productname} premium plugins and cloud-powered services in a self-hosted environment. This allows evaluation of the full {productname} feature set, including features that depend on cloud services, without requiring a separate cloud deployment or additional scripts. + +During the trial period, {productname} connects to {cloudname} services using the trial license key. No separate API key is required. + +[NOTE] +==== +Only new customers can start a self-hosted trial. The trial period lasts 14 days from the date of sign-up. +==== + +== 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}]. +* A trial license key, issued after sign-up. +* 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} +---- + +[NOTE] +==== +The self-hosted trial also supports installation using a ZIP package. For ZIP-based setup instructions, see xref:zip-install.adoc[Quick start: ZIP]. The remaining steps in this guide apply regardless of the installation method. +==== + +=== 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', + cloud_services_trial: true +}); +---- + +Replace the `+'your-trial-license-key'+` placeholder with the trial license key provided during sign-up. + +=== Step 3: Enable cloud services + +Set the `+cloud_services_trial+` option to `+true+` in the editor configuration. This option explicitly enables the connection to {cloudname} services for the duration of the trial. + +[IMPORTANT] +==== +Setting `+cloud_services_trial+` to `+true+` enables a network connection from the editor to {cloudname}. Features that depend on cloud services will not function without this option enabled. 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]. + +== Available features + +The self-hosted trial includes access to the following cloud-powered premium features: + +[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:autocorrect.adoc[Autocorrect] +| Automatic text corrections powered by cloud-based language services. + +| xref:tinymceai.adoc[TinyMCE AI] +| AI-powered content generation and editing. +|=== + +In addition to cloud-powered features, all self-hosted premium plugins included in the `+tinymce-premium+` package are available during the trial without requiring a cloud connection. + +== Network requirements + +When `+cloud_services_trial+` is enabled, the editor connects to {cloudname} services. Ensure the following domains allow outbound access if the network uses a forward proxy or firewall: + +* `+https://spelling.tiny.cloud+` +* `+https://hyperlinking.tiny.cloud+` +* `+https://imageproxy.tiny.cloud+` +* `+https://exportpdf.tiny.cloud+` +* `+https://exportdocx.tiny.cloud+` +* `+https://importdocx.tiny.cloud+` + +[NOTE] +==== +The exact list of required domains depends on which cloud-powered features are enabled in the editor configuration. Only domains for enabled features require network access. +==== + +== Trial limitations + +[cols="1,2", options="header"] +|=== +| Limitation | Details + +| Duration +| 14 days from sign-up. + +| 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 `+cloud_services_trial+` option set to `+true+`. +|=== + +== 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 `+cloud_services_trial+` option or set it to `+false+`. Cloud-powered features will not function without this option, but 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 `+cloud_services_trial+` 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 `+cloud_services_trial+` option value. This includes plugins such as xref:advtable.adoc[Advanced Tables], xref:introduction-to-powerpaste.adoc[PowerPaste], xref:footnotes.adoc[Footnotes], and xref:mergetags.adoc[Merge Tags], among others. + +| Can the trial be extended? +| Trial extensions are not available through self-service. Contact link:https://support.tiny.cloud[{productname} Support] for assistance. +|=== From 7406e65ac7637c8f2f87132fe1d3e217694e33d0 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 11 May 2026 13:35:33 +1000 Subject: [PATCH 2/4] DOC-3505: Address feedback from product review - Reframe overview to emphasize cloud connection is opt-in - Remove hard-coded trial duration (defer to Portal) - Remove specific plugin entitlement claims (defer to Portal) - Remove ZIP note (pending confirmation from Cloud team) - Rename section to "Cloud-powered features" for clarity - Add Portal links for trial details that may change --- modules/ROOT/pages/self-hosted-trial.adoc | 25 ++++++++++------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/modules/ROOT/pages/self-hosted-trial.adoc b/modules/ROOT/pages/self-hosted-trial.adoc index 7f65fc7a9e..366360603b 100644 --- a/modules/ROOT/pages/self-hosted-trial.adoc +++ b/modules/ROOT/pages/self-hosted-trial.adoc @@ -7,13 +7,13 @@ == Overview -A self-hosted trial provides access to {productname} premium plugins and cloud-powered services in a self-hosted environment. This allows evaluation of the full {productname} feature set, including features that depend on cloud services, without requiring a separate cloud deployment or additional scripts. +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. -During the trial period, {productname} connects to {cloudname} services using the trial license key. No separate API key is required. +Connecting to cloud services is opt-in. Setting the `+cloud_services_trial+` option to `+true+` enables the connection. Without this option, the editor operates entirely offline with no cloud dependency. No separate API key is required. [NOTE] ==== -Only new customers can start a self-hosted trial. The trial period lasts 14 days from the date of sign-up. +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 @@ -34,11 +34,6 @@ Install both the core editor and premium plugins package: npm install tinymce@^{productmajorversion} tinymce-premium@^{productmajorversion} ---- -[NOTE] -==== -The self-hosted trial also supports installation using a ZIP package. For ZIP-based setup instructions, see xref:zip-install.adoc[Quick start: ZIP]. The remaining steps in this guide apply regardless of the installation method. -==== - === Step 2: Configure the editor with the trial license key Add the trial license key to the {productname} configuration using the `+license_key+` option: @@ -82,9 +77,9 @@ 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]. -== Available features +== Cloud-powered features -The self-hosted trial includes access to the following cloud-powered premium features: +The following premium features require a connection to {cloudname} services and will only function when `+cloud_services_trial+` is set to `+true+`: [cols="1,2", options="header"] |=== @@ -118,7 +113,9 @@ The self-hosted trial includes access to the following cloud-powered premium fea | AI-powered content generation and editing. |=== -In addition to cloud-powered features, all self-hosted premium plugins included in the `+tinymce-premium+` package are available during the trial without requiring a cloud connection. +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 @@ -143,7 +140,7 @@ The exact list of required domains depends on which cloud-powered features are e | Limitation | Details | Duration -| 14 days from sign-up. +| 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. @@ -152,7 +149,7 @@ The exact list of required domains depends on which cloud-powered features are e | 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 `+cloud_services_trial+` option set to `+true+`. +| Cloud-powered features require an active internet connection and the `+cloud_services_trial+` option set to `+true+`. Without this option, no cloud connection is made. |=== == After the trial @@ -182,7 +179,7 @@ To continue using {productname} after the trial period: | No. Unlike a hybrid deployment, the self-hosted trial does not require an additional script tag. The `+cloud_services_trial+` 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 `+cloud_services_trial+` option value. This includes plugins such as xref:advtable.adoc[Advanced Tables], xref:introduction-to-powerpaste.adoc[PowerPaste], xref:footnotes.adoc[Footnotes], and xref:mergetags.adoc[Merge Tags], among others. +| All premium plugins that do not depend on an external service function during the trial regardless of the `+cloud_services_trial+` option value. Only the features listed in <> 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. From 7274368d3d8909767997e126f6195d32460065dd Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 11 May 2026 13:36:31 +1000 Subject: [PATCH 3/4] DOC-3505: Simplify network requirements to *.tiny.cloud Per engineering discussion, use wildcard domain instead of individual service URLs. Links to CSP page for detail. Avoids publishing a list that becomes stale as services change. --- modules/ROOT/pages/self-hosted-trial.adoc | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-) diff --git a/modules/ROOT/pages/self-hosted-trial.adoc b/modules/ROOT/pages/self-hosted-trial.adoc index 366360603b..7d0cb802dd 100644 --- a/modules/ROOT/pages/self-hosted-trial.adoc +++ b/modules/ROOT/pages/self-hosted-trial.adoc @@ -119,19 +119,9 @@ For the full list of features included in a trial, see the link:https://www.tiny == Network requirements -When `+cloud_services_trial+` is enabled, the editor connects to {cloudname} services. Ensure the following domains allow outbound access if the network uses a forward proxy or firewall: +When `+cloud_services_trial+` is enabled, the editor connects to {cloudname} services. Ensure that `+*.tiny.cloud+` is allowed for outbound access if the network uses a forward proxy or firewall. -* `+https://spelling.tiny.cloud+` -* `+https://hyperlinking.tiny.cloud+` -* `+https://imageproxy.tiny.cloud+` -* `+https://exportpdf.tiny.cloud+` -* `+https://exportdocx.tiny.cloud+` -* `+https://importdocx.tiny.cloud+` - -[NOTE] -==== -The exact list of required domains depends on which cloud-powered features are enabled in the editor configuration. Only domains for enabled features require network access. -==== +For detailed Content Security Policy (CSP) configuration, see xref:tinymce-and-csp.adoc[{productname} and Content Security Policy]. == Trial limitations From e4726894304b112aba1b038fd1202d72f561b8ed Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 18 May 2026 16:46:56 +1000 Subject: [PATCH 4/4] DOC-3505: Add 8.6.0 release notes and version infrastructure --- modules/ROOT/nav.adoc | 3 ++ modules/ROOT/pages/8.6.0-release-notes.adoc | 32 +++++++++++++++++++ modules/ROOT/pages/changelog.adoc | 6 ++++ modules/ROOT/pages/release-notes.adoc | 8 ++++- .../partials/misc/supported-versions.adoc | 1 + 5 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 modules/ROOT/pages/8.6.0-release-notes.adoc diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index b3ee18aacd..dea71d4a87 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -410,6 +410,9 @@ * Release information ** xref:release-notes.adoc[Release notes for {productname}] // Remove un-used-for-this-particular-release entries. +*** {productname} 8.6.0 +**** xref:8.6.0-release-notes.adoc#overview[Overview] +**** xref:8.6.0-release-notes.adoc#additions[Additions] *** {productname} 8.5.0 **** xref:8.5.0-release-notes.adoc#overview[Overview] **** xref:8.5.0-release-notes.adoc#accompanying-premium-plugin-changes[Accompanying Premium Plugin changes] diff --git a/modules/ROOT/pages/8.6.0-release-notes.adoc b/modules/ROOT/pages/8.6.0-release-notes.adoc new file mode 100644 index 0000000000..636c8b8241 --- /dev/null +++ b/modules/ROOT/pages/8.6.0-release-notes.adoc @@ -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 `+cloud_services_trial+` 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, Autocorrect, and TinyMCE AI become available during the trial period without requiring a separate API key or cloud deployment. + +Without the `+cloud_services_trial+` option, the editor operates entirely self-hosted with no external network connection. All premium plugins that do not depend on cloud services continue to function regardless. + +For setup instructions, see xref:self-hosted-trial.adoc[Self-hosted trial with cloud services]. diff --git a/modules/ROOT/pages/changelog.adoc b/modules/ROOT/pages/changelog.adoc index 772f97308e..39897b9792 100644 --- a/modules/ROOT/pages/changelog.adoc +++ b/modules/ROOT/pages/changelog.adoc @@ -4,6 +4,12 @@ NOTE: This is the {productname} Community version changelog. For information about the latest {cloudname} or {enterpriseversion} Release, see: xref:release-notes.adoc[{productname} Release Notes]. +== xref:8.6.0-release-notes.adoc[8.6.0 - 2026-05-27] + +### Added +* Self-hosted trials with optional access to cloud-powered premium features via the `cloud_services_trial` option. +// #DOC-3505 + == xref:8.5.0-release-notes.adoc[8.5.0 - 2026-04-29] ### Added diff --git a/modules/ROOT/pages/release-notes.adoc b/modules/ROOT/pages/release-notes.adoc index 14c8a3677c..dea36243aa 100644 --- a/modules/ROOT/pages/release-notes.adoc +++ b/modules/ROOT/pages/release-notes.adoc @@ -8,6 +8,12 @@ This section lists the releases for {productname} {productmajorversion} and the [cols="1,1"] |=== +a| +[.lead] +xref:8.6.0-release-notes.adoc#overview[{productname} 8.6.0] + +Release notes for {productname} 8.6.0 + a| [.lead] xref:8.5.0-release-notes.adoc#overview[{productname} 8.5.0] @@ -92,5 +98,5 @@ xref:8.0-release-notes.adoc#overview[{productname} 8.0.0] Release notes for {productname} 8.0.0 // Uncomment the dummy cell when the number of cells in the table is odd to ensure the table renders correctly. -// a| +a| |=== diff --git a/modules/ROOT/partials/misc/supported-versions.adoc b/modules/ROOT/partials/misc/supported-versions.adoc index 761c179ef3..3c5392e054 100644 --- a/modules/ROOT/partials/misc/supported-versions.adoc +++ b/modules/ROOT/partials/misc/supported-versions.adoc @@ -6,6 +6,7 @@ Supported versions of {productname}: [cols="^,^,^",options="header"] |=== |Version |Release Date |End of Premium Support +|8.6 |2026-05-27 |2027-11-27 |8.5 |2026-04-29 |2027-10-29 |8.4 |2026-03-31 |2027-09-30 |8.3 |2025-12-10 |2027-06-10