Tema Ayarları

$manifest['settings'] = [
    // anahtar => grubun başlığı ve ikonu. Etiket, bu temanın bir LOCALE ANAHTARIDIR.
    'groups' => [
        'topbar' => ['label' => 'grp_topbar', 'icon' => 'bi-megaphone'],
    ],
    // anahtar => tanımlayıcı. Anahtar aynı anda POST adı, config anahtarı ve view'ın
    // okuduğu addır: yeniden adlandırmak kayıtlı olanı öksüz bırakır.
    'fields' => [
        'topbar_enabled' => ['type' => 'switch', 'group' => 'topbar', 'label' => 'set_topbar_enabled', 'default' => false],
    ],
];

// Manifestteki ayarlar bloğu, bildirildiği gibi (groups + fields).
public function settingsSchema(): array;

// Tek değer: anahtar hiç kaydedildiyse kayıtlı olan, yoksa şema varsayılanı, o da
// yoksa null. Platform tek bir tema yeteneğini böyle okur.
public function setting(string $key): mixed;

// Yalnız kayıtlı değerler (config.php). İlk kayda kadar boştur.
public function savedConfig(): array;

// Her şema alanı değeriyle birleşmiş hâlde : view'ın $setting olarak aldığı şey.
// Çok dilli değer burada AKTİF dile indirgenir ve renk alanı ayrıca bir
// "{anahtar}_rgb" girdisi üretir.
public function allSettings(): array;

// Bir hex rengi, rgba() ifadesinin istediği virgüllü üçlüye çevirir. Kısa biçimler
// genişletilir ve kısa değer doldurulur, bu yüzden boş dize hata değil üç sıfır verir.
// Yukarıdaki "{anahtar}_rgb" girdilerini üreten budur.
public static function hexToRgb(string $hex): string;

return [
    'engine' => 'smarty',
    'status' => 'ready',
    'meta'   => [
        'name'    => 'Acme',
        'version' => '1.0.0',
        'author'  => 'Acme Ltd',
        'image'   => 'cover.png',
    ],
    'settings' => [
        'groups' => [
            'brand'    => ['label' => 'grp_brand', 'icon' => 'bi-palette'],
            'topbar'   => ['label' => 'grp_topbar', 'icon' => 'bi-megaphone'],
            'checkout' => ['label' => 'grp_checkout', 'icon' => 'bi-cart3'],
        ],
        'fields' => [
            // Bir marka rengi. `from_logo`, panelin site logosundan çıkardığı paletteki
            // sırasıdır; "renkleri logodan seç" düğmesi bu alanı o sıradan doldurur.
            // Varsayılan, diyez artı altı onaltılık hane biçimindedir (seçicinin kendi
            // biçimi) — yer tutucuyu bu temanın gerçek rengiyle değiştirin. Boş
            // bırakılırsa türetilen primary_color_rgb üç sıfır okunur ve ondan kurulan
            // her yarı saydam yüzey siyaha boyanır.
            'primary_color' => [
                'type'      => 'color',
                'group'     => 'brand',
                'label'     => 'set_primary_color',
                'from_logo' => 0,
                'default'   => '#RRGGBB',
            ],

            // Kapı. Altındaki her şey buna bağlıdır.
            'topbar_enabled' => [
                'type'    => 'switch',
                'group'   => 'topbar',
                'label'   => 'set_topbar_enabled',
                'desc'    => 'set_topbar_enabled_desc',
                'default' => false,
            ],

            // Dil başına ve markup taşıyabilir: duyurunun içinde genelde bir bağlantı olur.
            // Saklanan değer bir haritadır; view yine dize alır.
            'topbar_text' => [
                'type'      => 'textarea',
                'group'     => 'topbar',
                'label'     => 'set_topbar_text',
                'default'   => '',
                'rows'      => 3,
                'multilang' => true,
                'html'      => true,
                'depends'   => ['topbar_enabled' => true],
            ],

            // Anahtarlar saklanan şeydir; değerler bu temanın locale anahtarlarıdır.
            'checkout_sidebar' => [
                'type'    => 'select',
                'group'   => 'checkout',
                'label'   => 'set_checkout_sidebar',
                'options' => [
                    'rail'  => 'opt_checkout_rail',
                    'card'  => 'opt_checkout_card',
                    'stack' => 'opt_checkout_stack',
                ],
                'default' => 'rail',
            ],

            'popup_width' => [
                'type'    => 'number',
                'group'   => 'checkout',
                'label'   => 'set_popup_width',
                'default' => 500,
            ],
        ],
    ],
];

return [
    // Seçicinin gönderdiği hâliyle, baştaki diyezle saklanır. Dikkat: operatör
    // dokunmamış olsa da HER şema alanı her kayıtta yeniden yazılır.
    'primary_color'    => '#RRGGBB',
    'topbar_enabled'   => true,
    // Çok dilli: dil başına saklanır, kayıt anındaki her AKTİF dil için bir giriş.
    'topbar_text'      => [
        'en' => 'Free migration this month.',
        'tr' => 'Bu ay ücretsiz taşıma.',
    ],
    'checkout_sidebar' => 'card',
    'popup_width'      => 520,
];

{* Boolean doğrudan bir koşulun içinde okunur; bunun DEĞİŞKEN olup fonksiyon
   olmamasının sebebi budur: kayıtlı bir fonksiyon {if} içinden çağrılamaz. *}
{if $setting.topbar_enabled}
    {* Kayıtta markup korundu, bu yüzden burada filtresiz basılır. *}
    <div class="topbar">{$setting.topbar_text nofilter}</div>
{/if}

{* Select yalnızca saklanan anahtarıdır: dört kez dallanmak yerine sınıf olarak kullanın. *}
<div class="checkout-layout-{$setting.checkout_sidebar}">

{* Renk alanı ayrıca bir _rgb ikizi üretir; aynı rengin yarı saydam sürümü için. *}
<style>
    :root {
        --acme-brand: {$setting.primary_color};
        --acme-brand-rgb: {$setting.primary_color_rgb};
    }
</style>