Komut dosyası oluşturma ve etkinleştirme

Shopify Komut Dosyaları API'sinde komut dosyası yazarsınız. Bu API, Ruby programlama dilinin bir sürümüdür, yani Ruby ile programa konusunda deneyimli olmanız gerekir. Komut dosyası oluşturmak, düzenlemek, test etmek ve yayınlamak için Script Editor'ı kullanın.

Plan gerekliliği

Shopify Komut Dosyaları ve Script Editor uygulaması, yalnızca Shopify Plus planındaki mağazalar tarafından kullanılabilir. Script Editor uygulaması, artık Shopify App Store'dan indirilemeyecektir.

Shopify Komut Dosyaları, 28 Ağustos 2025'te kaldırılacak ve bu tarihten sonra çalışmayacaktır. Mevcut Komut Dosyalarınızı bu tarihten önce Shopify Functions'a taşıyın.

Komut dosyası yazmaya başlamadan önce, her bir komut dosyası türünün desteklediği yöntemleri öğrenmek için komut dosyalarının farklı türlerini (satır öğesi, kargo ve ödeme) gözden geçirmenizi öneririz. Örneğin, bir satır öğesi komut dosyası, kargo yöntemlerini kullanamaz.

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.

Desteklenen kanallar

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, Plobal Apps ve Vajro mobil uygulama oluşturucuları

Not

Komut dosyasında yapılan son güncellemeden sonra gerçekleşen uygulama yüklemeleri için, yeni yüklenen uygulama bağlamında beklendiği gibi çalıştığından emin olmak üzere komut dosyasını yeniden yayınlayın.

Sıkça kullanılan komut dosyalarının örneklerini, Script Editor'da yer alan komut dosyası şablonlarında bulabilirsiniz. Bu örnekleri görüntülemek için komut dosyası oluşturmanız gerekir.

Komut dosyası oluşturma

Komut dosyası oluşturmak için:

Komut dosyalarına kod yazmaya dair referanslar için Shopify Komut Dosyaları API'sini inceleyin.

1. Script Editor'ı açın. Mağazanızda kullanabileceğiniz komut dosyalarının bir listesini Komut Dosyaları genel bakış sayfasında görebilirsiniz.
2. Yeni bir komut dosyası oluşturmaya başlamak için Komut dosyası oluştur'a tıklayın.

3. Komut dosyası şablonu seç iletişim kutusunda:

   1. Oluşturmak istediğiniz komut dosyası türünü seçin.
   2. Başlangıç noktası olarak örnek bir şablon seçin veya sıfırdan komut dosyası yazmaya başlamak için Boş şablon'u seçin.
   3. Seçtiğiniz türde bir komut dosyası oluşturmak için Komut dosyası oluştur'a tıklayın.

      İpucu

      Burada seçtiğiniz komut dosyası türü (Satır öğesi, Kargo ücreti veya Ödeme ağ geçidi), komut dosyasının türünü ve kullanabileceği yöntemleri belirler.

4. Başlık kutusuna komut dosyası için bir ad girin. Komut dosyasının işlevini bir bakışta anlayabilmek için açıklayıcı bir ad kullanın.

5. Ruby kaynak kodu konsolonu açmak için Kod'a tıklayın.

6. Komut dosyanızın kodlarını girin. Referans olarak Shopify Komut Dosyaları API'si belgelerine başvurabilirsiniz.

7. Komut dosyasını çalıştırmak için Komut dosyasını çalıştır'a tıklayın.

8. İşlemi tamamladığınızda:

   • Komut dosyasının yayınlanmamış taslağını kaydetmek için Taslağı kaydet'e tıklayın
   • Komut dosyasını oluşturmak ve yayınlamak için Kaydet ve yayınla'ya tıklayın.

Sonraki adımlar

Komut dosyanızı yazdığınızda, bunu yayınlamadan önce test etmenizi ve hataları ayıklamanızı öneririz. Ayrıca komut dosyanız tarafından yapılan değişikliklerin mağaza vitrininizde görünmesi için de Liquid şablonu dosyalarınızı güncelleyebilirsiniz.