diff --git a/app/Domain/Catalog/ContentElement.php b/app/Domain/Catalog/ContentElement.php index 178dee3..cde9883 100644 --- a/app/Domain/Catalog/ContentElement.php +++ b/app/Domain/Catalog/ContentElement.php @@ -17,6 +17,10 @@ class ContentElement extends Model 'description', 'usage_note', 'license_note', + 'website_credit', + 'website_alt', + 'website_released_at', + 'website_public_path', 'summary', 'thumbnail_path', 'thumbnail_alt', @@ -30,6 +34,7 @@ protected function casts(): array { return [ 'archived_at' => 'datetime', + 'website_released_at' => 'datetime', ]; } diff --git a/app/Domain/Media/ThumbnailDeriver.php b/app/Domain/Media/ThumbnailDeriver.php index 43bb141..53ccbdd 100644 --- a/app/Domain/Media/ThumbnailDeriver.php +++ b/app/Domain/Media/ThumbnailDeriver.php @@ -52,6 +52,18 @@ public function forElementUpload(ContentElement $element, string $incoming): voi $this->rememberElement($element, 'eigen'); } + public function forWebsiteImage(ContentElement $element, string $incoming): void + { + if ($element->output_class !== 'bild' || ! $this->incomingIsSafe($incoming)) { + $this->fail($element, 'Das Bild für die Website wurde nicht übernommen.'); + + return; + } + + $this->still($element, Storage::disk('cms_incoming'), $incoming, 'element-'.$element->id); + $this->rememberElement($element, 'eigen'); + } + public function forElementFrame(ContentElement $element, ContentElementVersion $version, float $seconds): void { if ($version->content_element_id !== $element->id || $element->output_class !== 'film') { @@ -201,6 +213,14 @@ private function readableDerived(mixed $path, string $prefix): bool return Storage::disk('media_derived')->exists($path); } + private function incomingIsSafe(string $incoming): bool + { + return (str_starts_with($incoming, 'cms/') || str_starts_with($incoming, 'vorschau/')) + && ! str_contains($incoming, '..') + && preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $incoming) === 1 + && Storage::disk('cms_incoming')->exists($incoming); + } + private function secondText(float $seconds): string { $seconds = max(0, min(7200, $seconds)); diff --git a/app/Domain/Media/WebsiteIntake.php b/app/Domain/Media/WebsiteIntake.php new file mode 100644 index 0000000..55895d2 --- /dev/null +++ b/app/Domain/Media/WebsiteIntake.php @@ -0,0 +1,54 @@ +incomingIsReadable($incomingPath)) { + throw new DomainRuleException('Die Bilddatei liegt nicht im Eingang.'); + } + + $element = app(ContentService::class)->createElement('bild', 'bild', $title); + app(IdentityProfile::class)->fill($element, [ + 'display_title' => $title, + 'website_credit' => $credit, + 'website_alt' => $alt, + ], $actor); + AcceptWebsiteImage::dispatch($element->id, $incomingPath, $actor?->id); + + return $element->fresh(); + } + + private function incomingIsReadable(string $path): bool + { + return (str_starts_with($path, 'cms/') || str_starts_with($path, 'vorschau/')) + && ! str_contains($path, '..') + && preg_match('#^(cms|vorschau)/[A-Za-z0-9._\-/]+$#', $path) === 1 + && Storage::disk('cms_incoming')->exists($path); + } +} diff --git a/app/Domain/Media/WebsiteMedia.php b/app/Domain/Media/WebsiteMedia.php new file mode 100644 index 0000000..eb850d7 --- /dev/null +++ b/app/Domain/Media/WebsiteMedia.php @@ -0,0 +1,72 @@ +find($element); + + if (! $element instanceof ContentElement || $element->website_released_at === null) { + return null; + } + + $path = $element->website_public_path; + $expected = '#^website/'.$element->id.'/datei\.[a-z0-9]+$#'; + + if (! is_string($path) || preg_match($expected, $path) !== 1) { + return null; + } + + if (! Storage::disk('media_public')->exists($path)) { + return null; + } + + $title = trim((string) ($element->display_title ?: $element->working_title)); + $alt = trim((string) ($element->website_alt ?? '')); + + return new WebsitePresentation( + elementId: $element->id, + title: $title, + alt: $alt !== '' ? $alt : $title, + credit: filled($element->website_credit) ? trim((string) $element->website_credit) : null, + kind: $element->output_class === 'film' ? 'film' : 'bild', + url: route('website.media', $element), + ); + } + + /** + * Slideshow: freigegebene Medien in der angegebenen Reihenfolge. Nicht freigegebene Einträge entfallen. + * + * @param list $ids + * @return list + */ + public function presentMany(array $ids): array + { + $presentations = []; + + foreach ($ids as $id) { + if (! is_numeric($id)) { + continue; + } + + $presentation = $this->present((int) $id); + + if ($presentation !== null) { + $presentations[] = $presentation; + } + } + + return $presentations; + } +} diff --git a/app/Domain/Media/WebsitePresentation.php b/app/Domain/Media/WebsitePresentation.php new file mode 100644 index 0000000..d93072b --- /dev/null +++ b/app/Domain/Media/WebsitePresentation.php @@ -0,0 +1,19 @@ +refusal($element); + + if ($refusal !== null) { + return $refusal; + } + + PublishWebsiteMedia::dispatch($element->id, 'release', $actor?->id); + + return 'Für die Website freigegeben. Öffentliche Seiten lesen nur diese Ableitung.'; + } + + public function withdraw(ContentElement $element, ?User $actor = null): string + { + PublishWebsiteMedia::dispatch($element->id, 'withdraw', $actor?->id); + + return 'Die Website-Freigabe ist zurückgenommen.'; + } + + public function refusal(ContentElement $element): ?string + { + if ($this->isConfidential($element)) { + return 'Traineranleitungen werden nicht für die Website freigegeben.'; + } + + if ($this->derivedPath($element) === null) { + return 'Für die Website fehlt eine freigebbare Ableitung. Beim Bild ist das das Vorschaubild, beim Film eine Teaserfassung unter teaser/. Die Originaldatei bleibt geschützt.'; + } + + return null; + } + + public function derivedPath(ContentElement $element): ?string + { + if ($this->isConfidential($element)) { + return null; + } + + if ($element->output_class === 'bild') { + return $this->allowedDerivedPath($element->thumbnail_path, 'vorschau/'); + } + + if ($element->output_class !== 'film') { + return null; + } + + $version = $element->versions() + ->where('status', ContentVersionStatus::Bereit->value) + ->orderByDesc('number') + ->first(); + + if ($version === null) { + return null; + } + + $path = MediaRendition::query() + ->where('content_element_version_id', $version->id) + ->where('role', 'preview') + ->orderByDesc('id') + ->value('path'); + + return $this->allowedDerivedPath($path, 'teaser/'); + } + + public function publicPath(ContentElement $element, string $derivedPath): string + { + $extension = strtolower(pathinfo($derivedPath, PATHINFO_EXTENSION)); + + return 'website/'.$element->id.'/datei.'.$extension; + } + + private function isConfidential(ContentElement $element): bool + { + $slug = $element->editorialContentKind?->slug; + + if ($slug === null && $element->editorial_content_kind_id !== null) { + $slug = EditorialContentKind::query()->whereKey($element->editorial_content_kind_id)->value('slug'); + } + + return in_array($slug, PublicMaterialReader::CONFIDENTIAL_KINDS, true); + } + + private function allowedDerivedPath(mixed $path, string $prefix): ?string + { + if (! is_string($path) || ! str_starts_with($path, $prefix) || str_contains($path, '..')) { + return null; + } + + $extension = strtolower(pathinfo($path, PATHINFO_EXTENSION)); + + if (! in_array($extension, ['jpg', 'jpeg', 'png', 'webp', 'gif', 'mp4', 'webm'], true)) { + return null; + } + + if (! Storage::disk('media_derived')->exists($path)) { + return null; + } + + return $path; + } +} diff --git a/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php b/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php index dcaf6ad..cbe8e8d 100644 --- a/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php +++ b/app/Filament/Resources/ContentElements/Pages/ViewContentElement.php @@ -15,6 +15,8 @@ use App\Domain\Cms\Catalog\PublicMaterialReader; use App\Domain\Cms\Widgets\RenderContext; use App\Domain\Media\ThumbnailRef; +use App\Domain\Media\WebsiteMedia; +use App\Domain\Media\WebsiteRelease; use App\Filament\Resources\ContentElements\ContentElementResource; use App\Filament\Support\CatalogReading; use App\Filament\Support\EditorialCatalog; @@ -67,6 +69,12 @@ class ViewContentElement extends ViewRecord public string $licenseNote = ''; + public string $websiteCredit = ''; + + public string $websiteAlt = ''; + + public string $websiteFeedback = ''; + public int|string|null $kindId = null; /** @var list */ @@ -453,6 +461,8 @@ public function saveEditorial(): void 'description' => $this->descriptionText, 'usage_note' => $this->usageNote, 'license_note' => $this->licenseNote, + 'website_credit' => $this->websiteCredit, + 'website_alt' => $this->websiteAlt, 'thumbnail_alt' => $this->thumbnailAlt, 'editorial_content_kind_id' => filled($this->kindId) ? (int) $this->kindId : null, ], auth()->user()); @@ -476,6 +486,41 @@ public function saveEditorial(): void : 'Gespeichert. Prüfe die Fassungen, ihre Zahl hat sich geändert.'; } + public function releaseForWebsite(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + app(IdentityProfile::class)->fill($element, [ + 'website_credit' => $this->websiteCredit, + 'website_alt' => $this->websiteAlt, + ], auth()->user()); + $element->refresh(); + $this->websiteFeedback = app(WebsiteRelease::class)->release($element, auth()->user()); + $element->refresh(); + $this->fillEditorial(); + } + + public function withdrawWebsite(): void + { + abort_unless(ContentElementResource::editor(), 403); + + /** @var ContentElement $element */ + $element = $this->getRecord(); + $this->websiteFeedback = app(WebsiteRelease::class)->withdraw($element, auth()->user()); + $element->refresh(); + $this->fillEditorial(); + } + + public function websiteIsPublic(): bool + { + /** @var ContentElement $element */ + $element = $this->getRecord(); + + return app(WebsiteMedia::class)->present($element->fresh()) !== null; + } + public function adoptLibraryImage(): void { abort_unless(ContentElementResource::editor(), 403); @@ -610,6 +655,9 @@ public function editorialHistory(): array 'summary' => 'Kurzbeschreibung', 'usage_note' => 'Einsatzhinweis', 'license_note' => 'Interner Lizenzvermerk', + 'website_credit' => 'Quellenzeile', + 'website_alt' => 'Alternativtext der Website', + 'website_released_at' => 'Website-Freigabe', 'thumbnail_alt' => 'Alternativtext', 'thumbnail_path' => 'Vorschaubild', 'thumbnail_source' => 'Herkunft des Vorschaubilds', @@ -651,6 +699,8 @@ private function fillEditorial(): void $this->descriptionText = (string) ($element->description ?? ''); $this->usageNote = (string) ($element->usage_note ?? ''); $this->licenseNote = (string) ($element->license_note ?? ''); + $this->websiteCredit = (string) ($element->website_credit ?? ''); + $this->websiteAlt = (string) ($element->website_alt ?? ''); $this->kindId = $element->editorial_content_kind_id; $this->pillarIds = $element->pillars()->pluck('pillars.id')->all(); $this->dimensionIds = IdentityDimensionValue::query() diff --git a/app/Http/Controllers/WebsiteMediaController.php b/app/Http/Controllers/WebsiteMediaController.php new file mode 100644 index 0000000..2cbb199 --- /dev/null +++ b/app/Http/Controllers/WebsiteMediaController.php @@ -0,0 +1,25 @@ +present($element); + abort_if($presentation === null, 404); + + $path = $element->website_public_path; + abort_if(! is_string($path), 404); + + return Storage::disk('media_public')->response($path, null, [ + 'Content-Disposition' => 'inline', + 'X-Content-Type-Options' => 'nosniff', + ]); + } +} diff --git a/app/Jobs/AcceptWebsiteImage.php b/app/Jobs/AcceptWebsiteImage.php new file mode 100644 index 0000000..fcecc0e --- /dev/null +++ b/app/Jobs/AcceptWebsiteImage.php @@ -0,0 +1,49 @@ +find($this->elementId); + + if (! $element instanceof ContentElement) { + return; + } + + $deriver->forWebsiteImage($element, $this->incoming); + $element->refresh(); + + if ($release->derivedPath($element) === null) { + return; + } + + if ($this->incomingIsDisposable()) { + Storage::disk('cms_incoming')->delete($this->incoming); + } + + PublishWebsiteMedia::dispatch($element->id, 'release', $this->actorId); + } + + private function incomingIsDisposable(): bool + { + return (str_starts_with($this->incoming, 'cms/') || str_starts_with($this->incoming, 'vorschau/')) + && ! str_contains($this->incoming, '..'); + } +} diff --git a/app/Jobs/PublishWebsiteMedia.php b/app/Jobs/PublishWebsiteMedia.php new file mode 100644 index 0000000..7b28b38 --- /dev/null +++ b/app/Jobs/PublishWebsiteMedia.php @@ -0,0 +1,90 @@ +find($this->elementId); + + if (! $element instanceof ContentElement || ! in_array($this->action, ['release', 'withdraw'], true)) { + return; + } + + if ($this->action === 'withdraw') { + $this->deletePublicFile($element); + $this->mark($element, $element->website_released_at?->toIso8601String(), null); + $element->forceFill([ + 'website_released_at' => null, + 'website_public_path' => null, + ])->save(); + + return; + } + + $derived = $release->derivedPath($element); + + if ($derived === null) { + return; + } + + $target = $release->publicPath($element, $derived); + $previous = $element->website_public_path; + + Storage::disk('media_public')->put($target, Storage::disk('media_derived')->get($derived)); + + if (is_string($previous) && $previous !== $target && str_starts_with($previous, 'website/'.$element->id.'/')) { + Storage::disk('media_public')->delete($previous); + } + + $this->mark($element, $element->website_released_at?->toIso8601String(), now()->toIso8601String()); + $element->forceFill([ + 'website_released_at' => now(), + 'website_public_path' => $target, + ])->save(); + } + + private function deletePublicFile(ContentElement $element): void + { + $path = $element->website_public_path; + + if (! is_string($path) || ! str_starts_with($path, 'website/'.$element->id.'/') || str_contains($path, '..')) { + return; + } + + Storage::disk('media_public')->delete($path); + } + + private function mark(ContentElement $element, ?string $before, ?string $after): void + { + if ($before === $after) { + return; + } + + IdentityChange::query()->create([ + 'subject_type' => $element->getMorphClass(), + 'subject_id' => $element->id, + 'field' => 'website_released_at', + 'before' => $before, + 'after' => $after, + 'actor_id' => $this->actorId, + 'occurred_at' => now(), + ]); + } +} diff --git a/database/migrations/2026_11_18_210000_website_release_on_content_elements.php b/database/migrations/2026_11_18_210000_website_release_on_content_elements.php new file mode 100644 index 0000000..63723ef --- /dev/null +++ b/database/migrations/2026_11_18_210000_website_release_on_content_elements.php @@ -0,0 +1,30 @@ +text('website_credit')->nullable()->after('license_note'); + $table->string('website_alt')->nullable()->after('website_credit'); + $table->timestamp('website_released_at')->nullable()->after('website_alt'); + $table->string('website_public_path')->nullable()->after('website_released_at'); + }); + } + + public function down(): void + { + Schema::table('content_elements', function (Blueprint $table) { + $table->dropColumn([ + 'website_credit', + 'website_alt', + 'website_released_at', + 'website_public_path', + ]); + }); + } +}; diff --git a/docs/architektur/cms-widget-registry.md b/docs/architektur/cms-widget-registry.md index c5214ea..46954cc 100644 --- a/docs/architektur/cms-widget-registry.md +++ b/docs/architektur/cms-widget-registry.md @@ -306,7 +306,7 @@ ## 13. Premium-Karten (Brand-UI-Kit v1.7, ADR-39) **Raster.** Eine Karte je Platz. Gemischte Raster entstehen über die Abschnittsraster, zum Beispiel 1 + 1 + 2 (`u1_1_2`), 2 + 2, 1 + 1 + 1 + 1. Gleiche Höhe: alle Karten einer Zeile auf „An die Zeile angleichen“ stellen; die Aktion steht dann am unteren Rand. Eine öffentlich nicht sichtbare Karte lässt ihren Platz entfallen; die übrigen Plätze teilen sich die Breite. Solche Karten daher in einen eigenen Abschnitt setzen oder mit einem Platz kombinieren, der allein gut aussieht. -**Sicherheit.** Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`). +**Sicherheit.** Der einzuhaltende Weg steht in `medienzugriff-fuer-komponenten.md`. Vorschaubilder der Bibliothek (Filmstandbilder, Modulvorschau) nur über `editorial.card` (Redaktionsanmeldung) und nur in der Redaktionsvorschau; öffentlich nie. Keine Adressen unter `/bereich/` oder `/redaktion/` auf öffentlichen Seiten, kein Abspielen, kein Download, kein Preis, keine Kaufaktion. Nie öffentlich: Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtexte, Traineranleitungen. Eine Karte begründet keine Berechtigung (Tests `CmsPremiumCardsTest`). **Erweiterungsbedarf für öffentliche Vorschaubilder und Filmvorschauen (nicht umgesetzt, minimal):** 1. *Vorschaubild für die Website freigeben:* je `ContentElement` und `Composition` ein Freigabevermerk (`thumbnail_public_at`, `thumbnail_public_by`, Bezug auf `thumbnail_source`), gesetzt nur durch eine ausdrückliche Aktion „Vorschaubild für die Website freigeben“ in der Medien- bzw. Modulbearbeitung. Die Hintergrundverarbeitung kopiert das freigegebene Standbild nach `media_public` (eigener Pfad, zum Beispiel `katalog/`), Zurücknehmen löscht die Kopie. Die Karte nimmt dieses Bild, wenn kein Kartenbild gewählt ist. Der Web-Prozess schreibt weiterhin nicht in den Medienbestand. diff --git a/docs/architektur/medienzugriff-fuer-komponenten.md b/docs/architektur/medienzugriff-fuer-komponenten.md new file mode 100644 index 0000000..463e8bb --- /dev/null +++ b/docs/architektur/medienzugriff-fuer-komponenten.md @@ -0,0 +1,90 @@ +# Medienzugriff für CMS-Komponenten + +**Stand:** 18.11.2026. Beschreibt den vorhandenen Weg. Keine neue Freigabe, kein zweites Rechtesystem. + +Eine CMS-Komponente, die im Medienmanager liegt, ist ein Inhaltselement (`ContentElement`). Sie entscheidet den Zugriff nicht selbst. Sie ruft eine der drei vorhandenen Stellen auf, je nachdem, was sie tut. + +## Drei getrennte Stellen + +| Was die Komponente tut | Stelle | Was sie nicht tut | +|---|---|---| +| Anzeigedaten auf der Website lesen | `PublicMaterialReader` | keine Datei, keine Ausgabeadresse | +| Datei an ein Mitglied ausliefern | `DecideAccess`, erneut bei jedem Abruf | keine eigene Erlaubnis, keine Vereinigung von Berechtigungen | +| Ein öffentliches Bild zeigen, das kein Bestandsmedium ist | `PublicMedia` | keinen Pfad aus `originals/` oder `derived/` | + +Die Pflege im Medienmanager ist eine vierte, nur redaktionelle Tür: Ansehen dürfen Redaktion und Katalogverwaltung, Ändern nur die Redaktion (`ContentElementResource`). Diese Tür gibt nichts auf der Website und nichts im Mitgliederbereich frei. + +## Anzeige auf der Website + +`PublicMaterialReader` ist die einzige Lesesicht für ein Medium auf einer öffentlichen Seite. Die Medienkarte nutzt sie bereits. + +Öffentlich genannt wird ein Medium nur, wenn alle Punkte zutreffen: + +- es ist nicht archiviert und hat mindestens eine nicht gesperrte Fassung, +- es hat eine bereitgestellte Fassung, +- die Inhaltsart ist nicht `traineranleitung`, +- es gehört zur gezeigten Fassung eines öffentlich gezeigten Programms. + +Solange öffentliche Profile (ADR-29) fehlen, ist das die Übergangsregel. Ein Medium hat keine eigene öffentliche Seite. Die Karte verweist dann auf die Programmseite. + +Gelesen werden Anzeigename (sonst Arbeitstitel), Kurzbeschreibung, Inhaltsart und Ausgabeart. Nicht gelesen und nicht ausgegeben werden Beschreibung, Einsatzhinweis, Lizenzvermerk, Lehrtext und jede Datei. + +Das Vorschaubild der Bibliothek erscheint nur in der Redaktionsvorschau, über die Route `editorial.card`, und nur für angemeldete Redaktion. Auf einer öffentlichen Seite hat dieses Bild keine Adresse. + +## Auslieferung an Mitglieder + +`DecideAccess` ist die einzige Entscheidung über eine Datei. Sie prüft an genau einer Berechtigung: aktives Konto, passender Artikel-Stand, Fassung im fixierten Inhalt dieses Stands, Fassung nicht gesperrt, Aktion im Rechte-Schnappschuss für die Ausgabeart. Zwei Berechtigungen werden nicht zu einer zusammengefügt. + +Die Bibliothek ruft dieselbe Prüfung beim Aufbau der Seite und erneut beim Abruf auf (`LibraryController::media`, signierte Adresse, Leser gebunden). Eine Signatur, eine Karte oder eine gespeicherte Komponente ersetzen diesen zweiten Aufruf nicht. + +Komponenten liefern Dateien nicht selbst aus. Sie bauen keine Adresse auf `content.file`, `content.preview`, `content.rendition` oder `/bereich/`. + +## Öffentliche Bilder außerhalb des Bestands + +Heute liegen Bilder, die nur zur Website gehören, unter dem Präfix `cms/` und laufen über `PublicMedia` und die Route `media.public`. Der Controller liefert nur Pfade, die mit `cms/` beginnen, von den Platten `media_public` und `cms_incoming`. + +Dieser Pfad ist kein Zugang zum Medienmanager. Ein Inhaltselement wird darüber nicht ausgeliefert. Umgekehrt wird eine geschützte Bestandsdatei nicht in `cms/` gelegt, um sie öffentlich zu machen. + +## Website-Medien für Hero, Teaser und Slideshow + +Hero-Grafiken, Teaserfilme und Slideshows liegen im Medienmanager. Sie werden nicht verkauft. Lizenzartikel, Angebot, Grant und `DecideAccess` bleiben dafür unbenutzt. + +Die Website-Freigabe ist eine eigene Entscheidung am Inhaltselement. Sie hängt nicht daran, dass eine Fassung bereit ist, und nicht daran, dass das Medium in einem öffentlichen Programm liegt. `PublicMaterialReader` bleibt die Lesesicht der Programmkarte. Widgets für Hero, Bild und Slideshow lesen `WebsiteMedia`. + +| Aufruf | Klasse | Ergebnis | +|---|---|---| +| Ein Medium | `WebsiteMedia::present($elementOderId)` | `WebsitePresentation` oder `null` | +| Slideshow, Reihenfolge bleibt | `WebsiteMedia::presentMany([$id, ...])` | nur freigegebene Einträge | + +`WebsitePresentation` enthält `elementId`, `title`, `alt`, `credit`, `kind` (`bild` oder `film`) und `url`. `url` ist die einzige Dateiadresse, Route `website.media`. `credit` ist die öffentliche Quellenzeile. `license_note` steht dort nicht. + +Ein Widget speichert die Kennung des Inhaltselements (`refs.element` oder bei einer Slideshow `refs.elements`), nicht einen kopierten Dateipfad. Ist `present` leer, gibt das Widget nichts aus. Vorhandene Bilder unter `cms/` bleiben gültig, bis das jeweilige Widget umgestellt ist. + +### Neues Bild aus dem CMS + +`WebsiteIntake::acceptImage($pfad, $titel, $quellenzeile, $alternativtext, $redakteur)` legt das Medium an und gibt seine Kennung sofort zurück. `$pfad` ist die bereits hochgeladene Datei auf `cms_incoming` und beginnt mit `cms/` oder `vorschau/`. Titel, Quellenzeile und Alternativtext werden am Medium gespeichert. Eine Inhaltsfassung entsteht dabei nicht. + +Die Warteschlange liest die Datei, schreibt das JPEG nach `vorschau/element-{id}.jpg` und gibt danach genau diese Ableitung frei. `present` bleibt leer, bis das abgeschlossen ist. Eine unlesbare Datei bleibt im Eingang, das Medium trägt `thumbnail_error` und wird nicht freigegeben. Fehlt die Datei, liegt sie außerhalb des Eingangs oder fehlt der Titel, entsteht kein Medium. + +Das CMS ruft dafür nicht `DeriveThumbnail` und nicht `WebsiteRelease` auf. + +Freigeben und Zurücknehmen eines schon abgelegten Mediums stehen in der Medienansicht, Bereich Beschreibung (`WebsiteRelease`). Die Warteschlange kopiert die Ableitung nach `media_public` unter `website/{id}/datei.{endung}` und setzt `website_released_at`. Der Web-Prozess schreibt diese Datei nicht. Zurücknehmen löscht nur diese Kopie. + +Was freigegeben werden kann: + +- Bild: Vorschaubild unter `vorschau/` auf `media_derived`, Endung jpg, jpeg, png, webp oder gif. +- Film: an der höchsten bereitgestellten Fassung eine Ausgabe mit Rolle `preview` und Pfad unter `teaser/`, Endung mp4 oder webm. + +Originaldatei, Master-Fassung und Traineranleitungen werden abgelehnt. Eine Quellenzeile (`website_credit`) und ein Alternativtext (`website_alt`) gehören zu den Anzeigedaten und erzeugen keine neue Fassung. Die Quellenzeile erscheint nur, solange die Freigabe besteht. Der interne Vermerk bleibt intern. + +Ein neues Website-Bild nimmt `WebsiteIntake` auf. Eine Teaserfassung für einen Film erzeugt es nicht; die muss bereits unter `teaser/` liegen. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt. + +## Was eine Komponente einhält + +1. Identität und Anzeigedaten bleiben am Inhaltselement. Die Komponente speichert die Kennung, nicht eine Kopie von Titel, Text oder Datei. +2. Eine Programmkarte liest das Medium über `PublicMaterialReader`. Hero, Bild und Slideshow lesen `WebsiteMedia`. Ist dort nichts freigegeben, erscheint die Komponente öffentlich nicht. +3. Öffentliche Seiten enthalten keine Adresse unter `/redaktion/` oder `/bereich/` und kein Bibliotheksbild. +4. Die Mitgliedsdatei entsteht nur über den Mitgliederabruf, der `DecideAccess` erneut aufruft. Die Website-Ableitung läuft ausschließlich über `website.media`. +5. Der Web-Prozess schreibt nicht nach `originals/` und nicht nach `derived/` oder `public/`. + +Eine Karte oder eine Komponente begründet keine Berechtigung. diff --git a/resources/views/filament/media/editor-panels.blade.php b/resources/views/filament/media/editor-panels.blade.php index a005605..45a8269 100644 --- a/resources/views/filament/media/editor-panels.blade.php +++ b/resources/views/filament/media/editor-panels.blade.php @@ -36,6 +36,12 @@ + +