# Shopify mağazanızı AETHER Stüdyo'ya bağlama

AETHER'de ürettiğiniz 3D modelleri Shopify ürün sayfalarınıza ekleyebilmek için mağazanızda
tek seferlik bir **özel uygulama (custom app)** oluşturmanız gerekiyor. Bu, mağazanızdan
sadece AETHER'in erişebileceği, kimseyle paylaşılmayan bir anahtar üretir.

> ⚠️ Shopify 1 Ocak 2026'dan itibaren mağaza admin panelinden doğrudan özel uygulama
> oluşturmayı kaldırdı — artık her şey **Dev Dashboard** (dev.shopify.com) üzerinden yapılıyor.
> Aşağıdaki adımlar güncel akışı anlatıyor.

## 1. Dev Dashboard'da uygulama oluşturun

1. Mağaza admin panelinizde (`https://<magazaniz>.myshopify.com/admin`) sağ üstten mağaza
   adınıza tıklayıp **Dev Dashboard**'u seçin, ya da doğrudan `dev.shopify.com/dashboard`'a gidin.
2. Sol menüden **Apps** → sağ üstten **Create app** (Uygulama oluştur).
3. Uygulamaya bir isim verin, örn. "AETHER 3D/AR", oluşturun.

## 2. Yetkileri (scopes) ayarlayın

1. Uygulamayı açın → sol menüden **Sürümler** (Versions) sekmesine girin.
2. **API erişimi / API access** bölümünde **Kapsamlar → Kapsamları seç** (Select scopes) linkine
   tıklayın. Arama kutusuna yazdıktan sonra listenin gelmesi birkaç saniye sürebilir — gelmezse
   modalı kapatıp sayfayı yenileyip tekrar deneyin.
3. Şu üç izni sırayla arayıp işaretleyin:
   - `read_products`
   - `write_products`
   - `write_files`
4. Kaydedip yeni bir sürüm oluşturun/yayınlayın.

## 3. Tek mağazaya dağıtın ve yükleyin

1. Sol menüden **Dağıtım** (Distribution) sekmesine geçin.
2. **Özel dağıtım** (Custom distribution) seçin — bu, uygulamayı tek bir mağazaya kurmanızı sağlar
   (App Store incelemesi gerekmez).
3. Size verilen **kurulum linkine** kendi mağazanızın admin oturumundayken tıklayıp uygulamayı
   mağazanıza yükleyin (Install).

## 4. Client ID ve Client Secret'ı alın

> Not: Shopify artık statik bir "Admin API access token" göstermiyor — bunun yerine uygulamanın
> **Client ID** ve **Client Secret**'ını kullanıyoruz; AETHER bu ikisini mağazanızla değiştirip
> (Client Credentials Grant) kısa ömürlü bir erişim token'ı üretiyor, siz bir şey yapmanıza gerek yok.

1. Dev Dashboard'da uygulamanızı açın → **Ayarlar** (Settings) sekmesine gidin.
2. **Client ID** (istemci kimliği) ve **Client Secret** (gizli anahtar, `shpss_` ile başlar)
   değerlerini kopyalayın.

## 5. AETHER Stüdyo'ya bağlayın

1. [aetherrender.com/studyo](https://aetherrender.com/studyo) adresine gidip hesabınızla giriş yapın.
2. Üst çubuktaki **🛍️ Mağazam** butonuna tıklayın.
3. **Mağaza adresi** kutusuna `magazaniz.myshopify.com` yazın.
4. **Client ID** ve **Client Secret** kutularına 4. adımda kopyaladığınız değerleri yapıştırın.
5. **Bağla**'ya basın — mağaza adınız doğrulanıp gösterilirse bağlantı tamam.

## 6. Bir ürüne 3D model gönderin

1. **Ürünlerim** listesinde hazır (✅ Hazır) bir modelin yanındaki **Shopify'a Gönder** butonuna basın.
2. Açılan listeden modelin ekleneceği Shopify ürününü seçin.
3. Birkaç dakika içinde Shopify o ürünün **Medya** bölümüne 3D modeli ekler ve otomatik olarak
   iOS için AR (Quick Look) sürümünü de üretir — ayrıca bir şey yapmanız gerekmez.
4. Ürün sayfanızı mobil Safari'de (iPhone) veya Android Chrome'da açtığınızda "AR'da görüntüle"
   rozeti görünmelidir (temanız Online Store 2.0 uyumluysa otomatik çalışır — Dawn ve türevleri gibi).

## Notlar

- Client Secret'ınız yalnızca AETHER'in sunucusunda saklanır, hiçbir zaman tarayıcıya geri gönderilmez.
- Client Credentials Grant, uygulama ile mağazanın **aynı Shopify organizasyonuna** ait olmasını
  gerektirir — yani uygulamayı hangi Dev Dashboard hesabıyla oluşturduysanız, mağaza da o hesabın
  (ya da o organizasyona bağlı bir mağazanın) olmalı.
- Bir mağaza sadece bir AETHER hesabına bağlanabilir (v1). Birden fazla mağazanız varsa her biri
  için ayrı bir AETHER hesabı kullanın.
- Modelin Shopify'da işlenmesi (optimize + AR dönüşümü) birkaç dakika sürebilir; hemen görünmezse
  ürün sayfasını birkaç dakika sonra tekrar kontrol edin.