DOC-2581: Copy edits, update uploadcare config to use partials.

Author: kemister85

modules/ROOT/pages/uploadcare.adoc

@@ -187,8 +187,21 @@ Below is an overview of the features of the {pluginname} plugin includes for ima
 
 The following configuration options affect the behavior of the {pluginname} plugin.
 
-include::partial$configuration/{plugincode}.adoc[leveloffset=+1]
+include::partial$configuration/uploadcare_public_key.adoc[leveloffset=+1]
 
-include::partial$misc/plugin-toolbar-button-id-boilerplate.adoc[leveloffset=+1]
+include::partial$configuration/uploadcare_signed_upload_auth_provider.adoc[leveloffset=+1]
 
-include::partial$misc/plugin-menu-item-id-boilerplate.adoc[leveloffset=+1]
+include::partial$configuration/uploadcare_cdn_base_url.adoc[leveloffset=+1]
+
+include::partial$configuration/uploadcare_srcset_steps.adoc[leveloffset=+1]
+
+include::partial$configuration/uploadcare_store_type.adoc[leveloffset=+1]
+
+
+== Optional Option
+
+include::partial$configuration/a11y_advanced_options.adoc[leveloffset=+1]
+
+include::partial$misc/plugin-toolbar-button-id-boilerplate.adoc[]
+
+include::partial$misc/plugin-menu-item-id-boilerplate.adoc[]

modules/ROOT/partials/configuration/a11y_advanced_options.adoc

@@ -3,12 +3,13 @@
 
 This option affects the functionality of:
 
-* The Accessibility Checker plugin (`+a11ychecker+`).
-* The Image plugin (`+image+`).
+* The xref:a11ychecker.adoc[Accessibility Checker] plugin (`+a11ychecker+`).
+* The xref:image.adoc[Image] plugin (`+image+`).
+* The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] (`+uploadcare+`).
 
 Setting `+a11y_advanced_options+` to `+true+`:
 
-* Adds the *Image is decorative* option to the _Insert/Edit Image_ dialog, allowing users to specify that an image is decorative and does not require alternative text for accessibility purposes.
+* Adds the *Image is decorative* option to the _Insert/Edit Image_ or _Insert/Edit Image Optimizer_ dialog, allowing users to specify that an image is decorative and does not require alternative text for accessibility purposes.
 * Adds the *Image is decorative* option to the _Accessibility Checker error_ dialog for images without alternative text or the `+role="presentation"+` attribute.
 
 IMPORTANT: When `+a11y_advanced_options+` is set to `+true+`, xref:a11ychecker.adoc#a11ychecker_allow_decorative_images[`+a11ychecker_allow_decorative_images+`] will default to `+true+`.

modules/ROOT/partials/configuration/uploadcare.adoc

@@ -0,0 +1,21 @@
+[[uploadcare-cdn-base-url]]
+== `uploadcare_cdn_base_url`
+
+Specifies the domain used for the Uploadcare service. This domain determines where your files are uploaded and accessed. By default, the plugin uses the Uploadcare CDN `ucarecdn.com` to host and deliver your files. If you use a custom domain, update this option to match your configuration.
+
+*Type:* `+String+`
+
+*Default:* `+https://ucarecdn.com/+`
+
+=== Example: Customizing `uploadcare_cdn_base_url`
+
+[source,js]
+----
+tinymce.init({
+  selector: "textarea",
+  plugins: 'uploadcare',
+  toolbar: 'uploadcare',
+  uploadcare_public_key: '<your-public-key>',
+  uploadcare_cdn_base_url: 'https://cdn.mydomain.com',
+});
+----

modules/ROOT/partials/configuration/uploadcare_cdn_base_url.adoc

@@ -0,0 +1,21 @@
+[[uploadcare-public-key]]
+== `uploadcare_public_key`
+
+Defines the public API key required to authenticate and interact with the Uploadcare API. This key identifies your account and ensures that uploads and operations are associated with your project. Without setting this key, the Uploadcare integration will not function.
+
+[IMPORTANT]
+This option is mandatory for using Uploadcare.
+
+*Type:* `+String+`
+
+=== Example: Setting `uploadcare_public_key`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',
+  plugins: 'uploadcare',
+  toolbar: 'uploadcare',
+  uploadcare_public_key: '<your-public-key>',
+});
+----

modules/ROOT/partials/configuration/uploadcare_public_key.adoc

@@ -0,0 +1,36 @@
+[[uploadcare-signed-upload-auth-provider]]
+== `uploadcare_signed_upload_auth_provider`
+
+Specifies a function used to generate secure signatures for authenticated requests to Uploadcare. This is necessary when using secure Uploadcare features, such as signed uploads. The function should return a `Promise` that resolves with an object containing the signature and expiration timestamp.
+
+Use this option if you want to ensure secure uploads or restrict file access using Uploadcare's signed uploads feature.
+
+*Type:* `+Function+`
+
+=== Example: Setting `uploadcare_signed_upload_auth_provider`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',
+  plugins: 'uploadcare',
+  toolbar: 'uploadcare',
+  uploadcare_public_key: '<your-public-key>',
+  uploadcare_signed_upload_auth_provider: (_publicKey) => Promise.resolve({
+    signature: 'sig',
+    expire: 123
+  }),
+});
+----
+
+[IMPORTANT]
+====
+{companyname} recommends configuring the `uploadcare_signed_upload_auth_provider` option to enable signed uploads and enhance security when integrating with Uploadcare. This option is essential for applications requiring:
+
+* Secure file uploads by preventing unauthorized access.
+* Restriction of file access to specific users or sessions.
+
+The `uploadcare_signed_upload_auth_provider` ensures that every request is authenticated with a generated signature and expiration timestamp, providing an additional layer of security for sensitive data.
+
+Using this option will help safeguard your application by ensuring secure file uploads, protecting sensitive data, and maintaining system integrity. {companyname} strongly advises including this configuration as a fundamental part of your Uploadcare integration setup.
+====

modules/ROOT/partials/configuration/uploadcare_signed_upload_auth_provider.adoc

@@ -0,0 +1,23 @@
+[[uploadcare-srcset-steps]]
+== `uploadcare_srcset_steps`
+
+Defines an array of numeric values representing the widths for responsive images. These widths are used to generate the `srcset` attribute for images, allowing browsers to select the most appropriate resolution based on the device's display and network conditions.
+
+Customize this array to include only the widths you need for your application. For example, you can reduce the number of resolutions for faster processing or add specific sizes required for your layout.
+
+*Type:* `+Array+`
+
+*Default:* `+[100, 200, 300, 500, 750, 1000, 1250, 1500, 2000, 2500, 3000]+`
+
+=== Example: Customizing `uploadcare_srcset_steps`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',
+  plugins: 'uploadcare',
+  toolbar: 'uploadcare',
+  uploadcare_public_key: '<your-public-key>',
+  uploadcare_srcset_steps: [100, 200, 300, 500],
+});
+----

modules/ROOT/partials/configuration/uploadcare_srcset_steps.adoc

@@ -0,0 +1,29 @@
+[[uploadcare-store-type]]
+== `uploadcare_store_type`
+
+Specifies the storage type for uploaded files. Use this option to control whether files are stored temporarily or permanently, or allow Uploadcare to decide automatically based on your account settings.
+
+* `auto`: Default behavior; Uploadcare decides the storage type.
+* `temporary`: Files are stored temporarily and will expire after a certain period.
+* `permanent`: Files are stored permanently in your Uploadcare account.
+
+Select the appropriate value based on your application's requirements, such as whether files should persist for long-term use or be available for a limited time.
+
+*Type:* `+String+`
+
+*Default:* `permanent`
+
+*Possible values:* `auto`, `temporary`, `permanent`
+
+=== Example: Using `uploadcare_store_type`
+
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',
+  plugins: 'uploadcare',
+  toolbar: 'uploadcare',
+  uploadcare_public_key: '<your-public-key>',
+  uploadcare_store_type: 'permanent',
+});
+----