Prints the gift card's initial balance.

Kuvaus

The tag is used either before confirming the order (e.g. in the shopping cart or at checkout) or in the template for a printable PDF gift card.

If the visitor hasn't entered any gift card codes, the tag won't print anything.

The sum printed by the tag doesn't take into account the orders that have been paid for with the gift card.

To print the gift card's remaining balance, use the {GiftCardBalanceLeft} tag.

To print the gift card balance reserved for paying for the order, use the {GiftCardBalanceReserved} tag.

Syntaksi

{GiftCardBalance(
    html: boolean,
    exchanged: boolean,
    currencysymbol: boolean,
    decimals: int,
    decimalsep: string,
    thousandssep: string 
)}

Näkyvyys

Toimii näkyvyydessä: globaali

The tag is used in the {CartGiftCards} tag's helper attribute or in the gift card template.

The gift card template/themes/print/THEME/gift-card.html

Attribuutit

html:

Defines whether the content should be printed wrapped in the default HTML markup.

Allowed values:true/false

exchanged:

Defines whether to take currency conversion into account in the output if the customer has placed an order in a currency other than euro.

The exchanged attribute is used only if the Currency Converter extension is in use.

This attribute works only after the customer has placed an order. So, you can use the attribute in order templates and e.g. inside the order products' tags.

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

The content is always printed in euros if the value is false.

currencysymbol:

Defines whether the currency symbol should be printed along with the sum. The symbol to be printed is selected automatically based on the currency in use.

The exchanged attribute defines which currency symbol should be printed.

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

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

decimals:

Defines the number of decimal places to be printed (2 by default).

Allowed values:integers

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 jota halutaan käyttää desimaalierottimena (esim. desimaalipiste = decimalsep: '.'). Oletusarvo on pilkku.

thousandssep:

Defines the character used as a thousands separator.

The most commonly used thousands separators are space, comma and dot. You may want to define thousands separators according to the locale.

Allowed values: a character that should be used as the thousands separator in prices.

By default, the non-breaking space   is used.

after/before:

By using the after and before attributes you can define content that is output either after or before the tag's output.

Allowed values:The HTML and Interface markup

E.g.

  • before: '<p>Tämä merkkaus näkyy ennen tagin omaa sisältöä.</p>'
  • after: '<p>Tämä taas näkyy tagin oman sisällön jälkeen.</p>'

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

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:The HTML and Interface markup

E.g. or:'Sisältöä ei löytynyt.'