Tulostaa aktiivisen tuoteryhmän tuotteista listan, jota voi käyttää myös tuotesuodattimien kanssa.

Kuvaus

Oletusarvoisesti tagi tulostaa jokaisesta tuotteesta seuraavat tiedot:

Voit helper-attribuuttia käyttäen korvata oletustiedot haluamillasi tuotetiedoilla ja määrittää HTML-merkkauksen.

Tagi ottaa arvoja vastaan myös osoiteriviltä, joten se on yhteensopiva esim. tuotesuodattimien kanssa.

{ProductSet}-tagi on korvannut {Products}-tagin käytön ennalta määrittämättömän listan tulostamiseen.

{Products}-tagi on vastedes rajattu tulostamaan aktiivisen tuoteryhmän tuotteet. Suurin osa tagin vanhoista attribuuteista on poistettu käytöstä.

Uuden {ProductSet}-tagin avulla voit laatia joustavan tuotelistan, jonka sisällön ja muotoilun määrität tarpeen mukaan attribuuteilla.

Syntaksi

{Products(
    type: string,
        list_type: string,
        list_classes: string,
    classes: string,
    helper: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Näkyvyyshelper-attribuutissa: tuote

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

Attribuutit

type:

Määrittää tulostuvan listan merkkaustyypin.

Sallitut arvot:
  • 'normal': Jokainen listan kohta on oma div-elementtinsä. Listalla ei ole ympäröivää elementtiä.
  • 'list': Lista tulostuu HTML-listana. Käyttämällä list_type-attribuuttia voit määrittää listan tyypin.
list_type:

Määrittää, tulostuuko tuotelista järjestämättömänä vai järjestettynä (numeroituvana) listana.

Attribuutti on käytössä vain silloin, kun type-attribuutilla on arvo 'list'.

Sallitut arvot:
  • 'ul': tuotelista tulostuu järjestämättömänä listana
  • 'ol': tuotelista tulostuu järjestettynä listana
list_classes:

Luokkanimet, jotka annetaan listan sisältävälle listaelementille (<ul> tai <ol>, riippuen list_type-attribuutin arvosta).

Attribuutti on käytössä vain silloin, kun type-attribuutilla on arvo 'list'.

Sallitut arvot: välilyönneillä erotetut luokkanimet merkkijonona.

Esim. list_classes: 'ekaLuokka tokaLuokka'

classes:

Luokkanimet, jotka annetaan jokaiselle listaelementille.

Sallitut arvot: luokkanimet merkkijonoina.

Erota samalle elementille annettavat luokat välilyönnillä. Erota putkimerkeillä luokat, jotka haluat antaa eri listaelementeille.

Esim. classes: 'ekaLuokka tokaLuokka | jokaToisenLuokka jokaToisenTokaLuokka'

Katso myös tarkemmat ohjeet listojen luokkanimien määrittelyyn.

helper:

Määrittää yksittäisen listaelementin sisällön ja tulostusmuodon.

Sallitut arvot: Teksti, jossa voi olla Interface- ja HTML-merkkausta.

helper-attribuuttia on mahdollista käyttää kahdella tavalla:

  • voit kirjoittaa halutun merkkauksen suoraan attribuutin arvoksi tai
  • voit antaa attribuutin arvoksi viittauksen tiedostoon, joka sisältää halutun merkkauksen. Anna viittaus suhteessa teeman juurihakemistoon.

Katso myös helper-attribuutin tarkemmat käyttöohjeet.

before: / after:

Näillä kahdella attribuutilla 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>'

Jos tagi ei tuota mitään sisältöä, myöskään before- ja after-attribuuttien sisältö ei tulostu.

between:

Määrittää sisällön, jonka tagi tulostaa jokaisen listaelementin väliin.

Attribuutti esimerkiksi mahdollistaa tuotelistan muotoilun JSON-objektiksi käyttämällä attribuutin arvona pilkkua.

Sallitut arvot: merkkijono ja/tai HTML/Interface-merkkaus
escape:

Lisää tagin tulostamaan sisältöön pakomerkit, jotta sisältöä on helpompi käyttää JavaScript-koodissa tai JSON-objekteissa.

Sallitut arvot:
  • true: attribuutti lisää pakomerkit ennen lainausmerkkejä
  • false: attribuutti ei tee mitään
  • json: attribuutti lisää tulostukseen pakomerkit, joiden avulla sisältöä voi käyttää JSON-merkkauksessa.
or:

Määrittää vaihtoehtoisen sisällön, joka näkyy, jos 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.'