geliştirici belgeleri

İlk tema ve ilk uygulama

Sıfırdan başlayıp bir geliştirme mağazasında çalışan bir tema ve bir uygulamaya varmak.

Bu sayfa sizi boş bir klasörden, bir geliştirme mağazasında çalışan bir temaya ve bir uygulamaya götürür. Komutların ayrıntısı CLI sayfasındadır; burada yalnızca sıra anlatılır.

Gerekenler

Bir tema

  1. İskelet temadan başlayın:

    biticaret theme init my-theme
    cd my-theme
    
  2. Dosyaları düzenleyin. Tema nasıl kurulur: Tema yapısı.

  3. Denetleyin. Bu, yüklemenin yaptığı denetimin aynısıdır:

    biticaret theme check --strict .
    
  4. Tema klasörlerini ZIP yapın:

    zip -r ../my-theme.zip assets blocks config layout locales sections snippets templates
    

    ZIP yalnızca tema klasörlerini içerir; README.md, LICENSE, AGENTS.md ve CLAUDE.md gibi dosyaları yükleme reddeder.

  5. Geliştirme mağazanızın yönetim panelinde Online mağaza > Temalar altından ZIP'i yükleyin. Yüklenen tema yayınlanmamış olarak gelir: önizleyin, hazır olduğunda yayınlayın.

Döngü budur: düzenle, theme check, ZIP, yükle, önizle. Her yükleme yeni bir yayınlanmamış tema oluşturur; bir mağaza en çok 20 tema tutar.

Partner hesabı ve geliştirme mağazası

Uygulama geliştirmek için bir partner organizasyonu gerekir; temalar için gerekmez, yönetim panelindeki herhangi bir mağazaya yüklenir.

  1. Yönetim paneli adresinde (CLI'ın auth login komutundaki platform adresi; varsayılan https://admin.biticaret.com.tr) Hesap oluşturun ile bir hesap açın ve e-posta adresinizi doğrulayın: doğrulanmamış bir hesap başvuramaz.
  2. İş ortağı portalını (/partners) açın ve Partner olun formunu doldurun: organizasyonun bilgileri, bir veya birkaç amaç (Uygulama geliştirme, Müşteri mağazaları, Yönlendirme ya da Diğer), ne yapmak istediğiniz ve varsa önceki işlerinizin bağlantıları. Başvuruyu Biticaret ekibi elle değerlendirir; reddedilen bir amaç için 30 gün sonra yeniden başvurulur. Ölçütler ve süre iş ortağı programıyla birlikte netleşir. Beklerken portal yalnızca başvurunuzun durumunu gösterir.
  3. Uygulama geliştirme onaylanınca portalın Mağazalar sayfasından Mağaza oluştur ile Geliştirme mağazası türünde bir mağaza açın (ad ve adres verilir). Kuruluş başına bir mağaza sınırı vardır; sayfa kullanılanı ve kalanı gösterir. Geliştirme mağazası ücretlendirilmez, şifre koruması kapatılamaz, ödemeler yalnızca test modundadır ve müşteriye devredilemez.
  4. Aynı portalda uygulamanızı oluşturabilirsiniz (ad, kısa ad ve dağıtım: genel ya da tek bir müşteri mağazası için özel); ya da biticaret app config link bunu CLI'dan yapar.

Bir uygulama

  1. Go şablonundan başlayın:

    biticaret app init my-app
    cd my-app
    

    Şablon küçük bir Go sunucusudur: OAuth ile kurulur, yönetim panelinde bir sayfa gösterir ve her uygulamanın yanıtlaması gereken KVKK webhook'larını karşılar.

  2. Yapılandırmayı denetleyin (çevrimdışı çalışır):

    biticaret app check
    
  3. Giriş yapın ve uygulamayı organizasyonunuzda oluşturun. config link, biticaret.app.toml dosyasına client_id yazar:

    biticaret auth login
    biticaret app config link
    
  4. biticaret.app.toml içindeki application_url adresini sunucunuzun dışarıdan erişilen HTTPS adresine çevirin ve sunucuyu çalıştırın. CLIENT_ID ve CLIENT_SECRET iş ortağı portalındaki uygulamanızdan gelir; APP_URL, application_url sunucusunun kök adresidir:

    CLIENT_ID=… CLIENT_SECRET=… APP_URL=https://my-app.example.com go run .
    
  5. Bir sürüm yükleyip yayınlayın:

    biticaret app deploy --submit
    

    Yalnızca app deploy bir taslak yükler; taslak sürüm hiçbir mağazaya kurulmaz, kurulum her zaman uygulamanın yayınlanmış sürümünü kullanır. Özel bir uygulamada --submit (ya da portalın Sürümler sekmesindeki Gönder) sürümü hemen yayınlar; onaydan önce yalnızca kendi kuruluşunuzun mağazalarında çalışır. Ödeme uygulamaları ve onaylı erişimden fazlasını isteyen sürümler önce incelemeden geçer.

  6. Uygulamayı geliştirme mağazanıza kurun. Kurulum mağazanın yönetim panelinde başlar: platform application_url adresini imzalı bir sorguyla açar, uygulama mağaza sahibini izin ekranına gönderir ve onaydan sonra bir erişim jetonu alır. Akışın tamamı: Uygulama API'si.

Yerel geliştirmede HTTPS adresi

Platform application_url adresini, yönlendirme adreslerini ve webhook adreslerini kendi sunucusundan çağırır; bu yüzden uygulamanızın internetten erişilen bir HTTPS adresi olmalıdır. Bilgisayarınızda geliştirirken herhangi bir tünel aracı (yerel bir portu genel bir HTTPS adresine açan bir araç) işinizi görür. Tünelin adresini aldıktan sonra:

Döngü: kodu değiştirin, sunucuyu yeniden başlatın; yapılandırma (izinler, webhook'lar, adresler, uzantılar) değiştiyse app check ve yeniden app deploy --submit.

Şablon mağazaların jetonlarını bellekte tutar, yeniden başlatınca unutur. Gerçek bir uygulamada jetonları kendi veritabanınızda, şifreli tutun.

İnceleme ve yayın

biticaret app deploy bir taslak sürüm yükler; --submit onu aynı komutla incelemeye gönderir (ya da iş ortağı portalının Sürümler sekmesinden gönderin). Bir sürümün inceleme durumu draft (taslak), submitted (incelemede), approved (onaylı) veya rejected (reddedilmiş) olur; biticaret app versions list durumları gösterir. Göndermek için uygulamanın mağaza sayfası (listeleme bilgileri) tam olmalıdır, değilse sürüm taslak kalır ve komut listing_incomplete ile 1 döner. Yalnızca onaylı sürüm yayına çıkar.

Sonra