Komut Dosyaları için Liquid şablonlarınızı güncelleme

Online mağazanızda komut dosyaları çalıştırıyorsanız bunların dijital vitrininizdeki sayfaları nasıl etkilediğini kontrol etmeniz gerekir. Çoğu tema, komut dosyalarınızı destekleyecek kodu içerir ancak bazıları içermez. Temanızda bu kod yoksa kodu ekleyebilirsiniz.

Bu sayfada

Hata giderme

Komut dosyaları ve temalarla ilgili sorunların çoğu, indirim sunan satır öğesi komut dosyalarını içerir. Örneğin, siparişin toplam fiyatı doğru olsa da satır öğesi fiyatlarında indirimler gösterilmez. Müşterilerin, indirimlerinin nasıl hesaplandığını anlaması gerekir. Müşteriler orijinal fiyatı, indirimli fiyatı ve indirimin kısa bir açıklamasını görmek ister. Bu ayrıntılardan herhangi biri sepetinizde eksikse bunların görünmesi için Liquid kodunu eklemeniz gerekir.

Komut dosyanızın dijital vitrininizi nasıl etkilediğini kontrol etmenin iyi bir yolu, bir müşteri olarak mağazayı ziyaret etmek ve komut dosyasını tetikleyen eylemleri gerçekleştirmektir.

Liquid nesnesi özellikleri

Aşağıdaki listelerde, mağazanızın sepetindeki komut dosyalarını desteklemek için genellikle gereken Liquid nesnesi özellikleri yer alır:

Sepet nesnesi özellikleri:

Satır öğesi özellikleri:

Komut dosyası nesnesi:

Komut dosyası nesnesi, bir mağazanın etkin komut dosyaları hakkında bilgi döndürmek için kullanılabilir. Bu nesne, komut dosyalarında hata ayıklarken yararlı olabilir.

Örnek

Aşağıdaki örnekte, bir satır öğesi komut dosyasını desteklemek için cart.liquid şablonunuzda yapabileceğiniz değişiklikler açıklanmaktadır.

Örnek sepet

Örneğin, sepetinizde üç satır öğesi varsa:

Futbol topu
- Miktar: 1
- Birim fiyatı: 15,00 $
Tenis topu
- Miktar: 5
- Birim fiyatı: 5,00 $
Koşu ayakkabısı
- Miktar: 1
- Birim fiyatı: 30,00 $

Ve aşağıdaki indirimleri uygulayan bir komut dosyası yayınladıysanız:

İki veya daha fazla tenis topu için %10 indirim
Tüm ayakkabılarda 5 $ indirim

Bu durumda cart.liquid şablonunuz, satır öğelerini ve bu öğelerin toplam tutarlarının özetini listeleyen basit bir tablo olabilir:

<table class="cart">
  <thead class="heading">
    <tr>
      <th>Product</th>
      <th>Quantity</th>
      <th>Total</th>
    </tr>
  </thead>

  <tbody class="line-items">
    {% for item in cart.items %}
    <tr>
      <td>{{ item.product.title }}</td>
      <td>{{ item.quantity }}</td>
      <td>{{ item.line_price | money }}</td>
    </tr>
    {% endfor %}
  </tbody>

  <tfoot class="summary">
    <tr>
      <td colspan="2">Total</td>
      <td>{{ cart.total_price | money }}</td>
    </tr>
  </tfoot>
</table>

Komut dosyası tarafından uygulanan indirimlerle birlikte bu şablon, sepetiniz için aşağıdaki tabloyu oluşturur:

Ürün	Miktar	Toplam
Futbol topu	1	15,00 $
Tenis topu	5	22,50 $
Koşu ayakkabısı	1	25,00 $
Toplam		62,50 $

Satır öğelerini güncelleme

Komut dosyası tarafından uygulanan indirimleri göstermek için satır öğelerini, üç önemli bilgiyi gösterecek şekilde güncellememiz gerekir:

indirimler öncesindeki satır fiyatı
indirimler sonrasındaki satır fiyatı
uygulanan indirimleri açıklayan bir mesaj.

Bunu yapmak için aşağıdaki Liquid nesnesi özelliklerini kullanın:

line_item.total_discount, satır öğesine uygulanan indirim tutarını döndürür
line_item.original_line_price, indirimlerden önceki satır öğesi fiyatını döndürür
line_item.message, satır öğesine uygulanan indirimleri açıklayan bir mesaj döndürür.

Orijinal satır fiyatını indirimli satır fiyatından ayırmak için üstü çizili efektini kullanmak yararlı olabilir:

<tbody class="line-items">
  {% for item in cart.items %}
  <tr>
    <td>{{ item.product.title }}</td>
    <td>{{ item.quantity }}</td>
    <td>
      {{ item.line_price }}
      {% if item.total_discount > 0 %}
        <s>{{ item.original_line_price }}</s>
        ( {{ item.message }} )
      {% endif %}
    </td>
  </tr>
  {% endfor %}
</tbody>

Sepetiniz artık şöyle görünmelidir:

Ürün	Miktar	Toplam
Futbol topu	1	15,00 $
Tenis topu	5	22,50 $ ~~25,00 $~~ (İki veya daha fazla tenis topu için %10 indirim)
Koşu ayakkabısı	1	25,00 $ ~~30,00 $~~ (Tüm ayakkabılarda 5 $ indirim)
Toplam		62,50 $

Sepet özetini güncelleme

Müşterinin sipariş fiyatını takip etmesine yardımcı olmak için şunları da göstermeniz gerekir:

müşterilerin indirim öncesi ve sonrası toplamları karşılaştırmasını sağlamak için sepetin orijinal alt toplamı
müşterinin sepetinde elde ettiği toplam tasarruf.

Yine, bu bilgileri eklemek için aşağıdaki Liquid nesnesi özelliklerini kullanın:

cart.total_discount, sepetteki ürünlere uygulanan indirim tutarını döndürür
cart.original_total_price, indirimler öncesindeki sepet alt toplamını döndürür.

Bu bilgilerle, güncellenmiş .summary bloğunuz şöyle görünebilir:

<tfoot class="summary">
  <tr>
    <td colspan="2">Subtotal</td>
    <td>{{ cart.original_total_price | money }}</td>
  </tr>
  <tr>
    <td colspan="2">Discount Savings</td>
    <td>{{ cart.total_discount | money }}</td>
  </tr>
  <tr>
    <td colspan="2">Total</td>
    <td>{{ cart.total_price | money }}</td>
  </tr>
</tfoot>

Sepet tablonuz artık şöyle görünmelidir:

Ürün	Miktar	Toplam
Futbol topu	1	15,00 $
Tenis topu	5	22,50 $ ~~25,00 $~~ (İki veya daha fazla tenis topu için %10 indirim)
Koşu ayakkabısı	1	25,00 $ ~~30,00 $~~ (Tüm ayakkabılarda 5 $ indirim)
Alt toplam		70,00 $
İndirim tutarı		7,50 $
Toplam		62,50 $

Şablonlarınıza birkaç yeni Liquid nesnesi ekleyerek müşterilerinizin, indirimlerinin nasıl hesaplandığını anlamasına yardımcı olabilirsiniz.

Diğer örnekler

Aşağıdaki Liquid örneği, her bir satır öğesine yönelik indirimleri göstermektedir:

{% if item.original_line_price != item.line_price %}
  <small class="original-price"><s>{{ item.original_line_price | money }}</s></small>
  {% endif %}
  {{ item.line_price | money }}
  {% for discount in item.discounts %}
  <small class="discount">{{ discount.title }}</small>
  {% endfor %}

Liquid kod değişikliklerini de içeren başka bir indirim örneği'ni inceleyin.