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 .
- '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'
taisimilar_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'
taicompatible_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'
taicrosssales_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.
-
'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>
, 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.