Tema Motoru

templates/website/{Tema}/
├── theme.php     # manifest: motor, meta, durum, ayar şeması. Yazar tarafından yazılır
├── config.php    # kaydedilmiş ayar DEĞERLERİ. Çalışma anında yazılır, elle asla
├── hooks.php     # temanın dinleyicileri: değişkenler, çıktı filtreleri, rota eklemeleri
├── cover.png     # meta['image'] anahtarının gösterdiği katalog görseli
├── layouts/      # bir view'ın genişlettiği sayfa kabukları: default, auth, checkout, invoice
├── partials/     # kabuğun birleştirdiği parçalar: header, footer, topbar, drawer, popup
├── components/   # iki ya da daha çok view'ın paylaştığı işaretleme: plan ızgarası, ödeme yöntemleri
├── views/        # yüzeylerin kendisi, alana göre gruplu: account/ auth/ checkout/ content/ page/ products/
├── tables/       # müşteri paneli liste tablolarının kolon ön ayarları
├── assets/       # temanın getirdiği css, js, görsel, favicon
├── locale/       # temanın kendi metinleri, dil ve view kapsamı başına
└── content/      # o metinlerin operatör düzenlemeleri, panelden yazılır

public static function active(): self;                 // kurulumun teması, yoksa Basic'e düşer
public static function installed(): array;
public static function manifest(string $themeName): array;

public function getName(): string;
public function engine(): string;
public function exists(): bool;
public function dir(): string;                          // dosya sistemi yolu, sonunda ayraçla
public function assetUrl(string $path = ''): string;    // assets/ altındaki bir dosyanın adresi
public function viewExists(string $view): bool;         // 'account/dashboard', uzantısız
public function render(string $view, array $data = []): string;
public function lang(string $key, array $vars = []): string;

public function settingsSchema(): array;                // theme.php → settings
public function savedConfig(): array;                   // config.php → kaydedilmiş değerler
public function setting(string $key): mixed;            // kayıtlı değer, yoksa şema varsayılanı
public function allSettings(): array;                   // view'ların $setting olarak aldığı şey
public function boot(): void;                            // hooks.php'yi ilk render'dan önce bir kez dahil eder

return [
    'engine' => 'smarty',
    'meta'   => [
        'name'    => 'Acme',
        'version' => '1.0.0',
        'author'  => 'Acme Ltd',
        'image'   => 'cover.png',
    ],
    'settings' => [
        'groups' => [
            'topbar' => ['label' => 'grp_topbar', 'icon' => 'bi-megaphone'],
        ],
        'fields' => [
            'topbar_enabled' => [
                'type'    => 'switch',
                'group'   => 'topbar',
                'label'   => 'set_topbar_enabled',   // locale/{lang}.php içindeki anahtar
                'default' => false,
            ],
            'topbar_text' => [
                'type'      => 'textarea',
                'group'     => 'topbar',
                'label'     => 'set_topbar_text',
                'default'   => '',
                'rows'      => 3,
                'multilang' => true,
                // Üstteki anahtar açılana kadar satır kapalı kalır.
                'depends'   => ['topbar_enabled' => true],
            ],
        ],
    ],
];

{if $setting.topbar_enabled}
    <div class="topbar">{$setting.topbar_text nofilter}</div>
{/if}

// Tema başına TEK handler: yalnız son kaydın dönüş değeri yaşar.
Hook::add("filter:template.variables", 1, function ($template, $data) {

    // Her site sayfasında çalışır, o yüzden sorgu içeren her şey cache'ten geçer.
    $data["footer_groups"] = Cache::remember('website', 'acme_footer_' . Language::selected(), 3600,
        fn (): array => Products::groups());

    return $data;   // dönüş vermemek platformun topladığı her anahtarı düşürür
});

// Veri değil işaretleme: layout'un kanca noktaları dizeyi alır ve olduğu gibi basar.
Hook::add("ui:client.head.css", 1, fn () => '<link rel="stylesheet" href="' . Theme::active()->assetUrl('css/extra.css') . '">');