{ProductSet}

Tulostaa tuotelistan, jonka sisältöä ja merkkausta voi muokata hyvin joustavasti.

Kuvaus

{ProductSet}-tagi ei oletusarvoisesti tulosta mitään eikä ota arvoja vastaan osoiteriviltä, vaan tulostettavat tuotteet on valikoitava käyttäen soveltuvia attribuutteja (esim. categories).

Kun olet määrittänyt tulostettavat tuotteet, tagi tulostaa jokaisesta tuotteesta oletusarvoisesti seuraavat tiedot:

helper-attribuutin avulla voit korvata oletustiedot haluamillasi tiedoilla kustakin tuotteesta ja määrittää HTML-merkkauksen.

Useimmat tuotelistat ovat ennalta määritettyjä pikakomentoja {ProductSet}-tagille. Voit siis valita, käytätkö tietyntyyppisen tuotelistan valmiiksi rajattua tagia vai {ProductSet}-tagia, jonka tulostaman sisällön määrität itse asettamillasi attribuuteilla.

Syntaksi

{ProductSet(
    categories: int,
    category: int,
        subcategories: boolean,
    brand: int,
    campaign: int,
    id: int,
    keyword: string,
    filters: string,
    timelimit: string,
    similar_to: int,
    compatible_to: int,
    add_on_to: int,
    spare_part_to: int,
    crosssales_for: int,
        fallback: boolean,
    limit: int,
    prelimit: int,
    sort: string,
    pagination: boolean,
    type: string,
        list_type: string,
        list_classes: string,
    classes: string,
    helper: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Näkyvyyshelper-attribuutissa: tuote

Globaalin näkyvyyden tageja on mahdollista käyttää missä tahansa sivupohjassa ja minkä tahansa tagin sisällä.

Tuotenostojen tulostaminen piilotetuista tuoteryhmistä

Voit tulostaa {ProductSet}-tagin avulla tuotenostoja piilotetuista tuoteryhmistä. Tämä on hyödyllistä, jos haluat esitellä kaupassa valittuja tuotteita, mutta ne kuuluvat kaikki eri tuoteryhmiin tai -merkkeihin.

Luo uusi tuoteryhmä ja piilota se poistamalla valinta kaikkien versioiden kohdalta tuoteryhmän nimikentän alla.
Sijoita nostettavat tuotteet piilotettuun tuoteryhmään ja ota selaimen osoiteriviltä talteen tuoteryhmän ID.
Sijoita haluamaasi paikkaan teemassa {ProductSet}-tagi ja määritä tuoteryhmä tagin category-attribuuttia käyttäen.
Voit rajata listan sisältöä muidenkin kriteerien perusteella. Alla oleva esimerkki ottaa listalle vain tuoteryhmään 2 kuuluvat alennustuotteet, joita on varastossa.
```
{ProductSet(
    category: 2,
    filters: 'discounted|in_stock'
)}
```

Voit käyttää tuotenostojen toteuttamiseen myös mainostettavia tuotteita.

Tuotehakujen rajaaminen tuoteryhmittäin hakuoperaattorien avulla

{ProductSet}-tagin categories-attribuutti tarjoaa mahdollisuuden rajata tuotteiden hakua tuoteryhmittäin seuraavia operaattoreita käyttäen:

& = 'ja' (esim. 1&2 = tuotteet, jotka kuuluvat sekä ryhmään 1 että ryhmään 2)
| = 'tai' (esim. 1|2 = tuotteet, jotka kuuluvat ryhmään 1 tai ryhmään 2 tai molempiin)
! = 'ei' (esim. !1 = kaikki paitsi ryhmään 1 kuuluvat tuotteet tai 1!2 = ryhmän 1 tuotteet, jotka eivät kuulu ryhmään 2)
* = 'alaryhmät' (esim. 1* = tuotteet, jotka kuuluvat ryhmään 1 tai sen alaryhmiin).

Eri hakuoperaattoreita on mahdollista käyttää samassa hakulausekkeessa, ja sulkeiden avulla voi muodostaa myös alahakuja (esim. (1&2)|3 = tuotteet, jotka kuuluvat sekä ryhmään 1 että ryhmään 2 tai jotka kuuluvat ryhmään 3).

Attribuutit

categories:

Valikoi tuotteet tuoteryhmän mukaan. Tämä attribuutti on samantyyppinen kuin alla oleva category mutta tarjoaa monipuolisempia mahdollisuuksia tuotehaun rajaamiseen hakuoperaattorien avulla.

Sallitut arvot: tuoteryhmien ID-numerot, joiden kanssa voi käyttää hakuoperaattoreita.

category:

Valikoi tuotteet tuoteryhmän mukaan.

Sallitut arvot: tuoteryhmien ID-numerot.

Määrittääksesi useita tuoteryhmiä erota niiden ID-numerot toisistaan pystyviivoilla (esim. category: '2|34|5' kohdentaa haun tuotteisiin, jotka kuuluvat ainakin yhteen määritetyistä ryhmistä). Arvolla 'ALL' tuotehaku koskee kaikkia tuoteryhmiä.

subcategories:

Määrittää, kohdentuuko tuotehaku myös category-attribuutin määrittämien tuoteryhmien alaryhmiin.

Attribuutti on käytössä vain, mikäli category-attribuutilla on arvo.

Sallitut arvot: true/false. Oletusarvo true.

brand:

Valikoi tuotteet tuotemerkin mukaan.

Sallitut arvot: tuotemerkkien ID-numerot.

Määrittääksesi useita tuotemerkkejä erota niiden ID-numerot toisistaan pystyviivoilla (esim. brand: '2|34|5'). Arvolla 'ALL' tuotehaku koskee kaikkia tuotemerkkejä.

campaign:

Valikoi tuotteet kampanjan mukaan.

Sallitut arvot: kampanjoiden ID-numerot.

Määrittääksesi useita kampanjoita erota niiden ID-numerot toisistaan pystyviivoilla (esim. campaign: '2|34|5'). Arvolla 'ALL' tuotehaku koskee kaikkia kampanjoita.

id:

Valikoi tuotteet niiden ID-numeroiden perusteella.

Sallitut arvot: pystyviivoilla 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'

filters:

Asettaa valmiita suodattimia tagin tulostaman listan tuotteiden valikoimiseksi.

Sallitut arvot:

'discounted': alennustuotteet (tuotteet, jotka kuuluvat johonkin aktiiviseen alennuskampanjaan)
'regularly_priced': normaalihintaiset tuotteet
'featured': mainostettavat tuotteet (tuote merkitään mainostettavaksi tuotelomakkeen kohdassa Näkyvyys ja mainostus > Mainosta tuotetta)
'has_images': vain tuotteet joilla on tuotekuva
'preorder': ennakkotilattavat tuotteet (tuotteet, joiden rajoitettu saatavuusaika ei ole vielä alkanut)
'released': kaikki muut kuin ennakkotilattavat tuotteet viimeisen vuoden ajalta (timelimit-attribuuttia käyttämällä voit asettaa suodattimen hakemaan tuotteita valitsemaltasi ajanjaksolta)
'in_stock': varastossa olevat tuotteet
'out_of_stock': varastosta loppuneet tuotteet
'available': saatavilla olevat tuotteet
'unavailable': tuotteet, jotka ovat loppuneet varastosta ja joiden myyntiä ei jatketa
'navigable': tuote on navigoitavissa (tuote kuuluu johonkin tuoteryhmään, eikä mikään taso sen tuoteryhmähierarkiassa ole suljettu aktiivisessa kauppaversiossa)
'not_in_cart': tuotteet, joita ei ole ostoskorissa

Jos haluat käyttää useampaa suodatinta, erota arvot toisistaan pystyviivoilla, esim. filters: 'discounted|released'.

timelimit:

Asettaa aikavälin, johon listan tuotehaku kohdistuu.

Sallitut arvot:

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

Esim. timelimit: '-3 months'

Arvolla 0 voit asettaa aikarajoituksen kokonaan pois käytöstä.

similar_to:

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