Tulostaa yhden tai useamman banneriryhmän kaikki bannerit.

Kuvaus

Haluttu banneriryhmä voidaan valita joko ryhmän ID-numeron (aseta group-attribuutti) tai manuaalisesti asetetun koodinimen (aseta name-attribuutti) perusteella.

Jos haluat tulostaa useamman banneriryhmän bannerit, anna group- tai name-attribuuteilla kaikkien haluttujen ryhmien ID-numerot tai koodinimet putkimerkeillä eroteltuina.

Oletusarvoisesti jokaisen bannerin kohdalla tulostetaan {Banner}-tagin oletussisältö. Voit muotoilla tulostusta haluamaksesi käyttämällä bannerien tageja helper-attribuutissa.

Tutustu bannereihin käyttöoppaassa.

Syntaksi

{Banners(
    group: int,
    name: string,
    limit: int,
    sort: string,
    helper: string,
    classes: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Näkyvyyshelper-attribuutissa: banneri

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

Attribuutit

group:

Haluttujen banneriryhmien ID-numerot putkimerkeillä eroteltuina.

Sallitut arvot: putkimerkeillä eroteltu lista kokonaislukuja

Esim. group: 2 tai group: '2|4|7'

name:

Haluttujen banneriryhmien koodinimet putkimerkeillä eroteltuina.

Löydät koodinimet banneriryhmien tiedoista hallintatyökalussa.

Sallitut arvot: putkimerkeillä eroteltu lista merkkijonoja

Esim. name: 'etusivu' tai name: 'etusivu | tuoteryhmasivu'

limit:

Asettaa tulostuvan listan enimmäispituuden. Jos bannereita on enemmän kuin enimmäispituus sallii, tulostettavat bannerit määräytyvät sort-attribuutin perusteella.

Jos et aseta arvoa limit-attribuutilla, tulostetaan ryhmän kaikki bannerit.

Sallitut arvot: kokonaisluvut.

sort:

Määrittää bannerilistan lajitteluperusteet.

Sallitut arvot:

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.

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.

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.

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