DOC-3226: Update licensing information and examples for TinyMCE 8

modules/ROOT/pages/8.0-release-notes.adoc

@@ -1,4 +1,3 @@
-
 = {productname} {release-version}
 :release-version: 8.0.0
 :navtitle: {productname} {release-version}
@@ -27,8 +26,10 @@ include::partial$misc/admon-releasenotes-for-stable.adoc[]
 * xref:deprecated[Deprecated]
 * xref:known-issues[Known issues]
 
-[NOTE]
-For additional details on {productname} {release-version} breaking changes when considering upgrading, see xref:migration-from-7x.adoc[Migrating from {productname} 7 to {productname} {release-version}].
+[IMPORTANT]
+====
+This release includes breaking changes to the license key system. All commercial self-hosted deployments must update their license keys to use the new `T8LK:` prefix format. For details on this and other breaking changes when considering upgrading, see xref:migration-from-7x.adoc[Migrating from {productname} 7 to {productname} {release-version}].
+====
 
 [[new-premium-plugin<s>]]
 New Premium plugin<s>
@@ -119,7 +120,48 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a
 [[changes]]
 == Changes
 
-{productname} {release-version} also includes the following change<s>:
+{productname} {release-version} includes the following changes:
+
+=== Enhanced license key system with T8LK prefix
+
+The license key system in {productname} 8 has been enhanced to provide improved subscription access control and streamlined renewal processes. This change primarily affects self-hosted deployments, as cloud users ({cloudname}) do not require a license key.
+
+[IMPORTANT]
+====
+* If you use {cloudname}, no license key is required - your cloud subscription automatically includes the commercial license.
+* For self-hosted deployments, all commercial license keys must use the new `T8LK:` prefix format.
+* Existing TinyMCE 7 license keys cannot be made compatible with TinyMCE 8 by adding the T8LK prefix.
+====
+
+Key changes for self-hosted deployments:
+
+* New `T8LK:` prefix requirement for all commercial license keys.
+* No server communication or "phone home" checks required
+* Support for both date-based and version-locked keys
+* Streamlined hybrid deployment configuration
+* Improved support for air-gapped and offline environments
+
+[IMPORTANT]
+====
+*Cloud Deployments:*
+
+* When using {cloudname}, only an API key is required - no license key needed
+* Your cloud subscription automatically includes the commercial license
+
+*Self-hosted Deployments:*
+
+* Commercial use: Contact your account manager or visit link:https://www.tiny.cloud/my-account[Tiny Cloud Account] to obtain a T8LK-prefixed license key
+* GPL use: Set `license_key: 'gpl'` (case insensitive)
+* Open source projects using premium features: Use the combined format `license_key: 'GPL+T8LK:...'`
+====
+
+=== Upgrading from TinyMCE 7
+
+* *Cloud Users ({cloudname})*: No license key changes needed - simply update your {productname} version.
+* *Self-hosted Users*: Contact your account manager to obtain a new T8LK-prefixed license key.
+
+For more information on the new license key system, see: xref:license-key.adoc[License Key].
+
 
 // === <TINY-vwxyz 1 changelog entry>
 // #TINY-vwxyz1
@@ -182,4 +224,4 @@ There <is one | are <number> known issue<s> in {productname} {release-version}.
 // #TINY-vwxyz1
 
 // CCFR here.
-// **Status**: This issue is currently being investigated.
+// **Status**: This issue is currently being investigated.

modules/ROOT/pages/vite-es6-npm.adoc

@@ -15,8 +15,18 @@ This guide requires the following:
 
 * Node.js and npm.
 * Basic knowledge of how to use https://vitejs.dev[Vite].
+* For self-hosted deployments: A valid license key starting with `T8LK:` from your link:{accountpageurl}/[{accountpage}]
 * (Optional: For premium features) The latest premium .zip bundle of TinyMCE that includes premium plugins.
 
+[IMPORTANT]
+====
+When self-hosting TinyMCE 8:
+
+* A license key is required for commercial deployments
+* Keys must start with the `T8LK:` prefix
+* For hybrid deployments that need both cloud features and local fallback, you can use both `license_key` and `api_key`
+====
+
 == Procedures
 
 :is_zip_install: vite
@@ -72,4 +82,6 @@ npx vite preview
 ----
 :!is_zip_install:
 
+
+
 include::partial$module-loading/bundling-next-steps.adoc[]

modules/ROOT/partials/install/basic-quickstart-base.adoc

@@ -182,7 +182,7 @@ ifeval::["{productSource}" != "cloud"]
     <script>
       tinymce.init({
         selector: '#mytextarea',
-        license_key: 'gpl|<your-license-key>'
+        license_key: 'gpl' // gpl for open source, T8LK:... for commercial
       });
     </script>
   </head>

modules/ROOT/partials/integrations/angular-tech-ref.adoc

@@ -130,21 +130,18 @@ include::partial$misc/get-an-api-key.adoc[]
 [[licensekey]]
 === `+licenseKey+`
 
-{cloudname} License key.
+include::partial$integrations/common/license-key-property.adoc[]
 
-Use this when self-hosting {productname} instead of loading from {cloudname}. For more information, see: xref:license-key.adoc[License Key].
-
-*Type:* `+String+`
-
-*Default value:* `+undefined+`
-
-*Possible values:* `undefined`, `'gpl'` or a valid {productname} license key
-
-==== Example: using `+licenseKey+`
+==== Example: Commercial license
+[source,html]
+----
+<editor licenseKey="T8LK:..." />
+----
 
-[source,jsx]
+==== Example: using `+licenseKey+` with GPL
+[source,html]
 ----
-<editor licenseKey='your-license-key' />
+<editor licenseKey="gpl" />
 ----
 
 [[cloudchannel]]

modules/ROOT/partials/integrations/blazor-postinstall.adoc

@@ -1,4 +1,4 @@
-. Verify the installation by checking the `+ItemGroup+` references in the project file. For example, if the project is named _BlazorApp_, the relevant file would be `+BlazorApp.csproj+` with the dependency referenced as follows: 
+. Verify the installation by checking the `+ItemGroup+` references in the project file. For example, if the project is named _BlazorApp_, the relevant file would be `+BlazorApp.csproj+` with the dependency referenced as follows:
 +
 [source,xml]
 ----
@@ -16,9 +16,9 @@
 +
 [NOTE]
 ====
-The location of the script depends on the type of Blazor app, including Blazor Server and Blazor WebAssembly (WASM) which are not covered in this guide. 
+The location of the script depends on the type of Blazor app, including Blazor Server and Blazor WebAssembly (WASM) which are not covered in this guide.
 
-* If using Blazor Server, add the script in `+Pages/_Host.cshtml+`, for example: 
+* If using Blazor Server, add the script in `+Pages/_Host.cshtml+`, for example:
 +
 [source,html]
 ----
@@ -35,16 +35,16 @@ The location of the script depends on the type of Blazor app, including Blazor S
 ====
 +
 
-. Add the `+Editor+` component to a page by either:  
-* Using the `+using+` directive:  
+. Add the `+Editor+` component to a page by either:
+* Using the `+using+` directive:
 +
 [source,cs]
 ----
 @using TinyMCE.Blazor
 <Editor />
 ----
 +
-For example: 
+For example:
 +
 _File:_ `+Pages/Index.razor+`
 +
@@ -58,7 +58,7 @@ _File:_ `+Pages/Index.razor+`
 <h2>Welcome to your new app.</h2>
 <Editor />
 ----
-* Using the component with its namespace: 
+* Using the component with its namespace:
 +
 [source,cs]
 ----
@@ -78,10 +78,10 @@ _File:_ `+Pages/Index.razor+`
 <h1>Hello, world!</h1>
 <h2>Welcome to your new app.</h2>
 <Editor />
----- 
+----
 +
 [IMPORTANT]
-In a Blazor Web App, different render modes determine how components are rendered and how interactivity is handled. To enable JavaScript interactivity, ensure that `+@rendermode InteractiveServer+` is specified in a page component. 
+In a Blazor Web App, different render modes determine how components are rendered and how interactivity is handled. To enable JavaScript interactivity, ensure that `+@rendermode InteractiveServer+` is specified in a page component.
 +
 
 ifeval::["{productSource}" == "cloud"]
@@ -91,7 +91,7 @@ ifeval::["{productSource}" == "cloud"]
 [source,cs]
 ----
 <Editor ApiKey="no-api-key" />
----- 
+----
 +
 endif::[]
 
@@ -101,8 +101,9 @@ ifeval::["{productSource}" != "cloud"]
 +
 [source,cs]
 ----
-<Editor LicenseKey="your-license-key" />
----- 
+// gpl for open source, T8LK:... for commercial
+<Editor LicenseKey="gpl" />
+----
 +
 
 . To load {productname} from the self-hosted package instead of the {cloudname}, configure the `+ScriptSrc+` property:

modules/ROOT/partials/integrations/blazor-tech-ref.adoc

@@ -19,7 +19,7 @@ The `+TinyMCE.Blazor+` `+Editor+` component accepts the following properties:
   JsConfSrc="path_to_jsObj"
   Conf="@yourConf"
   ApiKey="no-api-key"
-  LicenseKey="your-license-key"
+  LicenseKey="gpl" // gpl for open source, T8LK:... for commercial
   ScriptSrc="/path/to/tinymce.min.js"
   ClassName="tinymce-wrapper"
 />
@@ -188,19 +188,29 @@ In your component:
 
 === `LicenseKey`
 
-Specifies the {productname} license key. Required for self-hosted deployments of {productname}. This property is not required for deployments using the {cloudname}. For more information on licensing, see: xref:license-key.adoc[License key].
 
-*Type:* `+String+`
+include::partial$integrations/common/license-key-property.adoc[]
+
+==== Example: Commercial license (TinyMCE 8+)
+[source,cs]
+----
+<Editor
+  LicenseKey="T8LK:..."
+/>
+----
 
-==== Example using LicenseKey
+Use this example when you have a commercial license for TinyMCE 8 or newer. The T8LK prefix is required.
 
+==== Example: Open source GPL license
 [source,cs]
 ----
 <Editor
-  LicenseKey="your-license-key"
+  LicenseKey="gpl"
 />
 ----
 
+Use this example when you're using TinyMCE under the open source GPL license in a self-hosted environment.
+
 === `ScriptSrc`
 
 Use the `+ScriptSrc+` property to specify the location of {productname} to lazy load when the application is not using {cloudname}. This setting is required if the application uses a self-hosted version of {productname}, such as the https://www.nuget.org/packages/TinyMCE/[{productname} NuGet package] or a .zip package of {productname}.

modules/ROOT/partials/integrations/common/license-key-property.adoc

@@ -0,0 +1,19 @@
+Specifies the {productname} license key. Required for self-hosted deployments of {productname}. This property is **not required** for cloud-only deployments using the {cloudname} as your cloud subscription automatically includes the commercial license. For more information, see: xref:license-key.adoc[License Key].
+
+*Type:* `+String+`
+
+*Default value:* `+undefined+`
+
+*Possible values:*
+* `undefined` - Use this when loading from {cloudname} with an API key
+* `'gpl'` - For open source projects using GPL license
+* `'T8LK:...'` - For commercial {productname} installations (must use this prefix for version 8+)
+
+[NOTE]
+====
+In hybrid deployments (using both cloud and self-hosted features):
+
+* You can provide both an API key and a license key
+* The editor will use cloud services when available
+* It will automatically fall back to the local license key if cloud services are not contactable
+====

modules/ROOT/partials/integrations/jquery-quick-start.adoc

@@ -119,7 +119,7 @@ ifeval::["{productSource}" == "package-manager"]
 <script>
   $('textarea#tiny').tinymce({
     height: 500,
-    license_key: '<your license key>',
+    license_key: 'gpl' // gpl for open source, T8LK:... for commercial
     /* other settings... */,
   });
 </script>
@@ -149,7 +149,7 @@ ifeval::["{productSource}" == "package-manager"]
     <script>
       $('textarea#tiny').tinymce({
         height: 500,
-        license_key: '<your-license-key>',
+        license_key: 'gpl' // gpl for open source, T8LK:... for commercial
         menubar: false,
         plugins: [
           'advlist', 'autolink', 'lists', 'link', 'image', 'charmap', 'preview',
@@ -219,4 +219,4 @@ $(document).on('focusin', function(e) {
 });
 ----
 
-This code is required because jQuery blocks all `focusin` calls from elements outside the dialog. For a working example, http://fiddle.tiny.cloud/ZZhaab/4[try this {productname} fiddle].
+This code is required because jQuery blocks all `focusin` calls from elements outside the dialog. For a working example, http://fiddle.tiny.cloud/ZZhaab/4[try this {productname} fiddle].

modules/ROOT/partials/integrations/react-bundling.adoc

@@ -41,9 +41,9 @@ import 'tinymce/skins/ui/oxide/content.js';
 export default function TinyEditorComponent(props) {
   return (
     <Editor
-      licenseKey='your-license-key'
+      licenseKey='gpl' // gpl for open source, T8LK:... for commercial
       {...props}
     />
   );
 }
-----
+----

modules/ROOT/partials/integrations/react-quick-start.adoc

@@ -149,7 +149,7 @@ export default function App() {
     <>
       <Editor
         tinymceScriptSrc='/tinymce/tinymce.min.js'
-        licenseKey='your-license-key'
+        licenseKey='gpl' // gpl for open source, T8LK:... for commercial
         onInit={(_evt, editor) => editorRef.current = editor}
         initialValue='<p>This is the initial content of the editor.</p>'
         init={{
@@ -243,7 +243,7 @@ import 'tinymce/skins/ui/oxide/content';
 export default function BundledEditor(props) {
   return (
     <Editor
-      licenseKey='your-license-key'
+      licenseKey='gpl' // gpl for open source, T8LK:... for commercial
       {...props}
     />
   );
@@ -358,7 +358,7 @@ export default function App() {
     <>
       <Editor
         tinymceScriptSrc='/tinymce/tinymce.min.js'
-        licenseKey='your-license-key'
+        licenseKey='gpl' // gpl for open source, T8LK:... for commercial
         onInit={(_evt, editor) => editorRef.current = editor}
         initialValue='<p>This is the initial content of the editor.</p>'
         init={{
@@ -496,7 +496,7 @@ import './tinymce/skins/ui/oxide/content.js';
 export default function BundledEditor(props) {
   return (
     <Editor
-      licenseKey='your-lisense-key'
+      licenseKey='gpl' // gpl for open source, T8LK:... for commercial
       {...props}
     />
   );