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 tagi tulostaa jokaisesta tuotteesta seuraavat tiedot:

Voit helper-attribuuttia käyttäen korvata oletustiedot haluamillasi tuotetiedoilla ja määrittää HTML-merkkauksen.

Tagi ei ole yhteensopiva tuotesuodattimien kanssa, sillä se ei ota arvoja vastaan selaimen osoiteriviltä. Voit rajata listan sisältöä vain tagin omien attribuuttien avulla.

Tämä tagi on pikakomento, jota voit käyttää alustamattoman {ProductSet}-tagin sijasta. Näin tuotelistan sisältöä ei tarvitse määrittää kokonaan 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
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Näkyvyyshelper-attribuutissa: tuote

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

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.

Attribuutit

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

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.

Sallitut arvot: pystyviivoilla 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: pystyviivoilla 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: pystyviivoilla 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 listan kohta on oma div-elementtinsä. Listalla ei ole ympäröivää elementtiä.
  • 'list': Lista tulostuu HTML-listana. Käyttämällä list_type-attribuuttia voit määrittää listan tyypin.
  • 'ids': Tagi tulostaa ainoastaan tuotteiden ID-numerot pystyviivojen jaottelemaksi merkkijonoksi ilman HTML-merkkausta.
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: Teksti, jossa voi olla Interface- ja HTML-merkkausta.

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

before: / after:

Näillä kahdella attribuutilla 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>'

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

or:

Määrittää vaihtoehtoisen sisällön, joka näkyy, jos 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.'

between:

Määrittää sisällön, jonka tagi tulostaa jokaisen listaelementin väliin.

Attribuutti esimerkiksi mahdollistaa tuotelistan muotoilun JSON-objektiksi käyttämällä attribuutin arvona pilkkua.

Sallitut arvot: merkkijono ja/tai HTML/Interface-merkkaus
escape:

Lisää tagin tulostamaan sisältöön pakomerkit, jotta sisältöä on helpompi käyttää JavaScript-koodissa tai JSON-objekteissa.

Sallitut arvot:
  • true: attribuutti lisää pakomerkit ennen lainausmerkkejä
  • false: attribuutti ei tee mitään
  • json: attribuutti lisää tulostukseen pakomerkit, joiden avulla sisältöä voi käyttää JSON-merkkauksessa.