Prints a list of gift cards activated by a customer.
Kuvaus
The tag does not have default content. The content of the list depends on the helper attribute, which can use the following tags:
Syntaksi
{CartGiftCards(
helper: string
)}Näkyvyys
Toimii näkyvyydessä: globaali
Näkyvyys
It is possible to use global visibility tags in any page template and within any tag.
Implementing a gift card listing in a theme
Below is an example of how to implement a gift card listing. This can be placed, for example, in the theme’s helpers/full-cart.html file:
{CartGiftCards(
helper: '{{
<div class="FullCartSection FullCartTotal">
{%CartPaidByGiftCard}: {GiftCardBalanceReserved}
</div>
}}',
after: '
{CartOpenTotal(
before: '
<div class="FullCartSection FullCartTotal">
<span class="H4">{%CartOpenTotal}: ',
after: '</span></div>'
)}',
or: '
{CartTotal(
before: '<div class="FullCartSection FullCartTotal"><span class="H4">{%Total}: ',
after: '</span></div>'
)}'
)}The gift card listing itself is printed with the {CartGiftCards} tag.
The {GiftCardBalanceReserved} tag prints the sum paid with a gift card on the listing. After that the open balance is printed in the after attribute by using the {CartOpenTotal} tag.
If the customer hasn't used any gift cards, only the shopping cart total will be printed via the or attribute.
Attribuutit
helper:Defines the content and output format of a single list element.
Allowed values: the Interface and HTML markup that define the output's markup and content.
The
helperattribute can be used in two ways:- you can indicate the desired markup directly as the attribute's value, or
- you can indicate a reference to a file with the desired markup as the attribute's value. The reference should be indicated in relation to the theme's root directory.
See also detailed instructions on using the
helperattribute.before: / after:With these two 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
beforeandafterattributes will also not be displayed.escape:Adds escape characters to the content printed by the tag, making it easier to use the content in JavaScript code or JSON objects.
Sallitut arvot:- true: the attribute adds escape characters before quotation marks
- false: the attribute does nothing
- json: the attribute adds escape characters to the output, allowing the content to be used in JSON markup.
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.'
