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.
Product info-blok in de map snippets.
kleep-button.liquid in uw map snippets. Zet de volgende inhoud erin:
Kleep-knop
Kleep-knop
Shopify-opties
Shopify-opties
- 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.

Vertalingen
Vertalingen
fr.json
fr.json
it.json
it.json
de.json
de.json
es.json
es.json
ja.json
ja.json
ko.json
ko.json
pt.json
pt.json
- Valideer de updates in het Shopify Thema Aanpassen-gebied. Configureer de visuele elementen in de instellingen van het productinformatieblok.
- Als u een secundaire knop wilt toevoegen, moet u een nieuw bestand aanmaken met de naam
kleep-secondary-button.liquidin uw mapsnippets. Zet de volgende inhoud erin:
Code secundaire knop
Code secundaire knop
Product info-blok in de map snippets.
Fragment renderen
Fragment renderen
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:
Fragment vergelijkbare knop
Fragment vergelijkbare knop
Stap 2 - Render het fragment in de productsjabloon
Voeg deze regel in op de plek waar u de knop wilt laten verschijnen:Fragment renderen
Fragment renderen
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_buttonspopup+custombutton+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
- Ga naar Online Store → Themes → Customize.
- Open de sectie App embeds.
- Schakel de Kleep App in.
- Sla het thema op.

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

- Open Online Store → Customize.
- Ga naar de sjabloon Productpagina.
- Klik in de gewenste sectie op Blok toevoegen.
- Selecteer Kleep Vergelijkbare Knop.
- Sla het thema op.

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

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.




{% 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.


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

