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>
This commit is contained in:
StommerandClaude Sonnet 5.5 committed 2026-11-22 14:54:14 +01:00
1 parent e0a3fdbb70
commit 67614158e4
23 files changed
+1110 -111

No files matched your search

+121
View File
@@ -0,0 +1,121 @@
<?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>');
}
}