# Yapay zekâ ve CLI ile kurulum

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](https://lintelagency.com/downloads/transom-theme-skill.zip) dosyasını indirin ve [Transom'u yapay zekâ araçlarıyla kullanın](https://lintelagency.com/tr/destek/transom.md#transomu-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](https://lintelagency.com/tr/destek/transom/ayar-basvurusu.md), 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:

1. 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.
2. Kopyayı yayınlamadan önce önizleyin.
3. Büyük değişikliklerden önce temanın bir kopyasını bilgisayarınıza indirin (**… > Tema dosyasını indir**).
4. 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](https://shopify.dev/docs/api/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.

```bash
# 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ı](https://lintelagency.com/tr/destek/transom/urun-sayfalari.md) |
| `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](https://lintelagency.com/tr/destek/transom/ayar-basvurusu.md) 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.

```json
"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](https://lintelagency.com/tr/destek/transom/metafieldlar.md) 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.

```graphql
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](https://lintelagency.com/tr/destek/transom/satislari-artirin.md).
- **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.

```text
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](https://lintelagency.com/tr/destek/iletisim?product=Transom).