Kurulum

Tema geliştirmeye başlamak için üç şeye ihtiyacınız var: bir T-SOFT360 hesabı, geliştirme makinenizde tsoft-cli ve CLI üzerinden açılmış bir oturum. Bu sayfa üçünü de sırayla kurar.

Hesap ve organizasyon

Partner paneli üç ana bölümden oluşur:

CLI kurulumu

tsoft-cli npm üzerinden global olarak kurulur ve tsoft adıyla çalışır. Node.js 20.19.0 veya üzeri gerektirir.

# Global kurulum
npm install -g tsoft-cli

# Kurulumu doğrula
tsoft --version
# 3.12.4

Kimlik doğrulama

Giriş yapma

tsoft login komutu tarayıcınızı açar ve OAuth2 PKCE akışını başlatır:

tsoft login
# ◐ Tarayıcı açılıyor...
# ↳ login.tsoft360.com adresinde giriş yapın
# ✔ Giriş başarılı!
#   Mağaza: example.tsoft.biz

Akış şu sırayla ilerler: tsoft login → tarayıcı → login.tsoft360.com → localhost:8046 callback → token. Oturumunuz açıksa bir mağaza seçim ekranı çıkar; bu ekranda kendi mağazalarınız ve katkıda bulunduğunuz mağazalar listelenir. Bir mağaza seçtiğinizde akış tamamlanır ve CLI o mağaza için yetkilendirilir.

Oturum bilgisi ve çıkış

# Aktif kullanıcı ve mağazayı göster
tsoft whoami

# Çıkış yap — token sunucuda iptal edilir, yerel dosyalar silinir
tsoft logout

Organizasyon değiştirme

Birden fazla organizasyonda çalışıyorsanız aktif organizasyonu değiştirebilirsiniz:

tsoft org switch
# ? Organizasyon seçin:
# ❯ Tekrom A.Ş.
#   Demo Mağaza
# ✔ Aktif organizasyon: Tekrom A.Ş.

Mağaza değiştirme

Oturumlar mağaza başına ayrı tutulur ve yaklaşık bir ay geçerlidir. Giriş yaptığınız mağazalar arasında geçiş yapmak için tekrar tsoft login çalıştırmanıza gerek yoktur:

# Kayıtlı mağazaları ve kalan oturum sürelerini listele
tsoft store list
# Toplam 2 kayıtlı mağaza
# ● example.tsoft.biz (27 gün)
# ○ musteri.tsoft.biz (12 gün)

# Aktif mağazayı değiştir
tsoft store use musteri.tsoft.biz

Oturumu bitmiş mağazalar listede işaretlenir; bunlar için tsoft login ile yeniden giriş yapmanız gerekir.

Tek bir komutu aktif mağazayı değiştirmeden başka bir mağazada çalıştırmak için --store bayrağını kullanın:

tsoft --store musteri.tsoft.biz theme push

Dil ayarı

CLI varsayılan olarak Türkçe çalışır. İngilizce arayüz için:

TSOFT_LANG=en tsoft theme list

Diğer ortam değişkenleri için bkz. CLI Referansı.

Sorun giderme

• tsoft login tarayıcıyı açmıyorsa, çıktıdaki URL'yi kopyalayıp bir tarayıcıda elle açabilirsiniz — bağlantı PKCE state ile eşleştirilir.
• Beklenmedik yetki hatalarında önce oturumu ve hangi mağazada olduğunuzu kontrol edin, gerekirse sıfırdan bağlanın:

tsoft whoami       # hangi kullanıcı, hangi mağaza?
tsoft store list   # hangi mağazalarda oturum var, ne kadar süre kaldı?
tsoft logout
tsoft login

• "Aktif tema bulunamadı" — bir tema dizininin dışındasınız ve seçili tema yok. Tema dizinine girin (cd <magaza-slug>/<tema-adi>) veya tsoft theme use ile aktif temayı seçin.
• Komutlar yanlış mağazada çalışıyor — bulunduğunuz dizin, kayıtlı aktif mağazaya göre önceliklidir. Hangi dizinde olduğunuzu kontrol edin; tek seferlik bir komut için --store <domain> kullanın. Bkz. Çalışma Dizini.
• HTTP 401 hataları genellikle token süresinin dolmasından kaynaklanır; tsoft login ile yeniden giriş sorunu çözer. Tüm hata kodları için bkz. CLI Referansı.

Hızlı kontrol listesi

Sonraki adımlar