Prints the amount of money a loyalty program member still needs to spend on the online store's products to reach the reward tier.

Kuvaus

The tag works in the loyalty program reward tier listing created with the {LoyaltyProgramDiscountTiers} tag.

The tag will print the amount required for the reward tier only if the customer has not yet reached that reward tier. However, you can use the or attribute to specify alternative content for the tag, which will be printed at the customer's current and lower reward tiers.

The tag calculates the value based on the correct point balance of a loyal customer, provided that the customer is logged into the online store. Otherwise, the default point balance is zero.

To avoid confusing customers when the value changes after login, you can use the {Helper} tag with the case: 'CustomerNotLogged' attribute to define different content for non-logged-in visitors.

Also read:

Syntaksi

{LoyaltyProgramDiscountTierPurchasesNeeded( includetax: boolean, price_format: string, currencysymbol: boolean, decimals: int, decimalsep: string, thousandssep: string, price_format: string )}

Näkyvyys

Toimii näkyvyydessä: loyalty-program-discount-tier

The tag is used only in the {LoyaltyProgramDiscountTiers} tag's helper attribute.

Attribuutit

includetax:

Determines whether the tag prints the price including VAT.

Allowed values: true/false. Default value: true.

price_format:

Determines the price information display format.

Sallitut arvot:
  • string (default): The price information is printed as a string, which may also include formatting and additions dependent on other attributes of the tag (e.g., currency symbol).
  • decimal: The price information is printed as a decimal number using a decimal point (e.g., 9.90), which works in, among other things, JavaScript code.

    If price_format: 'decimal' is in use, other price information formatting attributes do not affect the tag's output.

currencysymbol:

Determines whether the tag also prints the currency symbol. The symbol is automatically determined based on the currency in use.

Allowed values: true/false. The default value is false.

The currency symbol can also be printed using the {CurrencySymbol} tag.

decimals:

Sets the precision for printing decimals.

Allowed values: integers. Default value 2 decimal places.

decimalsep:

Defines the decimal separator character. The most popular decimal separators are comma and dot, the use of which depends on the store's locale.

Sallitut arvot: merkki, joka toimii desimaalierottimena (esim. desimaalipiste = decimalsep: '.'). Oletusarvo pilkku.
thousandssep:

Specifies the character used as the thousands separator.

According to the International System of Units, the thousand separator is a space, but in different countries, a period, comma, or apostrophe may traditionally be used. You may want to define thousands separators according to the locale.

Allowed values: a symbol that functions as a thousands separator. The default is a non-breaking space  

If you want to use an apostrophe as the thousands separator, write it between double quotes: thousandssep: "'"

If you do not want to use any thousands separator, just write two quotation marks or two apostrophes in a row in the attribute: thousandssep: "" or thousandssep: ''

before/after:

With the before and after attributes, you can define content that is output before or after the content produced by the tag.

Allowed values: text that may contain HTML and Interface markup.

E.g.

  • before: '<p>This markup appears before the tag's own content.</p>'.
  • after: '<p>This appears after the tag's own content.</p>'

If the tag does not produce any content, the content of the before and after attributes will also not be displayed.

escape:

Adds an escape character before quotation marks in the output. The attribute makes it easier to process the tag-produced content when using JavaScript.

Allowed values: true/false. The default value is false.

or:

Defines alternative content that is displayed if the tag itself does not produce any content.

Allowed values: text that may contain HTML and Interface markup.

E.g. or:'Content not found.'