Adding a Catalog Item

To add a new item to the catalog, you need to click the "Plus" button in the table in the row of the catalog to which you want to add the new item.

After that, the catalog item creation page will open, consisting of the following tabs:

• "Product Description"
• "Categories"
• "Attributes"
• "Links and Cross-Selling"
• "Blocks"

1. Product Description

This tab contains a text input field where you need to enter the description of the catalog item.

2. Categories

The "Categories" tab contains a search bar

page

and a tree view

of pages

. This tab is needed to link the catalog item to

pages

. To establish a link, you need to select

pages

from the list of

pages.

Important to understand

A catalog item can only be linked to

pages

of type "Catalog".

3. Attributes

The "Attributes" tab contains three dropdown lists for selecting a "Template" for the product page and product preview and a "Set of Attributes". "Attributes" is a fundamental concept of Headless CMS OneEntry, which is described in detail in the following chapters.

After selecting the set of attributes, you need to fill in the values. In our case, these are:

• The attribute "product_title", which is of type "String". We will set the value to "Some example title";
• The attribute "product_desc", which is of type "String". We will set the value to "Some example description";
• The attribute "product_price", which is of type "Real". We will set the value to "5999.99";
• The attribute "product_date", which is of type "Date and Time". We will set the value to "5999.99";
• The image upload field "product_img". We will upload the OneEntry logo here. We also have the option to optimize the uploaded image by clicking on "Optimize uploaded images" and change the image parameters directly in Headless CMS OneEntry;

You can read about other types in the chapter "Attribute Types"

4. Links and Cross-Selling

For each catalog item, there is a "Links and Cross-Selling" tab where you can see the links between catalog products based on attribute values. The links themselves are established in the "Product Links" block, which is described in detail in the next section. To understand the purpose of the "Links and Cross-Selling" tab, we will have to touch on the topic of the "Product Links" block now.
Let's analyze the links with a specific example. We have a catalog of four items that contain the attribute "product_price":

1. For demo1, the value of the attribute "product_price" is "1001"
2. For demo2, the value of the attribute "product_price" is "1050"
3. For demo3, the value of the attribute "product_price" is "1090"
4. For demo4, the value of the attribute "product_price" is "700"

Now we move to the "Product Links" tab and create a link "product_link_by_price" there, in which we will set the condition for the attribute "product_price" to be greater than 1000. Three of our catalog items meet this condition:

1. demo1 with the attribute "product_price" value of 1001
2. demo2 with the attribute "product_price" value of 1050
3. demo3 with the attribute "product_price" value of 1090

Condition for the attribute "product_price"

demo4 does not meet the condition of "product_price" greater than 1000, as the value of the attribute "product_price" for this item is 700

Now, for the items in our catalog that meet the specified condition, links have been established, which are displayed on the "Links and Cross-Selling" tab. The tab itself is a list of catalog items that meet the condition.

5. Blocks

The "Blocks" tab contains a dropdown list for selecting blocks and a list of selected blocks. Blocks can be moved (sorted) using this button:

There is also an action column for each block:

Configure - opens the editing page for the selected block

Delete - removes the block from the blocks table

Blocks can also be added not separately for each catalog item, but at once for all items. To do this, you need to go to the "Pages" module, open the editing of the catalog for which you want to apply the same block, and in the "Blocks" tab in the dropdown list "Product blocks that are attached to all child products" select the desired block. After that, this block will be applied to all items in your catalog. Let's analyze a specific example for the catalog "demo_catalog"

We will discuss blocks in detail in the following chapters.