Added Media Gallery Image Optimization Documenation (#762)

* Added Media Gallery Image Optimization Documentation

Co-authored-by: Leslie Tilling <[email protected]>

Author: sivaschenko

src/_data/toc/content.yml

@@ -52,6 +52,8 @@ pages:
             url: "/cms/media-gallery-asset-management.html"
           - label: Folder Management
             url: "/cms/media-gallery-folder-management.html"
+          - label: Media Gallery Image Optimization
+            url: "/cms/media-gallery-image-optimization.html"
     - label: Using the Editor
       url: "/cms/editor.html"
       children:

src/cms/media-gallery-image-optimization.md

@@ -0,0 +1,24 @@
+---
+title: Media Gallery Image Optimization
+---
+
+The new [Media Gallery]({% link cms/media-gallery.md %}) provides an _Image Optimization_ feature, which improves performance and decreases media file sizes on the storefront. This optimization is enabled by default and can be modified in the store configuration settings.
+
+## Configure image optimization
+
+1. On the _Admin_ sidebar, go to **Stores** > _Settings_ > **Configuration**.
+
+1. In the left panel, expand **Advanced** and choose **System**.
+
+1. Expand ![Expansion selector]({% link images/images/btn-expand.png %}) **Media Gallery Image Optimization** and do the following:
+
+   - Set **Enable Image Optimization** to `Yes`.
+   - Enter the **Maximum Width** and **Maximum Height** values (in pixels) according to your needs..
+
+## Behaviour
+
+When Media Gallery Image Optimization functionality is enabled, an optimized copy of an image is automatically inserted in the content from the [Media Gallery]({% link cms/media-gallery.md %}) instead of the original file.
+
+Any time the _Maximum Width_ and _Maximum Heigh_ values are changed in the configuration, it updates all the existing optimized images that were previously inserted.
+
+The Media Gallery Image Optimization requires `media.gallery.renditions.update` queue consumers to be running for regenerating optimized image when configuration is changed. See [Manage message queues](https://devdocs.magento.com/guides/v2.4/config-guide/mq/manage-message-queues.html) documentation for more details.

src/cms/media-gallery.md

@@ -54,4 +54,4 @@ To access the new Media Gallery when you are adding or editing a page:
 [add-page]: {% link cms/page-add.md %}
 [create-category]: {% link catalog/category-create.md %}
 [editor-insert-image]: {% link cms/editor-insert-image.md %}
-[editor-config]: {% link cms/editor-configure.md %}
+[editor-config]: {% link cms/editor-configure.md %}

src/configuration/advanced/system.md

@@ -214,5 +214,16 @@ _Enhanced Media Gallery_
 |--- |--- |--- |
 |Enabled|Global|Enables or disables the new Media Gallery.|
 
+## Media Gallery Image Optimization
+
+![Advanced configuration - Media Gallery Image Optimization]({% link images/images/enhanced-media-gallery/system-image-optimization.png %}){: .zoom}
+_Media Gallery Image Optimization_
+
+|Field|[Scope]({% link configuration/scope.md %})|Description|
+|--- |--- |--- |
+|Enable Image Optimization|Global|Determines if images are resized to decrease the file size of the images inserted to the content. Original images are preserved in the Media Gallery.|
+|Maximum Width|Global|The maximum width (in pixels) for images inserted from Media Gallery into the content.|
+|Maximum Height|Global|The maximum height (in pixels) for images inserted from Media Gallery into the content.|
+
 [1]: https://en.wikipedia.org/wiki/Sendmail
-[2]: https://magento.com/security/news/new-zend-framework-1-security-vulnerability
+[2]: https://magento.com/security/news/new-zend-framework-1-security-vulnerability