Menüler ve Navigasyon

$node = [
    'id'     => 12,
    'parent' => 0,
    'icon'   => 'bi bi-hdd-rack',      // sınıf dizesidir, adres değil
    'target' => 1,                      // 1 yeni sekmede açar
    'page'   => 'category/551',         // panelin sayfa tanımlayıcısı, aşağıda zaten çözülmüş
    'title'  => 'Hosting',              // AKTİF dilde
    'link'   => 'https://example.com/hosting',   // BOŞ olabilir: yalnız başlık olan düğüm
    'extra'  => [
        'desc'  => 'Paylaşımlı ve bayi planları',  // açılır menü satırında ikinci satır
        // Rozet. İki renk de panelin renk seçicilerinden gelir; yani baştaki diyeziyle
        // birer onaltılık dize olarak gelir ve doğrudan bir style özniteliğine girer.
        'tag'   => ['name' => 'Yeni', 'color' => '#RRGGBB', 'text_color' => '#RRGGBB', 'icon' => 'bi bi-stars'],
        'mega'  => '<div class="mega">…</div>',  // operatörün yazdığı markup, bağlantıları çözülmüş
    ],
    'children' => [ /* aynı biçim, özyinelemeli */ ],
];

// $type: 'header' | 'footer' | 'mobile' | 'sidebar' (ilk üçü her sayfada yüklenir)
// $parent: tüm ağaç için 0, ya da altından başlanacak düğüm kimliği
// $lang: boş bırakmak aktif dil demektir
public static function tree(string $type = 'header', int $parent = 0, string $lang = ''): array;

// Operatörün yazdığı markup içindeki {link page='...'} / {link route='...'} yer tutucularını
// çözer. Düğümün mega paneline zaten uygulanır; kendi sakladığınız HTML için siz çağırın.
public static function resolveLinks(string $html): string;

// $lang: boş bırakmak aktif dil demektir; aynı sayfayı başka dilde kurmak için doldurun.
public static function client($route = '', $params = [], $lang = ''): string;

// Panel tanımlayıcısını ("pages/4", "category/551", "home") bitmiş adrese çevirir.
public static function convert_to_link(string $arg): string;

// Sorgu dizesi ekler. Elle birleştirmeyin: bu metot adresin zaten "?" taşıyıp
// taşımadığını bilir.
public static function wQS(string|bool|null $url, array|string $params = []): string;

<ul class="nav site-nav">
    {foreach $header_menu as $item}
        {if $item.children}
    <li class="nav-item dropdown">
        <a class="nav-link"{if $item.link} href="{$item.link}"{/if}>{$item.title}</a>
        <div class="dropdown-menu">
            {foreach $item.children as $child}
            <a class="dropdown-item"{if $child.link} href="{$child.link}"{/if}{if $child.target} target="_blank" rel="noopener"{/if}>
                <i class="{$child.icon}"></i>
                <span>{$child.title}</span>
                {if $child.extra.desc ?? ''}<span class="item-desc">{$child.extra.desc}</span>{/if}
            </a>
            {/foreach}
        </div>
    </li>
        {elseif $item.extra.mega ?? ''}
    {* Operatörün yazdığı markup: ham basılır, yoksa etiketlerin kendisi sayfada görünür. *}
    <li class="nav-item dropdown">
        <a class="nav-link"{if $item.link} href="{$item.link}"{/if}>{$item.title}</a>
        <div class="dropdown-menu">{$item.extra.mega nofilter}</div>
    </li>
        {else}
    <li class="nav-item"><a class="nav-link"{if $item.link} href="{$item.link}"{/if}>{$item.title}</a></li>
        {/if}
    {/foreach}

    {* Bu temanın kapattığı bir bölüm: harita hooks.php'den, rota anahtarından gelir. *}
    {if !$route_off.affiliate}
    <li class="nav-item"><a class="nav-link" href="{link route='affiliate'}">{lang key='nav_affiliate'}</a></li>
    {/if}

    {hook name='ui:client.nav.items'}
</ul>

<a class="btn" href="{link route='cart'}">{lang key='nav_cart'}</a>
<a class="btn" href="{link route='invoice-detail' p1=$latest_invoice_id}">{lang key='nav_last_invoice'}</a>

Hook::add("filter:template.variables", 1, function ($template, $data) {

    // Liste değil anahtarlı harita: şablon sandbox'ında in_array() yoktur, koşul
    // yalnız {if !$route_off.affiliate} diye sorabilir.
    $data["route_off"] = array_fill_keys(Theme::active()->meta()["disabled_routes"] ?? [], true);

    return $data;
});

/*
 * Panelin yönetmediği bir düğüm. Referansla: ağaç yerinde değiştirilir ve bağlam
 * hangi ağaç olduğunu söyler, böylece bir üst menü kuralı altbilgiye dokunmaz.
 */
Hook::add("filter:client.menu", 10, function (&$rows, $ctx) {
    if (($ctx["type"] ?? '') !== 'header') return;

    $rows[] = [
        'id'       => 0,
        'parent'   => 0,
        'icon'     => 'bi bi-life-preserver',
        'target'   => 0,
        'page'     => '',
        'title'    => Theme::active()->lang('nav_status'),
        'link'     => LinkGenerator::client('contact'),
        'extra'    => [],
        'children' => [],
    ];
});