Medien aus dem PIM

Bilder und Dateien für die Website liegen in der Mediathek des PIM, nicht in Kirby. Im Panel wählen Sie sie aus; Kirby speichert nur einen Verweis.

Was Sie im Panel sehen

PIM-Mediathek (linke Navigation): Hier durchsuchen Sie die freigegebenen Ordner des PIM, als Liste oder Kacheln. Filtern Sie nach Ordner oder nutzen Sie die „Intelligente Suche“. „Verweis kopieren“ kopiert den Verweis eines Bildes.

Bildfelder in Bausteinen und Seiten:

• „Aus der Mediathek wählen“ öffnet die Auswahl mit Suche.
• „Anderes Medium wählen“ tauscht das Bild aus.
• „Weiteres Medium hinzufügen“ bei Feldern, die mehrere Bilder erlauben.
• „Entfernen“ nimmt das Bild aus dem Feld (in der Mediathek bleibt es).

Hinweise am Feld:

Hinweis	Bedeutung
„Verweis ohne Ziel“ / „Die Mediathek kennt … nicht mehr“	Das Bild wurde im PIM gelöscht oder aus dem freigegebenen Ordner genommen. Neues Bild wählen
„Datei aus dem CMS – bitte neu aus der Mediathek wählen“	Altes Bild, das noch in Kirby lag. Bitte durch ein Bild aus der Mediathek ersetzen

Im Reiter Medien jeder Seite sehen Sie, welche PIM-Bilder die Seite verwendet.

Welche Bilder kann ich wählen?

Nur Dateien aus Ordnern, die im PIM mit „Für Content-CMS freigeben“ markiert sind (samt aktiven Unterordnern). Fehlt ein Bild, bitten Sie das Produktmanagement, es in einen freigegebenen Ordner zu legen. Siehe PIM-Handbuch → Mediathek.

WARNING

Für die Auswahl im CMS zählt nur der Ordner. Ob ein Bild im PIM als „Freigegeben“ markiert oder abgelaufen ist, prüft die Auswahl nicht. Achten Sie selbst auf Nutzungsrechte und Copyright.

Was gespeichert wird

Kirby speichert nur einen Verweis:

• pim://ext:4970: die ID aus dem Quellsystem. Diese Form verwendet das Panel für neue Verweise. Sie bleibt gleich, auch wenn das PIM neu importiert wird, und funktioniert auf allen Installationen.
• pim://512: die interne ID. Ältere Verweise können so aussehen.

Die Website wandelt den Verweis beim Anzeigen in eine Bildadresse um und lädt das Bild in der passenden Größe (thumb, tile, preview, hero …) über ihren eigenen Server aus dem PIM. Videos werden als Originaldatei geladen. Fehlt ein Bild, zeigt die Website einen Platzhalter.

Taxonomie-Felder

Manche Felder (zum Beispiel „Kategorie“ in der Bühne) schlagen Begriffe aus der PIM-Taxonomie vor. Ist das PIM gerade nicht erreichbar, funktioniert das Feld als normales Textfeld weiter.

Technik (für Admins)

• Plugin: cms/site/plugins/content-media-bridge. Die Bildvorschau im Panel läuft über einen Proxy in Kirby, der nur für angemeldete Panel-Benutzer funktioniert. Das Token erreicht nie den Browser.
• Konfiguration in Kirby: matev.contentApi.url (Umgebungsvariable CONTENT_API_URL), matev.contentApi.token (CONTENT_API_TOKEN), matev.contentApi.verifyTls (CONTENT_API_VERIFY_TLS, nur lokal false).
• Die Website (Nuxt) hat einen eigenen Proxy staging/server/api/content/[...path].get.ts mit eigenem Token (private Runtime-Konfiguration, nie NUXT_PUBLIC_*). Er lässt nur products, articles, taxonomies und media/<id>/(preview|download) durch und speichert Bilder eine Stunde zwischen.
• Kirby und Website bekommen getrennte Tokens mit dem Profil „Content-CMS“ (siehe PIM → API-Tokens). Lokal liegen sie in cms/.ddev/config.local.yaml und staging/.ddev/config.local.yaml. Diese Dateien gehören nicht ins Repository. DDEV schließt sie über seine selbst erzeugte .ddev/.gitignore aus, die erst nach dem ersten ddev start existiert. Prüfen Sie mit git status, bevor Sie committen.
• Endpunkte: API → Medien für das CMS.
• Hintergrund: Content-API und Medienbrücke.