Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/content_management/create_edit_content_items.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<a name="relation_field"></a>
Expand Down Expand Up @@ -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.
Expand Down
86 changes: 0 additions & 86 deletions docs/dam/ibexa_dam.md

This file was deleted.

64 changes: 64 additions & 0 deletions docs/image_management/browse_images.md
Original file line number Diff line number Diff line change
@@ -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.

Check warning on line 14 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L14

[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.
Raw output
{"message": "[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 14, "column": 1}}}, "severity": "WARNING"}

- **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.

Check warning on line 24 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L24

[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.
Raw output
{"message": "[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 24, "column": 1}}}, "severity": "WARNING"}

## 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.

Check warning on line 29 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L29

[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.
Raw output
{"message": "[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 29, "column": 1}}}, "severity": "WARNING"}
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**.

Check warning on line 44 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L44

[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.
Raw output
{"message": "[Ibexa.OxfordComma] Use a comma before the last 'and' or 'or' in a list of four or more items.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 44, "column": 1}}}, "severity": "WARNING"}
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.

Check notice on line 49 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L49

[Ibexa.Passive] Try to avoid passive tense, when possible.
Raw output
{"message": "[Ibexa.Passive] Try to avoid passive tense, when possible.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 49, "column": 14}}}, "severity": "INFO"}
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.

Check notice on line 60 in docs/image_management/browse_images.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/image_management/browse_images.md#L60

[Ibexa.Passive] Try to avoid passive tense, when possible.
Raw output
{"message": "[Ibexa.Passive] Try to avoid passive tense, when possible.", "location": {"path": "docs/image_management/browse_images.md", "range": {"start": {"line": 60, "column": 19}}}, "severity": "INFO"}
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.
4 changes: 2 additions & 2 deletions docs/image_management/edit_images.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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

Expand Down
Binary file added docs/image_management/img/image_library.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/image_management/upload_images.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**.

Expand Down Expand Up @@ -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).
1 change: 1 addition & 0 deletions docs/persona_paths/author_content.md
Original file line number Diff line number Diff line change
Expand Up @@ -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") =]]
2 changes: 1 addition & 1 deletion docs/product_catalog/work_with_product_assets.md
Original file line number Diff line number Diff line change
Expand Up @@ -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")

Expand Down
4 changes: 1 addition & 3 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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'

Expand Down
1 change: 1 addition & 0 deletions plugins.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading