Manage Placeholders

Placeholders are the most basic building blocks of our extension. They should be created before any Label is created.
Placeholder are designed to group labels by posotions and manage their appearance in the store.

All of them are located at Marketing -> Promotions -> Product Labels -> Manage Placeholders section. From there, you can edit, remove, or create a new Placeholder.

How to Create New Placeholder

Visit Marketing -> Promotions -> Product Labels -> Manage Placeholders and press the Add New button. You will be brought to the Creation Page, as shown on the screenshot.

This page contains only one section, General Information, which consists of the following fields:

• Title - a sensical title of placeholder.
• Identifier - The identifier (code) of placeholder that is used to display labels, bound to this placeholder at required positions.
• Is Active - indicates whether this placeholder is active, and the bound labels are eligible for display.
• Limit of Labels - The number of labels that should be displayed in placeholder. If number of labels assigned to the placeholder is higher than the limit (n) only first n labels will be displayed (sorted by labels' sort order). Leave this field empty or set 0 to disable limitation.
• Labels Direction - describes how labels should be organized in the placeholder of more than one label assignd to the placeholder:
  • Horizontal - labels are shown in a row (horizontally).
  • Vertical - labels are shown in a column (vertically).

• Position - allows choosing where labels should be displayed. This field has options for two types of positioning:

  • Automatically positioned * - options for positioning labels over the product image.

    Example

    The Position is calculated from two directions: vertical and horizontal (not related to Labels Direction).
    Vertical are:

    • Left
    • Center
    • Right

    Horizontal are:

    • Top
    • Middle
    • Bottom

    If you wish to position the label to the upper right corner, select Top Right option.
    Only one placeholder for each of these positions can be created.

  • Manually positioned - allows to position label wherever you like by putting code snippet in coresponding place in template file.
    This type of labels has only one option - Manual. You can create as many manually positioned placeholder as needed. The code snippet for this placeholder that should be inserted in template file will be generated after the placeholder will be saved. For additional information regarding manually positioned labels check Display Labels with manual position