ProductPositiveIndicators

https://github.com/magesuite/product-positive-indicators

This module adds product positive indicators in the form of badges. They help to stress the special advantages of a product and incentivize the customer to make a purchase. 

 

Installation

This module is a part of MageSuite metapackage

composer require "creativestyle/magesuite-product-positive-indicators" ^3.0.0

User guide

3.4.Positive Indicators

Admin settings

General settings for all kinds of indicators can be found under:

Stores > Configuration > MageSuite > Positive indicator

 

Only X available, buy now

 

Name

Default value

Note

Name

Default value

Note

is Enabled

No

 

Quantity

0

Display info on PDP if product qty is less than this value. This setting can be overwritten in category and product.

Popular icon

Name

Default value

Note

Name

Default value

Note

is Enabled

No

 

Product Listing Sort by

Preis

Possible options:

  • position

  • name

  • price

  • set product as new from date

  • bestseller

Product Listing Sort Direction

Descending

descending/ascending

Number of products

3

The number of products that will be marked as popular in the category.

Recently bought

Name

Default value

Note

Name

Default value

Note

is Enabled

No

 

Order Period

0

Specify the time from which orders should be taken, in days. E.g. set 7 if you want use orders from last 7 days. Can be overwritten in the product.

Minimal value

0

Specify the minimal amount of orders to show Recently Bought badge. Can be overwritten in the product.

Fast shipping

Name

Default value

Note

Name

Default value

Note

is Enabled

No

 

Working days

Monday-Friday

 

Holidays

 

Provide list of holidays, one date per line. Format: dd.mm.yyyy

Time to delivery today

16:00

Time to which the orders will be ship on the same day. E.g. 15:00

Logistics working hours

0

Set how long logistics works per day (in hours). E.g. 10

Order queue length

0

Set how many hours is already reserved. E.g. 5

Expected delivery

Name

Default value

Note

Name

Default value

Note

is Enabled

No

 

Default shipping time (in days)

Monday-Friday

 

Holidays

 

Provide list of holidays, one date per line. Format: dd.mm.yyyy

Time to ship today

16:00

Time to which the orders will be shipped on the same day. E.g. 15:00

Free shipping

 

Name

Default value

Note

Name

Default value

Note

Default shipping method

None

Choose the default shipping method for the free shipping threshold. If there are no options, set the free delivery threshold in the shipping methods configuration (Stores > Configuration > Sales > Shipping methods).

Show in product tiles

Yes

 

Show badge on Product's detailpage

Yes

 

Show in search autosuggest

yes

 

 

 

Configuration of badges per product

Every product can configure positive indicators under Positive indicators tab

Settings:

Name

Value

Comment

Name

Value

Comment

Only X Available Qty

 

Display info on PDP if product qty is less than this value. If value is 0 or null, this field will not be used.

Popular Icon

Yes/No

Product marked as popular.

Popular Icon Categories

IDs separated by comma

Categories IDs in which product is marked as popular. Updated by cron every night.

Recently Bought Badge

Yes/No

Product marked as recently bought.

Recently Bought: Order Period

number (days)

Specify the time from which orders should be taken, in days. E.g. set 7 if you want use orders from last 7 days.

Recently Bought: Minimal Value

 

Specify the minimal amount of orders to show Recently Bought badge.

Recently Bought: Ordered Sum

 

Sum of orders in specific order period.

Expected Delivery: Use Specific Shipping Time

Yes/No

Take into account specific time (in days) needed to ship product.

Expected Delivery: Specific Shipping Time

number (days)

Specific time (in days) needed to ship product.

Top attributes

Top attributes can be configured in Stores -> Attributes -> Product

For any attribute in Manage Top attributes tab, an attribute can be configured as the top.

Name

Default value

Note

Name

Default value

Note

Enabled

No

Yes/No

Sign

greater than

Sign from this field will be used as parser instruction for comparison.
If the selected sign is %, the minimum value of the top attribute will be calculated according to the formula: maxValue - x% * (maxValue - minValue).
In case the selected sign is % and attribute type is text, the minimum value of the top attribute will be calculated by the cron job at night.

Default value

"

The value from this field will be used by the parser. It will be used as default in case the value for story is empty.

Value for German

Value for German

The value from this field will be used by the parser for German

Value for German

Value for English

The value from this field will be used by the parser for English

Backend

BE part of this documentation should be added.

Frontend

Only X available, buy now

 

Popular icon

The Popular Indicator is a badge that highlights products that are the best performing taking into account a certain attribute in a given category.

Recently bought( buybox)

The Recently Bought Indicator is, similar to the Popular Indicator, a positive stressor that indicates the popularity of an item.

 

Fast shipping (buybox)

The Fast Shipping Indicator is a helpful visualization to highlight that the given item may be shipped today in case the customer does place the order within a specific amount of time. 

 

Expected delivery (buybox)

With the Expected Delivery Indicator the customer gets an information about the estimated shipping date.

 

Free shipping (tile, buybox)

The Free Shipping Indicator is a simple visualization or message that points out that free shipping will be applied on a given item.

 

Top attributes

 

Styling

Styling is provided in the following files:

  • theme-creativeshop/src/components/badge/mixin.scss

  • theme-creativeshop/src/components/autocomplete/autocomplete.scss

  • theme-creativeshop/src/components/product-tile/product-tile.scss

  • theme-creativeshop/src/pages/product/product.scss