Mağazanız Shopify Plus'ta değilse, yine de çoğu Shopify Function API'sini kullanabilirsiniz, ancak yalnızca Shopify App Store aracılığıyla dağıtılan genel uygulamalar yoluyla. Function API'leri içeren özel uygulamalar Plus'a özel bir yetenek olmaya devam eder ve hiçbir geçici çözümü yoktur. Shopify'nin kendi belgelerinde onaylanan ve Plus olmayan mağazalarda geliştiriciyle çalışan her hata mesajında yinelenen bu tek kural, bu makaledeki diğer her şeyi tanımlar.
Başlıca noktalar
- Herhangi bir ücretli plan, Function içeren genel App Store uygulamalarını yükleyebilir. Bu, Discount, Delivery Customization, Payment Customization, Cart Transform ve Cart/Checkout Validation'ı kapsar.
- Function API'leri içeren özel uygulamalar (Dev Dashboard, özel dağıtım) Plus olmayan mağazalarda engellenir. Hata açıktır: "Shop must be on a Shopify Plus plan to activate functions from a custom app."
- İki API uygulama türünden bağımsız olarak Plus'a özeldir: Order Routing Location Rule (talep üzerine kullanılabilir) ve Cart Transform içindeki
lineUpdateişlemi. - Shopify Scripts 30 Haziran 2026'da yürütülmeyi durdurdu. Mantığı bir Function'a veya genel uygulamaya aktarılmayan herhangi bir tüccar artık hiçbir şey çalıştırmıyor.
- Dağıtım türü (genel vs özel) Dev Dashboard'da kalıcı ve geri döndürülemez bir seçimdir. Çok mağazalı yüklemeleri App Store incelemesinden atlatmak için "listelenmeyen genel" bir orta yol yoktur.
Kural, açık şekilde belirtildi
Shopify'nin plan kuralı kısa ve açıktır: herhangi bir ücretli plandaki mağazalar Function içeren genel App Store uygulamalarını yükleyebilir; yalnızca Shopify Plus mağazaları Function API'leri içeren özel uygulamaları etkinleştirebilir.
Dev Dashboard'da mükemmel şekilde çalışan bir uygulama oluşturan, bunu bir geliştirme mağazasında test eden, ardından işlevi bir Basic veya Advanced istemci mağazasında etkinleştirmeye çalışan geliştiricilere bunun kafasını karıştırdığını gördüm. Etkinleştirme mutasyonu bir sabit hataya dönüş verir. Çevirmek için sunucu tarafı bayrak yoktur ve Shopify'nin geliştirici toplum forumları tarafından onaylanmış hiçbir geçici çözümü yoktur.
Bunun pratikte kafa karıştırıcı yapan şey, hatanın derleme zamanında değil, etkinleştirme zamanında çıkmasıdır. Wasm ikili dosyanız iyi derlenebilir. Uygulama yüklenir. Function'ı etkinleştirmek için GraphQL mutasyonu geri dönüş yapar.
Plus olmayan mağazalar için hangi Function API'leri kullanılabilir (genel uygulamalar aracılığıyla)
| Function API | Kontrol ettiği şey | Plus olmayan mağazada genel uygulama aracılığıyla mı? | Notlar |
|---|---|---|---|
| Discount (Product, Order, Shipping) | Satır indirimleri, sipariş düzeyi promolar, kargo maliyeti indirimleri | Evet | 2025-04 sürümünden itibaren tek bir API'ye birleştirildi |
| Delivery Customization | Checkout'ta kargo yöntemlerini gizle, yeniden adlandır, yeniden sırala | Evet | Mağaza başına 25 etkin kadar |
| Payment Customization | Ödeme ağ geçitlerini gizle, yeniden adlandır, yeniden sırala | Evet | Mağaza başına 25 etkin kadar |
| Cart Transform (lineExpand, linesMerge) | Paket genişletme, satır birleştirme | Evet | Mağaza başına toplam bir etkin Cart Transform; aşağıdaki nota bakın |
| Cart Transform (lineUpdate) | Bir satırda fiyat, başlık veya görüntüyü geçersiz kıl | Hayır | Plus ve dev mağazaları yalnızca, uygulama türünden bağımsız olarak |
| Cart and Checkout Validation | Özel kuralları ihlal eden bir checkout'u engelle | Evet | 2025-07 hedef yeniden adlandırmasından bu yana diğer API'ler gibi işlemler döndürür |
| Fulfillment Constraints | Yerine getirme gruplarının nasıl oluşturulacağını tanımla | Kısmen | Genel uygulamalar aracılığıyla genel olarak mevcut |
| Order Routing Location Rule | Sipariş başına depo/konum önceliğini sırala | Hayır | Plus yalnızca, talep üzerine mevcut |
Cart Transform içindeki lineUpdate kısıtlaması, çoğu yazı Cart Transform API'sinin tamamının Plus'a özel olması ile karıştırdığı için dikkatlice okunmaya değer. Bu yanlış. lineExpand (bir satırı bileşenlere ayır) ve linesMerge (satırları birleştir) böyle bir kısıtlamayı taşımaz. Temel plandaki bir mağaza, bugün genel bir uygulama aracılığıyla tamamen işlevsel bir paket genişletme-ve-birleştirme Cart Transform işlevi gönderilebilir. Plus gereksinimi yalnızca bir satırda fiyat, başlık veya görüntü geçersiz kılmalarına iliştirilir.
Benzer şekilde, Shopify 2025-07 sürümünde Function API'leri arasında hedef ve işlem adlarını standartlaştırdı. purchase.cart-transform.run cart.transform.run oldu ve expand/merge/update lineExpand/linesMerge/lineUpdate oldu. 2025-07 veya daha sonraki bir API sürümü kullanılacak şekilde güncellenmemiş bir Function'ı koruyorsanız, bu yeniden adlandırmalar sizi etkiler.
İki dağıtım türü ve seçim neden geri döndürülemez
Shopify Dev Dashboard'da uygulama oluşturma sırasında iki dağıtım yolundan birini seçersiniz:
- Özel dağıtım: tek bir mağaza, bir Shopify Plus kuruluşu içindeki tüm mağazalar veya transfer devre dışı geliştirme mağazalarında yüklenir. App Store incelemesi yok. Shopify faturalama API'si yok. Plus olmayan mağazalarda Function API'leri engellenir.
- Genel dağıtım: uygulamayı Shopify App Store'da (veya listelenmemiş genel uygulama olarak) listeler. App Store incelemesi gerekli. Fonksiyonlar herhangi bir ücretli planda etkinleşir.
Kritik nokta, bu seçimin kalıcı olmasıdır. Özel dağıtım olarak oluşturulan bir uygulama daha sonra genel dağıtıma dönüştürülemez ve bunun tersi de geçerlidir. Bir geliştirici, Plus olmayan bir istemci için Payment Customization Function içeren özel dağıtım uygulaması oluşturursa, etkinleştirme hatasıyla karşılaşacak ve ileriye doğru yolu şunlardır:
- İstemci Shopify Plus'a yükseltilir.
- Geliştirici, genel dağıtım altında ayrı, yeni bir uygulama oluşturur ve App Store incelemesinden geçer.
- İstemci, gereksinimi karşılayan yapılandırılabilir mantığı olan App Store'da var olan genel bir uygulamayı bulur.
Seçenek 3, Plus olmayan fiyat noktalarında çoğu Plus olmayan tüccar için doğru cevaptır. Bunu birçok mağaza genelinde Plus olmayan fiyat noktalarında kurduktan sonra, indirim mantığı, teslimat yöntemi gizleme ve ödeme yöntemi yeniden sıralama kapsayan mevcut genel uygulamalar gerçekten iyidir. Kısıtlama işlevselliğin mevcut olmaması değildir; mantığın tam olarak sizin tam iş kurallarınıza göre olamayacağıdır.
"App Store'da yayınla" gerçekten tek mağazalık bir kullanım durumu için ne anlama gelir
Geliştiricilerin düştüğü tuzak budur: genel bir uygulamanın "listelenmemiş" (aramada gösterilmez) olarak listelenebileceğini düşünmek, özel uygulamaya benzer gizlilik elde ederken Plus olmayan bir mağaza için Function erişimini açabilirler. Bu şekilde çalışmaz.
Genel dağıtım altında listelenmeyen durumu olan bir uygulama, herhangi bir tüccarın yükleyebilmesi için önce Shopify App Store incelemesi gerektirir. Birden çok ilişkisiz mağazaya yüklüyorsanız, genel dağıtım gereklidir, çünkü özel dağıtım bir mağaza veya bir Plus kuruluşu ile kapsamlıdır. İnceleme zaman alır ve uygulamanın App Bridge, doğru OAuth akışı, barındırılan uygulama URL'si ve otomatik kontroller geçme de dahil olmak üzere Shopify'nin ortak gereksinimlerini karşılamasını gerektirir.
Function'a ihtiyaç duyan tek bir Plus olmayan mağaza için App Store'da yalnızca o mağaza için yayınlamak büyük bir yüktür: bir Function içeren ve bakım yapmanız gereken kamu incelemeli bir uygulama oluşturuyorsunuz ve tüm uyumluluğu içerir, tek bir tüccar'a hizmet verecek şekilde. Bu durumda daha pratik çağrı genellikle şudur: kuralı kapsayan en yakın genel uygulamayı bulun veya Plus'a yatırım yapın.
Shopify App Distribution için sözlük girişine özel vs genel dağıtım mekaniklerinin tam bir dökümü için bakın.
Scripts gitti: bu şu anda Plus olmayan mağazalar için ne anlama gelir
Shopify 15 Nisan 2026'da Script düzenlemelerine izin vermeyi durdurdu ve 30 Haziran 2026'da tüm Script'leri kapattı. Script'ler yalnızca Ruby idi ve Plus'a özel idi. Fonksiyonlar onları değiştirdi, WebAssembly tabanlıdır, 5 ms altında çalışır ve eski üç Script türü yerine 11 API türünü kapsar.
Önemli tarihsel kayma: Script'ler Plus'a özel bir araçtı. Genel uygulamalar aracılığıyla Function'lar her ücretli planda mevcuttur. Script'lerden Function'lara olan net hareket aslında Plus olmayan tüccarlar için erişimi azalttı değil, genişletti. Önceki deneyimi "Plus olmadan özel indirim mantığı yapamam" olan herhangi bir tüccar bu varsayımı yeniden gözden geçirmelidir. App Store artık Basic plan mağazalarında BOGO, ses düzeyi kırılması, satın alma ile ücretsiz hediye, teslimat yöntemi gizleme ve ödeme yöntemi yeniden sıralamaya yönelik Function tabanlı uygulamalara sahiptir.
Plus olmayan tüccarlar hala ne yapamaz:
- App Store'da yayınlamadan depoya özel Function mantığı çalıştırın.
- Cart Transform'un
lineUpdateişlemini kullanarak bir satırı yeniden fiyatlandırın veya yeniden başlık yapın. - Order Routing Location Rule API'sine erişin.
- Checkout'u kod aracılığıyla şekillendirmek için Branding API'sini kullanın.
- UI uzantılarını Information, Shipping veya Payment checkout adımlarının içine yerleştirin (bu adımlar Checkout UI uzantıları için Plus'a özel olmaya devam eder).
Somut bir desen: Plus olmayan mağazada Delivery Customization
Advanced plan'daki bir istemcinin, sepet toplamı eşik altında olduğunda belirli bir taşıyıcı oranını gizlemesi gerektiğini varsayın. Desen:
Genel uygulama kullanma (herhangi bir plan için mevcut): App Store'dan genel bir Delivery Customization uygulaması yükleyin. Gizleme kuralını uygulamanın yönetici UI'si aracılığıyla yapılandırın. Function, Shopify'nin altyapısında sunucu tarafında çalışır. Barındırma yok, kod sahipliği yok.
Özel uygulama kullanma (Plus yalnızca):
// Simplified Delivery Customization Function (JavaScript)
export function run(input) {
const cartTotal = input.cart.cost.totalAmount.amount;
const operations = input.cart.deliveryGroups
.flatMap(group => group.deliveryOptions)
.filter(option => option.title === "Express Shipping")
.filter(() => parseFloat(cartTotal) < 50.0)
.map(option => ({
hide: { deliveryOptionHandle: option.handle }
}));
return { operations };
}
Bu işlev Wasm'a derlenebilir, deliveryCustomizationCreate Admin API mutasyonu aracılığıyla etkinleştirilir ve her checkout isteğinde 5 ms altında çalışır. Plus mağazasında, tam mantığa sahipsiniz. Plus olmayan mağazada, uygulama genel dağıtım altında olmadığı sürece bu etkinleştirme mutasyonu bir hata döndürür.
Eşik altında bir oranı gizlemek olan işlevsel sonuç, genel bir uygulama aracılığıyla herhangi bir planda elde edilebilir. Fark, tam mantığı kimin kontrol ettiğidir.
Bilmek değer olan mağaza başına sınırlar
Plandan bağımsız olarak, Function etkinleştirmesinde yuva sınırları vardır:
- Çoğu Function API: mağaza başına 25'e kadar etkin fonksiyonlar.
- Cart Transform: mağaza başına toplam bir etkin işlev. İkinci bir uygulamayı yüklerseniz ve o da bir Cart Transform kaydı yaparsa, biri engellenir. Tüm paket genişletme, birleştirme ve güncelleme mantığı mağaza başına tek bir Function'a konsolidasyon edilmelidir.
- Order Routing Location Rule: Plus yalnızca, talep üzerine mevcut, self-servis değil.
Büyük kataloglar yöneten mağazalar için (karışık paket ve bağımsız ürünler arasında 10.000'den fazla SKU'lu bir tane koruyorum), mağaza başına tek Cart Transform sınırlaması en çok gösterilir kısıtlamadır. Hem bir paket uygulaması hem de satın alma ile ücretsiz hediye uygulaması varsa ve her ikisi de bir Cart Transform kaydı yapıyorsa, çatışacaklardır. Uygulama geliştiricileriyle koordinasyon yapın veya her iki işlemi tek bir Function'da işleyen bir uygulamaya geçin.
Karar çerçevesi: hangi yol sizin durumunuza uyar
| Durum | En iyi yol | Neden |
|---|---|---|
| Plus olmayan mağaza, standart kural (oranı gizle, BOGO indirim) | Genel App Store uygulaması | Herhangi bir planda Function erişimi, kod sahipliği yok |
| Plus olmayan mağaza, herhangi bir uygulamanın kapsamadığı özel kural | Plus'a yükselt veya kuralı yapılandırılabilir genel uygulamaya uyacak şekilde uyarla | Plus olmayan özel dağıtım Function'ları için geçici çözüm yok |
| Plus mağazası, bir mağazaya ait kural | Özel uygulama, özel dağıtım | Tam mantık kontrolü, App Store inceleme yükü yok |
| Plus kuruluşu, 3+ genişleme mağazası ile | Özel uygulama, özel dağıtım | Kuruluşun tüm mağazalarında yüklenir |
| Birçok tüccar için geliştirici oluşturma | Genel uygulama, genel dağıtım | Çok mağazalı yüklemeleri gerekli; Function'lar herhangi bir planda etkinleşir |
| Bir Plus istemcisi için geliştirici oluşturma | Özel uygulama, özel dağıtım | Daha hızlı, inceleme yok, Shopify faturalandırması yapılacak değil |
Etkinleştirme doğrulanıyor
Bir Function'ı etkinleştirdikten sonra, aşağıdakileri çağırarak çalışır durumda olduğunu onaylayın:
query {
shopifyFunctions(first: 10) {
nodes {
id
title
apiType
app { title }
}
}
}
Bu sorgu read_functions kapsamı gerektirir ve mağazada her etkin Function'ı döndürür. Özel olarak özel Function'ı kaydedilip kaydedilmediğini ve sadece yüklenmiş-ama-etkin olmadığını onaylamak için belirli özelleştirme türüne (ör., deliveryCustomizations) karşı başvuru yapın. Derleyen ve yüklenen ancak türe özel mutasyonu aracılığıyla hiçbir zaman etkinleştirilmeyen bir Function hiçbir şey yapmaz.
Yüklenebilen ancak sessizce hiçbir şey döndürmeyen bir Function hata ayıklamasının işlenmiş bir örneği için, discount Function hata ayıklama desenleri hakkındaki yazı tam GraphQL mutasyonlarını ve günlük okuma iş akışını kapsar.
Sonuç olarak
Shopify Function'lar için plan erişim kuralı, çoğu makalenin yaptığından daha basittir. App Store'dan genel uygulamalar, indirimler, teslimat özelleştirmesi, ödeme özelleştirmesi, Cart Transform (genişletme ve birleştirme işlemleri) ve checkout doğrulaması da dahil olmak üzere herhangi bir ücretli planda Function tabanlı mantığı açar. Function API'leri içeren özel uygulamalar Plus gerektirir, hiçbir istisna yok ve geçici çözümü yoktur. İki özel yetenek, Order Routing Location Rule ve Cart Transform'un lineUpdate işlemi, uygulama türünden bağımsız olarak Plus'a özeldir. Plus olmayan bir plandaysanız ve mevcut genel uygulamalar tam kuralınızı kapsamıyorsa, seçim kuralı yapılandırılabilir uygulamaya uyacak şekilde uyarlamak veya yükseltmektir. Kısıtlamanın doğru kapsamı budur.
Bunu şirket içinde yapmak yerine yaptırmak isterseniz, yönettiğim stüdyo Lintel bu tür projeler için Shopify Functions geliştirme sunuyor.
Sıkça sorulan sorular
Plus olmayan bir Shopify mağazası hiç Shopify Functions kullanabilir mi?
Evet, Function içeren Shopify App Store'dan genel uygulamalar aracılığıyla. Discount, Delivery Customization, Payment Customization, Cart Transform (genişletme ve birleştirme işlemleri) ve Cart/Checkout Validation hepsi genel bir uygulama aracılığıyla herhangi bir ücretli planda çalışır. Kısıtlama yalnızca özel uygulamalara uygulanır, Function API'lerini etkinleştirmek için Shopify Plus gerektirir.
Plus olmayan mağazada Shopify Functions'lı özel uygulama kullanmanın herhangi bir yolu var mı?
Hayır. Shopify'nin platformu bunu etkinleştirme zamanında değil, kurulum zamanında uygular ve mağazanın Shopify Plus'ta olması gerektiğini belirten bir sabit hatayı döndürür. Plus olmayan mağazalar tarafından Function API'leri içeren özel dağıtım uygulamalarını kullanmak için hiçbir bayrak, geçici çözüm veya ortak istisna belgeletirilmemiştir.
Cart Transform lineUpdate kısıtlaması nedir ve Plus olmayan tüccarları genel uygulamalar kullanarak etkiler mi?
Cart Transform'daki lineUpdate işlemi, bir Function'un bir sepet satırının fiyatını, başlığını veya görüntüsünü geçersiz kılmasını sağlayan, genel veya özel olsun uygulama türünden bağımsız olarak Plus mağazalarında ve geliştirme mağazalarında kısıtlanır. Diğer iki Cart Transform işlemi, lineExpand (paket bölmesi) ve linesMerge (satır birleştirme) yönteminde hiçbir plan kısıtlaması yoktur ve genel bir uygulama aracılığıyla herhangi bir ücretli planda çalışır.