Aangepaste Liquid

Met de regel Custom liquid schrijf je zelf een Liquid-codesnippet om te bepalen of een bezoeker toegang krijgt. Het is de meest flexibele regel in de app: alles wat je als Liquid-voorwaarde kunt uitdrukken over de klant, de winkelwagen, het huidige product of de huidige collectie, of de webshop zelf, kun je gebruiken om content af te schermen. Het is ook de enige regel waarbij een fout in de snippet echte gevolgen heeft, zoals hieronder wordt uitgelegd.

Zo werkt het

Custom liquid is een actiegebaseerde regel en heeft dus geen schakelaar If/Unless. In plaats daarvan voert de app je snippet uit voor elke bezoeker en leest het eindresultaat. Het resultaat moet exact true of false zijn (omringende witruimte wordt genegeerd): true voldoet aan de regel en false niet. Andere uitvoer, zoals true - customer is eligible, is geen geldig resultaat. Je snippet heeft toegang tot dezelfde soort gegevens over de huidige bezoeker en pagina als een Shopify-thema.

De regel toevoegen

Open de vergrendeling, klik op het tabblad Unlock rules en kies Custom liquid in de vervolgkeuzelijst Condition type.

Selecteer Custom liquid in de vervolgkeuzelijst Condition type op het tabblad Unlock rules.

De code-editor

Het voorwaardetype van de regel opent een speciale Liquid-code-editor met syntaxiskleuring, automatisch aanvullen en syntaxiscontrole in realtime. Fouten in je Liquid worden direct in de editor gemarkeerd terwijl je typt, nog voordat je opslaat.

Een Liquid-snippet schrijven en valideren in de code-editor.

Beschikbare variabelen

De editor biedt een bibliotheek met variabelen die je kunt invoegen, gegroepeerd op wat ze beschrijven:

Groep	Variabelen
Klant	customer, customer.tags, customer.orders_count, customer.total_spent, customer.b2b?
Winkelwagen	cart.item_count, cart.total_price, cart.items
Product en collectie	product.tags, product.vendor, product.metafields, collection.handle
Webshop	request.path, request.page_type, localization.country.iso_code, localization.language.iso_code

De beschikbare variabelen bekijken in het paneel Variables and templates.

Startsjablonen

Als je liever met iets werkends begint dan met een lege editor, bevat hetzelfde paneel kant-en-klare sjablonen die je kunt invoegen en aanpassen. Daaronder zijn een controle op ingelogde klant, een controle op klanttag, een minimum voor aantal artikelen of totaalbedrag van de winkelwagen, een controle op producttag, een controle op land van de bezoeker, een controle op URL-pad en een kant-en-klaar sjabloon Shopify B2B customer dat rechtstreeks customer.b2b? controleert.

Een startsjabloon kiezen, inclusief het kant-en-klare Shopify B2B-sjabloon.

Stappen om te beheren

1. Open de vergrendeling die je wilt beveiligen en klik op het tabblad Unlock rules.
2. Voeg een toegangsregel toe en stel het voorwaardetype in op Custom liquid.
3. Schrijf je snippet rechtstreeks in de editor, of open Variables and templates om een variabele te kopiëren of met een van de kant-en-klare sjablonen te beginnen.
4. Zorg dat de uiteindelijke uitvoer van je snippet exact true is voor bezoekers die moeten voldoen en exact false voor iedereen anders. Voeg geen verklarende tekst, HTML of andere uitvoer rond de waarde toe. De editor markeert basale syntaxisproblemen, maar je moet zelf nog controleren of de logica overeenkomt met wat je bedoelt.
5. Stel desgewenst per regel een Redirect URL in, die alleen wordt gebruikt als deze specifieke regel de bezoeker weigert.
6. Sla de vergrendeling op.

Fail-open-gedrag

Opgepast

Als een Custom liquid-snippet ontbreekt, kapot is of geen duidelijk true/false-resultaat oplevert, faalt de app open: de bezoeker krijgt toegang in plaats van te worden geblokkeerd. Dit is een bewuste keuze, maar het betekent ook dat een kapotte snippet niet veilig faalt. Wie aanneemt dat “geen resultaat” betekent dat het nog steeds vergrendeld is, heeft het mis. Controleer altijd of je snippet echt wordt weergegeven en test hem voordat je erop vertrouwt om iets gevoeligs te beschermen.

Voorbeeld: ingelogde klanten met een VIP-tag toelaten

Stel dat een privépagina alleen beschikbaar moet zijn voor ingelogde klanten wier account de tag vip heeft.

1. Selecteer de pagina VIP collection preview als de content die je wilt beveiligen.

Kies de pagina die je voor VIP-klanten wilt bewaren.

2. Voeg Custom liquid toe en vervang de startsnippet door:

{% if customer and customer.tags contains 'vip' %}true{% else %}false{% endif %}

De editor bevestigt onder het veld Liquid syntax is valid terwijl je typt.

De editor kleurt de Liquid-code en valideert de syntaxis voordat je opslaat.

3. Laat de Redirect URL van de regel leeg.
4. Stel het Access denied message in op:

This page is available to VIP customers only.

Custom liquid heeft één berichtveld, dat wordt getoond aan iedereen die de snippet afwijst.

5. Klik op Save.

Resultaat in de webshop

De snippet geeft exact true terug voor een ingelogde klant met de tag vip, dus de pagina opent normaal. Voor gasten en klanten zonder die tag geeft de snippet exact false terug, dus zij zien het bericht hierboven. Voeg geen tekst voor of na true of false toe in de uitvoer van de snippet.

Als de Liquid-snippet false teruggeeft, ziet de bezoeker het Access denied message uit dit voorbeeld.

Gerelateerde documentatie

• Regels combineren
• B2B-klant
• Vergrendeling werkt niet
• Hoe het werkt