Dokümantasyon
KEYDAL

Tema sistemi, katalog ve tema seçimi

Sitenizin görünümünü belirleyen tema sisteminin nasıl çalıştığını, temaların katalogdan nasıl seçildiğini ve varsayılan temanın rolünü anlatır.

Son güncelleme: 5 Eylül 2026

Genel bakış

Tema, sitenizin ziyaretçiye görünen kabuğudur: yerleşim, renkler, yazı tipleri, menü ve altbilgi. Haberlerinizi, manşetlerinizi ve kategori sayfalarınızı bu kabuk çizer. İçeriğinizi (haber, yazar, kategori) siz yönetirsiniz; temayı ise KEYDAL hazırlar.

Bu sistemin üç temel ilkesi vardır:

  • Temaları KEYDAL yapar. Her tema bir katalog girdisidir; hazır, sınanmış ve güvenli olarak sunulur.
  • Siz katalogdan seçersiniz. Kendi tema dosyanızı yükleyemezsiniz; seçim, KEYDAL’ın sunduğu temalar arasından yapılır.
  • Varsayılan da bir temadır. Ayrı bir tema seçmediğiniz sürece siteniz varsayılan temayla çizilir; site her koşulda açık kalır.

Temaları kim hazırlar

Temalar KEYDAL tarafından geliştirilir ve bir katalog altında toplanır. Her site kurulduğunda varsayılan (taban) temayla başlar; katalog büyüdükçe yeni temalar panelin Görünüm → Tema sayfasında seçilebilir olarak görünür. Temaların bir kısmı ücretsiz, bir kısmı lisansa bağlı (ücretli) olabilir.

Kendi HTML/CSS tasarımınızı panelden yükleyemezsiniz. Bu, bir kısıtlama olduğu kadar bir güvenlik kararıdır: özel tasarım yükleme yolu kapalıdır ve istendiğinde yalnızca KEYDAL operatör tarafından, aynı güvenlik denetimlerinden geçirilerek açılır.

Not: Özel tema yükleme uçları kod tarafında kapalıdır (OZEL_TEMA_YUKLEME=false). Panelden gönderilen özel tema isteği reddedilir; yalnız katalog temaları kullanılabilir.

Katalogdan tema seçimi

Her site için tek bir aktif tema vardır ve bu seçim, ana yazılım sürümünüzden bağımsızdır. Yani temanızı, çekirdek yazılım sürümünüzü etkilemeden değiştirebilirsiniz. Seçilen temanın belirli bir sürümü siteye sabitlenir; KEYDAL temayı güncellese bile siteniz, siz yeni sürümü etkinleştirene kadar sabitlenen sürümle çizilir.

Panelde Görünüm → Tema sayfasında katalogdaki temalar kart olarak listelenir; etkin olan tema Seçili rozetiyle işaretlidir. Aktif tema yoksa siteniz varsayılan temayla çizilir.

Not: Tema seçimi panelde Görünüm → Tema sayfasından yapılır. Yetkiniz (site.ayarlar) varsa bir temayı seçtiğinizde site anında o temayla çizilmeye başlar; Varsayılan’ı seçmek siteyi taban temaya güvenle geri döndürür.

Motor aktif temayı nasıl çizer

Bir ziyaretçi sayfanızı açtığında sunum motoru şu sırayı izler:

  1. Sitenizin aktif teması yüklenir. Etkin tema işaretçisi (siteye özel tek gerçek) hangi sürümü gösteriyorsa o sürüm çizilir.
  2. İstenen sayfa (ana sayfa, haber, kategori) temada tanımlıysa, sayfa o temanın şablonuyla üretilir.
  3. Aktif tema yoksa, sayfa temada tanımlı değilse ya da çizim sırasında bir sınır aşılırsa motor varsayılan yola düşer ve sayfa varsayılan görünümle çizilir.

Bu geri dönüş sessiz ve güvenlidir: ziyaretçi hata görmez, sayfa yine 200 döner. Temanın kaldırılması da aynı davranışa yol açar; etkin işaretçi silinince site varsayılana geri döner.

Her sitenin teması yalıtılmıştır

Temalar site başına ayrı depolanır. Bir sitenin teması ya da tema varlıkları (CSS, görsel, yazı tipi) başka bir siteye erişemez. Tema varlıkları siteye özel bir yol altında, kendi kaynak alanında sunulur. Bu yalıtım, çok siteli filoda bir sitenin diğerini etkilememesini sağlar.

Güvenlik: tema statik bir şablondur

Tema sistemi, “müşteri kodu sunucuda çalışmaz” ilkesi üzerine kuruludur. Tema bir statik şablondur; sunucu yalnızca verinizi şablondaki alanlara basar, şablonun içindeki hiçbir ifadeyi bir program gibi çalıştırmaz. Bunun pratik sonuçları şunlardır:

  • Şablon dili mantık içermez: yalnızca metin, alan basma, liste ve basit koşul düğümleri vardır. eval, Function ya da sanal makine gibi kod çalıştıran hiçbir yol kullanılmaz.
  • Her tema, yayına alınmadan önce bir doğrulama kapısından geçer. Kapıdaki kurallardan biri bile kırmızıysa tema gömülmez; var olan tema yayında kalır.
  • Her siteye ayrı ve katı bir içerik güvenliği politikası (CSP) uygulanır.

Bu tasarım, temanın hazırlanış biçiminden bağımsız olarak sitenizin güvenliğini yapısal olarak korur.

Ücretli temalar ve lisans

Katalogdaki ücretli temalar yalnızca o temaya lisanslı sitelerde etkinleşir. Bir tema etkinleştirilmeden önce, güvenlik doğrulaması geçtikten sonra bir hak kapısından daha geçer:

  • Tema ücretsizse (katalog dışı ya da ucretli:false) doğrudan geçer.
  • Tema ücretliyse ve sitenizin geçerli bir lisansı varsa geçer.
  • Tema ücretliyse ve lisans yoksa etkinleştirme reddedilir.

Reddedilen bir denemede aktif temanız değişmez; siteniz mevcut temasıyla yayında kalmayı sürdürür.

Ayar ve davranış referansı

DurumSonuç
Aktif tema seçiliSayfalar o temanın şablonuyla çizilir.
Aktif tema yokSite varsayılan görünümle çizilir.
Tema bu sayfayı tanımlamıyorYalnız o sayfa varsayılana düşer.
Tema kaldırıldıSite varsayılana geri döner, 200 kalır.
Ücretli tema, lisans yokEtkinleştirme reddedilir, tema değişmez.
Özel tema yüklemeKapalı; yalnız katalog temaları kullanılabilir.

İlgili konular

  • Tema dili, etiketleri ve site dili tema sisteminin bir parçasıdır; site tek dillidir ve içerik çevrilmez.
  • Ücretli tema lisansı ve site hakları, siparişleriniz üzerinden yönetilir.

Not: Bu bölümün ilgili sayfaları (tema dili, tema lisansı) henüz yayımlanmadı; yayına alındığında buraya bağlantı eklenecektir.