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äkyvyyshelper-attribuutissa: tuote

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|34|5'

campaign:

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

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

Esim. campaign: '2|34|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: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äkyvyyden tuotteiden perusteella. Voit estää tämän attribuuttimäärityksellä fallback:false.

Esim. compatible_to: '1|34|2' tai 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: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ä.

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 tulostuvan listan enimmäispituuden.

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

Sallitut arvot: putkimerkein eroteltu lista kokonaislukuja.

Listan ensimmäinen kokonaisluku toimii oletusarvona {PaginationLimit}-tagin tuottamassa rajausvalikossa.

Esim. limit: '1|5|10'

prelimit:

Rajoittaa tulostuvan listan pituutta ennen sort-attribuutin mukaista 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ää tulostuvan listan merkkaustyypin.

Sallitut arvot:
  • 'normal': Jokainen listaelementti on oma div-elementtinsä. Listalla ei ole sisältävää elementtiä.
  • 'list': Lista tulostuu HTML-listana. Käyttämällä list_type-attribuuttia voit määrittää listan tyypin.
  • 'ids': Lista ei sisällä merkkausta, vaan tagi palauttaa ainoastaan tuotteiden ID-numerot putkimerkein eroteltuina merkkijonomuodossa.
list_type:

Määrittää, tulostuuko tuotelista järjestämättömänä vai järjestettynä (numeroituvana) listana.

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

Sallitut arvot:
  • 'ul': tuotelista tulostuu järjestämättömänä listana
  • 'ol': tuotelista tulostuu järjestettynä listana
list_classes:

Luokkanimet, jotka annetaan listan sisältävälle listaelementille (<ul> tai <ol>, riippuen list_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, joka määrittää tulostuksen merkkauksen ja sisällön.

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.

before/after:

before- ja after-attribuuteilla voit määrittää sisällön, joka tulostuu ennen tagin tuottamaa sisältöä tai sen jälkeen.

Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.

Esim.:

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

Mikäli tagi ei tuota mitään sisältöä, myöskään before- ja after-attribuuttien sisältö ei tulostu.

escape:

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

Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.

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