Adding a catalog item
To add an item to a catalog, click the "Plus" button in that catalog's row in the table.
This opens the catalog item creation page, which has the following tabs:
- "Product Description"
- "Categories"
- "Attributes"
- "Cross-selling and upselling"
- "Blocks"
1. Product Description
This tab has the required "Header" field, where you enter the title (name) of the catalog item. Once the item is saved, a "Product status" dropdown also appears next to the title for selecting the item's status.
2. Categories
The "Categories" tab has a or screen search bar and a tree of or screens. Use this tab to link the catalog item to or screens: select the or screens in the or screens list.
A catalog item can be linked only to or screens of the "Catalog" type.
3. Attributes
Each catalog is linked to a specific attribute set for its items. If the catalog you are adding the item to has an attribute set selected for products, that set is already filled in under "Attribute Set" when you create the item. The "Attributes" tab has three dropdowns: the "Template" (opens in a new tab) for the product page, the template for the product preview, and the "Attribute Set" (opens in a new tab). "Attributes" are a core concept of OneEntry and are covered in detail in later chapters.
After you select the attribute set, fill in the values. In our example:
- The "product_title" attribute has the "String" type. We set its value to "Some example title".
- The "product_desc" attribute has the "String" type. We set its value to "Some example description".
- The "product_price" attribute has the "Real" type. We set its value to "5999.99".
- The "product_date" attribute has the "Date and Time" type. We set it to a date and time, such as the date the product goes on sale.
- "product_img" is an image upload field. We upload the OneEntry logo to it. You can also optimize the uploaded image by clicking "Optimize uploaded images" and change the image parameters directly in OneEntry.
Other types are described in the "Attribute Types" (opens in a new tab) chapter.
4. Cross-selling and upselling
Cross-selling and upselling links work within a single catalog.
Every catalog item has a "Cross-selling and upselling" tab that shows links between products in the catalog based on attribute values. The links themselves are set up in the "Product links" (opens in a new tab) block, described in detail in the next section. To explain what the "Cross-selling and upselling" tab is for, we need to touch on the "Product links" block here.
Here is an example. We have a catalog of four items with the "product_price" attribute:
- For demo1, "product_price" is "1001"
- For demo2, "product_price" is "1050"
- For demo3, "product_price" is "1090"
- For demo4, "product_price" is "700"
On the "Product links" (opens in a new tab) tab, we create a link named "product_link_by_price" with the condition "product_price" greater than 1000. Three of our catalog items meet this condition:
- demo1, with a "product_price" of 1001
- demo2, with a "product_price" of 1050
- demo3, with a "product_price" of 1090
demo4 does not meet the condition "product_price" greater than 1000, because its "product_price" is 700.
The catalog items that meet the condition are now linked, and the links appear on the "Cross-selling and upselling" tab. The tab is a list of the catalog items that meet the condition.
5. Blocks
The "Blocks" tab has a "Block selection" dropdown for choosing blocks and a list of the selected blocks. Below the dropdown, the "Managing blocks" link opens the "Blocks" module, where blocks are created. To move (sort) blocks, use this button:
Each block also has an actions column:
Configure: opens the editing page for the block
Delete: removes the block from the blocks table
You can also add a block to all items of a catalog at once instead of adding it to each item separately. In the "Pages" module, open the catalog for editing, go to the "Blocks" tab, and select the block in the "Product blocks that are attached to all child products" dropdown. The block is then applied to all items in the catalog. Here is an example for the "demo_catalog" catalog:
Blocks are covered in detail in later chapters (opens in a new tab).