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

Online mağazanızda komut dosyaları çalıştırırsanız, bu komut dosyalarının vitrininizdeki sayfaları nasıl etkilediğini kontrol etmeniz gerekir. Birçok tema, komut dosyalarınızı destekleyen kodlar içerirken bazıları ise içermez. Temanızda kod yoksa, kodu siz ekleyebilirsiniz.

Shopify Plus

Shopify Komut Dosyaları ve Script Editor uygulaması yalnızca Shopify Plus planındaki satıcılar tarafından kullanılabilir. Script Editor uygulaması artık Shopify App Store'dan indirilememektedir.

Shopify Komut Dosyaları, 28 Ağustos 2025'te kaldırılacak ve bu tarihten sonra çalışmayacaktır. Mevcut Komut Dosyalarınızı bu tarihten önce Shopify Functions'a taşıyın.

Hata giderme

Komut dosyaları ve temalarda yaşanan çoğu sorun, indirim sunan satır öğesi komut dosyalarından kaynaklanır. Örneğin, siparişin toplam fiyatı doğrudur ancak satır öğesi fiyatında indirim gözükmez. Müşterilerin, indirimlerinin nasıl hesaplandığını anlaması gerekir. Müşteriler orijinal ve indirimli fiyatın yanı sıra indirimin kısa bir açıklamasını görmek isterler. Bu ayrıntılardan herhangi biri sepetinizde eksikse Liquid kodunu ekleyerek bu ayrıntıları görünür kılabilirsiniz.

Müşteri gibi davranıp mağazanızı ziyaret edebilir ve komut dosyasını tetikleyen işlemleri gerçekleştirerek komut dosyasının vitrininizi nasıl etkilediğini kontrol edebilirsiniz.

Liquid nesnesi özellikleri

Aşağıdaki listeler, mağazanızın sepetindeki komut dosyalarını desteklemek için sıkça ihtiyaç duyulan Liquid nesnesi özelliklerini içerir:

Cart nesnesi özellikleri:

• cart.total_discount
• cart.original_total_price

Satır öğesi özellikleri:

• line_item.discounts
• line_item.message
• line_item.original_price
• line_item.original_line_price
• line_item.total_discount

Komut dosyası nesnesi:

• Komut dosyası nesnesi, bir mağazanın etkin komut dosyaları hakkında bilgi getirmek için kullanılabilir. Bu nesne, komut dosyalarında hata ayıklama yaparken faydalı olabilir.

Örnek

Aşağıdaki örnek, cart.liquid şablonunuzun bir satır öğesi komut dosyasını desteklemesi için yapabileceğiniz değişiklikleri göstermektedir.

Örnek sepet

Örneğin, üç adet satır öğesi bulunan bir sepetiniz varsa:

• Futbol topu

  • Adet: 1
  • Birim fiyatı: 15,00 TL

• Tenis topu

  • Adet: 5
  • Birim fiyatı: 5,00 TL

• Koşu ayakkabısı

  • Adet: 1
  • Birim fiyatı: 30,00 TL

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

• İki veya daha fazla tenis topu alınırsa %10 indirim
• Tüm ayakkabılarda 5 TL indirim

Daha sonra cart.liquid şablonunuz, satır öğelerini ve onların toplam tutarı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>

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

Ürün	Adet	Total (Toplam)
Futbol topu	1	15,00 TL
Tenis topu	5	22,50 TL
Koşu ayakkabısı	1	25,00 TL
Total (Toplam)		62,50 TL

Satır öğelerini güncelleme

Komut dosyası tarafından uygulanan indirimleri göstermek için satır öğelerini güncelleyerek üç temel bilgiyi göstermesini sağlamamız gerekir:

• İndirimlerden önce satır fiyatı
• İndirimlerden sonra 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 İndirimlerden ö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ı, üstünü çizme efektini kullanarak indirimli satır fiyatından ayırmaya yardımcı 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>

Bunu yaptığınızda sepetiniz şöyle görünmelidir:

Ürün	Adet	Total (Toplam)
Futbol topu	1	15,00 TL
Tenis topu	5	22,50 TL 25,00 TL (iki veya daha fazla tenis topu alınırsa %10 indirim)
Koşu ayakkabısı	1	25,00 TL 30,00 TL (tüm ayakkabılarda 5 TL indirim)
Total (Toplam)		62,50 TL

Sepet özetini güncelleme

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

• Müşterilerin indirimden önceki ve sonraki toplamı karşılaştırabilmesi için sepetin ilk alt toplamı
• Müşterilerin sepetlerinde elde ettiği toplam kazanç.

Bu bilgiyi eklemek için yine 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 İndirimlerden önceki sepet alt toplamını döndürür.

Bu bilgilerden sonra, güncellenmiş .summary kod bloğu şöyle görünür:

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

Bunu yaptığınızda sepet tablonuz şöyle görünmelidir:

Ürün	Adet	Total (Toplam)
Futbol topu	1	15,00 TL
Tenis topu	5	22,50 TL 25,00 TL (iki veya daha fazla tenis topu alınırsa %10 indirim)
Koşu ayakkabısı	1	25,00 TL 30,00 TL (tüm ayakkabılarda 5 TL indirim)
Alt toplam		70,00 TL
İndirim toplamı		7,50 $
Total (Toplam)		62,50 TL

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

Diğer örnekler

Aşağıdaki Liquid örneği, her satır öğesi için indirimleri gösterir:

  {% 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 kodundaki değişikliklerini içeren başka bir indirim örneğine bakın.