Ana içeriğe atla
Kod düzenleyici, bir şablon üzerinde size tam kontrol sağlar. Şablonlar, Shopify’ın kullandığı şablon dili olan Liquid ile yazılmış HTML ve CSS’dir: {{ order_name }} siparişin adını yazdırır, {% for line_item in line_items %} her ürün için tekrarlanır. Foliant’ın sipariş değişkenleri Shopify Order Printer’ınkileri izler. Bu nedenle onun için yazılmış şablonlar çoğunlukla olduğu gibi çalışır. Kod düzenleyici tüm planlarda bulunur.

Kod düzenleyiciyi açma

Şablonu düzenleyicide açın ve Kod sekmesine tıklayın. Kod şablonları doğrudan burada açılır. Görsel bir şablonda önce derlenmiş kodu görürsünüz. Değiştirmek için Kodu düzenle’ye tıklayın. Görsel ve Kod arasında geçiş yapma bölümüne bakın. Sol bölmede üç sekme vardır: Sağ bölme canlı önizlemedir. Yazmayı bıraktıktan kısa süre sonra güncellenir.

Alan ekleme

  1. İmleci alanın gelmesi gereken yere koyun.
  2. Alan ekle’ye tıklayın.
  3. Alanlarda ara altında alanı arayın (örneğin “tracking” veya “SKU”) ve üzerine tıklayın.
Foliant, alanın Liquid kodunu imlecin olduğu yere ekler, örneğin {{ shipping_address.city }}. {{ line_item.sku }} gibi satır öğesi alanları yalnızca satır öğeleri döngüsü içinde çalışır. Döngünün kendisi için Satır öğeleri’ni ekleyin.

Kodda arama

Şablonda metin bulmak için Alan ekle’nin yanındaki arama düğmesine tıklayın (veya kod içindeyken ⌘F / Ctrl+F tuşlarına basın).

Kod hataları

Düzenleyici, siz yazarken kodunuzu denetler ve sorunları kenar boşluğunda işaretler:
  • Hatalar kaydetmenizi engeller ve önizlemeyi duraklatır. Kapatılmamış bir {{ veya {% bir hatadır. Hatalar, düzenleyicinin üstündeki Kod Hataları başlığında, her biri Satıra git ile birlikte listelenir.
  • Uyarılar yanlış olabilecek şeylere dikkat çeker ama kaydetmenizi engellemez. Örneğin bilinmeyen bir Liquid filtresi, etiketi veya nesnesi, bilinmeyen bir HTML etiketi veya CSS özelliği ya da kapatılmamış bir HTML etiketi.
Kaydettiğinizde Foliant şablonu da denetler: Liquid okunabilir olmalı, HTML etiketleri dengeli olmalı ve satır içi SVG yalnızca çizim öğeleri içermelidir. Bir sorun varsa kaydetme başarısız olur ve bir Güncellenemedi başlığı, biliniyorsa satır numaralarıyla birlikte en fazla beş sorunu listeler. Şablon kaydedilir ama önizleme oluşturulamazsa, bir başlık Liquid’in mesajını ve biliniyorsa satırı gösterir.

İyi şablonlar yazma

  • Para değerleri kuruş cinsindendir: Bunları her zaman {{ total_price | money }} gibi bir para filtresiyle yazdırın. Şablonlarda para ve para birimi bölümüne bakın.
  • Notlar ve adresler gibi müşterilerin yazdığı metinlerde | escape kullanın: {{ note | escape }}.
  • Belgenin dilini izleyen ifadeler için {{ 'subtotal' | t }} kullanın. Tarihler, diller ve çeviriler bölümüne bakın.
  • KDV için Foliant’ın yerleşik parçacıklarını kullanın: {% include 'vat_breakdown' %} KDV döküm tablosunu, {% include 'legal_notes' %} ise yasal notları (ters ibraz, ihracat, IOSS…) yazdırır.

Bilmeniz gerekenler

  • Numaralı bir şablon (fatura, iade faturası veya teklif) document_number değerini hiçbir yerde yazdırmıyorsa, Foliant belgenin sonuna numarayı içeren küçük bir satır ekler. Şablonlarda belge numaraları bölümüne bakın.
  • Kod şablonları için sayfa numaraları ve tekrarlanan tablo başlıkları, şablonun ayarlar sayfasında Sayfa düzeni altında bulunur.
  • Shopify Order Printer veya Order Printer Pro’dan bir şablon aktarmak için Şablonlar sayfasındaki Şablon içe aktar seçeneğini kullanın. Order Printer’dan şablon içe aktarma bölümüne bakın.

İlgili makaleler