Sistem Sayfaları

$sys = require __DIR__ . DIRECTORY_SEPARATOR . 'inc' . DIRECTORY_SEPARATOR . 'shell.php';

// Değerler
$sys['lang'];                       // dil paketinden 'en', 'tr', ...
$sys['dir'];                        // 'ltr' ya da 'rtl'
$sys['app'];                        // sistemin taban adresi

// Çağrılabilirler
$sys['e']($text);                   // htmlspecialchars, tırnaklar dahil, UTF-8
$sys['l']($file, $key, $fallback);  // system/{file}/{key} ya da erişilemezse $fallback
$sys['head']();                     // yerel yazı tipi bağlantısı + paylaşılan stil
$sys['mark']($shape);               // gömülü ikon: 'alert', 'shield' ya da 'tools'
$sys['brand']();                    // ürün imzası + sürüm dosyası
$sys['mask']($text);                // yönetici dizini yer tutucuyla değiştirilir

// Tipik kullanım, sayfa başına locale dosyası bir kez bağlanır:
$e = $sys['e'];
$L = static fn (string $k, string $fallback): string => $sys['l']('error', $k, $fallback);

// Manifest yüklendiyse VE tema dizini gerçekten oradaysa true.
public function exists(): bool;

// views/<view>.<uzantı> gerçek bir dosyaysa true. Uzantı manifest motorunu izler.
public function viewExists(string $view): bool;

// Bir sistem yüzeyini istek dışında render etmek (CLI sağlık kontrolü, bir probe):
// chose("website") temayı atlar, bu yüzden temayı doğrudan çağırın.
public function render(string $view, array $data = []): string;

<!DOCTYPE html>
{* layouts/default.tpl DEĞİL: site kapalıdır, yani hiçbir gezinme, sepet ya da
   hesap kabuğu oraya geri bağlanamaz. Dil değiştirici tek kontroldür ve BU
   sayfayı seçilen dilde yeniden render eder. *}
<html lang="{$ui_lang|default:'en'}" dir="{$ui_dir|default:'ltr'}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="robots" content="noindex, nofollow">
    <title>{lang key='system/maintenance/meta'}</title>

    {* Guard'ı ana layout'tan BİREBİR kopyalayın. Son yedek değeri tema script'inin
       değeriyle eşleşmelidir; yoksa sayfa bir modda boyanır ve bir kare sonra
       diğerine döner. Hata yalnız hiç kayıtlı değeri olmayan ziyaretçide görünür;
       geliştiricinin kendi tarayıcısının onu hiç üretememesinin sebebi budur. *}
    <script>
      var t = localStorage.getItem('wstyle-theme') || 'light';
      document.documentElement.setAttribute('data-bs-theme', t);
    </script>

    <link rel="stylesheet" href="{asset path='css/theme.css'}">
    <link rel="stylesheet" href="{asset path='css/maintenance.css'}">

    {* Kapalı sitede de operatörün renkleri geçerlidir. *}
    <style>:root { --brand: {$setting.primary_color}; }</style>

    {hook name='ui:client.head.css'}
    {hook name='ui:client.head.js'}
</head>
<body class="maintenance-page">
{hook name='ui:client.body.begin'}

<header>
    <a href="{link route='home'}"><span>{$company_name}</span></a>

    {* Sayfadaki TEK kontrol. *}
    {if $lang_count > 1}
      {foreach $lang_list as $l}
        <a href="{$l.link}">{$l.name}</a>
      {/foreach}
    {/if}
</header>

<main id="maintenance-content">
    <p>{lang key='system/maintenance/text'}</p>
</main>

{hook name='ui:client.body.end'}
</body>
</html>

public function main(): void
{
    // Bilerek asgari: kapalı bir sayfanın menüye, sepete ya da duyuruya ihtiyacı yok.
    $this->takeDatas(["language", "website_logos", "company_name", "lang_list"]);
    $this->addData("current_year", date("Y"));

    // İKİ denetim de gerekli. viewExists olmadan, bakım view'ı taşımayan bir tema
    // düz PHP yoluna düşer, hiçbir dosya bulamaz ve boş string döner: hiçbir yerde
    // hata olmadan boş bir sayfa.
    $theme = \Theme::active();
    if ($theme->exists() && $theme->viewExists("maintenance"))
        $html = $this->view->chose("website")->render("maintenance", $this->data, true);
    else
        $html = $this->view->chose("system")->render("maintenance", $this->data, true);

    // Render sonrası enjekte edilir, böylece hem tema view'ına hem yedeğe ulaşır.
    $injection = implode('', \Hook::run('ui:client.maintenance.body', $this->data));
    if ($injection) $html = preg_replace('/<\/body>/i', $injection . '</body>', $html, 1);

    echo $html;
}