Update JWT authentication documentation across export and import plugins including use of partials.

Author: kemister85

modules/ROOT/pages/exportpdf.adoc

@@ -1,6 +1,7 @@
 = {pluginname} plugin
 :plugincode: exportpdf
 :pluginname: Export to PDF
+:pluginfilename: export-to-pdf
 :navtitle: {pluginname}
 :description: The {pluginname} feature provides the ability to generate a PDF file directly from the editor.
 :description_short: Generate a PDF file directly from the editor.
@@ -22,8 +23,7 @@ liveDemo::exportpdf[]
 
 To add the {pluginname} plugin to the editor, add `{plugincode}` to the `plugins` option in the editor configuration.
 
-For example:
-
+.Example:
 [source,js]
 ----
 tinymce.init({
@@ -41,37 +41,16 @@ tinymce.init({
 });
 ----
 
-[NOTE]
 For more infomation on the exportpdf_token_provider option, see xref:exportpdf.adoc#exportpdf-token-provider[exportpdf_token_provider].
 
-[IMPORTANT]
-====
-The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
-
-* Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:importword.adoc#data-structure[JSON] containing the token.
-
-For more information on how to set up JWT authentication with {pluginname}, see examples:
+include::partial$misc/admon-jwt-authentication-requirements.adoc[]
 
-* xref:export-to-pdf-with-jwt-authentication-nodejs.adoc[Export to PDF with JWT authentication (Node.js)]
-* xref:export-to-pdf-with-jwt-authentication-php.adoc[Export to PDF with JWT authentication (PHP)]
-
-**Trial period behavior:**
-
-* The {pluginname} plugin runs in evaluation mode and adds a watermark to exported content.
-* The `{plugincode}_token_provider` option is "not required" during the trial period.
-* If the trial period "expires" or the plugin lacks the necessary entitlement, it becomes _non-functional_.
-* Attempting to use JWT authentication during the trial will result in an _error_.
-====
-
-include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
 
 == Basic setup using the self-hosted service
 
 To use the self-hosted version of the {pluginname} plugin, you need to set the `exportpdf_service_url` option to the URL of the service.
 
-For example:
-
+.Example:
 [source,js]
 ----
 tinymce.init({

modules/ROOT/pages/exportword.adoc

@@ -1,6 +1,7 @@
 = {pluginname} plugin
 :plugincode: exportword
 :pluginname: Export to Word
+:pluginfilename: export-to-word
 :navtitle: {pluginname}
 :description: The {pluginname} feature lets you generate a .docx (Microsoft Word document) file directly from the editor.
 :description_short: Generate a .docx file directly from the editor.
@@ -47,41 +48,16 @@ tinymce.init({
 });
 ----
 
-[NOTE]
 For more infomation on the exportword_token_provider option, see xref:exportword.adoc#exportword-token-provider[exportword_token_provider]
 
-[IMPORTANT]
-====
-The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
-
-* Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:exportword.adoc#data-structure[JSON] containing the token.
-
-For more information on how to set up JWT authentication with {pluginname}, see examples:
-
-* xref:export-to-word-with-jwt-authentication-nodejs.adoc[{pluginname} with JWT authentication (Node.js)]
-* xref:export-to-word-with-jwt-authentication-php.adoc[{pluginname} with JWT authentication (PHP)]
-
-**Trial period behavior:**
-
-* The {pluginname} plugin runs in evaluation mode and adds a watermark to exported content.
-* The `{plugincode}_token_provider` option is "not required" during the trial period.
-* If the trial period "expires" or the plugin lacks the necessary entitlement, it becomes _non-functional_.
-* Attempting to use JWT authentication during the trial will result in an _error_.
-====
-
-include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
-
-
-
-
+include::partial$misc/admon-jwt-authentication-requirements.adoc[]
 
 
 == Basic setup using the self-hosted service
 
 To use the self-hosted version of the {pluginname} plugin, you need to set the `exportword_service_url` option to the URL of the service.
 
-For example:
+.Example:
 [source,js]
 ----
 tinymce.init({

modules/ROOT/pages/importword.adoc

@@ -2,6 +2,7 @@
 = {pluginname} plugin
 :plugincode: importword
 :pluginname: Import from Word
+:pluginfilename: import-from-word
 :navtitle: {pluginname}
 :description: Provides a way to import .docx (Microsoft Word documents) or .dotx (Microsoft Word templates) files into the editor.
 :description_short: Import .docx or .dotx files into the editor.
@@ -42,37 +43,16 @@ tinymce.init({
 });
 ----
 
-[NOTE]
 For more infomation on the importword_token_provider option, see xref:importword.adoc#importword-token-provider[importword_token_provider].
 
-[IMPORTANT]
-====
-The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
-
-* Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:importword.adoc#data-structure[JSON] containing the token.
-
-For more information on how to set up JWT authentication with {pluginname}, see examples:
-
-* xref:import-from-word-with-jwt-authentication-nodejs.adoc[{pluginname} with JWT authentication (Node.js)]
-* xref:import-from-word-with-jwt-authentication-php.adoc[{pluginname} with JWT authentication (PHP)]
+include::partial$misc/admon-jwt-authentication-requirements.adoc[]
 
-**Trial period behavior:**
-
-* The {pluginname} plugin runs in evaluation mode and adds a watermark to exported content.
-* The `{plugincode}_token_provider` option is "not required" during the trial period.
-* If the trial period "expires" or the plugin lacks the necessary entitlement, it becomes _non-functional_.
-* Attempting to use JWT authentication during the trial will result in an _error_.
-====
-
-include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
 
 == Basic setup using the self-hosted service
 
 To use the self-hosted version of the {pluginname} plugin, you need to set the `importword_service_url` option to the URL of the service.
 
-For example:
-
+.Example:
 [source,js]
 ----
 tinymce.init({

modules/ROOT/partials/configuration/exportpdf_token_provider.adoc

@@ -7,6 +7,8 @@ The `exportpdf_token_provider` option enables integration with a token-based aut
 
 *Default value:* `undefined`
 
+*Return data:* xref:exportpdf.adoc#data-structure[`Token` object]
+
 === Example: using `exportpdf_token_provider`
 
 [source,js]
@@ -22,4 +24,6 @@ tinymce.init({
     }).then(response => response.json());
   },
 });
-----
+----
+
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]

modules/ROOT/partials/configuration/exportword_token_provider.adoc

@@ -7,6 +7,8 @@ The `exportword_token_provider` option enables integration with a token-based au
 
 *Default value:* `undefined`
 
+*Return data:* xref:exportword.adoc#data-structure[`Token` object]
+
 === Example: using `exportword_token_provider`
 
 [source,js]
@@ -22,4 +24,6 @@ tinymce.init({
     }).then(response => response.json());
   },
 });
-----
+----
+
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]

modules/ROOT/partials/configuration/importword_token_provider.adoc

@@ -7,6 +7,8 @@ The `importword_token_provider` option enables integration with a token-based au
 
 *Default value:* `undefined`
 
+*Return data:* xref:importword.adoc#data-structure[`Token` object]
+
 === Example: using `importword_token_provider`
 
 [source,js]
@@ -22,4 +24,6 @@ tinymce.init({
     }).then(response => response.json());
   },
 });
-----
+----
+
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]

modules/ROOT/partials/misc/admon-document-converters-jwt-expected-data-structure.adoc

@@ -1,11 +1,12 @@
-== Data structure
+[[data-structure]]
+=== Data structure for the JWT token
 
-The JSON data containing the valid encoded token must match the following structure:
+The object containing the valid encoded token must match the following structure:
 
-[source,json]
+[source,js]
 ----
 {
-  "token": "<encoded JWT string>"
+  token: "<encoded JWT string>"
 }
 ----
 

modules/ROOT/partials/misc/admon-jwt-authentication-requirements.adoc

@@ -0,0 +1,18 @@
+[IMPORTANT]
+====
+The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
+
+* Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
+
+For more information on how to set up JWT authentication with {pluginname}, see examples:
+
+* xref:{pluginfilename}-with-jwt-authentication-nodejs.adoc[{pluginname} with JWT authentication (Node.js)]
+* xref:{pluginfilename}-with-jwt-authentication-php.adoc[{pluginname} with JWT authentication (PHP)]
+
+**Trial period behavior:**
+
+* The {pluginname} plugin runs in evaluation mode and adds a watermark to exported content.
+* The `{plugincode}_token_provider` option is "not required" during the trial period.
+* If the trial period "expires" or the plugin lacks the necessary entitlement, it becomes _non-functional_.
+* Attempting to use JWT authentication during the trial will result in an _error_.
+====