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:
1 parent
e0a3fdbb70
commit
67614158e4
23 files changed
+1110
-111
No files matched your search
@@ -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>');
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user