Custom liquid

Custom liquid kuralı, bir ziyaretçinin erişim alıp almayacağına karar vermek için kendi Liquid kod parçanızı yazmanızı sağlar. Uygulamadaki en esnek kuraldır: müşteriye, sepetine, mevcut ürüne veya koleksiyona ya da mağaza vitrininin kendisine dair bir Liquid koşulu olarak ifade edebildiğiniz her şeyi içeriğe erişimi sınırlamak için kullanabilirsiniz. Ancak kod parçasındaki bir hatanın gerçek sonuçlar doğurduğu tek kural da budur; bunlar aşağıda açıklanmıştır.

Nasıl çalışır?

Custom liquid eylem tabanlı bir kuraldır, bu nedenle If/Unless anahtarı yoktur. Bunun yerine uygulama kod parçanızı her ziyaretçi için çalıştırır ve nihai sonucunu okur. Sonuç tam olarak true veya false olmalıdır (çevresindeki boşluklar yok sayılır): true kuralı geçer, false kuralı geçemez. true - customer is eligible gibi diğer çıktılar geçerli bir sonuç değildir. Kod parçanız, bir Shopify temasının mevcut ziyaretçi ve sayfa hakkında sahip olacağı türden verilere erişebilir.

Kuralı ekleme

Kilidi açın, Unlock rules sekmesine tıklayın ve Condition type açılır listesinden Custom liquid seçeneğini belirleyin.

Unlock rules sekmesindeki Condition type açılır listesinden Custom liquid seçeneğini belirleyin.

Kod düzenleyici

Kuralın koşul türü; söz dizimi vurgulama, otomatik tamamlama ve gerçek zamanlı söz dizimi doğrulaması içeren özel bir Liquid kod düzenleyicisi açar. Liquid kodunuzdaki hatalar, daha kaydetmeden siz yazarken doğrudan düzenleyicide işaretlenir.

Kod düzenleyicide bir Liquid kod parçası yazma ve doğrulama.

Kullanılabilir değişkenler

Düzenleyici, açıkladıkları şeye göre gruplandırılmış, ekleyebileceğiniz bir değişken kitaplığı sunar:

Grup	Değişkenler
Müşteri	customer, customer.tags, customer.orders_count, customer.total_spent, customer.b2b?
Sepet	cart.item_count, cart.total_price, cart.items
Ürün ve koleksiyon	product.tags, product.vendor, product.metafields, collection.handle
Mağaza vitrini	request.path, request.page_type, localization.country.iso_code, localization.language.iso_code

Variables and templates panelinden kullanılabilir değişkenlere göz atma.

Başlangıç şablonları

Boş bir düzenleyici yerine çalışan bir örnekle başlamak isterseniz aynı panel, ekleyip düzenleyebileceğiniz hazır şablonlar içerir: oturum açmış müşteri kontrolü, müşteri etiketi kontrolü, minimum sepet adedi veya sepet toplamı, ürün etiketi kontrolü, ziyaretçi ülkesi kontrolü, URL yolu kontrolü ve customer.b2b? değerini doğrudan kontrol eden hazır bir Shopify B2B customer şablonu.

Hazır Shopify B2B şablonu dahil bir başlangıç şablonu seçme.

Yönetim adımları

1. Korumak istediğiniz kilidi açın ve Unlock rules sekmesine tıklayın.
2. Bir erişim kuralı ekleyin ve koşul türünü Custom liquid olarak ayarlayın.
3. Kod parçanızı doğrudan düzenleyiciye yazın ya da bir değişkeni kopyalamak veya hazır şablonlardan biriyle başlamak için Variables and templates bölümünü açın.
4. Kod parçanızın nihai çıktısının, geçmesi gereken ziyaretçiler için tam olarak true, diğer herkes için tam olarak false olduğundan emin olun. Değerin çevresine açıklayıcı metin, HTML veya başka çıktı eklemeyin. Düzenleyici temel söz dizimi sorunlarını işaretler, ancak mantığın istediğiniz şeyle eşleştiğini yine de sizin doğrulamanız gerekir.
5. İsteğe bağlı olarak kural başına bir Redirect URL belirleyin; yalnızca bu kural ziyaretçiyi reddettiğinde kullanılır.
6. Kilidi kaydedin.

Açık kalma davranışı

Dikkat

Bir Custom liquid kod parçası eksikse, bozuksa veya net bir true/false sonucu üretemiyorsa uygulama açık kalır: ziyaretçiyi engellemek yerine erişim verir. Bu bilinçli bir tercihtir, ancak bozuk bir kod parçasının güvenli tarafta kalmadığı anlamına da gelir; “sonuç yoksa hâlâ kilitli” varsayan bir satıcı yanılır. Hassas bir şeyi korumak için güvenmeden önce kod parçanızın gerçekten çalıştığından emin olun ve test edin.

Örnek: VIP etiketli, oturum açmış müşterilere izin verme

Özel bir sayfanın yalnızca hesabında vip etiketi bulunan, oturum açmış müşterilere açık olması gerektiğini varsayalım.

1. Korunacak içerik olarak VIP collection preview sayfasını seçin.

VIP müşterilere ayırmak istediğiniz sayfayı seçin.

2. Custom liquid kuralını ekleyin ve başlangıç kod parçasını şununla değiştirin:

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

Siz yazarken düzenleyici altta Liquid syntax is valid onayını gösterir.

Düzenleyici Liquid kodunu vurgular ve kaydetmeden önce söz dizimini doğrular.

3. Kuralın Redirect URL alanını boş bırakın.
4. Access denied message alanını şu şekilde ayarlayın:

This page is available to VIP customers only.

Custom liquid kuralında tek bir mesaj alanı vardır ve kod parçasının reddettiği herkese gösterilir.

5. Save düğmesine tıklayın.

Mağaza vitrinindeki sonuç

Kod parçası, vip etiketi olan oturum açmış bir müşteri için tam olarak true çıktısı verir, bu nedenle sayfa normal şekilde açılır. Misafirler ve bu etiketi taşımayan müşteriler için tam olarak false çıktısı verir, bu nedenle yukarıdaki mesajı görürler. Kod parçasının çıktısında true veya false değerinin öncesine ya da sonrasına metin eklemeyin.

Liquid kod parçası false döndürdüğünde ziyaretçi, bu örnekteki Access denied message mesajını görür.

İlgili belgeler

• Kuralları birleştirme
• B2B customer
• Kilit çalışmıyor
• Nasıl çalışır?