Yapay zekâ ve CLI ile kurulum · Transom kılavuzu

Bu kılavuzu bir yapay zekâ asistanına verebilir ya da Transom'u Shopify CLI ile çalışan bir yapay zekâ ajanına kurdurabilirsiniz. Bu sayfada asistana ne vermeniz gerektiğini, tema dosyalarının birbirine nasıl bağlandığını ve ajan çalışırken canlı mağazanızı nasıl koruyacağınızı anlatıyoruz.

Transom'u kullanmak için bu sayfaya hiç ihtiyacınız yok. Burada anlatılan her şeyi tema düzenleyicide de yapabilirsiniz.

Kılavuzu bir yapay zekâ asistanına verin

Bu kılavuzun her sayfası düz Markdown olarak da sunulur; yapay zekâ araçları Markdown'ı bir web sayfasından çok daha güvenilir okur. Skill, llms.txt dosyaları ve .md kopyaları kılavuzun İngilizce sürümünü içerir; asistanınızla yine Türkçe konuşabilirsiniz.

Transom skill'i: transom-theme-skill.zip dosyasını indirin ve Transom'u yapay zekâ araçlarıyla kullanın bölümünde anlatıldığı gibi kurun. Skill destekleyen asistanlar doğru kılavuz sayfasını kendileri yükler.
Tek bir sayfa: Herhangi bir kılavuz sayfasının üstündeki Markdown olarak kopyala düğmesini seçin ve metni asistanınıza yapıştırın. Ya da sayfa adresinin sonuna .md ekleyin, örneğin https://lintelagency.com/tr/destek/transom/satislari-artirin.md.
Kılavuzun tamamı tek dosyada: https://lintelagency.com/tr/destek/transom/llms-full.txt. Bu adresi web sayfası okuyabilen asistanlara verin.
Sayfa listesi: https://lintelagency.com/tr/destek/transom/llms.txt, yalnızca ihtiyaç duyduğu sayfayı çeken araçlar için her sayfayı tek satırlık bir özetle listeler.
Tüm ayar id'leri: Ayar başvurusu, temanın kaydettiği her ayarı türü, varsayılan değeri ve izin verilen değerleriyle listeler.

İyi bir ilk mesaj şöyle olabilir: "https://lintelagency.com/tr/destek/transom/llms-full.txt adresini oku. [Ne sattığınız] satıyorum. Hangi hazır stili ve ürün şablonunu kullanmam gerektiğini, hangi metafield'ları oluşturmam gerektiğini söyle."

Canlı temada değil, her zaman bir kopyada çalışın

Değişiklikleri hangi araç yaparsa yapsın şu kurallara uyun:

Shopify yönetim panelinde Online Mağaza > Temalar (Online Store > Themes) sayfasına gidin, Transom'un … menüsünü açın ve Kopya oluştur'u (Duplicate) seçin. Kopya üzerinde çalışın.
Kopyayı yayınlamadan önce önizleyin.
Büyük değişikliklerden önce temanın bir kopyasını bilgisayarınıza indirin (… > Tema dosyasını indir).
Shopify şifrenizi veya personel hesabınızı hiçbir yapay zekâ aracıyla paylaşmayın. CLI bunun yerine tarayıcınız üzerinden oturum açar.

Temayı Shopify CLI ile düzenleyin

Shopify CLI, bir temayı bilgisayarınıza indirir, hatalara karşı kontrol eder ve geri yükler. Kodlama yapan bir yapay zekâ ajanı bu komutları sizin yerinize çalıştırabilir.

# Download the duplicated theme (find its ID with: shopify theme list)
shopify theme pull --store your-store.myshopify.com --theme 123456789

# Check the files for errors after editing
shopify theme check

# Upload to the same unpublished copy and get a preview link
shopify theme push --store your-store.myshopify.com --theme 123456789

Sırasıyla bu komutlar: kopyalanan temayı indirir (id'sini shopify theme list ile bulursunuz), düzenlemeden sonra dosyaları hatalara karşı kontrol eder ve değişiklikleri aynı yayınlanmamış kopyaya yükleyip bir önizleme bağlantısı verir.

Komut --allow-live içermedikçe CLI yayındaki temanızın üzerine yazmayı reddeder. Bu seçeneği asla eklemeyin; önizlemeyi kontrol ettikten sonra temayı yönetim panelinden yayınlayın.

Ayarlar nerede saklanır?

Dosya	İçeriği
`config/settings_data.json`	`current` altında tema ayarları (renkler, yazı tipleri, sepet, renk örnekleri)
`templates/index.json`	Ana sayfa: bölümleri, bölümlerin ayarları ve blokları
`templates/product.json` ve `templates/product.*.json`	Varsayılan ve alternatif ürün şablonları
`templates/collection.json`, `cart.json`, `article.json` ve diğerleri	Diğer sayfa türleri
`sections/header-group.json`, `footer-group.json`, `overlay-group.json`	Her sayfada ortak olan duyuru çubuğu ve üst bilgi, bülten ve alt bilgi ile e-posta kaydı penceresi

Bir şablondaki her bölümün bir type değeri (hangi bölüm olduğu), settings alanı ve isteğe bağlı olarak block_order ile birlikte blocks alanı vardır. Ayar başvurusu id'leri listeler; böylece bir ajan tahmin yürütmeden geçerli bir şablon yazabilir.

Örnek: Ana sayfadaki banner'da metni görselin altına alıp yüksekliği "uzun" yapmak.

"hero": {
  "type": "image-banner",
  "settings": {
    "text_placement": "below",
    "height": "tall"
  }
}

Görseller, ürünler, koleksiyonlar, sayfalar ve menüler handle (tanıtıcı) ile saklanır. Bir ajan koleksiyonu handle'ıyla ayarlayabilir (örneğin "collection": "living-room"), ancak görselleri tema düzenleyicide seçmek daha kolaydır.

Metafield'ları Admin API ile oluşturun

Transom, Metafield'lar sayfasında listelenen metafield'ları okur. Mağazanızda Admin API GraphQL çalıştırabilen bir ajan (özel bir uygulama, CLI ya da mağazanıza bağlı bir MCP sunucusu aracılığıyla) tanımları sizin yerinize oluşturabilir. Yaptığı işi Ayarlar > Özel veriler (Settings > Custom data) altında kontrol edin.

mutation {
  metafieldDefinitionCreate(definition: {
    name: "Material"
    namespace: "transom"
    key: "material"
    type: "single_line_text_field"
    ownerType: PRODUCT
  }) {
    createdDefinition { id }
    userErrors { field message }
  }
}

Namespace ve anahtar	Sahibi	API için tür
`transom.material`	Ürün	`single_line_text_field`
`transom.dimensions`	Ürün	`single_line_text_field`
`transom.care`	Ürün	`multi_line_text_field`
`transom.origin`	Ürün	`single_line_text_field`
`transom.badge`	Ürün	`single_line_text_field`
`transom.fbt`	Ürün	`list.product_reference`
`transom.tiers`	Ürün	`json`
`custom.related_products`	Makale	`list.product_reference`
`custom.faq`	Makale	`json`

Değerler metafieldsSet mutation'ı ile yazılır. reviews.rating ve reviews.rating_count alanları yorum uygulamanıza aittir; bunları uygulamanın doldurmasına bırakın.

Tema bu ikisini denetleyemez; bu yüzden bir ajanın uyması gereken iki kural var:

İndirimleri tema uygulamaz. Adet kademelerindeki, paketlerdeki veya sepet hedeflerindeki her yüzde, Shopify'da oluşturulmuş bir otomatik indirimle aynı olmalıdır. Ayrıntılar: Satışları artırın.
Puanlar ve stok mesajları gerçek olmalıdır. Hiçbir aracın yorum, puan ya da düşük stok sayısı uydurmasına izin vermeyin.

Yapay zekâ ajanları için hazır istem

Bunu bilgisayarınızda Shopify CLI çalıştırabilen bir ajana yapıştırın. Mağaza adresini ve tema id'sini kendi bilgilerinizle değiştirin.

Mağazam your-store.myshopify.com üzerinde Transom Shopify temasını kuruyorsun.
1. Hiçbir şeyi değiştirmeden önce https://lintelagency.com/tr/destek/transom/llms-full.txt adresini oku.
2. Yalnızca yayınlanmamış 123456789 numaralı temada çalış. Asla yayınlama, asla --allow-live kullanma.
3. Temayı Shopify CLI ile çek, değişiklikleri yap, shopify theme check komutunu çalıştır ve geri yükle.
4. Yalnızca Settings reference sayfasındaki ayar id'lerini kullan. Id uydurma.
5. İndirim, yorum veya stok sayısı oluşturma. Benim oluşturmam gereken otomatik indirimleri listele.
6. İşin bitince bana önizleme bağlantısını ve yaptığın her değişikliğin listesini ver.

Yardım

Bir araç takılırsa ya da bir değişiklik önizlemede doğru görünmüyorsa mağaza adresinizle ve araçtan ne yapmasını istediğinizle birlikte destek ekibine yazın.