Komut dosyası gereklilikleri ve sınırlamaları
Komut dosyası oluşturabilmek için Shopify Plus planında olmanız ve Script Editor'a sahip olmanız gerekir. Ayrıca, Ruby programlama diliyle ilgili bilgi sahibi olmanız veya bu programlama dilini bilen bir geliştiriciye ya da Shopify İş Ortağına erişiminiz olması gerekir. Bir Shopify İş Ortağı ile çalışma hakkında daha fazla bilgi edinin.
Bazı komut dosyası sınırlamaları, güvenliği artırmak ve bu komut dosyalarının herhangi bir zamanda mağazanızda kaç müşteri olursa olsun çalışmasını sağlamak için vardır. Shopify mağazanız için komut dosyaları geliştiriyorsanız aşağıdaki sınırlamaları göz önünde bulundurun.
Bu sayfada
- Online mağaza ve Vitrin API'si
- Yayınlanmış komut dosyaları
- Maksimum Shopify Komut Dosyası sayısı
- Taslak siparişler
- Meta alanlar
- Sepet/ödeme sayfası özellikleri
- İndirim kodları
- Satır öğeleri
- Kargo ücretleri
- Normal ifadeler
- Temalar
- Kaynaklar
- Girdi/çıktı
- Zaman ve rastgelelik
- Komut dosyası karakter sınırı
- Abonelik siparişleri
- Hızlı ödemeler
- Shopify Point of Sale (POS)
- Ödeme ağ geçitlerini yeniden adlandırma
Online mağaza ve Vitrin API'si
Bir komut dosyası oluştururken veya düzenlerken, bu komut dosyasının yalnızca online mağazanızda mı yoksa online mağazanızın yanı sıra aşağıdaki uygulamalarda da mı çalışacağını seçersiniz:
- Vitrin API'si, JavaScript Satın Alma SDK'sı ve Mobil Satın Alma SDK'sı (Android ve iOS) ile geliştirilen özel uygulamalar
- Ödeme sayfaları oluşturulan özel uygulamalar
- Tapcart ve Plobal Apps mobil uygulama geliştiricileri
Komut dosyalarının çalışması için web sitesinin yerleşik alışveriş sepeti işlevselliği olması gerekir. Bu nedenle Satın Al Düğmesi, Facebook veya Toptan satış kanallarını komut dosyalarıyla kullanamazsınız.
Yayınlanmış komut dosyaları
Her komut dosyası türü için tek seferde yalnızca bir komut dosyası yayınlanabilir. Örneğin, bir satır öğesi ve bir kargo ücreti komut dosyası yayınlayabilirsiniz ancak aynı anda iki farklı satır öğesi komut dosyası yayınlayamazsınız.
Maksimum Shopify Komut Dosyası sayısı
En fazla 200 Shopify Komut Dosyası oluşturabilirsiniz.
Taslak siparişler
Satır öğesi komut dosyaları, kargo komut dosyaları ve ödeme komut dosyaları, taslak siparişlerle veya taslak siparişi ödeme sayfalarıyla çalışmaz.
Meta alanlar
Shopify Komut Dosyalarının Meta alanlara erişimi yoktur.
Sepet/ödeme sayfası özellikleri
Shopify Komut Dosyaları, Shopify Liquid sepet özelliklerine erişemez. Müşterilerinizden ilave bilgi toplamak için bu özellikleri sepet sayfalarınıza ekleyebilirsiniz ancak özellikleri kullanan bir komut dosyası oluşturamazsınız.
İndirim kodları
Komut dosyaları; bir indirim kodunun uygulanıp uygulanmadığına, indirimin tutarına ve indirim türüne (sabit tutar, yüzde veya kargo) erişebilir. Ancak nasıl uygulanacağına (sepet veya satır öğesine özel) erişemezler. Bu nedenle, komut dosyaları indirim sonrası toplamlara ve ayrıca, otomatik indirimlere erişemez.
Sepete uygulanan indirimlere erişen satır öğesi ve kargo komut dosyaları, indirim kombinasyonlarıyla uyumlu değil. .discount_code yöntemi yalnızca tek bir indirim kodu döndürebilir. İndirim kombinasyonları kullanan birden fazla indirim kodu içeren sepetler desteklenmez.
Satır öğeleri
Komut dosyaları, sepete ürün ekleyemez veya bir ürünün fiyatını artıramaz.
Kargo ücretleri
Komut dosyaları, bir kargo ücretinin fiyatını artıramaz.
Normal ifadeler
Normal ifade eşleştirme desteklenmemektedir. Bir satır öğesi komut dosyası oluşturacaksanız geçici çözüm olarak aşağıdaki yöntemlerden birini kullanabilirsiniz:
- split yöntemi
- start_with ve end_with yöntemleri
- include yöntemi
Temalar
Komut dosyalarınızın desteklenmesi ve müşterilerinizin aklını karışmasından kaçınmak için Liquid temanızı güncellemeniz gerekebilir. Örneğin, bazı temaların sepetinde satır öğesi indirimleri gözükmez. Siz de bu durumu yaşıyorsanız sepetinizde satır öğesi indirimlerini göstermek için temanızı düzenlemeniz gerekir. Liquid temalarınızda yapabileceğiniz değişiklikler hakkında daha fazla bilgi edinin.
Kaynaklar
Bir komut dosyasına ayrılan işlemci ve bellek gücü sınırlıdır. Komut dosyasının kullandığı kaynaklar, komut dosyasının gerektirdiği hesaplamaların ve sepetin boyutuna bağlıdır. Shopify, komut dosyalarınızın beklediğiniz şekilde çalışmasını sağlamak için bu kaynak sınırlarını yakından takip eder.
Siz bir komut dosyasını test ederken, Script Editor konsolu, komut dosyasına ayrılan kaynakların yüzdesini yazdırır.
Girdi/çıktı
Birkaç istisna dışında Shopify Komut Dosyaları girdi/çıktı yapamaz. Yani komut dosyaları, web isteklerini veya veritabanı çağrılarını işleyemez ve kullanıcıdan girdi alamaz.
Ancak puts
yöntemi, Script Editor uygulamasının konsoluna metin yazdırmak için kullanılabilir.
Zaman ve rastgelelik
Komut dosyaları rastgele veya zamana dayalı hesaplamalar içeremez. Time
nesnesi ve rand
yöntemine Shopify Komut Dosyaları erişemez.
Komut dosyaları bir sepetin toplam tutarı her hesaplandığında çalıştığı için zamana dayalı veya rastgele sayı oluşturan komut dosyaları, müşteriniz sepetinde çok sayıda değişiklik yaptığı zaman öngörülemez veya kafa karıştırıcı sonuçlar doğurabilir. Ancak Launchpad uygulamasını kullanarak komut dosyalarının etkinlik süresince çalışmasını planlayabilirsiniz.
Komut dosyası karakter sınırı
En fazla 24.576 karakter uzunluğunda komut dosyaları oluşturabilirsiniz.
Abonelik siparişleri
Satır öğeniz ve kargo komut dosyalarınız tarafından bir abonelik ürününe indirim uygulanırsa, indirim aşağıdaki ödemeler için geçerli olur:
- Planlanan siparişlere uygulanmadan, yalnızca teslimat başına ödeme işleminin ilk ödemesi
- Önceden ödenmiş bir abonelik sipariş tutarının tamamı
Abonelikler ve komut dosyaları hakkında daha fazla bilgi edinin.
Hızlı ödemeler
Hızlı ödeme içeren Komut Dosyaları kullanıyorsanız, kargo ücreti indirimleri müşteriniz hızlı ödeme yöntemini seçtikten sonra uygulanır. Bu nedenle sipariş fiyatındaki değişiklikler müşterinin cihazına veya tarayıcısına yansımaz. Müşteriler hızlı ödeme sayfasında asıl fiyatı görmelerine rağmen doğru olan indirimli fiyatı öderler.
Shopify Point of Sale (POS)
Shopify Komut Dosyaları, Shopify Point of Sale (POS) ile çalışmaz.
Ödeme ağ geçitlerini yeniden adlandırma
Ağ geçidinin adı olarak görüntülenen resimlere veya logolara sahip ödeme ağ geçitlerini yeniden adlandıramazsınız. Adlarının yanında logo görselleri olan ödeme ağ geçitlerini yeniden adlandırabilirsiniz.