Skip to main content

Introduction

The "Blocks" module is for creating structures that contain sets of attributes. You can use it in whatever way suits your specific case. The core idea of the module is reusable entities (blocks) that contain sets of attributes and additional content.

For example, you can create a "footer" block and use it on all or screens of your project.

Main interface elements​

Finds blocks by name. Enter the block name in the search field and select the block from the dropdown list.

2. List of blocks​

Shows all created blocks. The table has 12 rows, one for each block type: Repeat Purchase Block, Similar products block, Cart Complement Block, Similar Products to Cart Block, Frequently ordered products block, Slider, Trending Products Block, Recently Viewed Block, Personal Recommendations Block, Common block, Product block, Similar Products to Wishlist Block. The button in a type's row expands the list of blocks created with that type.

By purpose, these types fall into groups (the interface doesn't group them):

Basic types:

Recommendation and dynamic types:

Choosing the type when you create a block

You select any of the types above in the Type field of the Create a new block form. Clicking Add creates a block of the selected type.

The table has three columns, but only two of them have headers:

  • Name
  • unique identifier by which the entity can be retrieved
  • the third column: row actions (no header)

The "Name" column shows the block type name and a button that expands the list of blocks of that type. Once expanded, the list shows the names of the blocks of that type. The "Marker" column shows each block's unique unique identifier by which the entity can be retrieved. The third column shows the actions available for each block:

Edit Edit: opens the block editing page

Information: opens a window with block details: the block id, creation date, and last modified date

Delete Delete: deletes the block

3. Help buttons for block types​

Each block type name in the table has a Help button next to it. Click it to see what the type is for and when to choose it, without opening the documentation. All 12 types have hints, and they appear in the language selected in the admin panel.

4. Block creation form​

The block creation form has three input fields:

  • Name: required, the block name;
  • Type: a dropdown list where you select the block type;
  • Marker: required, the block's unique unique identifier by which the entity can be retrieved (only Latin letters and the "_" and "-" characters are allowed);

5. Common tools for recommendation and dynamic blocks​

All settings screens of recommendation and dynamic blocks follow the same template and share these tools:

  • Audience Filter (opens in a new tab): a separate editor for the block's audience. You select the user attribute set and the attribute once for the whole filter, and each rule has its own condition, value, and categories.
  • Block preview (opens in a new tab): a window that previews the block's result, opened with the Open in modal button. It has the Basic tab (products the block will return), the Explanation tab (why each product was selected), and the Investigate tab (debugging diagnostics).
  • Help button: hints for settings. Each key setting of the block has a Help button next to it. Click it to open a detailed explanation with examples and recommendations. The hint opens on hover, and clicking the button toggles it: it closes an open hint and opens it again.
Help hint language

If the admin panel is set to Russian, all hints appear in Russian. If it's set to English, they appear in English.

Last updated on