Der Web-Prozess hat derived/ nur lesend; das Anlegen als eigenständiges Präsentationsmedium schrieb dort selbst und scheiterte auf den Servern (die Tests fakten die Disk). Jetzt prüft PresentationFile nur und übergibt das Kopieren an StorePresentationFile; ein Fehler steht am Medium. Die Prüfung läuft vor dem Anlegen, sodass keine leere Hülle zurückbleibt, und nennt das Format (MOV und M4V sind keine Website-Dateien). Am Medium gibt es unter Website-Freigabe die Website-Datei zum nachträglichen Hochladen, auch bei einem Film mit geschützter Fassung (ungeschützter Trailer). Die Fassung bleibt unverändert. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
20 KiB
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), Inhaltsart und Ausgabeart sowie genau einer der Texte Teaser, Kurzbeschreibung oder ausführliche Beschreibung (siehe „Text der Medien- und Materialkarte“). Nicht gelesen und nicht ausgegeben werden 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/aufmedia_derived, Endung jpg, jpeg, png, webp oder gif. Eine Inhaltsfassung ist dafür nicht nötig. - Film oder Hörstück ohne Inhaltsfassung:
preview_patham Medium, unterteaser/, Film mp4 oder webm, Hörstück mp3, m4a oder ogg. - Film mit Inhaltsfassung: an der höchsten bereitgestellten Fassung eine Ausgabe mit Rolle
previewund Pfad unterteaser/, Endung mp4 oder webm. Das gilt, wenn am Medium keinpreview_pathliegt.
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 und gibt es nach der Ableitung frei. Ein eigenständiges Präsentationsmedium legt PresentationFile ohne Inhaltsfassung an und gibt es nicht von selbst frei. Der Web-Prozess liest derived/ nur; er prüft die Datei (Film: MP4 oder WebM, Hörstück: MP3, M4A oder OGG) und übergibt das Kopieren an die Warteschlange (StorePresentationFile). Dieselbe Website-Datei lässt sich unter „Website-Freigabe“ am Medium auch zu einem Film mit geschützter Inhaltsfassung hinzufügen, zum Beispiel für einen ungeschützten Trailer; die Fassung bleibt dabei unverändert. Öffentliche Profile nach ADR-29 sind damit nicht umgesetzt.
Was eine Komponente einhält
- Identität und Anzeigedaten bleiben am Inhaltselement. Die Komponente speichert die Kennung, nicht eine Kopie von Titel, Text oder Datei.
- Eine Programmkarte liest das Fachobjekt über
PublicMaterialReaderund ein Bild überWebsiteImage. Hero, Bild und Text sowie Karten lesenWebsiteMedia. Ist das Medium nicht freigegeben, wird es nicht ausgeliefert. Texte und übrige Inhalte des Widgets bleiben. Ein Widget ohne verbleibenden Inhalt entfällt. - Öffentliche Seiten enthalten keine Adresse unter
/redaktion/oder/bereich/und kein Bibliotheksbild. - Die Mitgliedsdatei entsteht nur über den Mitgliederabruf, der
DecideAccesserneut aufruft. Die Website-Ableitung läuft ausschließlich überwebsite.media. - Der Web-Prozess schreibt nicht nach
originals/und nicht nachderived/oderpublic/.
Eine Karte oder eine Komponente begründet keine Berechtigung.
Umsetzung im CMS (19.11.2026, ADR-40)
Alle Bildstellen des CMS lesen den zentralen Medienbestand: Einstieg (Hero), Bild und Text, redaktionelle Karten, Premium-Karten (Kartenbild) und Abschnittshintergrund. Das CMS hat keine eigene Medienverwaltung mehr.
- Gespeichert wird die Kennung des Inhaltselements im jeweiligen Bildschlüssel:
refs.image(Einstieg, Bild und Text, Premium-Karten),data.items[].image(redaktionelle Karten),style.image(Abschnittshintergrund). Abweichung vonrefs.element: Die Medienkarte verwendetrefs.elementbereits für ihr Fachobjekt; ein gemeinsamer Bildschlüsselimagehält alle Widgets gleich und ändert die gespeicherte Struktur nicht. - Lesen:
App\Domain\Cms\Widgets\Support\WebsiteImageruftWebsiteMedia::presentauf. Öffentlich erscheint ein Bild nur überwebsite.media. In der Redaktionsvorschau erscheint ein nicht freigegebenes Bild als Vorschaubild übereditorial.cardmit Hinweis; öffentlich nie. - Nicht freigegeben: Das Medium wird nicht öffentlich ausgeliefert. Überschrift, Text und Schaltflächen bleiben. Ein Widget, das danach keinen Inhalt mehr hat, entfällt. Die Redaktionsvorschau zeigt ein nicht freigegebenes Bild weiter mit Hinweis. Entschieden am 19.11.2026, siehe ADR-40.
- Neu hochladen im Widget-Dialog: Die Datei geht über
WebsiteIntake::acceptImagesofort in den Medienmanager und wird ausgewählt. Titel aus dem Dateinamen, ohne Quellenzeile; beides ist im Medienmanager änderbar. Die Warteschlange leitet ab und gibt frei (wie dokumentiert). - Auswahl: alle Bilder (
output_class = bild, nicht archiviert, keine Traineranleitung) mit Vorschaubild, Titel und Website-Status; das gewählte Medium mit Status und Verweis auf den Medienmanager. Die Bildauswahl des Modul-/Programmeditors ist an dessen Livewire-Seite gebunden und lässt sich nicht als Formularfeld einhängen; das Bedienmuster (Suche, Vorschaubild, Auswahl) ist übernommen. - Alternativtext: aus dem Medium (
website_alt, sonst Titel). Das Feld im Widget ist eine optionale Abweichung. - Website-Ableitung: Bilder werden bis 2400 px breit abgeleitet (vorher 640 px), nie vergrößert.
- Medienmanager: Die Medienansicht nennt die Website-Seiten, auf denen ein Bild verwendet wird
(
WebsiteImageUsage), damit vor dem Zurücknehmen sichtbar ist, welche Seiten das Bild verlieren.
Übernahme der früheren CMS-Bilder
- Der Job
ImportCmsImages(angestoßen von einer Migration, ausgeführt von der Warteschlange) nimmt jede Bilddatei untermedia_public/cms/überWebsiteIntakeauf. Bytegleiche Dateien werden ein Medium (SHA-256). Der Titel kommt aus dem Dateinamen ohne Zufallskennung. Nichts wird gelöscht; der Job ist wiederholbar. website_media_aliasesordnet jeden früheren Pfad seinem Medium zu. Wirksam wird die Zuordnung erst, wenn das Medium einmal für die Website freigegeben war; bis dahin (oder wenn die Ableitung scheitert) gilt der frühere Pfad weiter, damit keine Seite ihr Bild verliert.- Danach entscheidet die Website-Freigabe des Mediums allein, auch über die frühere Adresse
/medien/cms/…(404, wenn zurückgenommen). - Gespeicherte Revisionen bleiben unverändert; frühere Pfade werden beim Darstellen zugeordnet und beim nächsten
Speichern durch die Kennung ersetzt. Frühere Pfade ohne Zuordnung bleiben über
PublicMediagültig. - Wird ein übernommenes Medium gelöscht, bleibt die Zuordnung als Sperre bestehen (
content_element_idleer): Der frühere Pfad wird weder über/medien/cms/…ausgeliefert noch als Bild gezeigt; die Datei untercms/bleibt liegen. Die Karte oder das Widget bleibt ohne Bild. - Eine Slideshow gibt es im CMS nicht;
WebsiteMedia::presentManyist für sie vorbereitet und noch unbenutzt.
Präsentationszuordnungen (19.11.2026, ADR-41)
Ein Titelbild, Trailer oder Galerieelement an einem Film, Modul, Programm oder Lizenzartikel ist eine Referenz (presentation_assignments) auf die Medienidentität. Eine Inhaltsfassung ist dafür nicht erforderlich. source_version_id hält nur eine ausdrücklich hinterlegte Fassung fest. Die Rolle ist keine Verwendung im Aufbau, keine Inhaltsart und keine Website-Freigabe. Die Zuordnung macht das Medium nicht lizenzierbar.
Öffentliche Seiten lesen ein Bild nur über WebsiteImage und damit über WebsiteMedia. Ein freigegebener Film oder ein Hörstück wird über website.media ausgeliefert. Geschützte Originaldateien und Vorschaubilder der Bibliothek bleiben auf diesem Weg geschlossen. Wird die Freigabe zurückgenommen, endet die öffentliche Ausgabe; Überschriften und Texte bleiben. Ein Widget ohne verbleibenden Inhalt entfällt.
Einsatzhinweise, Lizenzvermerke und Lehrtexte bleiben außerhalb der öffentlichen Karte. Die ausführliche Beschreibung erscheint nur, wenn die Redaktion sie für diese Karte ausdrücklich wählt (siehe unten). PublicMaterialReader und PublicCatalogReader lesen dafür die Klasse-A-Angaben (EditorialProfileReader) und keine Datei.
Text der Medien- und Materialkarte, Bild aus dem Film (21.11.2026)
Text
Die Redaktion wählt je Karte in der Darstellung „Text der Karte“:
| Wahl | Text |
|---|---|
| Automatisch (Vorgabe) | Kurzbeschreibung, sonst Teaser (wie bisher) |
| Teaser | teaser |
| Kurzbeschreibung | summary |
| Ausführliche Beschreibung | description |
- Jede Wahl liest dieselbe Quelle wie die übrige Karte: das Medium, mit einer Abweichung für die Mitgliederbibliothek (
EditorialProfileReader, Zielgruppebibliothek), wenn es sie gibt. Die Zielgruppecms(„CMS-Teaser“) wird weiterhin nirgends gelesen; ein Wechsel würde bestehende Karten ändern und ist eine offene Frage. - Eine ausdrückliche Wahl ersetzt nicht still durch ein anderes Feld. Ist der gewählte Text nicht gepflegt, bleibt die Karte ohne Text; die Redaktionsvorschau nennt, wo er zu pflegen ist. Öffentlich erscheint nie ein Hinweis.
- Der eigene Text der Karte (
data.summary, „Text nur für diese Karte“) hat Vorrang vor der Wahl. - Neu öffentlich auf ausdrückliche Wahl: die ausführliche Beschreibung, die bisher Bibliothekstext war. Der Dialog sagt das („erscheint öffentlich“). Einsatzhinweis und Lizenzvermerk sind nicht wählbar. Öffentlich ist die Karte weiterhin nur, wenn das Medium zu einem öffentlich gezeigten Programm gehört.
- Die Wahl gibt es an der Medien- und Materialkarte und an der Programm- und Modulkarte. Ein Thema hat nur einen Text („Text für die Website“); dort gibt es nichts zu wählen.
- Programm- und Modulkarte: Wahl Automatisch (Teaser, sonst Kurzbeschreibung, sonst Lernziel, wie bisher), Teaser, Kurzbeschreibung, Ausführliche Beschreibung oder Lernziel der Fassung (steht auf der öffentlichen Programmseite bereits öffentlich). Die Texte werden mit der Zielgruppe „Öffentliche Kachel“ gelesen. Auch hier ersetzt eine ausdrückliche Wahl nicht still durch ein anderes Feld; die Vorschau nennt, wo der Text zu pflegen ist („Programm oder Modul bearbeiten“).
Bild aus dem Film
Das Vorschaubild eines Films (Medienmanager) und jede Filmstelle sind geschützt und erscheinen öffentlich nie. Für die Karte gibt es einen ausdrücklichen Weg, daraus ein Website-Bild zu machen. Im Reiter „Medien“ der Medienkarte, bei einem Film:
- eine Stelle wählen: Regler und Zahlenfeld zeigen dieselbe Zeitposition, das Bild der Stelle folgt dem Regler nach kurzer Pause (wie im Medienmanager); „Diese Stelle übernehmen“ legt genau die angezeigte Stelle ab, oder
- „Vorschaubild des Films übernehmen“ (das im Medienmanager gesetzte Vorschaubild; mit kleiner Ansicht daneben).
FilmStill zieht das Einzelbild einmal und legt es über WebsiteIntake als gewöhnliches Bild-Medium (output_class = bild) im Medienmanager ab. Die Warteschlange leitet es ab und gibt genau diese Ableitung frei, wie bei jedem Upload aus dem CMS. Die Karte speichert die Kennung dieses Bildes in refs.image.
- Kein Neuziehen: Seitenaufrufe lesen nur die gespeicherte Datei;
ffmpegläuft nur beim Übernehmen und in der Vorschau des Dialogs (Routeeditorial.frame, nur angemeldete Redaktion). Test:FilmStillTestzählt die Extraktionen. - Einmal je Stelle:
film_still_sources(additive Tabelle) ordnet Film, Quelle (frame:{Fassung}@{Sekunde}oderfile:{SHA-256}) und Bild zu. Dieselbe Stelle, auch über „Vorschaubild übernehmen“ eines Filmbilds aus derselben Stelle, ergibt dasselbe Medium. Ein archiviertes oder bei der Verarbeitung gescheitertes Bild wird nicht wiederverwendet; die Stelle lässt sich dann neu übernehmen. - Wiederverwendung ehrlich melden: Wird ein schon übernommenes Bild gewählt, sagt die Meldung, wie es steht (bereits freigegeben, wird verarbeitet oder Website-Freigabe zurückgenommen). Eine zurückgenommene Freigabe bleibt zurückgenommen; das Bild erscheint öffentlich erst nach erneuter Freigabe im Medienmanager (Reiter „Website“).
- Löschen: „Medium löschen“ (Medien ohne Fassung) entfernt auch ein Standbild; die Herkunftszeile entfällt (Migration
allow_deleting_media_with_stills_and_aliases), dieselbe Stelle lässt sich neu übernehmen. - Auflösung: Aus der Mediendatei (
inhalte/) bis 1600 px Breite, nie über die Breite der Quelle hinaus vergrößert; ohne Mediendatei aus der kleinen Stufe (480 p). Die Vorschau im Dialog und das Vorschaubild des Medienmanagers bleiben bei 640 px. - Rechte: Es wird nie der Film abgelegt, nur ein Einzelbild; keine Fassung, keine Berechtigung, kein Lizenzartikel. Ausgeschlossen sind Traineranleitungen, archivierte Filme und Filme ohne bereitgestellte Fassung. Die Handlung ist ausdrücklich (Redakteur, wie beim Upload); die Freigabe des entstandenen Bildes lässt sich im Medienmanager zurücknehmen (Wirkung: das Bild entfällt auf allen Seiten).
- Das Bild ist ein eigenes Medium mit Titel „Standbild: {Film} (Fassung n, x s)“, Alternativtext „Szene aus dem Film …“ und der Quellenzeile des Films. Es folgt späteren Änderungen des Film-Vorschaubilds nicht; wer es als Titelbild des Films verwenden will, ordnet es im Medienmanager als Präsentationsmedium zu (dann nutzen alle Karten des Films es automatisch).
- Nicht umgesetzt: eine öffentliche Filmvorschau (Trailer, Ausschnitt) und die Laufzeit. Beides bleibt Erweiterungsbedarf (Registry §13).
Vorschaubild eines Programms oder Moduls (Programm- und Modulkarte)
Das Vorschaubild eines Programms oder Moduls (Redaktionsmanager) ist ebenfalls ein geschütztes Bibliotheksbild. Im Reiter „Medien“ der Programm- und Modulkarte übernimmt „Vorschaubild übernehmen“ es als Bild-Medium („Titelbild: {Titel}“); CompositionStill arbeitet wie FilmStill: einmal kopiert (bis zur Größe der Vorschaudatei, 640 px), über WebsiteIntake abgelegt, Herkunft in composition_still_sources (dasselbe Vorschaubild ergibt dasselbe Medium), ein gescheitertes oder archiviertes Bild wird nicht wiederverwendet, die Meldung nennt den tatsächlichen Stand (auch bei zurückgenommener Freigabe). Ein Programm ohne Vorschaubild zeigt den Hinweis, es im Redaktionsmanager zu setzen. Eine Stelle aus einem Film des Programms zu wählen gibt es hier nicht; das Vorschaubild des Programms selbst lässt sich im Redaktionsmanager aus einem Film setzen.
Trailer auf Medien-, Programm- und Modulkarten
Ein Trailer ist ein eigenes Medium (Film ohne Fassung, Ableitung unter teaser/), das im Medienmanager einem Medium, Programm oder Modul in der Präsentation mit der Rolle „Trailer“ oder „Vorschauclip“ zugeordnet wird. Die Karte spielt ihn ab, wenn er für die Website freigegeben ist (Reiter „Website“ am Trailer). Lesende Klasse: CardClip (Trailer, sonst Vorschauclip, bei einem Film ersatzweise sein eigener freigegebener Teaser). Ausgeliefert wird über website.media, die Bereichsabrufe (Range) beantwortet. Nicht freigegebene Clips, der vollständige Film und Originale kommen nie über die Karte. Die Redaktionsvorschau spielt ebenfalls nur freigegebene Clips und nennt sonst den Grund. Verhalten (Maus, Tipp, Tastatur, reduzierte Bewegung, Datensparmodus): ADR-43.