Komut dosyaları oluşturma ve etkinleştirme

Komut dosyalarını Shopify Scripts API'sinde yazarsınız. Bu API, Ruby programlama dilinin bir sürümüdür. Bu nedenle Ruby programlama deneyiminizin olması gerekir. Komut dosyalarınızı oluşturmak, düzenlemek, test etmek ve yayınlamak için Script Editor uygulamasını kullanın.

Plan gerekliliği

Shopify Komut Dosyaları ve Script Editor uygulaması yalnızca Shopify Plus planındaki mağazalarda kullanılabilir. Script Editor uygulaması artık Shopify App Store'dan indirilemiyor.

30 Haziran 2026'da Shopify Komut Dosyaları kaldırılacak ve artık çalışmayacaktır. Mevcut Shopify Komut Dosyaları kullanım örnekleriniz için desteğin devam etmesini istiyorsanız mevcut ödeme, kargo veya satır öğesi komut dosyalarınızın yerine uyumlu Shopify Functions yedeklerine geçmeniz gerekir. Shopify Komut Dosyaları'ndan Shopify Functions'a geçiş yapma hakkında daha fazla bilgi edinin.

Bir komut dosyası yazmaya başlamadan önce, her bir komut dosyası türünün desteklediği yöntemlerden haberdar olmak için farklı komut dosyası türlerini (satır öğesi, kargo ve ödeme) incelemeniz gerekir. Örneğin, bir satır öğesi komut dosyası, kargo yöntemlerini kullanamaz.

Her komut dosyası türü için aynı anda yalnızca bir komut dosyası yayınlanabilir. Örneğin, bir satır öğeleri komut dosyası ile bir kargo ücretleri komut dosyası yayınlayabilirsiniz ancak aynı anda iki satır öğeleri komut dosyası yayınlayamazsınız.

Desteklenen kanallar

Bir komut dosyası oluşturduğunuzda (veya düzenlediğinizde), 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 ve Mobile Buy SDKs (Android ve iOS) ile oluşturulmuş özel uygulamalar
• Ödeme oluşturan özel uygulamalar
• Tapcart, Plobal Apps ve Vajro mobil uygulama oluşturucuları

Not

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

Script Editor'da sunulan komut dosyası şablonlarında yaygın olarak kullanılan komut dosyası örneklerini bulabilirsiniz. Bu şablonları görüntülemek için bir komut dosyası oluşturmanız gerekir.

Komut dosyası oluşturma

Bir komut dosyası oluşturmak için:

Komut dosyaları için kod yazma konusunda referans olarak Shopify Scripts API'sini inceleyin.

1. Script Editor'ı açın. Komut Dosyaları genel bakış sayfasında, mağazanıza ait komut dosyalarının listesi gösterilir.
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 bir örnek şablon seçin veya bir komut dosyasını sıfırdan yazmaya başlamak için Boş şablon'u seçin.
   3. " Komut dosyası oluştur "a tıklayarak seçtiğiniz türde bir komut dosyası oluşturun.

      İpucu

      Burada seçtiğiniz komut dosyası türü (Satır öğeleri, Kargo ücretleri veya Ödeme ağ geçitleri), 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 ne işe yaradığını bir bakışta anlayabilmeniz için açıklayıcı bir ad kullanın. 5. **Ruby kaynak kodu** konsolunu açmak için **Kod**'a tıklayın. 6. Komut dosyanızın kodunu girin. Referans olarak [Shopify Komut Dosyaları API'si belgelerini](/manual/checkout-settings/script-editor/shopify-scripts) kullanın. 7. Komut dosyasını çalıştırmak için **Komut dosyasını çalıştır**'a tıklayın. 8. İşiniz bittiğinde: * Komut dosyasının yayınlanmamış bir taslağını kaydetmek için **Taslağı kaydet**'e tıklayın. * Komut dosyasını oluşturup yayınlamak için **Kaydet ve yayınla**'ya tıklayın.

Sonraki adımlar

Bir komut dosyası yazdıktan sonra, onu yayınlamadan önce test etmeniz ve hatalarını ayıklamanız gerekir. Dijital vitrininizin, komut dosyalarınızın yaptığı değişikliklere yanıt vermesi için Liquid şablon dosyalarınızı da güncelleyebilirsiniz.