{SearchProducts}

/Tagit/Haku ja navigointi/{SearchProducts}

Tulostaa listan haun palauttamista tuotteista.

Kuvaus

Tagille annetaan hakutulossivulla automaattisesti kävijän käyttämä hakusana keyword-attribuutin arvoksi. Tulostettavalle listalle lisätään oletusarvoisesti kaikki tuotteet, jotka annetulla hakusanalla löydetään.

Lue lisää MyCashflow'n hakukoneesta.

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

{SearchProducts(
    category: int,
        subcategories: boolean,
    brand: int,
    campaign: int,
    id: int,
    filters: string,
    timelimit: string,
    similar_to: int,
    compatible_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,
    noresults: string
)}

Käyttöympäristö

Näkymä helper-attribuutissa: tuote

Tagia käytetään vain hakutulossivulla, jossa se poimii asiakkaan syöttämän hakutermin sivun URL-osoitteesta.

Attribuutit

Tagilla ovat käytössä lähes kaikki samat attribuutit kuin {Products}-tagilla. Vain keyword-attribuutin arvoksi asetetaan ennalta asiakkaan syöttämä hakusana.

category:

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

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

Esim. category: '2 | 234 | 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 | 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

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 tuotelomakkeella kohdassa Näkyvyys ja mainostus > Mainosta tuotetta.
'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
'available': saatavilla olevat tuotteet
'unavailable': tuotteet joita ei ole saatavilla
'navigable': tuote on navigoitavissa
Tämä tarkoittaa että tuote kuuluu johonkin tuoteryhmään ja mikään taso sen tuoteryhmähierarkiassa ei ole suljettu aktiivisessa kauppaversiossa.

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.

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

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.

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

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.

noresults:

Merkkaus joka näytetään, jos asiakkaan syöttämä hakusana ei palauta yhtään tuotetta.

Tämä attribuutti on käytössä vain hakutulossivulla.

Sallitut arvot: HTML- ja Interface-merkkaus

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

after- ja before-attribuuttien sisältöä ei tulosteta, jos tagi itse ei tuota mitään sisältöä.

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

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.

Varastossa olevien tuotteiden suodattaminen hakutulosten joukosta

Joskus voi olla hyödyllistä näyttää hakutuloksissa vain tuotteita, joita on varastossa. Tämä onnistuu esimerkiksi {SearchProducts}-tagin filters-attribuutin avulla:

{SearchProducts(
    filters: 'in_stock'
)}

Huomaathan että {SearchProducts}-tagi on käytettävissä vain hakutulossivulla, ja se tulostaa sisältöä vain silloin kun hakusana on asetettu.

Kuvaus

Syntaksi

Käyttöympäristö

Attribuutit

Varastossa olevien tuotteiden suodattaminen hakutulosten joukosta

Aiheeseen liittyviä sivuja