Tulostaa rekisteröitymislomakkeen, jolla asiakkaat voivat luoda käyttäjätilin verkkokauppaan.

Kuvaus

Sijoita tagi aina HTML-lomakkeen sisään. Lomakkeen käsittelyosoitteeksi voidaan asettaa kaksi eri arvoa:

  • /checkout/: Kun tilausta ei ole jätetty, ja asiakas on vielä kassalla
  • /account/register/: Kun tilaus on jo jätetty, eli useimmiten kassan kiitossivulla

Lähetä lomake palvelimelle POST-pyyntönä. Voit sijoittaa samaan lomakkeeseen useampia lomaketageja, jolloin ne käsitellään samalla pyynnöllä.

Tagin käyttäminen edellyttää, että asiakas on syöttänyt asiakastiedot, tai että ne lähetetään samalla pyynnöllä palvelimelle kuin rekisteröitymislomake.

Tagi tulostaa valintaruudun, jossa asiakas valitsee, haluaako luoda käyttäjätilin. Valintaruudun alle tulostetaan salasanakenttä. Jos asiakas ei rastita valintaruutua, salasanakentän arvoa ei huomioida.

Kassan kiitossivulla käyttäjätilin luonnin valintaruutua ei tulosteta. Asiakas voi luoda tilin suoraan syöttämällä salasanan.

Katso jäljempänä esimerkki rekisteröintilomakkeen lisäämisestä verkkokaupan eri sivuille.

Syntaksi

{CheckoutRegistrationForm}

Näkyvyys

Toimii näkyvyydessä: globaali

Toimii näkymässä: globaali

Globaalin näkyvyyden tageja on mahdollista käyttää missä tahansa sivupohjassa ja minkä tahansa tagin sisällä.

Tagia voidaan käyttää esimerkiksi kassan kiitossivulla, jolloin asiakas voi tilauksen jätettyään vielä luoda itselleen tilin verkkokauppaan.

Rekisteröintilomakkeen lisääminen eri verkkokaupan sivuille

{CheckoutRegistrationForm}-tagi tulostaa asiakkaiden rekisteröitymislomakkeen. Tagia voidaan periaatteessa käyttää millä tahansa verkkokaupan sivulla, mutta useimmiten se sijoitetaan jollekin kassasivulle, ostoskoriin tai tilauksen kiitossivulle.

Sijoita tagi aina HTML-lomakkeen sisään. Tämä lomake lähetetään POST-pyyntönä osoitteeseen /checkout/, jossa asiakkaan antamat tiedot käsitellään. Esimerkiksi seuraavasti:

<form action="/checkout/" method="post">
    {CheckoutBillingAddress(mode: 'form')}
    {CheckoutRegistrationForm}
    <button type="submit">{%Save}</button>
</form>

Esimerkissä rekisteröitymislomakkeen mukana lähetetään myös asiakastietolomake, jolloin molemmat lomakkeet käsitellään samassa osoitteessa samalla HTTP-pyynnöllä.

Voit liittää tällaisen lomakkeen mihin tahansa sivupohjaan tai esimerkiksi jonkin sisältösivun tai tuotteen sisältökenttään.

Attribuutit

after/before:

after- ja before-attribuuteilla voit määrittää sisällön, joka tulostuu ennen tagin tuottamaa sisältöä tai sen jälkeen.

Sallitut arvot: HTML- ja Interface-merkkaus.

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 after- ja before-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: HTML- ja Interface-merkkaus.

Esim. or: 'Sisältöä ei löytynyt.'