Skip to content

Commit ba2b471

Browse files
kemister85kimwoodfieldtiny-ben-tran
authored
DOC-3270: Add partial to mention conflict between Uploadcare and Image/EditImage plugins which prevents Uploadcare from loading in TinyMCE. (#3843) (#3844)
* DOC-3270: Add partial to mention conflict between Uploadcare and Image/EditImage plugins prevents Uploadcare from loading in TinyMCE. (#3843) * Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: Kim <[email protected]> * Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: Kim <[email protected]> * Update modules/ROOT/partials/misc/plugin-compatibility-uploadcare-image.adoc Co-authored-by: tiny-ben-tran <[email protected]> --------- Co-authored-by: Kim <[email protected]> Co-authored-by: tiny-ben-tran <[email protected]>
1 parent 7cc493c commit ba2b471

File tree

4 files changed

+27
-2
lines changed

4 files changed

+27
-2
lines changed

modules/ROOT/pages/editimage.adoc

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,15 +12,18 @@ The {pluginname} (`{plugincode}`) plugin adds a contextual editing toolbar to im
1212

1313
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).
1414

15-
NOTE: In previous versions of {productname}, the {pluginname} plugin was provided as an open source plugin known as the Image Tools plugin.
15+
1616

1717
== Interactive example
1818

1919
liveDemo::edit-image[]
2020

2121
include::partial$misc/admon-svg-not-supported.adoc[]
2222

23-
// include::partial$misc/purchase-premium-plugins.adoc[]
23+
:includedSection: editimagePlugin
24+
include::partial$misc/plugin-compatibility-uploadcare-image.adoc[]
25+
:!includedSection:
26+
2427

2528
== Cloud Installation
2629

modules/ROOT/pages/image.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,10 @@ tinymce.init({
2424

2525
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.
2626

27+
:includedSection: imagePlugin
28+
include::partial$misc/plugin-compatibility-uploadcare-image.adoc[]
29+
:!includedSection:
30+
2731
include::partial$misc/admon-svg-not-supported.adoc[]
2832

2933
== Options

modules/ROOT/pages/uploadcare.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ The **Image Optimizer** plugin offers a range of powerful features for image hos
2626

2727
liveDemo::{plugincode}[]
2828

29+
:includedSection: uploadcarePlugin
30+
include::partial$misc/plugin-compatibility-uploadcare-image.adoc[]
31+
:!includedSection:
32+
2933
== Basic setup
3034

3135
To add the {pluginname} plugin to the editor, include `{plugincode}` in the `plugins` option in the editor configuration.
@@ -50,6 +54,7 @@ tinymce.init({
5054
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.
5155
====
5256

57+
5358
== Image Operations
5459

5560
Below is an overview of the features provided by the {pluginname} plugin for image optimization:
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
[WARNING]
2+
====
3+
**Plugin Compatibility Issues**
4+
5+
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.
6+
7+
**Recommended Solutions:**
8+
9+
* Configure either the xref:image.adoc[Image] and xref:editimage.adoc[Image Editing] plugins together, or
10+
* Configure the xref:uploadcare.adoc[Image Optimizer Powered by Uploadcare] plugin as the sole image handler for all images.
11+
12+
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".
13+
====

0 commit comments

Comments
 (0)