Tema Kancaları ve Çıktı Filtreleri

// $priority: küçük olan önce çalışır; çakışma artırılarak çözülür, dinleyici asla düşürülmez.
// $properties: bir closure ya da ['class' => 'X', 'method' => 'y'] ya da ['class' => 'X', 'method::static' => 'y'].
public static function add($name, $priority, $properties = []): void;

// Değer kopyasıyla. Dinleyici başına bir giriş döner; markup noktası bunları birleştirir.
public static function run($name, ...$args): array;

// Referansla. HER argüman referansla geçer, bu yüzden her biri düz bir değişken olmalıdır.
public static function runRefs($name, &...$args): array;

/*
 * Tüm tema için TEK değişken dinleyicisi: view katmanı yalnız SON dönen diziyi
 * saklar, ikinci bir kayıt bunun yazdığı her şeyi düşürürdü.
 */
Hook::add("filter:template.variables", 1, function ($template, $data) {

    // Şablonun kendi başına okuyamayacağı çekirdek ayarından türetilir.
    $data["support_enabled"] = (int) (Config::get("options/ticket-system") ?? 0) === 1;

    // Bu temanın 404 döndürdüğü rotalar, anahtarlı harita olarak: sandbox'ta in_array()
    // yoktur, bu yüzden şablon {if !$route_off.affiliate} diye sorar.
    $data["route_off"] = array_fill_keys(Theme::active()->meta()["disabled_routes"] ?? [], true);

    // HER sayfada çalışır, bu yüzden sorgusu olan her şey önbellekten geçer. Anahtar
    // para birimini VE dili taşır, çünkü çıktı ikisine birden bağlıdır; biri eksik
    // kalırsa bir ziyaretçiye diğerinin kopyası servis edilir.
    $data["footer_groups"] = Cache::remember('website',
        'acme_footer_' . Money::getUCID() . '_' . Language::selected(), 3600,
        fn (): array => Products::groups());

    // Sayfaya özel iş ikinci bir kayıt değil, bir yol sınamasının arkasında durur.
    if (str_ends_with(str_replace('\\', '/', (string) $template), '/page/pricing.php'))
        $data["plans"] = AcmePricing::cards();

    return $data;   // başka bir şey döndürmek platformun topladığı her anahtarı düşürür
});

/*
 * Bitmiş sayfa. Bağlantı üreten her yükü yeniden yazmaktan hem ucuz hem güvenli:
 * tek yer, ve bir tanesini bile atlayamaz.
 */
Hook::add('filter:client.page.output', 1, function (&$output, $view, $engine) {
    if (str_contains($view, '/')) return;   // parçalar belge değildir

    $output = str_replace('</body>', '<script src="/assets/acme-widget.js" defer></script></body>', $output);
});

/*
 * Veri değil markup: yerleşimin noktaları bir dize alır ve olduğu gibi basar. Burada
 * kaydedilir, böylece temanın ek stil dosyası için hiçbir yerleşim dosyası düzenlenmez.
 */
Hook::add("ui:client.head.css", 1, fn (): string =>
    '<link rel="stylesheet" href="' . Theme::active()->assetUrl('css/extra.css') . '">');

<head>
    {block name=head}{/block}
    {hook name='ui:client.head.css'}
    {hook name='ui:client.head.js'}
</head>
<body>
    {hook name='ui:client.body.begin'}

    {* Kanca dosyasının koyduğu bir değer, başka her değişken gibi okunur. *}
    {if !$route_off.affiliate}<a href="{link route='affiliate'}">{lang key='nav_affiliate'}</a>{/if}

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