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