Loheide-eu-mitarbeiterplatt.../app/Support/Branding.php
Friederich Loheide 82bbeef31b
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 2m7s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 2m11s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 2m16s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 2m18s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 2m49s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 2m46s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 2m41s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 2m33s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m0s
Phase 5: Erscheinungsbild mit Entwurf, Vorschau und Veröffentlichen
- Theme in den Einstellungen (Entwurf/veröffentlicht), Übernahme der
  Einstellungen aus Phase 0; statische CSS-Datei mit Hash beim Veröffentlichen
- Logos hell/dunkel, Signet, App-Symbol → Favicon, Homescreen-Symbole,
  Web-App-Manifest; SVG-Bereinigung
- Markenfarbe exakt, zweite Akzentfarbe, Kopfleiste hell/Marke/dunkel,
  Kontrastprüfung (WCAG AA) mit automatisch lesbarer Linkfarbe
- Lokale Schriften (Latein), Überschriften-Schrift, eigene WOFF2-Schrift,
  Ecken, Dichte, Dunkelmodus-Regel
- Anmeldeseite (geteilt/zentriert, Bild, Texte), Fußzeile, E-Mails im Design
- Admin: Live-Vorschau (Startseite, Anmeldung, Beispielseite; hell/dunkel),
  Veröffentlichen, Verwerfen, Export/Import, Zurücksetzen, eigenes CSS
- Admin-Bereich übernimmt Logo, Farbe und Favicon; Whitelabel

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 10:46:05 +00:00

187 lines
5.1 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Support;
use App\Support\Theme\Icons;
use App\Support\Theme\Theme;
use App\Support\Theme\ThemeCompiler;
use Illuminate\Support\Facades\Storage;
use Throwable;
/**
* Das aktive Erscheinungsbild (docs/PLAN.md, Abschnitt 12): der veröffentlichte
* Stand – oder der Entwurf, wenn eine berechtigte Person gerade die Vorschau nutzt.
*/
class Branding
{
public const DEFAULT_NAME = 'Inhaus';
public const DEFAULT_PRIMARY_COLOR = '#0F4C5C';
public const PREVIEW_SESSION_KEY = 'theme_preview';
/** @var array<string, mixed>|null */
private ?array $active = null;
private ?bool $previewing = null;
public function __construct(
private readonly Settings $settings,
private readonly Theme $theme,
private readonly ThemeCompiler $compiler,
) {}
/**
* @return array<string, mixed>
*/
public function active(): array
{
return $this->active ??= $this->isPreviewing() ? ($this->theme->draft() ?? $this->theme->published()) : $this->theme->published();
}
public function isPreviewing(): bool
{
if ($this->previewing !== null) {
return $this->previewing;
}
try {
$request = request();
return $this->previewing = $request->hasSession()
&& $request->session()->get(self::PREVIEW_SESSION_KEY) === true
&& (bool) $request->user()?->can('appearance.manage')
&& $this->theme->hasDraft();
} catch (Throwable) {
return $this->previewing = false;
}
}
/** Nach dem Speichern eines Entwurfs oder Veröffentlichen neu lesen. */
public function refresh(): void
{
$this->active = null;
$this->previewing = null;
}
public function get(string $key): mixed
{
return $this->active()[$key] ?? null;
}
public function portalName(): string
{
return $this->get('portal_name') ?: self::DEFAULT_NAME;
}
public function primaryColor(): string
{
return $this->get('primary_color') ?: self::DEFAULT_PRIMARY_COLOR;
}
public function logoPath(): ?string
{
return $this->get('logo_light');
}
public function logoUrl(): ?string
{
return $this->url($this->get('logo_light'));
}
public function logoDarkUrl(): ?string
{
return $this->url($this->get('logo_dark')) ?? $this->logoUrl();
}
public function url(?string $path): ?string
{
return $path ? Storage::disk('uploads')->url($path) : null;
}
/**
* @return array<int, string>
*/
public function palette(): array
{
return ColorPalette::fromHex($this->primaryColor());
}
/**
* Stylesheet des veröffentlichten Stands; null = inline ausgeben (Vorschau, noch nie veröffentlicht).
*/
public function stylesheetUrl(): ?string
{
$path = $this->isPreviewing() ? null : $this->get('stylesheet');
return $path && Storage::disk('uploads')->exists($path) ? $this->url($path) : null;
}
public function inlineCss(): string
{
return $this->compiler->css($this->active());
}
/**
* @deprecated Nur noch für Übergänge – das Theme liefert alle Variablen.
*/
public function cssVariables(): string
{
return '--brand:'.$this->primaryColor();
}
public function faviconUrl(): string
{
$icons = $this->get('icons') ?? [];
return isset($icons[32]) ? $this->url($icons[32]) : Icons::monogram($this->portalName(), $this->primaryColor(), ColorPalette::foregroundFor($this->primaryColor()));
}
public function appleTouchIconUrl(): ?string
{
return isset(($this->get('icons') ?? [])[180]) ? $this->url($this->get('icons')[180]) : null;
}
/**
* Welche Darstellung gilt für eine Person? null = selbst gewählt/Systemeinstellung.
*/
public function forcedColorMode(): ?string
{
return match ($this->get('dark_mode')) {
'light' => 'light',
'dark' => 'dark',
default => null,
};
}
/**
* Für das Portal (Inertia).
*
* @return array<string, mixed>
*/
public function toArray(): array
{
$theme = $this->active();
return [
'portal_name' => $this->portalName(),
'primary_color' => $this->primaryColor(),
'logo_url' => $this->logoUrl(),
'logo_dark_url' => $this->logoDarkUrl(),
'logo_mark_url' => $this->url($theme['logo_mark']),
'header_style' => $theme['header_style'],
'color_mode' => $this->forcedColorMode(),
'login' => [
'layout' => $theme['login_layout'],
'title' => $theme['login_title'],
'text' => $theme['login_text'],
'image_url' => $this->url($theme['login_image']),
],
'footer' => [
'text' => $theme['footer_text'],
'links' => $theme['footer_links'],
],
'preview' => $this->isPreviewing(),
];
}
}