İ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
biticaretCLI: kurulum.- Tema için:
gitvezip. - Uygulama için: Go, ve iş ortağı portalında uygulamalar üzerinde çalışabilen bir üyelik.
- Bir geliştirme mağazası. İş ortağı organizasyonunuz geliştirme mağazaları açar: ücretsizdirler, şifre koruması kapatılamaz ve ödeme adımı yalnızca test modunda çalışır, yani gerçek satış yapmazlar.
Bir tema
-
İskelet temadan başlayın:
biticaret theme init my-theme cd my-theme -
Dosyaları düzenleyin. Tema nasıl kurulur: Tema yapısı.
-
Denetleyin. Bu, yüklemenin yaptığı denetimin aynısıdır:
biticaret theme check --strict . -
Tema klasörlerini ZIP yapın:
zip -r ../my-theme.zip assets blocks config layout locales sections snippets templatesZIP yalnızca tema klasörlerini içerir;
README.md,LICENSE,AGENTS.mdveCLAUDE.mdgibi dosyaları yükleme reddeder. -
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.
- Yönetim paneli adresinde (CLI'ın
auth loginkomutundaki platform adresi; varsayılanhttps://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. - İş 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önlendirmeya daDiğ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. Uygulama geliştirmeonaylanınca portalın Mağazalar sayfasından Mağaza oluştur ileGeliş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.- 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 linkbunu CLI'dan yapar.
Bir uygulama
-
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.
-
Yapılandırmayı denetleyin (çevrimdışı çalışır):
biticaret app check -
Giriş yapın ve uygulamayı organizasyonunuzda oluşturun.
config link,biticaret.app.tomldosyasınaclient_idyazar:biticaret auth login biticaret app config link -
biticaret.app.tomliçindekiapplication_urladresini sunucunuzun dışarıdan erişilen HTTPS adresine çevirin ve sunucuyu çalıştırın.CLIENT_IDveCLIENT_SECRETiş ortağı portalındaki uygulamanızdan gelir;APP_URL,application_urlsunucusunun kök adresidir:CLIENT_ID=… CLIENT_SECRET=… APP_URL=https://my-app.example.com go run . -
Bir sürüm yükleyip yayınlayın:
biticaret app deploy --submitYalnızca
app deploybir 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. -
Uygulamayı geliştirme mağazanıza kurun. Kurulum mağazanın yönetim panelinde başlar: platform
application_urladresini 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:
biticaret.app.tomliçindekiapplication_urldeğerini o adrese çevirin.[auth] redirect_urls,[privacy]adresleri ve webhookurideğerleri yol olarak yazıldıysa (/auth/callback,/webhooks)application_urlsunucusuna göre çözülür; başka bir şey değiştirmeniz gerekmez. Tam adres yazdıysanız onları da güncelleyin.- Sunucuyu
APP_URLolarak aynı adresle başlatın. biticaret app checkvebiticaret app deploy --submitile yapılandırmayı yeniden yükleyin. Adresler sürümle birlikte gittiği için,app config pushgibi ayrı bir komut yoktur: tünelin adresi her değiştiğinde yeni bir sürüm yükleyip yayınlamak (app deploy --submit) gerekir. Sabit bir adres veren bir tünel bunu önler.
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.
- Genel uygulama: sürüm Biticaret incelemesinden geçer; onaylanınca uygulama, mağazaların Uygulamalar > Uygulama mağazası sekmesinde listelenir ya da (listelenmesin seçilirse) yalnızca yükleme bağlantısıyla bulunur. İnceleme ölçütleri ve süresi iş ortağı programıyla birlikte yayımlanacaktır.
- Özel uygulama: pazarda yer almaz. Kuruluşunuzun geliştirme ve müşteri mağazalarına, portalın uygulama sayfasındaki yükleme bağlantısıyla onaysız kurulur; canlı bir mağazaya çıkması için o mağaza adına ayrıca Biticaret onayı istenir.
Sonra
- Tema: Tema yapısı, nesneler, etiketler, filtreler.
- Uygulama: Uygulama API'si, webhook'lar, uygulama vekili ve arayüz, Go SDK, yapılandırma dosyaları, bütün API yolları.
- Kodlama asistanı:
biticaret mcpile belgeleri ve denetimleri asistanınıza bağlayın (CLI). - Uzantılar:
biticaret app generate extension --type <tür> --name <ad>tema blokları, ödeme adımı fonksiyonları, arayüz uzantıları ve web pikselleri başlatır.