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
2 changes: 1 addition & 1 deletion docs/commerce/commerce.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ edition: commerce
You can use them to create a unified and streamlined e-commerce platform.
Modules interact with each other, for example, to decrease stock following a sale, reduce prices when the cart reaches a certain value, or cancel shipments and payments when orders are cancelled.

The solution complements functionalities provided by the [PIM](products.md) offering, and allows you to sell products through the website.
The solution complements functionalities provided by the [product catalog](products.md) offering, and allows you to sell products through the website.
With Commerce, you can build your own storefront from a set of generic components, which you can then customize to cover all aspects of the e-commerce experience.

Out of the box, Commerce is configured to follow a specific workflow and support a certain number of processing method types, for example, flat rate, free shipping methods, and offline payment methods.
Expand Down
2 changes: 2 additions & 0 deletions docs/commerce/discounts/discounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,5 @@ The **Discounts** module interacts with other parts of the system, so that store
- in the product catalog, see base prices of products together with prices reduced according to active catalog discounts
- in the cart, see prices reduced according to catalog and/or cart discounts, apply discount codes, and observe as prices change when various cart discount conditions are met
- at checkout, see a total value of all applied discounts and prices reduced as a result of those discounts

For more information about discounts, see [Work with discounts](work_with_discounts.md).
2 changes: 1 addition & 1 deletion docs/commerce/discounts/work_with_discounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ If your store supports multiple languages and you want different discount names

## Create new discount

When you create discounts, you must first decide whether they apply to all [products](../../pim/products.md) from the catalog, or the products that the customer has put into their cart.
When you create discounts, you must first decide whether they apply to all [products](../../product_catalog/products.md) from the catalog, or the products that the customer has put into their cart.
You are then taken through a series of steps, where you define the discount, for example, decide if it applies to selected [customer groups]([[= developer_doc =]]/users/customer_groups/) and specific products.
Cart discount applicability can be further limited by setting a number of conditions, such as:

Expand Down
90 changes: 52 additions & 38 deletions docs/content_management/block_reference.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
description: Pick from a list of dynamic page blocks to create landing pages.
edition: experience
month_change: true
---

# Block reference
Expand All @@ -22,20 +23,21 @@
|[Form](#form-block)|Embeds a Form content item that you select from the content structure. |
|[Gallery](#gallery-block)|Displays all images contained in a selected folder. |
|[[[= product_name_connect =]]](#ibexa-connect-block)|Retrieves and displays data from an [[= product_name_connect =]] webhook. |
|[Last purchased](#last-purchased-block)|Displays a list of products that were recently purchased from PIM. |
|[Last viewed](#last-viewed-block)|Displays a list of products from PIM that were recently viewed. |
|[Last purchased](#last-purchased-block)|Displays a list of products that were recently purchased from the product catalog. |
|[Last viewed](#last-viewed-block)|Displays a list of products from the product catalog that were recently viewed. |
|[Orders](#orders-block)|Displays a list of orders associated with a particular company or individual customer. |
|[Personalized](#personalized-block)|Displays a list of content items/products that are recommended to end users when specific scenarios are triggered. |
|[Product collection](#product-collection-block)|Displays a list of specifically selected products.|
|[Recently added](#recently-added-block)|Displays a list of products that were recently added to PIM. |
|[Product embed](#product-embed)|Displays a specific product.|
|[Recently added](#recently-added-block)|Displays a list of products that were recently added to the product catalog. |
|[RSS](#rss-block)|Loads and displays news from RSS feeds (channels). |
|[Sales representative](#sales-representative)|Loads and displays company's sales representative.|
|[SeenThis!](#seenthis-block)|Displays video with exceeded standard video restrictions of 3.5MB.|
|[Targeting](#targeting-block)|Embeds an content item based on the [segment](content_organization/classify_content.md#segments) the user belongs to. |
|[Text](#text-block)|Enables you to add to the page a Rich Text block. |
|[Video](#video-block)|Embeds a video into the page with standard playback controls. |

[[= include_file('docs/content_management/create_edit_pages.md', 86, 96) =]]
[[= include_file('docs/content_management/create_edit_pages.md', 85, 96) =]]

## Block basics

Expand Down Expand Up @@ -66,7 +68,9 @@

In the block configuration, on the **Scheduler** tab, you can set a date for the block to be revealed or hidden.

## Banner block
## Standard blocks

### Banner block

The banner block showcases an image linked to a specific URL.
It can be used for creating visually appealing banners or promotional sections on websites that require linked images to direct users to specific pages or content.
Expand All @@ -76,7 +80,7 @@
- **Image** — Click **Select content**, browse the available content, and choose an image for display.
- **URL** — Enter a URL that opens when users click on the banner block.

## Bestsellers block
### Bestsellers block

Displays products that were recently top sellers, to help users discover popular items quickly.
On the **Properties** tab, set values in the following fields:
Expand All @@ -88,20 +92,20 @@

On the **Design** tab, in the **View** field, select the layout to be used to present a list of products and submit your changes.

## Campaign block
### Campaign block

Displays a campaign created and configured in [[[= product_name_engage =]]](../ibexa_engage/ibexa_engage.md).
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the campaign.
- **Campaign** – Select a campaign that you want to display on the page. The list contains only those campaigns from your Qualifio account, which are active or scheduled to launch in the future.

## Catalog block
### Catalog block

Shows products from a chosen catalog tailored for a particular group of customers, ensuring a personalized browsing experience.

Before you configure this block, make sure that there are [catalogs](work_with_catalogs.md) that are defined
and published in your PIM.
and published in your product catalog.
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the page block.
Expand All @@ -111,15 +115,15 @@

On the **Design** tab, in the **View** field, select the layout to be used to present a list of products and submit your changes.

## Code block
### Code block

Enables you to use custom HTML to add customized text, links, images, and more to your page.
On the **Properties** tab, set values in the following fields:

- **Name** — Enter a name for the page block.
- **Content** — Enter the HTML code for the content you want to display.

## Collection block
### Collection block

Displays a collection of content items manually selected from the content structure, allowing you to feature specific content for promotional campaigns or highlight essential information on your website.
On the **Properties** tab, set values in the following fields:
Expand All @@ -130,7 +134,7 @@
All selected content items appear in the **Selected items** box at the bottom of the window.
When done selecting, click **Confirm**.

## Content List block
### Content List block

Check notice on line 137 in docs/content_management/block_reference.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/block_reference.md#L137

[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings
Raw output
{"message": "[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings", "location": {"path": "docs/content_management/block_reference.md", "range": {"start": {"line": 137, "column": 5}}}, "severity": "INFO"}

Displays content items of specified content type from a selected folder, simplifying access to categorized information or targeted content presentation on your site.
On the **Properties** tab, set values in the following fields:
Expand All @@ -140,7 +144,7 @@
- **Limit** — Set the number of products to be displayed.
- **Content types to be displayed** — Select content type(s) to be displayed.

## Dynamic targeting block
### Dynamic targeting block

Dynamic targeting block provides recommended items based on users related to the configured segments.

Expand All @@ -156,15 +160,15 @@

![Dynamic targeting](img/page_builder_dynamic_targeting.png)

## Embed block
### Embed block

Place any content item directly on the page. This function works across all content types seamlessly.
On the **Properties** tab, set values in the following fields:

- **Name** — Enter a name for the page block.
- **Content** — Click **Select content**, browse the content, and select a content item.

## Form block
### Form block

Place a selected form from the content structure onto the page.
Integrate specific forms into your content to enhance client interaction.
Expand All @@ -181,7 +185,7 @@

For more information about creating form blocks, see [Creating a newsletter form]([[= developer_doc =]]/content_management/pages/create_custom_page_block/) in Developer Documentation.

## Gallery block
### Gallery block

Presents a comprehensive visual array by displaying all images from your selected folder.
On the **Properties** tab, set values in the following fields:
Expand All @@ -192,9 +196,10 @@
After submitting the settings, all images in the folder are shown in the Gallery block.
Selecting a folder containing content items other than images results in displaying only a link to the folder where they're stored.

## [[= product_name_connect =]] block
### [[= product_name_connect =]] block

Access and showcase data retrieved from an [[= product_name_connect =]] webhook. Streamline information presentation for seamless insights and improved decision-making.
Access and showcase data retrieved from an [[= product_name_connect =]] webhook.
Streamline information presentation for seamless insights and improved decision-making.
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the page block.
Expand All @@ -204,20 +209,20 @@

For more information about using [[= product_name_connect =]] scenario block, see [[[= product_name_connect =]] scenario block]([[= developer_doc =]]/content_management/pages/ibexa_connect_scenario_block/) in Developer Documentation.

## Last purchased block
### Last purchased block

Showcases a list of recently purchased products from PIM.
Showcases a list of recently purchased products from the product catalog.
Helps keep track of recent sales and improve product visibility.
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the page block.
- **Personalization scenario** – Select "Last purchased" to display products that were recently purchased from PIM by any user, or "Last purchased by user" to display products that were recently purchased by the current user.
- **Personalization scenario** – Select "Last purchased" to display products that were recently purchased from the product catalog by any user, or "Last purchased by user" to display products that were recently purchased by the current user.
- **Product Types to be displayed** – Select the type of products to be displayed on the list.
- **Limit** – Set the number of products to be displayed.

## Last viewed block
### Last viewed block

Showcases a list of recently viewed products from PIM.
Showcases a list of recently viewed products from the product catalog.
Helps track and show recent product interests for quick access and informed decisions.
On the **Properties** tab, set values in the following fields:

Expand All @@ -226,7 +231,7 @@
- **Product Types to be displayed** – Select the type of products to be displayed on the list.
- **Limit** – Set the number of products to be displayed.

## Orders block
### Orders block

Showcases a list of orders linked to a specific company or individual customer.
Helps track purchase history for streamlined customer service and personalized interactions.
Expand All @@ -238,7 +243,7 @@
- **Number of orders** — Set the number of orders to be displayed.
- **Sort order** — Set the sort order for the displayed orders.

## Personalized block
### Personalized block

Showcases recommended content items or products triggered by specific scenarios for end users.
Enhances user experience by suggesting tailored options for various situations.
Expand All @@ -251,30 +256,34 @@

On the **Design** tab, in the **View** field, change the layout to "Products" and submit your changes.

## Product collection block
### Product collection block

Presents curated collections of items for easier exploration and discovery.
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the page block.
- **Product list** — Create a list of products. Enter a comma-separated list of product/variant codes and click **Add** or click **Select product**. Then, in content browser, select products, and click **Confirm**.
- **Product list** — Create a list of products. Either enter a comma-separated list of product codes and click **Add**, or click **Select products**, select products, and click **Confirm**.

!!! note
## Product embed

Due to a technical limitation, content browser doesn't display product variants.
Presents a single product, allowing you to highlight its key features.
On the **Properties** tab, set values in the following fields:

## Recently added block
- **Name** – Enter a name for the page block.
- **Product code** — Enter the product code and click **Add** or click **Select products**. Then, select a single product, and click **Confirm**.

Highlights recently added products from PIM.
### Recently added block

Highlights recently added products from the product catalog.
Quickly informs users about new additions for quicker distribution and popularizing added products.
On the **Properties** tab, set values in the following fields:

- **Name** – Enter a name for the page block.
- **Personalization Scenario** – Select "Recently added items" to display products that were recently added to PIM.
- **Personalization Scenario** – Select "Recently added items" to display products that were recently added to the product catalog.
- **Product Types to be displayed** – Select the type of products to be displayed on the list.
- **Limit** – Set the number of products to be displayed.

## RSS block
### RSS block

Check notice on line 286 in docs/content_management/block_reference.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/block_reference.md#L286

[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings
Raw output
{"message": "[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings", "location": {"path": "docs/content_management/block_reference.md", "range": {"start": {"line": 286, "column": 5}}}, "severity": "INFO"}

Imports and showcases news content from RSS feeds (channels), helping users stay informed with the latest updates and diverse news sources.
On the **Properties** tab, set values in the following fields:
Expand All @@ -284,7 +293,7 @@
- **Limit** — Set the number of news items to be displayed.
- **Offset** — Set the limit of featured news items to be displayed.

## Sales representative
### Sales representative

Imports and showcases sales representatives for the company in the Customer Portal.
Gives users a way to connect with the team that handles their sales needs.
Expand All @@ -294,7 +303,7 @@

On the **Design** tab, in the **View** field, select the layout to be used to present the Sales representative's details view and submit your changes.

## SeenThis! block
### SeenThis! block

Check notice on line 306 in docs/content_management/block_reference.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/content_management/block_reference.md#L306

[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings
Raw output
{"message": "[Ibexa.SentenceCapitalizationInHeadings] Use sentence-style capitalization in headings", "location": {"path": "docs/content_management/block_reference.md", "range": {"start": {"line": 306, "column": 5}}}, "severity": "INFO"}

Integration with [SeenThis!](https://seenthis.co/) service. SeenThis! block provides an adaptive streaming technology with no limitations as conventional streaming service. It allows to preserve the best video quality with minimum amount of data transfer.

Expand All @@ -320,7 +329,7 @@

SeenThis! technology might be blocked by some ad blocker solutions. If you can't see the block once configured, check the ad blocker configuration.

## Targeting block
### Targeting block

Targeting block provides recommendation of content based on users related to the configured segments.

Expand All @@ -336,7 +345,7 @@

![Previewing page for a given segment](img/page_builder_segment_preview.png)

## Text block
### Text block

Adds a Rich Text block to the page.
On the **Properties** tab, set values in the following fields:
Expand All @@ -352,7 +361,7 @@

For more information, see [AI Assistant](create_edit_content_items.md#ai-assistant).

## Video block
### Video block

Integrates a video into the page with standard playback controls.
Helps enhance content variety and captivate audiences with seamless video viewing.
Expand All @@ -362,3 +371,8 @@
- **Video** — Click **Select content**, browse the content, and select a video to display in the block.

On the **Properties** tab you can preview the selected video before adding it to the page.

## Recommendation blocks

One of the elements of the Raptor integration is the addition of recommendation blocks.
For more information, see [Recommendation blocks](raptor_recommendation_blocks.md).
14 changes: 12 additions & 2 deletions docs/content_management/create_edit_content_items.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
description: Create content for your website with different fields, rich text, tags, and then publish it.
month_change: true
---

# Create and edit content items
Expand Down Expand Up @@ -110,6 +111,7 @@ To do it, choose one of the available elements:
- Ordered list
- Table
- Embed
- Embed product
- Image
- YouTube
- X
Expand Down Expand Up @@ -149,9 +151,17 @@ This option is also available when you want to set up a [relation](configure_ct_

![Edit embedded content item - set up a relation](img/edit_embedded_items_relation.png "Edit embedded content item - set up a relation")

#### Distraction free mode
#### Embed products

You can embed [products](products.md) from the product catalog directly inside a Rich Text field.
Use this feature when building landing pages or articles that reference specific products, for example, a blog post that highlights a new product launch.

Two embed styles are available:

While editing Rich Text fields, you can switch to distraction free mode.
- **Embed** embeds a product as a standalone element between paragraphs.
- **Inline embed** embeds a product within a sentence or paragraph.

#### Distraction free mode

Distraction free mode expands the workspace to full screen and shows only editor toolbar.
It's helpful when you need to work with longer texts that take more space and when you want to focus your attention on editing text.
Expand Down
Loading
Loading