Configuring the Image Editor ¶
The Image Editor does not support images that come from a Digital Asset Management (DAM) system.
You can modify the default settings to change the appearance or behavior of the Image Editor. You can also expand the default set of parameters to create buttons that may be required by custom features that you add by extending the Image Editor, for example, to enable changes to the color palette of an image.
To do this, modify the
config/packages/ezplatform.yaml file, or create a separate YAML file
config/packages folder, and add a settings tree similar to the following example.
The settings tree can contain one or more action groups.
You can control the order of actions within a group by setting the
You can also toggle the visibility of actions within the user interface.
Image Editor settings are SiteAccess-aware.
The following example sets the aspect ratio values and label names for buttons used by the Crop feature.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
Each image can be accompanied by additional information that is not visible to the user. By default, additional information stores the coordinates of the focal point, but you can use this extension point to pass various parameters of custom features that you add by extending the Image Editor.
To modify the value of additional information programmatically, you can set a value of the
Image field by using the PHP API, for example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15