Tulostaa summan, joka lahjakortilta on käytetty tilauksen maksamiseen.
Kuvaus
Tagi tulostaa sisältöä vain, mikäli asiakas on ottanut käyttöön lahjakortin.
Voit tulostaa lahjakortilla jäljellä olevan summan käyttämällä {GiftCardBalanceLeft}
-tagia.
Syntaksi
{GiftCardBalanceReserved(
html: boolean,
exchanged: boolean,
currencysymbol: boolean,
decimals: int,
decimalsep: string,
thousandssep: string
)}price_format
Lahjakorttilistauksen toteuttaminen teemassa
Alla esimerkki lahjakorttilistauksen toteutuksesta. Tämän voi sijoittaa esimerkiksi teeman helpers/full-cart.html-tiedostoon:
{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>'
)}'
)}
Lahjakorttilistaus itsessään tulostetaan {CartGiftCards}
-tagin avulla.
{GiftCardBalanceReserved}
-tagilla tulostetaan listaukseen lahjakortilla maksettu summa. Tämän jälkeen after
-attribuutissa tulostetaan avoin summa käyttämällä {CartOpenTotal}
-tagia.
Jos asiakas ei ole käyttänyt lahjakortteja, or
-attribuutin kautta tulostetaan pelkkä ostoskorin loppusumma.
Attribuutit
html:
Määrittää, tulostaako tagi sisällön ympärille oletusarvoisen HTML-merkkauksen.
Sallitut arvot: true/false
exchanged:
Määrittää, käyttääkö tagi valuuttamuunnosta, jos asiakas on jättänyt tilauksen jollain muulla valuutalla kuin eurolla.
exchanged
-attribuutti toimii vain, kun käytössä on Valuuttamuunnin-laajennus.Tämä attribuutti toimii vasta, kun asiakas on jättänyt tilauksen. Voit siis käyttää attribuuttia tilauksen sivupohjissa ja esimerkiksi tilaustuotteiden tagien sisällä.
Sallitut arvot: true/false. Oletusarvo false.
Arvolla false sisältö tulostuu aina euroina.
currencysymbol:
Määrittää, tulostaako tagi myös valuuttasymbolin. Symboli valikoituu käytössä olevan valuutan perusteella automaattisesti.
Sallitut arvot: true/false. Oletusarvo false.
Valuuttasymbolin voi tulostaa myös käyttämällä
{CurrencySymbol}
-tagia.decimals:
Määrittää desimaalien tulostustarkkuuden.
Sallitut arvot: kokonaisluvut. Oletusarvo 2 desimaalia.
decimalsep:
Määrittää desimaalierottimena toimivan merkin. Useimmiten desimaalierottimena on pilkku tai piste lokaalista riippuen.
Sallitut arvot: merkki, joka toimii desimaalierottimena (esim. desimaalipiste =decimalsep: '.'
). Oletusarvo pilkku.thousandssep:
Määrittää tuhaterottimena toimivan merkin.
Kansainvälisen yksikköjärjestelmän mukainen tuhaterotin on välilyönti, mutta eri maissa voi olla vanhastaan käytössä piste, pilkku tai heittomerkki. Tuhaterotin kannattaa valita kulloisenkin lokaalin mukaan.
Sallitut arvot: merkki, joka toimii tuhaterottimena. Oletusarvo on katkeamaton välilyönti
Jos haluat tuhaterottimeksi heittomerkin, kirjoita se kokolainausmerkkien väliin:
thousandssep: "'"
Jos et halua käyttää mitään tuhaterotinta, kirjoita attribuuttiin vain kaksi lainausmerkkiä tai kaksi heittomerkkiä peräkkäin:
thousandssep: ""
taithousandssep: ''
price_format:
Määrittää hintatiedon tulostusmuodon.
Sallitut arvot:- string (oletusarvo): Hintatieto tulostuu merkkijonona, jossa voi olla myös tagin muista attribuuteista riippuvia muotoiluja ja lisäyksiä (esim. valuuttasymboli).
- decimal: Hintatieto tulostuu desimaalilukuna (esim. 9.90), jota voi käyttää muun muassa JavaScript-koodissa.
Muut hinta-attribuutit eivät vaikuta tulostukseen, jos tämä arvo on käytössä.
before/after:
before
- jaafter
-attribuuteilla voit määrittää sisällön, joka tulostuu ennen tagin tuottamaa sisältöä tai sen jälkeen.Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.
Esim.:
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>'
Mikäli tagi ei tuota mitään sisältöä, myöskään
before
- jaafter
-attribuuttien sisältö ei tulostu.escape:
Asettaa tulostuvassa sisällössä pakomerkin ennen lainausmerkkejä. Attribuutin tarkoitus on helpottaa tagin palauttaman sisällön käyttämistä JavaScriptin avulla.
Sallitut arvot: true/false. Oletusarvo false.
or:
Määrittää vaihtoehtoisen sisällön, joka näkyy mikäli tagi ei itse tuota mitään sisältöä.
Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.
Esim.
or:
'Sisältöä ei löytynyt.'