Added doc for ConfigureImageOptimizersEvent

code_samples/back_office/images/src/Event/RemovePngquantOptimizer.php

@@ -0,0 +1,22 @@
+<?php declare(strict_types=1);
+
+namespace App\Event;
+
+use Ibexa\Contracts\ImageEditor\Event\ConfigureImageOptimizersEvent;
+use Spatie\ImageOptimizer\Optimizers\Pngquant;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+class RemovePngquantOptimizer implements EventSubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return [
+            ConfigureImageOptimizersEvent::class => 'onConfigureOptimizers',
+        ];
+    }
+
+    public function onConfigureOptimizers(ConfigureImageOptimizersEvent $event): void
+    {
+        $event->removeOptimizer(Pngquant::class);
+    }
+}

composer.json

@@ -76,7 +76,8 @@
         "ibexa/collaboration": "~4.6.x-dev",
         "ibexa/share": "~4.6.x-dev",
         "ibexa/phpstan": "~4.6.-dev",
-        "ibexa/cdp": "~4.6.x-dev"
+        "ibexa/cdp": "~4.6.x-dev",
+        "ibexa/image-editor": "~4.6.x-dev"
     },
     "scripts": {
         "fix-cs": "php-cs-fixer fix --config=.php-cs-fixer.php -v --show-progress=dots",

docs/api/event_reference/other_events.md

@@ -60,6 +60,17 @@
 |---|---|---|
 |`PublishVersionEvent`|`PublishAssetEventDispatcher::emitPublishAssetEvent`|`Content $content`</br>`Connector\Dam\AssetIdentifier $assetIdentifier`</br>`Connector\Dam\AssetSource $assetSource`|
 
+## Image Editor
+
+The following event is dispatched when the Image Editor optimizes an image.
+You can subscribe to it to customize the list of active image optimizers at runtime.
+
+For more information, see [Customizing image optimizers with an event](images.md#customizing-image-optimizers).
+
+| Event | Dispatched by | Properties |
+|---|---|---|
+|<nobr>[`ConfigureImageOptimizersEvent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ImageEditor-Event-ConfigureImageOptimizersEvent.html)</nobr>|`SpatieChainOptimizer::`<br>`optimize`|`array<Spatie\ImageOptimizer\Optimizer> $optimizers`|
+
 ## Form Builder [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]]
 
 | Event | Dispatched by | Properties |

docs/content_management/images/images.md

@@ -254,6 +254,17 @@ Install these libraries using your package manager, for example:
 sudo apt-get install optipng
 ```
 
+### Customizing image optimizers
+
+When the Image Editor saves a modified image, the system dispatches the [`ConfigureImageOptimizersEvent`](other_events.md#image-editor) event before running the optimizer chain.
+You can listen to this event to customize the list of image optimizers at runtime.
+
+The following example shows how to remove the Pngquant optimizer to prevent grayscale conversion of low-saturation PNG images:
+
+``` php
+[[= include_file('code_samples/back_office/images/src/Event/RemovePngquantOptimizer.php') =]]
+```
+
 ## Embedding images in Rich Text
 
 The [RichText](richtextfield.md) field allows you to embed other content items within the field.