tsv08kulmbach-website/app/components/stadionzeitung-cover.php

<?php

declare(strict_types=1);

/**
 * Automatisch generiertes Stadionzeitung-Cover (Phase 3) — ersetzt das bisherige
 * Canva-Titelbild. Einzige fotografische Stadionzeitungs-Seite: Vereins-Hero-Bild
 * als Hintergrund (dieselbe Quelle wie die Startseite, data/home.json — nie
 * duplizieren) mit Abdunklungs-Verlauf, das freigestellte Spielerfoto ist der
 * Star (sehr großformatig, rechts randabfallend). Kopf wie ein echtes
 * Zeitschriften-Titelblatt: kleine rote Kicker-Zeile (Saison/Datum), riesiger
 * Masthead mit Logo auf gleicher Höhe, dezente Tagline darunter. Unten links
 * gestapelt: Begegnung als große freie Typografie (kein Kasten) über einer
 * roten Trennlinie und Slogan + QR-Plakette. Dünne Passepartout-Rahmenlinie
 * gibt den "druckfertig"-Effekt.
 *
 * Selbst-Containment: alle Maße hier laufen über CSS Container Queries (cqi,
 * relativ zur eigenen Breite von .stadionzeitung-cover), NICHT über die
 * Website-Schriftgrößen-Tokens aus tokens.css — das Cover sieht dadurch in
 * jedem Kontext (Karten-Vorschau, Swipe-Viewer, Druck) proportional exakt
 * gleich aus, unabhängig von Viewport/Root-Schriftgröße. Einzige Ausnahme
 * ganz bewusst: die crest-Komponente (geteiltes Bauteil, bekommt ihre Größe
 * über --crest-size lokal in cqi mitgegeben, keine eigene Kopie nötig).
 *
 * Props: $issue (Eintrag aus data/stadionzeitung.json: opponent, date, team_key,
 *        player_image?, qr_image?)
 *
 * Gegner-Wappen wird zur Laufzeit über den Anstoß-Tag in data/matchcenter.json
 * gesucht (next_matches/last_results des Teams) — nie im JSON dupliziert. Kein
 * Treffer (z. B. Freundschaftsspiel gegen eine Spielgemeinschaft, die der BFV
 * nicht führt) → das eigene Wappen kommt trotzdem aus dem lokalen Vereinslogo,
 * der Gegner läuft über den Initialen-Fallback der crest-Komponente.
 */
$issue = $issue ?? [];
$opponent = (string) ($issue['opponent'] ?? '');
$date = (string) ($issue['date'] ?? '');
$teamKey = (string) ($issue['team_key'] ?? '');
$playerImage = $issue['player_image'] ?? null;
$qrImage = $issue['qr_image'] ?? null;

$club = json_load('club');
$heroImage = json_load('home')['hero']['image'] ?? null;

$team = null;
foreach (json_load('matchcenter')['teams'] ?? [] as $t) {
    if (($t['key'] ?? '') === $teamKey) {
        $team = $t;
        break;
    }
}
$teamName = (string) ($team['name'] ?? '');
$league = (string) ($team['league'] ?? '');
$season = (string) ($team['season'] ?? '');

$match = null;
foreach (array_merge($team['next_matches'] ?? [], $team['last_results'] ?? []) as $candidate) {
    if (str_starts_with((string) ($candidate['kickoff'] ?? ''), $date)) {
        $match = $candidate;
        break;
    }
}

$ownCrest = 'img/logo.svg';
$opponentCrest = null;
if ($match !== null) {
    $ownCrest = $match['is_home'] ? $match['home_crest'] : $match['away_crest'];
    $opponentCrest = $match['is_home'] ? $match['away_crest'] : $match['home_crest'];
}

// Gedruckte Zeile neben dem QR-Code — immer die echte Domain (club_domain()).
$linkText = club_domain();
// Aufmacher unten links: normal die Begegnung (Wappen + „Heimspiel gegen …").
// Zeigt die Ausgabe auf eine Veranstaltung (Sportfest-Ausgabe), tritt an deren
// Stelle das FEST als Titelgeschichte — denn ein Fest bringt mehrere Heimspiele
// mit (Erste, Zweite, Frauen), und ein einzelnes davon aufs Cover zu heben wäre
// falsch (Felix, 03.09.2026). Titel und Zeitraum kommen aus
// data/veranstaltungen.json, nie neu getippt.
$feature = null;
$featureV = veranstaltung_find((string) ($issue['veranstaltung'] ?? ''));
if ($featureV !== null) {
    $feature = [
        'title' => trim((string) ($featureV['title'] ?? '')),
        'range' => german_date_range((string) ($featureV['date_start'] ?? ''), $featureV['date_end'] ?? null),
    ];
}

// Bildmotiv rechts: normal das freigestellte Spielerfoto. Eine Sonderausgabe mit
// Veranstaltung zeigt stattdessen deren HAUPTPLAKAT (erstes Plakat, dieselbe
// Quelle wie /veranstaltungen/<slug>, nie eine Kopie) — leicht schräg gelegt mit
// zwei abgerundeten Ecken, wie ein aufs Cover gelegter Aushang (Felix,
// 03.09.2026). Ohne Plakat bleibt es beim Spielerfoto, ohne beides trägt der
// Hintergrund die Seite allein.
$poster = null;
if ($featureV !== null) {
    $ersteseite = $featureV['plakate'][0] ?? null;
    if (is_array($ersteseite) && !empty($ersteseite['base'])) {
        $poster = $ersteseite;
    }
}

// Kicker: Saison · Datum, auf jedem Cover gleich. Eine Sonderausgabe bekommt
// bewusst KEINE zusätzliche Kennung im Kopf: ein roter Kasten „Sportfest-Ausgabe"
// war gebaut und am 03.09.2026 wieder entfernt (Felix) — er stach aus dem
// ruhigen Kopf heraus, und die Ausgabe kennzeichnet sich unten links ohnehin
// selbst durch den großen Fest-Titel.
$kicker = implode(' · ', array_filter([
    $season,
    $date !== '' ? german_date($date) : '',
], static fn (string $s): bool => $s !== ''));

// Zweite Coverzeile (Magazin-Praxis: Teaser auf die Geschichte im Heft) —
// aus stadionzeitung_teaser(): `cover.teaser` einer Sonderausgabe, sonst die
// Coverzeile des Interviews. Dieselbe Funktion speist die Archivkarte.
$teaser = stadionzeitung_teaser($issue);
?>
<div class="stadionzeitung-cover<?= $poster !== null ? ' stadionzeitung-cover--poster' : '' ?>">
<?php if ($heroImage): ?>
<?php component('img', ['image' => $heroImage, 'sizes' => '480px', 'class' => 'stadionzeitung-cover__bg']); ?>
<?php endif; ?>
<?php if ($poster !== null): ?>
<?php /* Alt-Text bewusst leer: der Plakat-Alt-Text aus veranstaltungen.json
         beschreibt die Termine, die drei Zeilen weiter unten als Text stehen —
         auf dem Cover wäre er eine Dopplung fürs Screenreader-Ohr. */ ?>
<?php component('img', [
        'image' => ['base' => $poster['base'], 'widths' => $poster['widths'] ?? [], 'alt' => ''],
        'class' => 'stadionzeitung-cover__poster',
        'sizes' => '(max-width: 600px) 55vw, 260px',
    ]); ?>
<?php elseif (!empty($playerImage)): ?>
<?php
    /* Varianten-Set (base/widths/ext=png) statt der Originaldatei. Das Original ist
       ein Freisteller mit 2584x5093 Pixeln und 12 MB: iOS Safari verwirft Bilder,
       deren dekodierte Größe sein Budget übersteigt (hier gut 53 MB), und auf einer
       Ausgabe liegen rund 86 Bilder — das Cover blieb am iPhone leer, während Chrome
       am Desktop es zeigte (31.07.2026). Dargestellt wird es mit 98cqi Höhe, bei
       480px Seitenbreite also etwa 238x470 CSS-Pixel; die 1000er Variante deckt
       damit auch Druck und dreifache Pixeldichte ab.
       sizes nennt die echte Breite, sonst zöge ein Handy mit DPR 3 die größte. */
    $playerBild = is_array($playerImage)
        ? $playerImage
        : ['src' => $playerImage, 'width' => 0, 'height' => 0, 'alt' => ''];
?>
    <?php component('img', [
        'image' => $playerBild,
        'class' => 'stadionzeitung-cover__player',
        'sizes' => '(max-width: 600px) 50vw, 240px',
    ]); ?>
<?php endif; ?>
    <div class="stadionzeitung-cover__inner">
        <header class="stadionzeitung-cover__masthead">
<?php if ($kicker !== ''): ?>
            <p class="stadionzeitung-cover__kicker"><?= e($kicker) ?></p>
<?php endif; ?>
            <div class="stadionzeitung-cover__masthead-row">
                <img class="stadionzeitung-cover__logo" src="<?= e(asset('img/logo.svg')) ?>" alt="" width="75" height="97">
                <p class="stadionzeitung-cover__wordmark">Stadionzeitung</p>
            </div>
            <p class="stadionzeitung-cover__tagline">Rund ums Heimspiel im Katzbachtal</p>
        </header>
        <div class="stadionzeitung-cover__corner">
<?php if ($feature !== null): ?>
<?php /* Sonderausgabe: das Fest ist die Titelgeschichte, nicht eine der
         Begegnungen. Titel in der Display-Schrift (Versalien wie der Masthead),
         Zeitraum darunter als gesperrte Zeile. */ ?>
            <div class="stadionzeitung-cover__feature">
                <p class="stadionzeitung-cover__feature-title"><?= e($feature['title']) ?></p>
<?php if ($feature['range'] !== ''): ?>
                <p class="stadionzeitung-cover__meta"><?= e($feature['range']) ?></p>
<?php endif; ?>
            </div>
<?php else: ?>
            <div class="stadionzeitung-cover__headline">
<?php /* Bewusst ohne Trennzeichen zwischen den Wappen (Felix, 29.07.2026:
         ruhiger) — die beiden Logos sprechen für sich. */ ?>
                <div class="stadionzeitung-cover__crests">
<?php component('crest', ['src' => $ownCrest, 'name' => $club['name'] ?? '']); ?>
<?php component('crest', ['src' => $opponentCrest, 'name' => $opponent]); ?>
                </div>
                <p class="stadionzeitung-cover__matchup">Heimspiel gegen <?= e($opponent) ?></p>
<?php if ($teamName !== '' || $league !== ''): ?>
                <p class="stadionzeitung-cover__meta"><?= e(trim($teamName . ($league !== '' ? ' · ' . $league : ''))) ?></p>
<?php endif; ?>
            </div>
<?php endif; ?>
<?php if ($teaser !== ''): ?>
            <p class="stadionzeitung-cover__teaser">
                <span class="stadionzeitung-cover__teaser-label">Im Heft</span>
                <?= e($teaser) ?>
            </p>
<?php endif; ?>
<?php /* Bewusst ohne Vereins-Slogan (Felix, 29.07.2026: ruhiger) — der
         Slogan bleibt Footer/JSON-LD der Website vorbehalten. */ ?>
            <footer class="stadionzeitung-cover__footer">
<?php /* QR bewusst minimal (Felix, 29.07.2026): Code + eine Zeile,
         keine Plakette/kein Rahmen mehr. */ ?>
<?php if (!empty($qrImage)): ?>
                <div class="stadionzeitung-cover__digital">
                    <img class="stadionzeitung-cover__qr" src="<?= e(asset($qrImage)) ?>" alt="" width="60" height="60" loading="lazy">
                    <span class="stadionzeitung-cover__link">Digital lesen · <?= e($linkText) ?></span>
                </div>
<?php endif; ?>
            </footer>
        </div>
    </div>
</div>