Prints a listing of gift cards used by the visitor.

Description

By default, the tag does not print anything. The contents and markup to be printed are defined by using the helper attribute.

Syntax

{CartGiftCards(
    helper: string
)}

Scope

Required scope: globaali

Scope in helper attribute: gift-card

Tags with global scope can be used on any template and in any tag.

Implementing a gift card listing in a theme

Below you can see an implementation of a gift card listing in the default theme Barebones:

Barebones-teeman lahjakorttilistaus – helpers/full-cart.html
{CartGiftCards(
	helper: '{{
		<div class="FullCartSection FullCartTotal">
			{%CartPaidByGiftCard}: {GiftCardBalanceReserved}
		</div>
	}}',
	after: '
		{CartOpenTotal(
			before: '
				<div class="FullCartSection FullCartTotal">
					<span class="H4">{%CartOpenTotal}:&nbsp;',
			after: '</span></div>'
		)}',
	or: '
		{CartTotal(
			before: '<div class="FullCartSection FullCartTotal"><span class="H4">{%Total}:&nbsp;',
			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 helper attribute can be used in two ways:

  1. you can indicate the desired markup directly as the attribute's value, or
  2. 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 helper attribute.

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.'