{Products}

Tulostaa tuotelistan, jonka sisältöä ja merkkausta on mahdollista muokata erittäin joustavasti.

Kuvaus

Oletusarvoisesti jokaisesta tuotteesta tulostetaan seuraavat tiedot:

Kun {Products}-tagia käytetään tuoteryhmän, tuotemerkin tai kampanjan sivulla, tagi tulostaa automaattisesti kaikki kyseisen kategorian tuotteet.

Useimmat tuotelistat ovat pikakomentoja {Products}-tagille. Voit siis tulostaa useimpien sisällön käyttämällä tätä tagia.

Kun teeman asetuksissa on käytössä <ProductListFilters supported="true" /> -asetus, {Products}-tagin toiminta muuttuu osittain.

Syntaksi

{Products(
    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 {Products}-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 talteen tuoteryhmän ID selaimen osoiteriviltä.
Sijoita haluamaasi paikkaan teemassa {Products}-tagi, jolle annat ID:n category-attribuutissa.
Voit myös rajata listan sisältöä muiden kriteerien perusteella. Esimerkiksi alla otetaan listalle vain alennustuotteet, joita on varastossa.
```
{Products(
    category: 2,
    filters: 'discounted|in_stock'
)}
```

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

Attribuutit

Kun tuotesuodattimet ovat käytössä verkkokaupassa, {Products}-tagilta poistuu käytöstä useita attribuutteja, joilla hallitaan listan sisältöä.

Tuotesuodattimien ollessa käytössä {Products}-tagilla ovat käytössä vain seuraavat muotoiluattribuutit:

type
list_type
list_classes
classes
helper

{Products}-tagin aliakset (esim. {CategoryProducts}, {DiscountProducts}, jne.) toimivat samoin kuin aiemminkin. Näitä tageja ei ole mahdollista käyttää tuotesuodattimien kanssa.

Lue lisää tuotesuodattimien vaikutuksista tuotelistoihin.

category:

Määrittää tuoteryhmät, joista tuotteet haetaan.

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

Esim. category: '2|34|5'

subcategories:

Määrittää haetaanko tuotteita myös category-attribuutilla määriteltyjen tuoteryhmien aliryhmistä.

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

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'

filters:

Asettaa tulostettavalle listalle valmiita suodattimia, joiden perusteella listalle sisällytettävät tuotteet valikoidaan.

Sallitut arvot:

'discounted': alennustuotteet (siis 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
Tämä tarkoittaa että 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 putkimerkeillä.

Esim. filters: 'discounted|released'

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.