Shopify Scripts çalışmayı bıraktı. Her script’in mantığı artık nereye gidiyor?
Kısa yanıt
Shopify Scripts 30 Haziran 2026’da çalışmayı bıraktı. Mantıkları Shopify Functions’a taşınıyor: satır öğesi script’leri Discount Function API’ye (paketler için Cart Transform’a), kargo script’leri Delivery Customization API’ye ve teslimat indirimlerine, ödeme script’leri de Payment Customization API’ye. Functions içeren özel uygulamalar yalnızca Shopify Plus mağazalarında çalışır.
- Shopify Scripts’i düzenlemek ve yayınlamak 15 Nisan 2026’da durdu; tüm Scripts 30 Haziran 2026’da çalışmayı bıraktı.
- Shopify yönetim panelindeki Scripts customizations raporu, bir mağazanın sahip olduğu ödeme, kargo ve ürün indirimi özelleştirmelerini listeler.
- Her plandaki mağazalar Functions içeren App Store uygulamalarını kullanabilir; Functions içeren özel uygulamaları yalnızca Shopify Plus mağazaları kullanabilir.
- Functions saati okuyamaz ya da rastgele değer üretemez: bir Function’ın çalıştığı veri girdi sorgusundan gelir.
- Ödeme vadesi belirlemek Shopify Plus gerektirir. Bir sepet satırının fiyatını, başlığını ya da görselini Cart Transform ile değiştirmek Shopify Plus ya da geliştirme mağazası gerektirir.
Ödeme sayfanızdaki bir indirim, kargo kuralı ya da ödeme kuralı 30 Haziran 2026’da çalışmayı bıraktıysa bunun bir Shopify Script olup olmadığına bakın. Shopify, Scripts’i düzenlemeyi ve yayınlamayı 15 Nisan 2026’da durdurdu ve tüm Scripts 30 Haziran 2026’da çalışmayı bıraktı. Hâlâ yayında olan Scripts devre dışı bırakıldı.
Önce elinizde ne olduğunu çıkarın
Shopify yönetim panelinde bir Scripts customizations raporu bulunur. Kullanımdan kaldırılmadan önce etkin olan özelleştirmeleri ödeme altyapıları, kargo ve ürün indirimleri başlıkları altında listeler. Hafızaya ya da eski koda güvenmek yerine geçişin envanteri olarak bu raporu kullanın.
Her kayıt için kuralı sade bir dille yazın: hangi sepetlere uygulanıyordu, neyi değiştiriyordu ve neden vardı? Bazı kuralları Shopify’ın yerleşik indirimlerinin ya da hazır bir App Store uygulamasının zaten karşıladığı ortaya çıkar. Gerisi bir Shopify Function gerektirir.
Her script türü nereye gidiyor?
| Script türü | Ne yapıyordu | Yerini alan Function API |
|---|---|---|
| Satır öğesi (line item) | Sepet satırlarında fiyatları değiştiriyor ve indirim uyguluyordu | İndirimler için Discount Function API (sepet satırı hedefi); paketler için Cart Transform. Bir satırın fiyatını, başlığını ya da görselini değiştirmek (Cart Transform lineUpdate) Shopify Plus ya da geliştirme mağazası gerektirir |
| Kargo | Kargo yöntemlerini yeniden adlandırıyor, gizliyor ya da yeniden sıralıyor ve ücretlere indirim uyguluyordu | Delivery Customization API; ücret indirimleri için Discount Function API’nin teslimat hedefi |
| Ödeme | Ödeme altyapılarını yeniden adlandırıyor, gizliyor ve yeniden sıralıyordu | Payment Customization API |
Yeniden geliştirirken iki fark önemlidir. Teslimat seçenekleri yeniden adlandırılabilir, ama kargo firmasının adı yeni başlığın başında kalır. Kargo seçeneklerini yeniden sıraladığınızda da varsayılan olarak seçili olan seçenek en ucuz seçenek olarak kalmalıdır.
Geliştirmeyi belirleyen kısıtlar
- Plan. Her plandaki mağazalar Functions içeren App Store uygulamalarını kullanabilir; ama Functions içeren özel bir uygulamayı yalnızca Shopify Plus mağazaları kullanabilir. Plus olmadan mantığın Shopify App Store’daki bir uygulamadan gelmesi gerekir. Bazı yetenekler de hangi tür uygulamayı kullanırsanız kullanın Plus ister: ödeme vadeleri ve Cart Transform
lineUpdate(geliştirme mağazalarında da kullanılabilir). - Veri. Bir Function yalnızca GraphQL girdi sorgusunun istediğini alır. Saati okuyamaz ya da rastgele değer üretemez. Kademeler ya da eşikler gibi ihtiyaç duyduğu veriler genellikle metafield’lardan (meta alanlardan) ya da sepet özniteliklerinden gelir.
- Boyut ve hız. Functions, 256 kB derlenmiş ikili dosya dahil sabit sınırlarla ödeme sayfasının içinde çalışır. Shopify performans için Rust’ı önerir; JavaScript ve TypeScript da desteklenir.
- Mağaza başına sınırlar. Bir mağaza en fazla 25 teslimat özelleştirme function’ı ve 25 ödeme özelleştirme function’ı etkinleştirebilir.
Functions başka neler yapabilir?
Geçiş, kuralların kendisini yeniden gözden geçirmek için de bir fırsattır. Cart and Checkout Validation API’si, örneğin bir adet sınırında, ödeme adımını açık bir hata mesajıyla engelleyebilir. Shopify Plus mağazalarında Payment Customization API, kurumsal alıcılar için vadeli ödeme gibi ödeme vadeleri de belirleyebilir. Bir Function ayarlarını bir metafield’dan okuduğunda eşik değeri kod değişikliği olmadan değişebilir.
Mantıklı bir çalışma sırası
- Scripts customizations raporunu açın ve her kuralı sade bir dille yazın.
- Her kuralı yerleşik indirim, App Store uygulaması ya da özel Function olarak işaretleyin.
- Planı kontrol edin: özel Functions, Shopify Plus gerektirir.
- Her Function’ı gerçekçi sepetlerle bir geliştirme mağazasında geliştirip test edin, sonra canlı mağazaya kurun.
- Ödeme sayfası toplamlarını, aynı türde sepetler için 30 Haziran öncesindeki siparişlerle karşılaştırın.
Sık sorulan sorular
- Shopify Scripts’i hâlâ düzenleyebilir ya da çalıştırabilir miyim?
- Hayır. Düzenleme ve yayınlama 15 Nisan 2026’da durdu; tüm Scripts 30 Haziran 2026’da çalışmayı bıraktı.
- Shopify Functions kullanmak için Shopify Plus gerekir mi?
- App Store uygulamaları için gerekmez: her plandaki mağazalar Functions içeren herkese açık uygulamaları kullanabilir. Functions içeren özel bir uygulama yalnızca Shopify Plus mağazalarında çalışır; ödeme vadeleri gibi bazı yetenekler de her durumda Plus gerektirir.
- Bir kargo script’inin yerini hangi Function alır?
- Delivery Customization API teslimat seçeneklerini yeniden adlandırır, sıralar ve gizler. Kargo ücretlerindeki indirimler Discount Function API’nin teslimat hedefini kullanır.
Kaynaklar
- Shopify Scripts will be deprecated on June 30, 2026
- Transitioning from Shopify Scripts to Shopify Functions
- Shopify Scripts and the Script Editor app
- About Shopify Functions
- Function APIs: limitations
- Delivery Customization Function API
- Payment Customization Function API
- About functions in payments (payment terms)
- Discount Function API
- Cart Transform Function API
- Cart and Checkout Validation Function API
