Tema ZIP'i yüklemek, indirmek ve kaldırmak

Temalar ZIP paketi olarak kurulup indirilebilir. Bir tema yazarından aldığın ya da kendi yazdığın temayı kurmak, bir temayı kod düzenlemeleriyle birlikte başka bir BorCube sitesine taşımak için bu yolu kullanırsın.

Tema yüklemek#

Tema yüklemek için rolünde Temaları yönetme ve düzenleme izni olmalı ve hesabında iki adımlı doğrulama açık olmalı (Güvenlik). Temanın dosyaları her ziyaretçinin tarayıcısında çalıştığı için bu koruma zorunludur.

1. Yönetim paneli → Görünüm → Temalar sayfasının altındaki Tema yükle (ZIP) kutusuna git.
2. ZIP dosyasını seç.
3. Aynı kimlikli, daha önce yüklenmiş bir temayı güncelliyorsan "Aynı kimlikli yüklü temayı güncelle" kutusunu işaretle.
4. Yükle ve kur'a bas.
5. Paket baştan sona denetlenir. Sorun varsa hiçbir şey değişmez ve mesaj neyin yanlış olduğunu söyler.
6. Kurulan tema listede Yüklendi rozetiyle görünür. Önizle ile bak, beğenirsen Etkinleştir'e bas.

Pakette neler olabilir?#

theme.json ZIP'in kökünde ya da tek bir klasörün içinde olmalı. Diğer dosyalar şu klasörlerde durur:

Dosya ve klasör adlarında boşluk ve Türkçe karakter kullanma. Bunların dışında bir dosya (ör. .php ya da .html) varsa paket reddedilir ve mesaj o dosyanın adını yazar. Bilgisayarların kendiliğinden eklediği __MACOSX, .DS_Store ve Thumbs.db gibi dosyalar atlanır.

Sınırlar#

Şifreli ZIP'ler ve ZIP64 paketleri kabul edilmez.

Kurulumda neler denetlenir?#

• theme.json geçerli JSON olmalı ve zorunlu alanları (kimlik, ad, sürüm, yazar, motor sürümü) doğru içermeli. Alanların açıklaması Kendi temanı geliştirmek makalesinde.
• Kimlik (id) küçük harf, rakam ve tireden oluşur, 2 ile 40 karakter arasıdır. BorCube ile gelen temaların kimlikleri (bor, borte, volt…) kullanılamaz.
• Tema başka bir temayı genişletiyorsa (extends), o tema sitede yüklü olmalı. Başka bir temayı genişleten bir temayı genişletemezsin; yalnız tek seviye vardır.
• Bütün şablonlar derlenir. Sözdizimi hatası olan şablon paketi reddettirir ("Şablon hatası: …").
• layout/theme.liquid, templates/index.liquid ve templates/404.liquid bulunmalı. Bir alt temada bunlar ana temadan gelebilir.

Güncellemek#

Yeni sürümü aynı kimlikle hazırla ve yüklerken "Aynı kimlikli yüklü temayı güncelle" kutusunu işaretle. Kutu işaretli değilse kurulum "zaten yüklü" uyarısıyla durur.

Güncellemede özelleştirici ayarların ve kod düzenleyicideki değişikliklerin korunur. Kod düzenleyicide değiştirdiğin bir dosya, yeni sürümdeki karşılığının yerine kullanılmaya devam eder. Yeni sürümün dosyasını görmek için kod düzenleyicide o dosyayı açıp Orijinale döndür'e bas.

ZIP indirmek#

Her tema kartında ZIP indir düğmesi vardır; BorCube ile gelen temalarda da. İnen dosyanın adı temanın kimliği ve sürümünden oluşur, örneğin gece-1.0.0.zip.

• Paket, temanın kendi dosyalarını kod düzenleyicideki değişikliklerinle birlikte içerir.
• Alt temanın paketinde ana temanın dosyaları yoktur; paket yine bir alt tema olarak kurulur.
• Özelleştirici ayarları (renkler, logo, bölümler) pakete girmez. Temayı başka bir siteye kurduğunda bunları orada yeniden ayarlarsın.

Hazır bir temayı kendi temanın başlangıcı yapmak istersen indirdiğin paketteki theme.json'da id ve name değerlerini değiştir. BorCube ile gelen temaların kimlikleri ayrıldığı için paket, kimliği değiştirmeden yüklenmez.

Kaldırmak#

Kaldır düğmesi yalnız ZIP ile yüklenmiş ve etkin olmayan temalarda görünür.

• BorCube ile gelen temalar kaldırılamaz.
• Etkin tema kaldırılamaz; önce başka bir temayı etkinleştir.
• Başka bir yüklü tema bu temayı genişletiyorsa önce onu kaldırman gerekir.

Kaldırınca temanın dosyaları ve kod düzenlemeleri silinir; bu işlem geri alınamaz. Temayı sonra yeniden kurabilmek için kaldırmadan önce ZIP indir ile bir kopyasını al.

Yüklediğin temalar sitenin verileriyle birlikte saklanır; BorCube güncellemeleri onlara dokunmaz (Güncellemeler).