Dieser Artikel richtet sich an Administratoren.
Kurzfassung: Mit der offiziellen TYPO3-Extension bindest du deinen Mediaspace direkt in die Dateiverwaltung (FAL) von TYPO3 ein. Ein zusätzlicher Button in jedem Bildfeld ermöglicht die Auswahl direkt aus pixx.io – eingefügte Dateien verhalten sich anschließend wie jede andere TYPO3-Datei.
Die CDN-Links-Einzelfunktion ist planabhängig und erfordert einen entsprechenden pixx.io-Plan.
Voraussetzung
Die Extension pixxio/pixxio-extension muss von einem Administrator installiert sein (z. B. per Composer oder über den Extension Manager). Unterstützt werden TYPO3 v12, v13 und v14.
Eine Datei einfügen
- Öffne ein Inhaltselement mit Bildfeld (z. B. "Images" oder "Text & Images") zur Bearbeitung und wechsle auf den Tab "Images".
- Neben den TYPO3-eigenen Buttons "Add image" und "Select & upload files" findest du den Button "Select from pixx.io".
- Es öffnet sich der gewohnte Datei-Picker (Bereiche Media/Collections/Marked, Suche und Filter identisch zum Mediaspace).
- Wähle eine Datei aus, wähle das gewünschte Format und klicke auf "Select".
- Die Datei erscheint anschließend als reguläre Datei am Ende der Bilderliste – mit allen TYPO3-eigenen Metadatenfeldern (Alternativtext, Titel, Beschreibung, Link) und den konfigurierten Bildzuschnitten, genau wie bei einer nativ hochgeladenen Datei.
Beachte: Im Regelfall legt TYPO3 dabei eine eigenständige Kopie der Datei an, keinen dauerhaften Verweis auf pixx.io. Änderst du das Original in pixx.io später, aktualisiert sich die Kopie in TYPO3 nicht automatisch. Ein echter, fortlaufender Abgleich ist nur möglich, wenn ein Administrator die unten beschriebene automatische Synchronisation einrichtet – das ist die Ausnahme, die meisten Kunden nutzen diese Funktion nicht.
Beachte: Dateien mit aktivierter Download-Sperre lassen sich im Picker nicht auswählen.
Administrative Einstellungen
Ein Administrator konfiguriert die Extension unter "Settings (Einstellungen) → Extension Configuration" (Eintrag "pixxio_extension") in vier Bereichen:
Basic:
- File Storage ID (Standard: 1 = fileadmin) und optionaler Standard-Unterordner
- Erlaubte Downloadformate: steuert, welche Formate im Format-Dropdown des Pickers zur Auswahl stehen (z. B. nur "original,preview" oder zusätzlich "jpg,png,pdf,tiff"). Leer gelassen stehen alle Formate zur Verfügung.
- CDN-Links verwenden: Statt eine lokale Kopie anzulegen, verwendet TYPO3 dauerhaft die aktuelle Datei direkt von pixx.io. Dafür ist ein pixx.io-Plan mit CDN-Links-Funktion nötig.
Metadata:
- Legt fest, welches pixx.io-Metadatenfeld als Alternativtext übernommen wird (Standard: "Alt Text (Accessibility)").
Sync (optional, wird von den meisten Kunden nicht genutzt):
- Ob Dateien automatisch ersetzt werden, wenn in pixx.io eine neue Version vorliegt (nur wenn CDN-Links deaktiviert sind), und ob Metadaten automatisch aktualisiert werden
- Auto-Login mit den Sync-Zugangsdaten direkt im Bild-Picker
- Anzahl der Dateien, die pro Synchronisationslauf abgeglichen werden (Standard: 20)
- Mediaspace-URL sowie ein Refresh-Token für die automatische Synchronisation (kein Benutzername/Passwort nötig)
- Ob Dateien in TYPO3 gelöscht werden sollen, wenn sie im Mediaspace nicht mehr existieren
Proxy:
- Optionale Proxy-Konfiguration (URL im Format
http(s)://benutzername:passwort@host:port) für Firmennetzwerke mit Proxy-Pflicht.
Praxistipp: Der automatische Abgleich läuft über einen TYPO3-Scheduler-Task ("Execute console commands", Befehl
pixxio:sync). Damit die Synchronisation tatsächlich regelmäßig ausgeführt wird, muss dieser Task im Scheduler-Modul eingerichtet und als wiederkehrend aktiviert sein.