Die Theme-Sitzung wartete darauf: Seebad ruft schon ortsneutrale Plätze über `partials/motif` auf und behilft sich mit einem eigenen `motifs/`- Ordner. Der Kommentar dort sagt es selbst – „so a later picture-world system can replace the mapping below". Das System gibt es jetzt. **Bildwelten** (A18–A20) sind Pakete wie Themes: `resources/image-worlds/ <key>/` mit `world.json` und `svg/`. Eine Website wählt eine Bildwelt, eine Wohnung darf eine andere tragen – das ist der Platz für die Bergwohnung auf einer Küsten-Website. Vorlagen fragen über `$theme->motif($slot)` nach einem Platz, nie nach einer Datei. Die Render-Logik ist aus Seebads Partial in die Anwendung gewandert, damit jedes Theme sie bekommt: Inline-SVG (nimmt die Textfarbe an, kein zweiter Request), Titel und ARIA entfernt, und die internen Ids je Aufruf eindeutig gemacht – zwei Kopien derselben Grafik auf einer Seite würden sonst auf denselben Verlauf zeigen und eine davon verlöre ihre Farben. Ein leerer Platz ist kein Fehler: die Vorlage bekommt schlicht keine Dekoration. Weil das leicht zu übersehen ist, meldet `php artisan image-worlds:check`, welcher Platz ohne Datei dasteht. **Marke je Website** (A14/A22): Logo, Favicon und ein Logo für E-Mail und Vertrag als Medien der Website. Der Mietvertrag bettet die Datei ein statt eine URL zu holen – er wird auf dem Server gerendert und darf nicht davon abhängen, dass dieser sich selbst erreicht. Ohne Logo bleibt der Vertrag wie bisher. `resources/themes/**` ist unberührt: die Ostsee-Grafiken sind kopiert, nicht verschoben. Was die Theme-Sitzung nun tun kann, steht in ZUSAMMENARBEIT.md §6; ihr Wunsch aus §5 ist als erledigt vermerkt. 272 Feature-Tests grün. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
78 lines
2.4 KiB
PHP
78 lines
2.4 KiB
PHP
<?php
|
|
|
|
namespace App\ImageWorlds;
|
|
|
|
use JsonException;
|
|
use RuntimeException;
|
|
|
|
/**
|
|
* One picture world ("Bildwelt"): a folder with a world.json and SVG files, exactly like a theme is a
|
|
* folder with a theme.json. Themes ask for a slot (divider, vignette.beach …), never for a file, so a
|
|
* website can be dressed in "Ostsee" or later in "Berge" without touching a single template (A18/A19).
|
|
*/
|
|
class ImageWorldManifest
|
|
{
|
|
/**
|
|
* @param array<string, string> $slots slot => file name without .svg
|
|
*/
|
|
public function __construct(
|
|
public readonly string $key,
|
|
public readonly string $name,
|
|
public readonly ?string $description,
|
|
public readonly string $path,
|
|
public readonly array $slots,
|
|
) {}
|
|
|
|
public static function fromFile(string $file): self
|
|
{
|
|
try {
|
|
$data = json_decode((string) file_get_contents($file), true, 512, JSON_THROW_ON_ERROR);
|
|
} catch (JsonException $exception) {
|
|
throw new RuntimeException('Bildwelt '.$file.' ist kein gültiges JSON: '.$exception->getMessage());
|
|
}
|
|
|
|
$path = dirname($file);
|
|
$key = basename($path);
|
|
|
|
return new self(
|
|
key: $key,
|
|
name: is_string($data['name'] ?? null) ? $data['name'] : $key,
|
|
description: is_string($data['description'] ?? null) ? $data['description'] : null,
|
|
path: $path,
|
|
slots: array_filter(
|
|
is_array($data['slots'] ?? null) ? $data['slots'] : [],
|
|
fn (mixed $file, mixed $slot): bool => is_string($slot) && is_string($file),
|
|
ARRAY_FILTER_USE_BOTH,
|
|
),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* The file behind a slot, or null when this world does not fill it. A missing slot is not an error:
|
|
* a template asks for decoration and simply gets none.
|
|
*/
|
|
public function fileFor(string $slot): ?string
|
|
{
|
|
$name = $this->slots[$slot] ?? null;
|
|
|
|
if ($name === null) {
|
|
return null;
|
|
}
|
|
|
|
$file = $this->path.DIRECTORY_SEPARATOR.'svg'.DIRECTORY_SEPARATOR.$name.'.svg';
|
|
|
|
return is_file($file) ? $file : null;
|
|
}
|
|
|
|
/**
|
|
* @return list<string>
|
|
*/
|
|
public function missingFiles(): array
|
|
{
|
|
return array_values(array_filter(
|
|
array_keys($this->slots),
|
|
fn (string $slot): bool => $this->fileFor($slot) === null,
|
|
));
|
|
}
|
|
}
|