Let op: Hoe je onze nieuwe Autocomplete kunt implementeren is afhankelijk van je platform. Draait jouw webshop op Magento 2. Lees dan dit artikel.
Op https://developers.tweakwise.com/api/ vind je de informatie die je nodig hebt om deze feature te implementeren onder Suggestions:
Maakt jouw webshop gebruik van de groepcode, dan moet je de grouped gebruiken. In alle andere gevallen gebruik je de /suggestions en /suggestions/products.
/Suggestions
Binnen de Suggestions call zijn er verschillende groepen die kunnen worden samengesteld, namelijk:
- Zoekzinsuggesties, met het eerste resultaat gegroepeerd op categorie
- Categoriesuggesties
- Eigenschapsuggesties
In Tweakwise Navigator kan de klant deze verschillende groepen zelf inrichten. Ze kunnen hier het aantal suggesties opgeven en een naam geven aan deze groep.
Zoekzinsuggesties
Bovenstaande inrichting kan de klant zelf doen in Tweakwise Navigator. Wanneer het vinkje ‘Groepeer eerste resultaat op categorie’ wordt aangezet, ziet dit er in de XML als volgt uit:
In de frontend kan dit vervolgens als volgt getoond worden: ‘Kinderzitje in Fietszitjes'. De gehele response voor deze groep zal met een aantal ‘2’ als volgt uitzien:
<group> <name>De groepsnaam die gegeven is in Tweakwise Navigator</name> <suggestions> <suggestion> <match>Zoekzinsuggestie</match> <navigationLink> <path>De volledige navigatie link met zoekzin en eventueel categorieID</path> <context>De context bevat details over het gegeven pad. <searchterm>De zoekzin</searchterm> <category> <path>De categorieID voor het gegroepeerde resultaat</path> <name>Categorienaam</name> </category> </context> </navigationLink> </suggestion> </suggestions> </group>
Categoriesuggesties
Bovenstaande inrichting kan de klant zelf doen in Tweakwise Navigator. De gehele response voor deze groep zal met een aantal ‘2’ als volgt uitzien:
<group> <name>De groepsnaam die gegeven is in Tweakwise Navigator</name> <suggestions> <suggestion> <match>Categorienaam</match> <navigationLink> <path>De volledige navigatie link met Categoriepad</path> <context>De context bevat details over het gegeven pad. <category> <path>Het categoriepad</path> <name>Categorienaam</name> </category> </context> </navigationLink> </suggestion> </suggestions> </group>
Eigenschapsuggesties
Bovenstaande inrichting kan de klant zelf doen in Tweakwise Navigator. De gehele response voor deze groep zal met een aantal ‘2’ als volgt uitzien:
<group> <name>De groepsnaam die gegeven is in Tweakwise Navigator</name> <suggestions> <suggestion> <match>Filterwaarde</match> <navigationLink> <path>De volledige navigatie link met geselecteerd filter</path> <context>De context bevat details over het gegeven pad. <category> <path>Het categorieID</path> </category> <facetFilters> <filter> <key>Eigenschapsnaam</key> <values> <eigenschapsnaam>Filterwaarde</eigenschapsnaam> </values> </filter> </facetFilters> </context> </navigationLink> </suggestion> </suggestions> </group>
/suggestions/products
De productsuggesties zijn een losse call en geven op dezelfde manier items terug zoals de navigation en navigation-search calls.