diff --git a/docs/content_management/create_edit_content_items.md b/docs/content_management/create_edit_content_items.md index ae9535c7..ac0eb445 100644 --- a/docs/content_management/create_edit_content_items.md +++ b/docs/content_management/create_edit_content_items.md @@ -86,6 +86,7 @@ Fields marked with an asterisk (\*) are required. You can't save the content item without filling them in. Some fields, such as *Relation* field (which links two content items) or *Image* field, require you to select a different content item to link to. +For *Image* and *Image asset* fields, you select the image from the [image library](browse_images.md). A *Location* field is a point on the map. You can type the place name, enter its coordinates, or select it on the map. @@ -188,6 +189,8 @@ This opens the window to create the link. #### Images +When you add an **Image** element, you choose the image asset in the [image library](browse_images.md). + In image options you can select an image variation. Variations can include different sizing options and other filters that are applied to images. Available image variations are configured by your integration partner. diff --git a/docs/dam/ibexa_dam.md b/docs/dam/ibexa_dam.md deleted file mode 100644 index 64ab0c2d..00000000 --- a/docs/dam/ibexa_dam.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -description: DAM module interface for uploading and managing image assets. ---- - -# [[= product_name_dam =]] - -Digital Asset Management is a platform dedicated to editors. -It enables storing in central location, organizing, distributing, and sharing media assets across many channels. - -[[= product_name_dam =]] image picker is developed to work with any web browser that supports modern standards. -The minimum screen resolution is 1366 x 768. - -List of supported web browsers: - -- Mozilla® Firefox® most recent stable version (recommended) -- Google Chrome™ most recent stable version (recommended) -- Chromium™ based browsers such as Microsoft® Edge® and Opera®, most recent stable version, desktop and tablet -- Apple® Safari® most recent stable version, desktop and tablet - -## View modes - -The main window is available in two display versions: grid and list view. - -To change the view mode, in the upper-right corner, click **View** and select the view you need. - -### Grid view - -Grid view contains image preview, file format, and image size. - -### List view - -List view contains a thumbnail, title, format, size, dimensions, creation, and update date. - -### Sorting - -You can sort image assets by alphabetical order or by the creation date. -To sort image assets, in the upper-right corner, click **Date** and select the sorting method you need. - -## Search assets - -### Keyword search - -The search option allows to find image assets using a word or phrase. -To use it, in the upper part of the screen, click the **Search** field. -Enter a search keyword. -The platform searches assets for matches based on the keyword, including file title. - -### Filter by attributes - -With filtering by attributes, you can narrow search results to the following attributes: - -- language -- format -- file size -- orientation -- dimensions -- tags (this filter is available only when image assets have tags assigned to) -- date of creation - -To use it, in the right-side panel select attributes and click the **Apply** button. -You can combine searches by all types of filtering: keyword search and attributes filter. - -!!! note "Search engine support" - - Filtering works only when [[= product_name =]] uses `solr` or `elasticsearch` search engine. - Legacy Search Engine (LSE) isn't supported. - -### Navigation - -Assets are organized and stored in folders. The folder structure serves as another option for filtering assets. - -To navigate through folders, go to left-side panel **Folders**, and in the folders tree view, click folder you want to open. - -!!! note - - Filtering by attribues and folders is complimentary, it means you have to use these two methods at once to get search results. - -### Insert images - -To insert an image asset into the HTML editor, find the image with search options, or manually locate the asset in the folder. -Next, click the image thumbnail. -The selected item is marked with a red dot in the upper-left corner. -To confirm the selection, in the bottom toolbar, click **Insert**. - -You can only select one image at a time. -To deselect the image, click the thumbnail again. diff --git a/docs/image_management/browse_images.md b/docs/image_management/browse_images.md new file mode 100644 index 00000000..22ab086a --- /dev/null +++ b/docs/image_management/browse_images.md @@ -0,0 +1,64 @@ +--- +description: Browse, search, and filter image assets in the image library. +--- + +# Browse images + +The image library is a dedicated browser for the image assets that you store in the Media section of the content tree. +It opens whenever you select an existing image in the back office, for example, when you add an image asset to a content item, or when you [insert an image into a Rich Text field](create_edit_content_items.md#edit-rich-text-fields). +In the image library you can search, filter, and preview image assets before you insert them into content. + +## View modes + +The main window of the image library is available in two display versions: grid view and list view. +To change the view mode, in the upper-right corner, click **View** and select the view that you need. + +- **Grid view** - contains an image preview, file format, and image size +- **List view** - contains a thumbnail, title, format, size, dimensions, creation date, and update date + +![Grid view of image library](img/image_library.png) + +## Sort images + +You can sort image assets in alphabetical order or by the creation date. +To sort image assets, in the upper-right corner, click **Date** and select the sorting method that you need. + +## Search for images by keyword + +The search option allows you to find image assets with a word or phrase. +To use it, in the upper part of the screen, click the **Search** field and enter a search keyword. +The application searches the assets for matches based on the keyword, including the file title. + +## Filter images by attributes + +You can narrow down the search results by filtering on the following attributes: + +- language +- format +- file size +- orientation +- dimensions +- tags (this filter is available only when image assets have tags assigned to them) +- date of creation + +To use it, in the right-side panel, select the attributes and click **Apply**. +You can combine both search methods: keyword search and attribute filters. + +## Browse image folders + +Image assets are organized and stored in folders, so the folder structure serves as another option for filtering assets. +To navigate through the folders, go to the left-side panel **Folders**, and in the folder tree view, click the folder that you want to open. + +!!! note + + Filtering by attributes and browsing folders are complementary: the attribute filters narrow the results within the folder that you currently have open. + +## Insert images into content + +To insert an image asset, find the image with the search options, or manually locate the asset in the folder structure. +Next, click the image thumbnail. +The selected item is marked with a red dot in the upper-left corner. +To confirm the selection, in the bottom toolbar, click **Insert**. + +You can select only one image at a time. +To deselect the image, click the thumbnail again. diff --git a/docs/image_management/edit_images.md b/docs/image_management/edit_images.md index 5b36ac18..82b802c6 100644 --- a/docs/image_management/edit_images.md +++ b/docs/image_management/edit_images.md @@ -12,7 +12,7 @@ You can also edit the image itself with the Image Editor. The editing tools are available when you work in the back office of your application, for example, to: - browse the Media root folder of the content tree - - add an image or an image asset to a content item by selecting it from a Content browser or an Image picker + - add an image or an image asset to a content item by selecting it from the [image library](browse_images.md) - insert an image into a [Rich Text Field](create_edit_content_items.md#edit-rich-text-fields) ## Edit image asset @@ -38,7 +38,7 @@ Here, you can: ![Generate alternative text](img/alt_text_use_ai.png) - Change the keywords assigned to the image. -Tagging image assets helps keep the media library organized and enables searching images by tags in the DAM. +Tagging image assets helps keep the image library organized and enables [searching images by tags](browse_images.md#filter-images-by-attributes). ### Edit image in Image Editor diff --git a/docs/image_management/img/image_library.png b/docs/image_management/img/image_library.png new file mode 100644 index 00000000..9303c0e3 Binary files /dev/null and b/docs/image_management/img/image_library.png differ diff --git a/docs/image_management/upload_images.md b/docs/image_management/upload_images.md index 674a3ffc..af0a8763 100644 --- a/docs/image_management/upload_images.md +++ b/docs/image_management/upload_images.md @@ -42,7 +42,7 @@ You can also [create additional folders](content_tree.md#add-folders) and sub-fo 6\. To find images using tags, in the **Tags** field, enter keywords. -Tagging image assets helps keep the media library organized and enables searching images by tags in the DAM. +Tagging image assets helps keep the image library organized and enables [searching images by tags](browse_images.md#filter-images-by-attributes). 7\. Click **Publish**. @@ -74,7 +74,7 @@ To upload multiple images and create many image assets, you can use multi-file u ## Add translations -If you work with multiple languages and want to use searching by languages in DAM, you can add translations to image assets. +If you work with multiple languages and want to [filter images by language](browse_images.md#filter-images-by-attributes) in the image library, you can add translations to image assets. You can replace the contents of all the fields that have values in the base language, for example, the description, or the alternative text. To see how to add translations, go to [translate content section](translate_content.md). diff --git a/docs/persona_paths/author_content.md b/docs/persona_paths/author_content.md index e05a9bb1..32308c4e 100644 --- a/docs/persona_paths/author_content.md +++ b/docs/persona_paths/author_content.md @@ -13,6 +13,7 @@ Learn to add and modify various content items, so that you can then show them to "content_management/create_edit_pages", "content_management/work_with_forms", "content_management/translate_content", + "image_management/browse_images", "image_management/edit_images", "content_management/content_organization/copy_move_hide_content" ], style="path") =]] diff --git a/docs/product_catalog/work_with_product_assets.md b/docs/product_catalog/work_with_product_assets.md index e1d317c4..911d11fb 100644 --- a/docs/product_catalog/work_with_product_assets.md +++ b/docs/product_catalog/work_with_product_assets.md @@ -7,7 +7,7 @@ description: Add image assets to products or product variants. When you [create or edit products](create_edit_product.md), you can add assets in a form of images. Assets can be assigned to the base product, and to one or more of its [variants](work_with_product_variants.md). -To add assets to a product, in the product's **Assets** tab browse or drag and drop image files from disk, or select an existing image asset from library. +To add assets to a product, in the product's **Assets** tab browse or drag and drop image files from disk, or select an existing image asset from the [image library](browse_images.md). ![Adding assets to a product](img/product_assets.png "Adding assets to a product") diff --git a/mkdocs.yml b/mkdocs.yml index 56ef3b71..9b583130 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -81,6 +81,7 @@ nav: - Schedule publication: content_management/schedule_publishing.md - Image management: - Upload and store images: image_management/upload_images.md + - Browse images: image_management/browse_images.md - Edit images: image_management/edit_images.md - Search: - Search for content: search/search_for_content.md @@ -92,8 +93,6 @@ nav: - Recommendation blocks: recommendations/raptor_integration/raptor_recommendation_blocks.md - Data collection: - Qualifio integration: qualifio/qualifio.md - - DAM: - - Ibexa DAM: dam/ibexa_dam.md - Customer management: - Customer management: customer_management/customer_management.md - Customer Portal: customer_management/customer_portal.md @@ -158,7 +157,6 @@ extra: product_name_cdp_base: 'Raptor' product_name_connect: 'Ibexa Connect' product_name_cloud: 'Ibexa Cloud' - product_name_dam: 'Ibexa DAM' product_name_engage: 'Qualifio' pim_product_name: 'Quable' diff --git a/plugins.yml b/plugins.yml index 728843c7..ee305062 100644 --- a/plugins.yml +++ b/plugins.yml @@ -80,6 +80,7 @@ plugins: 'pim/work_with_product_categories.md': 'product_catalog/work_with_product_categories.md' 'pim/work_with_product_page_urls.md': 'product_catalog/work_with_product_page_urls.md' 'pim/work_with_product_variants.md': 'product_catalog/work_with_product_variants.md' + 'dam/ibexa_dam.md': 'image_management/browse_images.md' - llmstxt: preprocess: llmstxt_preprocess.py