Skip to main content

Shopify V2 Integratiehandleiding

In deze sectie wordt uitgelegd hoe u Kleep AI Sizing aan uw Shopify-winkel toevoegt.

Stapsgewijze video-walkthrough

Volg onze Tango-tutorial om de Kleep-knop aan uw winkel toe te voegen op Online Store 2.0-thema’s.

Shopify V1 Integratiehandleiding

1. Maatbepaling

In deze sectie wordt uitgelegd hoe u Kleep AI Sizing aan uw Shopify-codebase toevoegt.

Liever een visuele walkthrough?

Bekijk de stapsgewijze Tango-tutorial voor het installeren van Kleep in een Shopify V1-winkel.

Stappen

Stap 1: Schakel de App Embed in Zorg ervoor dat de Kleep-app is geactiveerd in uw App-embeds. Capture d'écran 2025-08-13 à 14.29.30.png Stap 2: Render het knopfragment Plak de volgende code op de plek waar u Kleep wilt laten verschijnen. Dit moet deel uitmaken van het Product info-blok in de map snippets.
Stap 3: Maak het knopfragmentbestand Maak een nieuw bestand aan met de naam kleep-button.liquid in uw map snippets. Zet de volgende inhoud erin:
Stap 4: Voeg opties toe aan het instellingsschema Voeg de volgende opties toe aan uw instellingsschema aan het einde van de pagina:
Om uw eigen CSS-stijlen toe te voegen:
  • Om het uiterlijk te wijzigen (kleuren, afstand, lettertypen, etc.), plak uw CSS in het vak “Voer aangepaste CSS-stijlen in” in de Kleep App Embed-instellingen.
Bijvoorbeeld: Screenshot 2025-08-13 at 13.25.30.png Stap 5: Voeg Engelse vertalingen toe Voeg Engelse vertalingen toe aan uw themalocales.
Stap 6: Voeg andere taalvertalingen toe Voeg andere vertalingen toe aan uw themalocales.
  1. Valideer de updates in het Shopify Thema Aanpassen-gebied. Configureer de visuele elementen in de instellingen van het productinformatieblok.
  2. Als u een secundaire knop wilt toevoegen, moet u een nieuw bestand aanmaken met de naam kleep-secondary-button.liquid in uw map snippets. Zet de volgende inhoud erin:
Plak de volgende code op de plek waar u Kleep wilt laten verschijnen. Dit moet deel uitmaken van het Product info-blok in de map snippets.

2. Vergelijkbare producten


Installeer “Vergelijkbare producten” voor V1 Shopify-thema’s

In dit geval moet u handmatig een Liquid-fragment toevoegen.

Stap 1 - Maak een fragment

Maak: snippets/kleep-similar-button.liquid Voeg de volgende code in:

Stap 2 - Render het fragment in de productsjabloon

Voeg deze regel in op de plek waar u de knop wilt laten verschijnen:
Typische plaatsing: onder de variantselectoren of nabij het formulier ‘Aan winkelwagen toevoegen’.

Stap 3 - Schakel de juiste modus in voor V1-thema’s

Omdat V1-thema’s geen OS2.0-blokken kunnen invoegen, moet de widget een van de volgende modi gebruiken:
  • custom_buttons
  • popup+custom
  • button+custom

Installeer “Vergelijkbare producten” voor V2 (Online Store 2.0)-winkels

Moderne Shopify-thema’s ondersteunen app-embeds en aangepaste blokken. Er zijn geen codewijzigingen vereist.

Stap 1 — Schakel de Kleep App Embed in

  1. Ga naar Online Store → Themes → Customize.
  2. Open de sectie App embeds.
  3. Schakel de Kleep App in.
  4. Sla het thema op.
Dit activeert het kernscript dat de logica van vergelijkbare producten beheert. Screenshot 2025-12-09 at 11.55.25.png Zoek vervolgens de “Aanbevolen producten weergeven”

Stap 2 — Selecteer de weergavemodus voor vergelijkbare producten

Kies in de Kleep-widgetconfiguratie hoe vergelijkbare producten op de productpagina moeten verschijnen:
  • disabled – schakelt de functie volledig uit
  • popup – voegt automatisch een popup toe boven variant-/maatselectoren op desktop, en vervangt de standaardknop op mobiel
  • button – voegt automatisch een CTA-knop in nabij het gebied ‘Aan winkelwagen toevoegen’ wanneer de geselecteerde variant uitverkocht is
  • custom_buttons – schakelt alle automatische plaatsing uit; de handelaar moet handmatig een of meer “Kleep Vergelijkbare Knop”-blokken toevoegen
  • popup+custom – behoudt de automatische popup en schakelt ook eventuele aangepaste knoppen in het thema in
  • button+custom – behoudt de automatische CTA-knop en schakelt ook eventuele aangepaste knoppen in het thema in
Screenshot 2025-12-09 at 11.48.24.png Sla daarna gewoon het thema op en het verschijnt onmiddellijk in uw winkel (productpagina). Stap 3 — Aangepaste knoppen toevoegen (alleen voor custom_buttons, popup+custom, button+custom) Als uw geselecteerde modus aangepaste knoppen omvat:
  1. Open Online Store → Customize.
  2. Ga naar de sjabloon Productpagina.
  3. Klik in de gewenste sectie op Blok toevoegen.
  4. Selecteer Kleep Vergelijkbare Knop.
  5. Sla het thema op.
Aangepaste knoppen verschijnen alleen wanneer de geselecteerde variant uitverkocht is. image.png

Meerdere knoppen “Vergelijkbare producten” toevoegen (primair en secundair)

U kunt elk gewenst aantal knoppen voor vergelijkbare producten op de productpagina toevoegen. Dit werkt voor zowel OS 2.0-thema’s als V1 / klassieke thema’s.

Schakel een modus in die aangepaste knoppen ondersteunt

Om meerdere knoppen mogelijk te maken, moet de widget zijn ingesteld op een van:
  • custom_buttons
  • popup+custom
  • button+custom
Deze modi activeren handmatige plaatsing, zodat handelaren zoveel knoppen kunnen invoegen als nodig.

Voor Online Store 2.0 (moderne thema’s)

OS 2.0-thema’s bieden de mogelijkheid om knoppen visueel toe te voegen via de Thema-editor. Stappen:
  • Ga naar Online Store → Customize
  • Open de sjabloon Productpagina
  • Klik op Blok toevoegen → Kleep Vergelijkbare Knop
  • Voeg de knop toe op de gewenste locatie
  • Herhaal dit als u 2+ knoppen op de pagina wilt
Elke knop verschijnt automatisch alleen wanneer de geselecteerde variant uitverkocht is.

Voor V1 / klassieke thema’s

Klassieke thema’s ondersteunen geen blokken, maar u kunt het fragment meerdere keren renderen. Voeg dit fragment in op de plek waar u een knop wilt: {% render 'kleep-similar-button' %} Om meerdere knoppen te maken, plaatst u deze code eenvoudig op verschillende locaties van de productsjabloon. Elke aanroep van het fragment maakt een extra knop aan.

Samenvatting

Om meerdere knoppen voor vergelijkbare producten toe te voegen: Schakel een modus met aangepaste knoppen in → voeg meerdere OS 2.0-blokken of meerdere fragmentaanroepen toe → alle knoppen werken automatisch wanneer de variant uitverkocht is.
CTA-locatie op de PDP De locatie wordt bepaald door DOM-selectoren in KleepSDK.getConstants(). targetProductInfoBlockQueries – waar de productinformatie zich bevindt. Dit is een reeks selectoren die verwijzen naar de hoofdcontainer van productdetails (titel, prijs, maten, etc.). Het script itereert door deze selectoren en gebruikt de eerste die het vindt als invoegpunt voor de CTA of popups. targetVariantQueries – waar de maat-/variantopties zich bevinden: zodra het productinformatieblok is gevonden, zoekt het script daarin naar variantelementen (zoals maatselectoren). Elk variant-<label> (of equivalent) wordt een doelwit voor het koppelen van de popup-CTA. Popup vs. Knop (desktop vs. mobiel) Wij detecteren het apparaattype met checkIfMobile(): Deze functie vergelijkt de navigator.userAgent-string van de browser met een lijst van mobiele apparaten (bijv. iPhone, Android, iPad).
  • Op desktop wordt de CTA weergegeven als hover-popups naast de variantlabels.
  • Op mobiel vervangt het script hover-popups door een enkele knop, omdat hover-interacties niet werken op touchscreens.
Aanpassing
  • Er zijn geen andere varianten van plaatsing/indeling beschikbaar buiten het aanpassen van de selectoren en CSS.
  • Om het uiterlijk te wijzigen (kleuren, afstand, lettertypen, etc.), plak uw CSS in het vak “Voer aangepaste CSS-stijlen in” in de Kleep App Embed-instellingen. Screenshot 2025-08-13 at 13.25.30.png

3. Zoekfunctie


Opmerking: U hoeft geen themacode te wijzigen om de Kleep Zoekfunctie in Shopify V1 in te stellen. Open de Thema-editor, schakel de Kleep App Embed in, activeer Aangepaste zoekfunctie en vervang vervolgens het standaard zoekblok door het Kleep Zoekblok. Om het uiterlijk te wijzigen (kleuren, afstand, lettertypen, etc.), plak uw CSS in het vak “Voer aangepaste CSS-stijlen in” in de Kleep App Embed-instellingen. Al deze zaken worden hieronder beschreven Open de thema-editor Ga naar Online winkel > Thema’s, zoek het thema dat u wilt bewerken en klik op Aanpassen. Kleep App Embed inschakelen Open de sectie App-embeds. Zoek de Kleep-app en schakel deze in. Aangepaste zoekfunctie inschakelen (optioneel) Schakel in de Kleep-instellingen “Aangepaste zoekfunctie inschakelen” in. Screenshot 2025-07-28 at 17.17.44.png Vervang de standaard zoekfunctie Open in de thema-editor het zoeksjabloon (navigeer naar het paginasjabloon Zoeken). Screenshot 2025-07-28 at 17.18.59.png Verwijder of verberg de standaard zoeksectie uit het thema. Screenshot 2025-07-28 at 17.19.32.png Voeg het Kleep Zoekblok toe (vanuit het tabblad Apps) en plaats het waar de standaard zoekfunctie stond. Screenshot 2025-07-28 at 17.19.48.png Sla de themawijzigingen op. De zoekfunctie is geïntegreerd als een Liquid-sectie in de app, niet als afzonderlijke Liquid-code. Activering wordt bepaald door: {% if block.settings.kleep_enable_custom_search and '[kookai.fr](http://kookai.fr/), [gualap.com](http://gualap.com/), [gualap.fr](http://gualap.fr/), [www.molli.com](http://www.molli.com/), [getkleep.myshopify.com](http://getkleep.myshopify.com/)' contains domain%} Dit zorgt ervoor dat alleen specifieke winkels (domeinen) de zoekfunctie kunnen inschakelen.Indeling en stijlen
  • De raster- versus lijstweergave wordt alleen geschakeld via de instelling products_search_grid_layout in de app.
Ga hiervoor naar de zoekfunctie die u al hebt toegevoegd en aan de rechterkant ziet u de optie om deze te configureren Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Extra stijlen (lettertypen, kleuren, afstand) worden door ons in de code geïmplementeerd, per winkel, indien nodig.
  • Alle functionaliteit is gekoppeld aan deze Liquid-sectie en ingeschakeld via kleep_enable_custom_search in de app, niet door Liquid-code toe te voegen aan de thema-instellingen.
  • Om het uiterlijk te wijzigen (kleuren, afstand, lettertypen, etc.), plak uw CSS in het vak “Voer aangepaste CSS-stijlen in” in de Kleep App Embed-instellingen. Screenshot 2025-08-13 at 13.25.30.png

Cookies en gegevensprivacy

Kleep is volledig afhankelijk van de toestemming van de bezoeker: het script wordt pas geladen nadat de toestemming is verzameld via uw CMP, en u dient het laden hiervan dienovereenkomstig te conditioneren. Raadpleeg Cookies, CMP & Gegevensprivacy voor de volledige lijst van trackers, de verwerkte gegevens, de doeleinden en rechtsgrondslagen, hosting, subverwerkers en beveiliging.