{Banners}

/Tagit/Bannerit/{Banners}

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.

Vihje:

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.

Huomautus:

Tutustu bannereihin ylläpitäjän oppaassa.

Syntaksi

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

Käyttöympäristö

Toimii näkymässä: globaali

Näkymä helper-attribuutissa: banneri

Vihje:

Globaalin näkymän 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 tulostettavalle listalle 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:

'manual': käytetään hallintatyökalussa asetettua järjestystä (oletusarvo)
'random': käytetään sattumanvaraista järjestystä

helper:

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

Sallitut arvot: Interface- ja HTML-merkkaus, joilla määritellään tulostuksen merkkaus ja sisältö.

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

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.

after: / before:

after- ja before-attribuuteilla voit määritellä sisällön, joka tulostetaan ennen ja/tai jälkeen tagin tulostaman sisällön.

Sallitut arvot: HTML- ja Interface-merkkaus

Esim.:

after: '<p>Tämä merkkaus näytetään ennen tagin omaa sisältöä.</p>'
before: '<p>Tämä taas lisätään tagin oman sisällön jälkeen</p>'

Huomautus:

after- ja before-attribuuttien sisältöä ei tulosteta, jos tagi itse ei tuota mitään sisältöä.

escape:

Asettaa tulostettavassa 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äytetään mikäli tagi ei itse tuota mitään sisältöä.