Voit käyttää komentoa näkymissä:
- Kaikissa näkymissä
Tagin attribuutit
Näyttää oletuksena banneriryhmän kaikki bannerit siinä järjestyksessä johon ne on hallintatyökalussa asetettu.
Banners tagi on erittäin hyödyllinen komento jolla voit tulostaa banneriryhmän kaikki bannerit kerralla tai pyörittää vaikka bannerirulettia, josta arvotaan kerralla yksi tai useampi banneri näytettäväksi Limit attribuuttia käyttämällä. Banners tagille voit myös asettaa Helper-attribuutin jonka avulla pääset muokkaamaan yksittäisen bannerin tulostusta vapaammin.
Bannereiden käyttöä ei ole rajattu pelkkiin kuvabannereihin, vaan hallintatyökalussa voi asettaa bannereille nimen lisäksi myös pidemmän tekstin. Tekstikentässä toimivat niin Textile-muotoilut ja HTML kuin toiset Interface tagitkin. Näillä työkaluilla on helppo tehdä monipuolisia sisäisiä mainoksia kauppaan.
Yksi hyödyllinen esimerkki siitä mitä bannereilla voit tehdä on etusivun kategoriakuvan korvaaminen usealla suurella ja näyttävällä bannerilla (mallibanneri kuvassa), joiden yhteyteen kaupan ylläpitäjä voi kirjoittaa myös banneriin liittyvää tekstiä ja tekstin sisältä linkittää vielä muille bannerin kannalta oleellisille sivuille. Useiden suurien bannereiden näyttämisen kerralla voisi hoitaa esimerkiksi jQueryllä ja SerialScroll-pluginilla.
Esimerkiksi seuraavalla komennolla etusivulle voisi tulostaa kolme banneria arvottuna käyttäen etusivubannerit.html tiedostoa helperinä {Banners(group:ID,limit:3,sort:'random',helper:'etusivubannerit')} jolloin kyseisen helper-tiedoston sisälle voisi tulostaa halutut tiedot komennoilla BannerImage,, BannerName, BannerText ja BannerURL.
Attribuutit:
Name
Tulostettavan bannerin nimi. Voidaan määrittää itse.
Link
Tulostetaanko linkki-tagi. Vaihtoehdot ovat true tai false
ImageSize
Kuvan kokoasetus. Joko 'mini','list','normal' tai 'big'.
Width
Kuvan leveys pikseleinä.
Height
Kuvan korkeus pikseleinä.
Limit
Kuinka monta banneria tulostetaan
Group
Banneriryhmän id, näet tämän hallintatyökalun kautta
Name
Tulostaa bannerit ryhmästä jonka koodinimi vastaa Name attribuutin arvoa.
Sort
Missä järjestyksessä bannerit haetaan. Vaihtoehdot ovat 'manual' (oletus), joka tulostaa hallinnassa olevan järjestyksen mukaan tai 'random' joka tulostaa bannerit satunnaisessa järjestyksessä.
Helper
Helper-tiedoston nimi, jos bannerit tulostetaan helperin kautta. Helperin kautta tulostamalla voit muotoilla html-lähdekoodin ja elementtien tulostamisjärjestyksen mieleiseksi.
Esimerkkejä:
Yksi satunnainen banneri ryhmästä 1
{Banners(group:1,sort:'random',limit:1)}
Kaikki bannerit ryhmästä 2
{Banners(group:2)}
Kaikki bannerit ryhmästä 3 koossa 250x250 pikseliä
{Banners(group:3,width:250,height:250)}