Tulostaa tuotteen ajantasaisen myyntihinnan.

Kuvaus

Myyntihintaan voi sisältyä kampanja-alennus. Tällöin alkuperäinen hinta on mahdollista tulostaa käyttämällä {ProductComparePrice}-tagia.

Jos listahintaan kohdistuu useita kampanjoita, myyntihinta määräytyy suurimman kampanja-alennuksen perusteella.

Mikäli tuotteella on variaatioita, joilla on omat hinnat, tagi tulostaa edullisimman variaation hinnan. Jos haluat tulostaa hintahaarukan (esim. 2–25 €), käytä {ProductPriceRange}-tagia.

Voit tulostaa tuotteen kaikki hinnat helposti käyttämällä {ProductPrices}-tagia.

Jos kävijällä on asetettuna URL-parametri variation_id (esim. ?variation_id=5), tagi tulostaa sen yksilöimän variaation hinnan. Kävijä asettaa variation_id ‑parametrin aina valitessaan variaation, mutta voit asettaa sen myös itse, jos haluat ennakkoon valita variaation linkittäessäsi tuotesivulle.

Syntaksi

{ProductPrice(
    currencysymbol: boolean,
    includetax: boolean,
    html: boolean,
    decimals: int,
    decimalsep: string,
    thousandssep: string,
    legend: boolean,
    price_format: string
)}

Näkyvyys

Toimii näkyvyydessä: tuote

Tagia on mahdollista käyttää myös {ProductVariations}-tagin helper-attribuutissa. Tällöin tagi tulostaa variaation hinnan.

Vaadittu näkyvyys on aina asetettu seuraavissa sivupohjissa:

Sivupohjat
Yksittäisen tuotteen sivupohja
Tuotekuvat

Attribuutit

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.

includetax:

Määrittää, tulostaako tagi hinnan arvonlisäverollisena.

Sallitut arvot: true/false. Oletusarvo true.

html:

Määrittää, tulostaako tagi sisällön ympärille oletusarvoisen HTML-merkkauksen.

Sallitut arvot: true/false. Oletusarvo false.

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: "" tai thousandssep: ''

legend:

Huomio! legend-attribuutti on käytössä vain, mikäli tagi tulostaa tuotteen edullisimman variaation hinnan.

Sallitut arvot: true/false. Oletusarvo true.

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