{CategoryDiscountProducts}

/Tagit/Tuoteryhmät/{CategoryDiscountProducts}

Tulostaa listan tuoteryhmän alennustuotteista.

Kuvaus

Alennuksessa olevat tuotteet valitaan automaattisesti kaikista voimassa olevista kampanjoista. Listalle sisällytetään sekä määrä- että yksittäisalennetut tuotteet.

Oletusarvoisesti jokaisesta tuotteesta tulostetaan seuraavat tiedot:

Voit muokata tagin tulostusta määrittämällä haluamasi sisällön ja merkkauksen helper-attribuutissa.

Huomautus:

Tämä tagi on pikakomento {Products}-tagille. Voit tulostaa saman sisällön {Products}-tagin oikeilla attribuuteilla.

Syntaksi

{CategoryDiscountProducts(
    subcategories: boolean,
    brand: int,
    campaign: int,
    id: int,
    keyword: string,
    timelimit: string,
    similar_to: int / string,
    compatible_to: int / string,
    crosssales_for: int / string,
        fallback: boolean,
    limit: int,
    prelimit: 
    sort: string,
    pagination: boolean,
    type: string,
        list_type: string,
        list_classes: string,
    classes: string,
    helper: string
)}

Käyttöympäristö

Toimii näkymässä: tuoteryhmä

Näkymä helper-attribuutissa: tuote

Vaadittu näkymä on aina asetettu seuraavissa sivupohjissa:

Sivupohjat
Tuotelista – themes/shop/THEME/product-list.html
Näyteikkuna – themes/shop/THEME/category-front.html
Etusivu – themes/shop/THEME/homepage.html

Attribuutit

Huomautus:

Tagilla ovat käytössä lähes kaikki samat attribuutit kuin {Products}-tagilla. Seuraaville attribuuteille asetetaan ennalta oletusarvot:

category: NÄKYMÄN TUOTERYHMÄN ID
filters: 'discounted'
Voit käyttää myös omia arvojasi filters-attribuutilla, jolloin ne lisätään oletusarvon perään.
type: 'list'
limit: 10

type- ja limit-attribuuttien arvoja on mahdollista muuttaa.

subcategories:

Määrittää haetaanko tuotteita myös käsiteltävän tuoteryhmän aliryhmistä.

Sallitut arvot: true / false. Oletusarvo true.

brand:

Määrittää tuotemerkit, joiden tuotteet haetaan.

Sallitut arvot: putkimerkeillä erotellut tuotemerkkien ID-numerot. Arvolla 'ALL' tuotteet haetaan kaikista tuotemerkeistä.

Esim. brand: '2 | 234 | 5'

campaign:

Määrittää kampanjat, josta tuotteet haetaan.

Sallitut arvot: putkimerkeillä erotellut kampanjoiden ID-numerot. Arvolla 'ALL' tuotteet haetaan kaikista kampanjoista.

Esim. campaign: '2 | 234 | 5'

id:

Määrittää ID-numeroiden perusteella listalle haettavat tuotteet.

Sallitut arvot: putkimerkeillä erotetut tuotteiden ID-numerot

keyword:

Hakusanat, joiden perusteella tuotteet valikoidaan listalle.

Katso ylläpitäjän oppaasta kuvaus haun toimintaperiaatteesta.

Sallitut arvot: hakusanat välilyönneillä erotettuina

Esim. keyword: 'paidat housut Jamppa'

timelimit:

Asettaa aikavälin, jolta tuotteita haetaan listalle.

Sallitut arvot:

Päivät: '-n days'
Viikot: '-n weeks'
Kuukaudet: '-n months'

Esim. timelimit: '-3 months'

Arvolla 0 voit asettaa aikarajoituksen kokonaan pois päältä.

similar_to:

Määrittää tuotteet, joiden kanssa samankaltaisiksi merkittyjä tuotteita listalle halutaan hakea.

Sallitut arvot: putkimerkeillä erotetut tuotteiden ID-numerot tai jokin valmiista suodattimista:

'cart': valikoidaan ristiinmyynnit ostoskorissa olevien tuotteiden perusteella
'last_viewed': valikoidaan ristiinmyynnit asiakkaan viimeksi katsomien tuotteiden perusteella
'last_bought': valikoidaan ristiinmyynnit asiakkaan viimeksi ostamien tuotteiden perusteella (asiakkaan on oltava kirjautunut sisään)

Jos valmiit suodattimet eivät tuota tuloksia, attribuutti yrittää hakea ristiinmyyntejä näkymän tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä fallback: false.

Esim.: similar_to: '1 | 14 | 24' tai similar_to: 'cart'

compatible_to:

Määrittää tuotteet, joiden kanssa yhteensopivia tuotteita listalle halutaan hakea.

Sallitut arvot: putkimerkeillä erotetut tuotteiden ID-numerot tai jokin valmiista suodattimista:

'cart': valikoidaan ristiinmyynnit ostoskorissa olevien tuotteiden perusteella
'last_viewed': valikoidaan ristiinmyynnit asiakkaan viimeksi katsomien tuotteiden perusteella
'last_bought': valikoidaan ristiinmyynnit asiakkaan viimeksi ostamien tuotteiden perusteella (asiakkaan on oltava kirjautunut sisään)

Jos valmiit suodattimet eivät tuota tuloksia, attribuutti yrittää hakea ristiinmyyntejä näkymän tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä fallback: false.

Esim. compatible_to: '1 | 34 | 2' tai compatible_to: 'cart'

crosssales_for:

Valikoi ristiinmyyntituotteita asiakkaan ostohistorian perusteella.

Sallitut arvot: putkimerkeillä erotetut tuotteiden ID-numerot tai jokin valmiista suodattimista:

'cart': valikoidaan ristiinmyynnit ostoskorissa olevien tuotteiden perusteella
'last_viewed': valikoidaan ristiinmyynnit asiakkaan viimeksi katsomien tuotteiden perusteella
'last_bought': valikoidaan ristiinmyynnit asiakkaan viimeksi ostamien tuotteiden perusteella (asiakkaan on oltava kirjautunut sisään)

Jos valmiit suodattimet eivät tuota tuloksia, attribuutti yrittää hakea ristiinmyyntejä näkymän tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä fallback: false.

Esim. crosssales_for: '1 | 2 | 3' tai crosssales_for: 'last_viewed'

fallback:

Estää ristiinmyyntiattribuuttien oletusarvojen käyttämisen.

Katso myös tarkempi kuvaus ristiinmyyntiattribuuttien käyttämisestä.

Huomautus:

Tämä attribuutti on käytössä vain silloin, kun similar_to-, compatible_to- tai crosssales_for-attribuuteilla on arvo.

Sallitut arvot: true / false. Oletusarvo true.

limit:

Asettaa tulostettavalle listalle enimmäispituuden.

limit-attribuutin arvojen perusteella määrittyvät myös sivutustyökalujen rajausvaihtoehdot.

Sallitut arvot: putkimerkeillä erotettu lista kokonaislukuja.

Listan ensimmäistä arvoa käytetään oletusarvona {PaginationLimit}-tagin tuottamassa rajausvalikossa.

Esim. limit: '1 | 5 | 10'

prelimit:

Rajoittaa tulostettavan listan pituutta ennen sort-attribuutilla tehtävää sivutusta ja järjestelyä.

Attribuutin pääasiallinen käyttötapa on poimia ristiinmyynti- ja hakutuloslistoilta esim. 10 sopivinta ja tulostaa niistä rajattu määrä satunnaisia tuotteita.

Sallitut arvot: kokonaisluvut

sort:

Määrittää listan lajitteluperusteet. Attribuutin arvot määrittävät myös sivutuksen järjestelyvalikon saatavilla olevat arvot.

Sallitut arvot:

'search': hallintatyökalussa manuaalisesti määritetty järjestys
'last_sold': viimeksi myydyt tuotteet ensin
'name_asc': aakkosjärjestys nimien mukaan (A-Ö)
'name_desc': käänteinen aakkosjärjestys nimien mukaan (Ö-A)
'price_asc': hinnan mukaan nouseva järjestys
'price_desc': hinnan mukaan laskeva järjestys
'released_asc': uutuusjärjestys (vanhimmat ensin)
'released_desc': uutuusjärjestys (uusimmat ensin)
'random': satunnainen järjestys
'sales_asc': nouseva järjestys tuotteen myynnin mukaan
'sales_desc': laskeva järjestys tuotteen myynnin mukaan

Jos haluat asettaa useita järjestelyperusteita, erota arvot toisistaan putkimerkeillä.

Esim. sort: 'name_asc | name_desc | released_asc'

pagination:

Määrittää näytetäänkö sivutustyökalut.

Sallitut arvot: true / false. Oletusarvo false.

type:

Määrittää tulostettavan listan merkkaustyypin.

Sallitut arvot:

'normal': Jokainen listaelementti on oma div-elementtinsä. Listalla ei ole sisältävää elementtiä.
'list': Lista tulostetaan HTML-listana. list_type-attribuutin avulla voit määritellä listan tyypin.
'ids': Lista ei sisällä merkkausta, vaan tagi palauttaa ainoastaan tuotteiden ID-numerot putkimerkeillä erotettuina merkkijonomuosossa.

list_type:

Määrittää tuotelistan merkkaustyypin.

Huomautus:

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

Sallitut arvot: 'ul' tai 'ol'.

list_classes:

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

Huomautus:

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

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öä.

Sallitut arvot: HTML- ja Interface-merkkaus

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

Kuvaus

Syntaksi

Käyttöympäristö

Attribuutit

Aiheeseen liittyviä sivuja