From 23f32fa5bbf4e39844c4958cdbac1aff2f795061 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 1 Sep 2025 15:15:17 +1000 Subject: [PATCH 1/4] DOC-3270: Add partial to mention conflict between Uploadcare and Image/EditImage plugins prevents Uploadcare from loading in TinyMCE. (#3843) --- modules/ROOT/pages/editimage.adoc | 7 +++++-- modules/ROOT/pages/image.adoc | 4 ++++ modules/ROOT/pages/uploadcare.adoc | 5 +++++ .../misc/plugin-compatibility-uploadcare-image.adoc | 13 +++++++++++++ 4 files changed, 27 insertions(+), 2 deletions(-) create mode 100644 modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc diff --git a/modules/ROOT/pages/editimage.adoc b/modules/ROOT/pages/editimage.adoc index 5519122321..4d0d5c6157 100644 --- a/modules/ROOT/pages/editimage.adoc +++ b/modules/ROOT/pages/editimage.adoc @@ -12,7 +12,7 @@ The {pluginname} (`{plugincode}`) plugin adds a contextual editing toolbar to im If the toolbar does not appear after clicking on an image, you may need to enable `+editimage_cors_hosts+` or `+editimage_proxy_service_url+` (see below). -NOTE: In previous versions of {productname}, the {pluginname} plugin was provided as an open source plugin known as the Image Tools plugin. + == Interactive example @@ -20,7 +20,10 @@ liveDemo::edit-image[] include::partial$misc/admon-svg-not-supported.adoc[] -// include::partial$misc/purchase-premium-plugins.adoc[] +:includedSection: editimagePlugin +include::partial$misc/plugin-compatibility-uploadcare-image.adoc[] +:!includedSection: + == Cloud Installation diff --git a/modules/ROOT/pages/image.adoc b/modules/ROOT/pages/image.adoc index 33de0981b4..7dc3b051cc 100644 --- a/modules/ROOT/pages/image.adoc +++ b/modules/ROOT/pages/image.adoc @@ -24,6 +24,10 @@ tinymce.init({ NOTE: This is not drag-drop functionality and the user is required to enter the path to the image. Optionally the user can also enter the image description, dimensions, and whether image proportions should be constrained (selected via a checkbox). Some of these settings can be preset using the plugin's configuration options. +:includedSection: imagePlugin +include::partial$misc/plugin-compatibility-uploadcare-image.adoc[] +:!includedSection: + include::partial$misc/admon-svg-not-supported.adoc[] == Options diff --git a/modules/ROOT/pages/uploadcare.adoc b/modules/ROOT/pages/uploadcare.adoc index 0ca199ad62..69936317fb 100644 --- a/modules/ROOT/pages/uploadcare.adoc +++ b/modules/ROOT/pages/uploadcare.adoc @@ -26,6 +26,10 @@ The **Image Optimizer** plugin offers a range of powerful features for image hos liveDemo::{plugincode}[] +:includedSection: uploadcarePlugin +include::partial$misc/plugin-compatibility-uploadcare-image.adoc[] +:!includedSection: + == Basic setup To add the {pluginname} plugin to the editor, include `{plugincode}` in the `plugins` option in the editor configuration. @@ -50,6 +54,7 @@ tinymce.init({ The {pluginname} plugin overrides the xref:quickbars.adoc[Quickbar] quickimage toolbar item. To ensure a better user experience and to avoid having two image buttons configure `quickbars_insert_toolbar` to omit the `quickimage` toolbar item. ==== + == Image Operations Below is an overview of the features provided by the {pluginname} plugin for image optimization: diff --git a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc new file mode 100644 index 0000000000..d274ba6751 --- /dev/null +++ b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc @@ -0,0 +1,13 @@ +[WARNING] +==== +**Plugin Compatibility Issues** + +The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin cannot be configured together with the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins. These plugins have conflicting functionality's that prevent proper image editing operations. + +**Recommended Solutions:** + +* Configure either the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins together, or +* Configure the xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] plugin as the sole image handler for all images. + +If all three plugins are enabled, editor notification: "Unable to initialize uploadcare due to the presence of incompatible plugins. Details are in the browser console." will be shown along with console error: "Unable to initialize uploadcare due to the presence of incompatible plugins: image, editimage". +==== From 74c205e05da62c5d41690f9160d7938bed232bd4 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Tue, 2 Sep 2025 10:23:53 +1000 Subject: [PATCH 2/4] Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: Kim <45845989+kimwoodfield@users.noreply.github.com> --- .../partials/misc/plugin-compatibility-uploadcare-image.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc index d274ba6751..96fa032613 100644 --- a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc +++ b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc @@ -2,7 +2,7 @@ ==== **Plugin Compatibility Issues** -The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin cannot be configured together with the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins. These plugins have conflicting functionality's that prevent proper image editing operations. +The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin cannot be configured together with the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins. These plugins have conflicting functionality that prevent proper image editing operations. **Recommended Solutions:** From 1c620c7664128b835318788b70a972f38b6e9ee6 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Tue, 2 Sep 2025 10:24:15 +1000 Subject: [PATCH 3/4] Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: Kim <45845989+kimwoodfield@users.noreply.github.com> --- .../partials/misc/plugin-compatibility-uploadcare-image.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc index 96fa032613..95704dd078 100644 --- a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc +++ b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc @@ -9,5 +9,5 @@ The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin c * Configure either the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins together, or * Configure the xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] plugin as the sole image handler for all images. -If all three plugins are enabled, editor notification: "Unable to initialize uploadcare due to the presence of incompatible plugins. Details are in the browser console." will be shown along with console error: "Unable to initialize uploadcare due to the presence of incompatible plugins: image, editimage". +If all three plugins are enabled, editor notification: "Unable to initialize uploadcare due to the presence of incompatible plugins. Details are in the browser console." will be shown along with a console error: "Unable to initialize uploadcare due to the presence of incompatible plugins: image, editimage". ==== From e0fddf99bc0a6472165f5da4284672d433f302d0 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Tue, 9 Sep 2025 09:39:51 +1000 Subject: [PATCH 4/4] Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: tiny-ben-tran --- .../partials/misc/plugin-compatibility-uploadcare-image.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc index 95704dd078..d34e71414f 100644 --- a/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc +++ b/modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc @@ -2,7 +2,7 @@ ==== **Plugin Compatibility Issues** -The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin cannot be configured together with the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins. These plugins have conflicting functionality that prevent proper image editing operations. +The xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] premium plugin cannot be configured together with the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins. These plugins have conflicting functionalities that prevent proper image editing operations. **Recommended Solutions:**