Creating a Block of Similar Products

The second type of blocks in Platform OneEntry is the "Block of Similar Products." This block is designed for products that share common characteristics. For example, it can group all products within a specific price range.

The block supports two modes of operation:

• Manual — you set the filtering rules yourself (attribute, condition, value). All conditions are configured through the RulesBuilder.
• Automatic — the system automatically selects similar products based on matching values of the selected attributes with the current product. This is convenient for recommendations of "similar products."

1. Creating a Block

To create a block of the type "Block of Similar Products," you need to enter the block name in the Name field, select "Block of Similar Products" from the dropdown list in the "Type" field, and enter a unique

Marker

in the Marker field. After clicking the Add button, the block will appear in the blocks table under the "Block of Similar Products" category.

2. Editing a Block

To edit a block, you need to click the "Edit" button in the "Actions" column of the blocks table.

For blocks of the type "Block of Similar Products," three tabs are available during editing:

• Basic data
• Attributes
• Linked pages

Basic Data — Manual Mode

The "Basic Data" tab consists of the following forms:

1. Name - change the block's name

2. Marker - change the

   Marker
   of the block

3. Individual settings:

   • Quantity - change the number of items in the block (only integer values are allowed)
   • Sorting type of block items - you can sort either by date or by name
   • Sorting order of block items - three options: ascending, descending, and no sorting
   • Number of items per row - change the number of items in one row of the block (only integer values are allowed)

4. Add condition - allows you to add conditions for product search. It contains the following fields:

   • Attribute - a dropdown list that allows you to select an attribute from all created sets of product attributes for the search.
   • Condition - a dropdown list that allows you to select a condition for the search. Available filters:
   • contains
   • does not contain
   • equal to
   • not equal to
   • more
   • less
   • contains any value
   • does not contain a value
   • NaN
   • the same value as the selected attribute
   - Value - an input field where you need to enter the value for the search. For example, if you want to filter all items where product_price is greater than 1000, you need to set the following condition:

   

   • Categories - necessary for selecting
     pages
     of type "Catalog" for the search based on the specified condition. It contains an input field for quick search of
     pages
     and a list of all
     pages
     . If nothing is selected, the search will be conducted across all
     pages
     of type "Catalog."
   • Buttons - actions available in the "Add Condition" module:
     • Add - adds the condition
     • Reset - resets the parameters of the current condition
     • Reset all - resets the parameters of the current condition and removes previously created conditions for the current block
   💡Note

   To apply the condition, you need to click the Add button
   

   • Added conditions - a table containing previously added conditions. It consists of 6 columns:
     • Attribute
     • Condition
     • Value
     • Category
     • Content language code
     • Condition removal buttons
   • Found products - a table containing items that match the specified condition. Under each product in the preview, a label Matched by: Brand: ONE, Color: White is displayed — next to the value, the name of the attribute by which the match occurred is shown. This makes it clear that the block selected this product because it has the same brand (ONE) and the same color (White) as the original product.

ℹ️Scrolling the Category Tree

When working with a large category tree (Category tree) within the block, scrolling works correctly — hover the mouse over the list and scroll with the wheel. When you reach the top or bottom, the scroll smoothly transitions to the page. The tree automatically adjusts when expanding nested nodes.

Basic Data — Automatic Mode

In automatic mode, the system finds similar products based on matching values of the selected attributes with the current product. This differs from manual mode: in manual mode, you set the rules yourself (brand = X, price < Y), while here the system takes attribute values directly from the current product and selects "similar" ones.

In the header of the "Automatic (by attributes)" section, there is an icon ⓘ with a short hint — click it to open a full explanation of the mode.

Attributes for Comparison and Minimum Matches

After switching the Selection mode to Automatic (by attributes), two fields appear in the form:

• Attributes for comparison — a list of attributes based on which the system selects similar products. Values are taken from the selected set of attributes (field "Selecting a set of attributes").
• Minimum matches — the minimum number of matching attributes (an integer from 1 to the number of selected in "Attributes for comparison"). It controls the selection logic:
  • Minimum matches = number of selected attributes → the product will be included in the output only if all attributes match (logic "AND"). For example, brand = X AND color = Y.
  • Minimum matches = 1 → it is sufficient for at least one attribute to match (logic "OR"). Brand = X OR color = Y.

💡Value Selection Tip

For clothing/shoes, a low value (1) is usually suitable — otherwise, few products will be included in the selection. For strict filters (spare parts, compatibility), set Minimum matches equal to the number of selected attributes.

⚠️A Set of Attributes with Attributes is Required

The list "Attributes for comparison" is filled from the selected set of product attributes. Before configuring automatic mode, select a set in the "Selecting a set of attributes" field — otherwise, there will be nothing to choose from.

Additional Settings for Automatic Mode

In addition to the Attributes for comparison and Minimum matches fields, the following are available in automatic mode:

• Audience filter — a separate audience editor for whom to show the block. See Audience Filter.
• Open in modal — a button to open a preview modal with Basic and Investigate tabs. See Preview Modal.

Attributes

The "Attributes" tab contains two dropdown lists for selecting a Template and a Set of Attributes.

After selecting a set of attributes, you need to fill in the values. In our case, this is the attribute number, which has the type Integer. We will specify 44 as the value.

Linked Pages

The Linked Pages tab contains a search line for

pages

and a tree list of

pages

. This tab is needed to link the edited block with

pages

. To establish a link, you need to select

pages

from the list of

pages

. In the screenshot below, the block "new_block" is linked with the

pages

"catalog" and "we."