Tema Anatomisi

views/
├── account/     25   müşteri paneli: pano, hizmetler, faturalar, talepler, ayarlar
├── auth/         6   giriş, kayıt, unutulan parola, sıfırlama, aktivasyon, davet kabul
├── checkout/    14   yapılandırma, sepet, ödeme, sipariş tamamlandı
├── content/     14   bilgi bankası, haberler, iletişim, sözleşmeler
├── products/     3   katalog yüzeyleri
├── page/         1   dosya tabanlı sayfalar: views/page/{slug} adresi /{slug} olur
├── home.tpl          apply_theme'in ısrar ettiği tek view
├── 404.tpl           temanın kendi bulunamadı yüzeyi
├── maintenance.tpl   site kapalıyken render edilir
└── domain.tpl        kamuya açık alan adı arama

render("account/dashboard")  ->  views/account/dashboard.tpl   (smarty)
                             ->  views/account/dashboard.twig  (twig)
                             ->  views/account/dashboard.php   (php)

$settings = [
    'groups' => [
        // grup anahtarı    label = temanın locale dosyasındaki anahtar, düz metin DEĞİL
        'appearance' => ['label' => 'grp_appearance', 'icon' => 'bi-palette'],
        'checkout'   => ['label' => 'grp_checkout',   'icon' => 'bi-cart3'],
    ],
];

// HERHANGİ bir temanın tüm manifesti, klasör adıyla. Ad başına önbelleklenir, yoksa boş dizi.
public static function manifest(string $themeName): array;

// Çalışan tema. Yapılandırılan klasör yoksa Basic'e düşer.
public static function active(): self;

public function meta(): array;                    // manifest['meta']
public function engine(): string;                 // küçük harfe indirilmiş, yoksa 'php'
public function settings(): array;                // manifest['settings']
public function settingsSchema(): array;          // settings() ile AYNI dizi
public function exists(): bool;                   // manifest boş değil VE dizin yerinde

// Değerler.
public function savedConfig(): array;             // config.php, örnek başına önbelleklenir
public function setting(string $key): mixed;      // kayıtlı değer, yoksa alanın varsayılanı, o da yoksa null
public function allSettings(): array;             // her şema alanı, birleştirilmiş, view'ların aldığı hâliyle

public static function is_shipped(?string $name = null): bool;   // ürünle gelen temalardan biri (Basic, WStyle)
public static function engineLabel(string $engine): string;      // 'smarty' -> 'Smarty', panel için

return [
    'meta' => [
        'name'        => 'Acme',
        'version'     => '1.0.0',
        'author'      => 'Acme Ltd',
        'website'     => 'https://acme.example',
        'image'       => 'cover.png',      // theme.php'nin yanında, assets/ altında DEĞİL
        'description' => '',               // locale/en.php kazanır, o yüzden burası boş

        // Davranış bayrakları: katalog değil çekirdek okur.
        'signup_minimal'           => false,
        'dashboard_due_soon_alert' => false,
        'disabled_routes'          => ['references', 'references_detail'],
    ],
    'update-url' => '',                    // boş: güncelleme hiç kontrol edilmez
    'engine'     => 'smarty',
    'status'     => 'ready',
    '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
                'desc'    => 'set_topbar_enabled_desc',
                'default' => false,
            ],
            'topbar_text' => [
                'type'      => 'textarea',
                'group'     => 'topbar',
                'label'     => 'set_topbar_text',
                'default'   => '',
                'rows'      => 3,
                'multilang' => true,        // etkin dil başına bir sekme
                'html'      => true,        // olmasa kayıtta her etiket temizlenir
                'depends'   => ['topbar_enabled' => true],
            ],
        ],
    ],
];

return [
    // Katalog kartı bu ikisini meta'dan değil buradan okur.
    'name'        => 'Acme',
    'description' => 'A compact storefront theme with a promotional strip.',

    'grp_topbar'              => 'Promotional Strip',
    'set_topbar_enabled'      => 'Show the strip',
    'set_topbar_enabled_desc' => 'Prints a single line above the header on every public page.',
    'set_topbar_text'         => 'Strip content',
];

return [
    'topbar_enabled' => true,
    'topbar_text'    => [
        'en' => '<strong>Launch week</strong> 20% off every plan.',
        'tr' => '<strong>Lansman haftası</strong> tüm planlarda %20 indirim.',
    ],
];

{* $setting.topbar_text zaten aktif dilin dizesidir, harita değil. *}
{if $setting.topbar_enabled}
    <div class="topbar">{$setting.topbar_text nofilter}</div>
{/if}

// setting() HAM saklanan değeri döner: çok dilli bir alan burada hâlâ dil => değer haritasıdır.
$strip = Theme::active()->setting('topbar_text');
$lang  = Language::selected() ?: 'en';
$text  = is_array($strip) ? ($strip[$lang] ?? $strip['en'] ?? '') : (string) $strip;

// allSettings() çözülmüş biçimdir; şablonların yukarıdakini hiç yapmamasının sebebi budur.
$resolved = Theme::active()->allSettings();
$text     = (string) ($resolved['topbar_text'] ?? '');