Files
laraundfelix/app/Domain/Design/DesignSettings.php
StommerandClaude Sonnet 5.5 67614158e4 Führe eine konfigurierbare Größenskala für Website und Vorschau ein
Zehn Basiswerte (Fließtext, Überschriften, Abstände, Kopfzeile, Inhaltsbreite, Bildhöhe) leiten in tokens.css alle Größen ab. Einstieg, Bild und Text, Premium-Karten, Karten, Kopf, Fuß und Schaltflächen verwenden nur noch diese Tokens. Die Werte sind unter Website, Design, Größen einstellbar und wirken ohne Deployment über ein Inline-Stylesheet in Website, Mitgliederbereich-Layout und CMS-Vorschau. Lesen fällt bei fehlender Tabelle oder beschädigten Daten auf die Standardwerte zurück. Die Migration ist rein ergänzend.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 14:54:14 +01:00

122 lines
3.5 KiB
PHP

<?php
namespace App\Domain\Design;
use App\Models\User;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\HtmlString;
use Throwable;
/**
* Lesen und Schreiben der Größenskala (Schlüssel „design.scale“ in site_settings).
*
* Die öffentliche Ausgabe hängt nie am Erfolg dieser Klasse: Fehlt die Tabelle (Code vor Migration), ist die Datenbank
* nicht erreichbar oder sind die Daten beschädigt, gelten die Standardwerte aus tokens.css, ohne Fehlerseite.
* Änderungen wirken sofort (Zwischenspeicher wird beim Speichern geleert), ohne Deployment.
*/
final class DesignSettings
{
public const KEY = 'design.scale';
private const CACHE_KEY = 'design.scale.v1';
/** @var array<string, int>|null */
private static ?array $memo = null;
/**
* Wirksame Werte (gespeichert oder Standard).
*
* @return array<string, int>
*/
public static function values(): array
{
if (self::$memo !== null) {
return self::$memo;
}
try {
$stored = Cache::rememberForever(self::CACHE_KEY, static function (): array {
$row = SiteSetting::query()->find(self::KEY);
return $row === null ? [] : (array) $row->value;
});
return self::$memo = $stored === [] ? DesignScale::defaults() : DesignScale::read($stored);
} catch (Throwable) {
return self::$memo = DesignScale::defaults();
}
}
/** Ob abweichende Werte wirksam sind. */
public static function isCustomised(): bool
{
return self::values() !== DesignScale::defaults();
}
/**
* Speichert vollständige, geprüfte Werte.
*
* @param array<string, mixed> $input
* @return array<string, string> Fehlermeldungen je Schlüssel; leer bei Erfolg
*/
public static function save(array $input, ?User $by = null): array
{
$errors = DesignScale::errors($input);
if ($errors !== []) {
return $errors;
}
$ordered = [];
foreach (array_keys(DesignScale::PARAMETERS) as $key) {
$ordered[$key] = (int) $input[$key];
}
SiteSetting::query()->updateOrCreate(['key' => self::KEY], ['value' => $ordered, 'updated_by' => $by?->getKey()]);
self::flush();
return [];
}
/** Standardwerte wiederherstellen: die Zeile entfällt, es gelten wieder die Werte aus tokens.css. */
public static function reset(): void
{
SiteSetting::query()->whereKey(self::KEY)->delete();
self::flush();
}
/** Zeitpunkt der letzten Speicherung, falls vorhanden. */
public static function updatedAt(): ?Carbon
{
try {
return SiteSetting::query()->find(self::KEY)?->updated_at;
} catch (Throwable) {
return null;
}
}
public static function flush(): void
{
self::$memo = null;
try {
Cache::forget(self::CACHE_KEY);
} catch (Throwable) {
// Der Zwischenspeicher ist nur Beschleunigung.
}
}
/**
* Stylesheet-Block für Layouts und Vorschauen; nach dem Stylesheet der Website einzufügen, damit er gewinnt.
* Leer, solange keine abweichenden Werte gespeichert sind.
*/
public static function styleTag(): HtmlString
{
$css = DesignScale::css(self::values());
return new HtmlString($css === '' ? '' : '<style id="lf-design-scale">'.$css.'</style>');
}
}