Anpassad Liquid

Regeln Custom liquid låter dig skriva ett eget Liquid-kodutdrag som avgör om en besökare får åtkomst. Det är appens mest flexibla regel – allt du kan uttrycka som ett Liquid-villkor mot kunden, varukorgen, den aktuella produkten eller kollektionen, eller själva butiken kan du använda för att begränsa innehåll. Men det är också den enda regel där ett misstag i utdraget får verkliga konsekvenser, vilket beskrivs nedan.

Så fungerar det

Custom liquid är en åtgärdsbaserad regel och har därför ingen växlare för If/Unless. I stället kör appen ditt utdrag för varje besökare och läser det slutliga resultatet. Resultatet måste vara exakt true eller false (omgivande blanksteg ignoreras): true klarar regeln och false underkänner den. Annan utdata, som true - customer is eligible, är inte ett giltigt resultat. Ditt utdrag har tillgång till samma typ av data som ett Shopify-tema har om den aktuella besökaren och sidan.

Lägga till regeln

Öppna låset, klicka på fliken Unlock rules och välj Custom liquid i listrutan Condition type.

Välj Custom liquid i listrutan Condition type på fliken Unlock rules.

Kodredigeraren

Regelns villkorstyp öppnar en särskild Liquid-kodredigerare med syntaxmarkering, autokomplettering och syntaxvalidering i realtid. Fel i din Liquid-kod markeras direkt i redigeraren medan du skriver, redan innan du sparar.

Skriva och validera ett Liquid-utdrag i kodredigeraren.

Tillgängliga variabler

Redigeraren erbjuder ett bibliotek med variabler som du kan infoga, grupperade efter vad de beskriver:

Grupp	Variabler
Kund	customer, customer.tags, customer.orders_count, customer.total_spent, customer.b2b?
Varukorg	cart.item_count, cart.total_price, cart.items
Produkt och kollektion	product.tags, product.vendor, product.metafields, collection.handle
Butik	request.path, request.page_type, localization.country.iso_code, localization.language.iso_code

Bläddra bland de tillgängliga variablerna i panelen Variables and templates.

Startmallar

Om du hellre vill utgå från något som fungerar än från en tom redigerare innehåller samma panel färdiga mallar som du kan infoga och anpassa. Där finns bland annat en kontroll av inloggad kund, en kontroll av kundtagg, ett minimiantal artiklar eller en minsta summa i varukorgen, en kontroll av produkttagg, en kontroll av besökarens land, en kontroll av URL-sökväg och en färdig mall Shopify B2B customer som kontrollerar customer.b2b? direkt.

Välja en startmall, inklusive den färdiga Shopify B2B-mallen.

Steg för att hantera

1. Öppna låset du vill skydda och klicka på fliken Unlock rules.
2. Lägg till en åtkomstregel och ställ in villkorstypen på Custom liquid.
3. Skriv ditt utdrag direkt i redigeraren, eller öppna Variables and templates för att kopiera en variabel eller utgå från en av de färdiga mallarna.
4. Se till att utdragets slutliga utdata är exakt true för besökare som ska släppas in och exakt false för alla andra. Lägg inte till förklarande text, HTML eller annan utdata runt värdet. Redigeraren flaggar grundläggande syntaxproblem, men du måste ändå kontrollera att logiken gör det du avser.
5. Ange eventuellt en Redirect URL per regel, som bara används om just den här regeln nekar besökaren.
6. Spara låset.

Beteende vid fel (fail-open)

Caution

Om ett Custom liquid-utdrag saknas, är trasigt eller inte ger ett tydligt resultat med true/false, fungerar appen enligt principen fail-open: den ger åtkomst i stället för att blockera besökaren. Det är avsiktligt, men det innebär också att ett trasigt utdrag inte misslyckas på den säkra sidan. En butiksägare som utgår från att ”inget resultat betyder att det fortfarande är låst” har fel. Kontrollera alltid att ditt utdrag faktiskt renderas och testa det innan du förlitar dig på det för att skydda något känsligt.

Exempel: tillåt inloggade kunder med VIP-tagg

Anta att en privat sida bara ska vara tillgänglig för inloggade kunder vars konto har taggen vip.

1. Välj sidan VIP collection preview som innehåll att skydda.

Välj sidan som du vill reservera för VIP-kunder.

2. Lägg till Custom liquid och ersätt startutdraget med:

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

Redigeraren bekräftar Liquid syntax is valid under fältet medan du skriver.

Redigeraren markerar Liquid-koden och validerar syntaxen innan du sparar.

3. Lämna regelns Redirect URL tom.
4. Ange Access denied message till:

This page is available to VIP customers only.

Custom liquid har ett enda meddelandefält som visas för alla som utdraget avvisar.

5. Klicka på Save.

Resultat i butiken

Utdraget ger exakt true för en inloggad kund med taggen vip, så sidan öppnas som vanligt. Det ger exakt false för gäster och kunder utan den taggen, som därför ser meddelandet ovan. Lägg inte till text före eller efter true eller false i utdragets utdata.

När Liquid-utdraget returnerar false ser besökaren Access denied message från det här exemplet.

Relaterade dokument

• Combining rules
• B2B customer
• Lock not working
• How it works