DOC-2215: add new feature to 6.8 release project for AdvTemplate. (#2985)

* DOC-2215: add new feature  to 6.8 release project for AdvTemplate.

* DOC-2215: add mce-clipboard demo to advanced tempaltes new feature sub-section.

* Update modules/ROOT/examples/live-demos/advtemplate-mce-clipboard/index.html

Co-authored-by: vpyshnenko <[email protected]>

* DOC-2215: updated demo files to remove template categories.

* Update modules/ROOT/examples/live-demos/advtemplate-mce-clipboard/index.html

* Update modules/ROOT/examples/live-demos/advtemplate-mce-clipboard/index.html

Co-authored-by: vpyshnenko <[email protected]>

* Update modules/ROOT/pages/advanced-templates.adoc

* DOC-2215: update demo and js.

* Update index.html

Co-authored-by: vpyshnenko <[email protected]>

* DOC-2215: correcting index.js backslash  for antora syntax.

* DOC-2215: updating with new {{prefix}}mce-clipboard{{suffix}} tags for antora to render correctly in live-demos.

* Update index.html

Co-authored-by: vpyshnenko <[email protected]>

* Update index.html

Co-authored-by: vpyshnenko <[email protected]>

* Update index.html

Co-authored-by: vpyshnenko <[email protected]>

---------

Co-authored-by: vpyshnenko <[email protected]>

Author: kemister85

changelog.md

@@ -6,6 +6,7 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/
 
 ### Unreleased
 
+- DOC-2215: add new feature `mce-clipboard` to 6.8.1 release project for AdvTemplate.
 - DOC-2216: add new single `js` bundling feature example for `Bundling an npm version of TinyMCE with ES6 and Vite`.
 - DOC-2202: add new `bespoke` button text updates to `events.adoc` file.
 - DOC-2209: add new default_font_stack `user-formatting-option.adoc` file.

modules/ROOT/examples/live-demos/advtemplate-mce-clipboard/index.html

@@ -0,0 +1,27 @@
+<textarea id="advanced-template-mce-clipboard">
+  <h3>Using the {{prefix}}mce-clipboard{{suffix}} Marker with Advanced Templates</h3>
+  <h4>Before inserting the example template, <strong>type in your name</strong> to the editor, select and copy it to your clipboard by using <strong>Ctrl+C</strong> for Windows users, or <strong>⌘+C</strong> for Mac users</h4>
+  <div>
+    <ol>
+      <li>
+        Select <strong>Template…</strong> from the <strong>Insert</strong> menu or by selecting the <strong>Insert template</strong> toolbar button.
+      </li>
+      <li>
+        Select a template to add to the TinyMCE document from the <strong>Templates</strong> dialog that presents.
+        <ol>
+          <li>
+            <p>Click the <strong>Without an <code>{{prefix}}mce-clipboard{{suffix}}</code> marker</strong> template.</p>
+            <p>The template should be inserted into the editor content regardless of any clipboard content./p>
+          </li>
+          <li>
+            <p>Click the <strong>With a <code>{{prefix}}mce-clipboard{{suffix}}</code> marker</strong> template.</p>
+            <p><em>When a template <strong>does</strong> contain a valid {{prefix}}mce-clipboard{{suffix}} marker, the current content saved in the users clipboard will <strong>replace</strong> the marker when the user inserts the template.</em></p>
+          </li>
+        </ol>
+      </li>
+      <li>
+        Click <strong>Insert</strong> or press <strong>Return</strong>.
+      </li>
+    </ol>
+  </div>
+</textarea>

modules/ROOT/examples/live-demos/advtemplate-mce-clipboard/index.js

@@ -0,0 +1,15 @@
+tinymce.init({
+  selector: "textarea#advanced-template-mce-clipboard",
+  plugins: [ "advtemplate", "code", "help"],
+  toolbar: "undo redo | inserttemplate",
+  advtemplate_templates: [
+    {
+      title: 'Without an mce-clipboard marker',
+      content: '<p>Hi , Thank you for visiting this page. We truly appreciate and value your feedback and any feature requests you may have While you are here, take a moment to explore mce-cursor, its another powerful tool designed for Advanced Templates</p>'
+    },
+    {
+      title: 'With an mce-clipboard marker',
+      content: '<p>Hi {{prefix}}mce-clipboard{{suffix}}, Thank you for visiting this page. We truly appreciate and value your feedback and any feature requests you may have While you are here, take a moment to explore mce-cursor {{prefix}}mce-clipboard{{suffix}}, its another powerful tool designed for Advanced Templates</p>'
+    }
+  ],
+});

modules/ROOT/pages/advanced-templates.adoc

@@ -151,6 +151,19 @@ Also, and as shown in the interactive demonstration below, the xref:mergetags.ad
 liveDemo::{plugincode}-insertionpoint[]
 
 
+[[the-mce-clipboard-marker]]
+=== The mce-clipboard marker
+
+include::partial$misc/admon-requires-6.8v.adoc[]
+
+The `+{{mce-clipboard}}+` marker is a fixed string for adding to any template.
+
+The string to add is as follows: `+{{mce-clipboard}}+`.
+
+Whenever a user inserts a template containing the `+{{mce-clipboard}}+` marker, the editor will replace those markers with the actual content from the clipboard.
+
+liveDemo::{plugincode}-mce-clipboard[]
+
 [[options]]
 == Options