Shopify Komut Dosyaları gereklilikleri ve sınırlamaları

Güvenliği artırmak ve mağazanızı aynı anda kaç müşterinin kullandığından bağımsız olarak komut dosyalarının çalışabilmesini sağlamak için bazı Shopify Komut Dosyaları sınırlamaları mevcuttur. Shopify mağazanız için komut dosyaları geliştiriyorsanız aşağıdaki kısıtlamaları aklınızda bulundurun.

Bu sayfada

Online mağaza ve Storefront API

Bir komut dosyası oluştururken veya düzenlerken komut dosyasının yalnızca online mağazanızda mı yoksa online mağazanızda ve aşağıdaki uygulamalarda mı çalışacağını seçersiniz:

Storefront API, JavaScript Buy SDK veya Mobile Buy SDKs (Android ve iOS) ile oluşturulmuş özel uygulamalar
Ödeme oluşturan özel uygulamalar
Tapcart ve Plobal Apps mobil uygulama oluşturucuları

Komut dosyalarının çalışması için web sitenizin yerleşik alışveriş sepeti işlevine sahip olması gerekir. Bu nedenle Buy Buttons veya Facebook and Instagram by Meta satış kanalı ile komut dosyalarını kullanamazsınız.

Yayınlanan komut dosyaları

Aynı anda komut dosyası türü başına yalnızca bir komut dosyası yayınlanabilir. Örneğin, bir satır öğeleri komut dosyası ve bir kargo ücretleri komut dosyası yayınlayabilirsiniz ancak aynı anda iki satır öğeleri komut dosyasını 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 ücreti komut dosyaları ve ödeme komut dosyaları; taslak siparişler veya taslak sipariş ödemesi ile çalışmaz.

Meta alanlar

Shopify Komut Dosyaları, meta alanlara erişemez.

Sepet/ödeme özellikleri

Shopify Komut Dosyaları, Shopify Liquid sepet özelliklerine erişemez. Müşterilerinizden ek bilgi toplamak için bu özellikleri sepet sayfalarınıza ekleyebilirsiniz ancak bunları kullanan bir komut dosyası oluşturamazsınız.

İndirim kodları

Komut dosyaları; bir indirim kodunun uygulanıp uygulanmadığına, indirim tutarına ve indirimin sabit tutar, yüzde veya kargo gibi türüne erişebilir. Komut dosyaları, indirim kodunun sepete özel mi yoksa satır öğesine özel mi olduğu gibi, nasıl uygulandığına erişemez. Bu, komut dosyalarının indirim sonrası toplam tutarlara veya otomatik indirimlere erişemeyeceği anlamına gelir.

Bir sepete uygulanan indirimlere erişen satır öğesi ve kargo komut dosyaları, indirim kombinasyonlarıyla uyumlu değildir. .discount_code yöntemi yalnızca tek bir indirim kodu döndürebilir. İndirim kombinasyonları kullanılarak 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.

Çoklu para birimi

Komut dosyalarınız, çoklu para birimi ile beklendiği gibi çalışmayabilir. Komut dosyalarınızın, mağazanızın birincil para birimi dışındaki herhangi bir para birimindeki sepetlerde veya ödemelerde çalıştığından emin olmak için komut dosyalarınızı Shopify Functions platformuna taşımanız gerekir.

Normal ifadeler

Normal ifade eşleştirme desteklenmez. Bir satır öğesi komut dosyası oluşturuyorsanız geçici bir çö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ı desteklemek ve müşterilerinizin kafasının karışmasını önlemek için Liquid temanızı güncellemeniz gerekebilir. Örneğin, tüm temalar satır öğesi indirimlerini sepette göstermez. Sizin durumunuz buysa satır öğesi indirimlerini sepette göstermek için temanızı düzenlemeniz gerekir. Liquid temalarınızda yapabileceğiniz değişiklik türleri hakkında daha fazla bilgi edinin.

Kaynaklar

Bir komut dosyasının kullanabileceği CPU ve bellek miktarı sınırlıdır. Bir komut dosyası için ayrılan kaynaklar, sepetin boyutuna ve komut dosyasının gerektirdiği hesaplama miktarına bağlıdır. Shopify, komut dosyanızın amaçlandığı gibi çalışmasını engellemediğinden emin olmak için bu kaynak sınırlarını dikkatli bir şekilde takip eder.

Bir komut dosyasını test ettiğinizde, Script Editor konsolu, komut dosyasının kullandığı ayrılmış kaynakların yüzdesini yazdırır.

Girdi/çıktı

Birkaç istisna dışında Shopify Komut Dosyaları girdi/çıktı yapamaz. Bu, komut dosyalarının web istekleri veya veritabanı çağrıları yürütemeyeceği ve bir kullanıcıdan girdi alamayacağı anlamına gelir.

puts yöntemi, Script Editor uygulamasındaki konsola metin yazdırmak için kullanılabilir.

Zaman ve rastgelelik

Komut dosyaları, rastgele veya zamana dayalı hesaplamalar içeremez. Shopify Komut Dosyaları, Time nesnesine ve rand yöntemine erişemez.

Bir sepetin toplam tutarı her yeniden hesaplandığında komut dosyaları çalıştığı için zamana veya rastgele sayı oluşturmaya dayalı komut dosyaları, bir müşteri sepetini sık sık değiştirirse öngörülemeyen veya kafa karıştırıcı sonuçlar doğurabilir. Ancak Launchpad uygulamasını kullanarak komut dosyalarını etkinlikler sırasında çalışacak şekilde planlayabilirsiniz.

Komut dosyası karakter sınırı

Maksimum 40.960 karaktere kadar komut dosyaları oluşturabilirsiniz.

Abonelik siparişleri

Satır öğesi ve kargo komut dosyalarınız bir abonelik ürünü için indirim oluşturursa bu indirim aşağıdaki ödemelere uygulanır:

yalnızca teslimat başına ödeme türündeki siparişlerin ilk ödemesi (planlanmış siparişlere uygulanmaz)
ön ödemeli abonelik siparişinin tutarının tamamı

Abonelikler ve komut dosyaları hakkında daha fazla bilgi edinin.

Hızlı ödemeler

Hızlı ödemeler ile Shopify Komut Dosyaları kullandığınızda, müşteriniz bir hızlı ödeme yöntemi seçtikten sonra kargo indirimleri uygulanır. Bu nedenle, siparişin fiyatındaki değişiklikler müşterinin cihazına veya tarayıcısına yansıtılmaz. Müşteriler, hızlı ödemede orijinal fiyatı görebilir ancak onlardan doğru, indirimli fiyat tahsil edilir.

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çidi adı olarak resimlerin veya logoların gösterildiği ödeme ağ geçitlerini yeniden adlandıramazsınız. Adlarının yanında logo resimleri olan ödeme ağ geçitleri yeniden adlandırılabilir.

Ödemede kargoyu bölme

Kargo komut dosyaları, Shopify Checkout'ta kargoyu bölme özelliğiyle uyumlu değildir. Kargo komut dosyaları kullanır ve kargoyu bölme özelliğini etkinleştirirseniz bölünmüş kargolar, müşterilerinize ödeme sayfasında gösterilmez.