Tulostaa listan tuoteryhmän myydyimmistä tuotteista.
Kuvaus
Oletusarvoisesti jokaisesta tuotteesta tulostetaan seuraavat tiedot:
Tämä tagi on pikakomento {Products}
-tagille. Voit
tulostaa saman sisällön {Products}
-tagin
oikeilla attribuuteilla.
Syntaksi
{CategoryTopSellers(
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
)}
Näkyvyys
Toimii näkyvyydessä: tuoteryhmä
Näkyvyys
Vaadittu näkyvyys on aina asetettu seuraavissa sivupohjissa:
Sivupohjat |
---|
Tuotelista |
Näyteikkuna |
Etusivu |
Attribuutit
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, joista 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 käyttö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äkyvyyden tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä
.fallback:
falseEsim.:
taisimilar_to:
'1 | 14 | 24'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äkyvyyden tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä
.fallback:
falseEsim.
taicompatible_to:
'1 | 34 | 2'compatible_to:
'cart' crosssales_for:
-
Määrittää tuotteet, joiden kanssa yhdessä ostettuja 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äkyvyyden tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä
.fallback:
falseEsim.
taicrosssales_for:
'1 | 2 | 3'crosssales_for:
'last_viewed' fallback:
-
Estää ristiinmyyntiattribuuttien oletusarvojen käyttämisen.
Katso myös tarkempi kuvaus ristiinmyyntiattribuuttien käyttämisestä.
Tämä attribuutti on käytössä vain silloin, kun
similar_to
-,compatible_to
- taicrosssales_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 merkkijonomuodossa.
- 'normal': Jokainen listaelementti on oma
list_type:
-
Määrittää tuotelistan merkkaustyypin.
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>
, riippuenlist_type
-attribuutin arvosta).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
- jabefore
-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.:
before:
'<p>Tämä merkkaus näytetään ennen tagin omaa sisältöä.</p>'after:
'<p>Tämä taas lisätään tagin oman sisällön jälkeen</p>'
after
- jabefore
-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.'