AddOn
media_srcset
Beschreibung
Addon das einen neuen Effekt namens SRCSET hinzufügt (basierend auf dem resize-Effekt) und zusätzlich die Angabe eines SRCSET-Attributs ermöglicht.Rewrite URLs von YRewrite werden unterstützt.Addon das einen neuen Effekt namens SRCSET hinzufügt (basierend auf dem resize-Effekt) und zusätzlich die Angabe eines SRCSET-Attributs ermöglicht.Rewrite URLs von YRewrite werden unterstützt.
Umsetzung
Versionen
3.0.1
3.0.1] - 2026-10-10
Fixed (Behoben)
- Update von 2.x legt den Basistyp
media_srcset_setan. REDAXO führt bei einem Updateupdate.phpaus, nichtinstall.php; die fehlte, daher gab es nach dem Update keinen Basistyp und alle Set-Adressen (/media/is_<set>__<breite>/…) lieferten 404. Abhilfe bisher: Addon neu installieren. Neu:update.phpbindet die (idempotente)install.phpein – damit greift beim Update auch die Voreinstellung der HTML-Platzhalterersetzung (an, wenn das Projekt den klassischensrcset-Effekt nutzt).
3.0.0
Responsive Bilder, ohne Typen-Zoo
media_srcset 3.0.0 bringt einen zweiten Weg zur responsiven Bildausgabe: Sets.
Bisher brauchte jeder Bildausschnitt einen eigenen Media-Manager-Typ – teaser, teaser_mobile, hero, hero_quadratisch … Ein Set fasst Seitenverhältnis, Zuschnittsmodus und Breitenstufen stattdessen in einer Konfigurationseinheit zusammen. Ein Bild wird dann so angefragt:
/media/is_ratio_4_3__800/bild.jpg
In der Datenbank steht dafür ein einziger technischer Typ – für alle Sets und alle Breiten. Ein neues Bildformat für ein Modul heißt jetzt: ein Set registrieren. Nicht: einen Typ anlegen, konfigurieren und auf Dauer pflegen.
Bestehende Projekte bleiben unangetastet
Der bisherige Weg funktioniert unverändert weiter: rex_media_srcset, der Effekt srcset, die Unterprofile profil__breite, srcset.js und die HTML-Platzhalterersetzung verhalten sich exakt wie in 2.x. Das Update erfordert keine Codeänderung, und beide Wege laufen im selben Projekt nebeneinander.
Die Major-Nummer steht für den Funktionsumfang und die angehobenen Systemanforderungen – nicht für Breaking Changes.
Was Sets können
Markup, das man nicht selbst zusammenbauen muss
echo ResponsiveImage::forFile($file)
->withDesktopPreset('ratio_4_3')
->withColumns(3, 2, 1)
->toImageTag(['alt' => $alt]);
Daraus entstehen src, srcset und ein sizes, das aus dem Layout gerechnet wird – Container-Breite, Spaltenzahl, Bildanteil – statt nur die Breakpoints zu wiederholen. width und height sind immer gesetzt, damit nichts springt.
Descriptor-Garantie. Ein 800w im srcset muss auch 800 Pixel liefern, sonst wählt der Browser falsch. Breiten werden auf die Stufen des Sets gerundet und an der erreichbaren Quellbreite gekappt – notfalls wird die Quellbreite mit korrektem Descriptor angehängt.
Art Direction. Beliebig viele <source> mit eigener Media Query, jeweils mit eigenem Set:
ResponsiveImage::forFile($file)
->withDesktopPreset('ratio_21_9')
->withSource('(max-width: 639px)', 'ratio_1_1')
->toPictureTag();
Alt-Texte, die diesen Namen verdienen. Der Alt-Text kommt aus dem dafür vorgesehenen Feld (MediaPlace oder med_alt, mehrsprachig). Der Medienpool-Titel wird bewusst nicht verwendet – ein Titel beschreibt das Bild nicht für Screenreader. Fehlt der Text oder ist das Bild als dekorativ markiert, wird alt="" role="presentation" ausgegeben.
Vorverarbeitung. Ein Set kann die Effekte bestehender Media-Manager-Typen wiederverwenden, etwa watermark,make_greyscale. Die Kette läuft vor dem Zuschnitt in voller Auflösung und komplett im Speicher – ohne Zwischendateien und ohne erneutes Encodieren, also ohne Qualitätsverlust.
Backend: Media Manager › srcset & Sets
- Sets & Builder – Sets anlegen und verwalten. Ein Assistent leitet sinnvolle Breitenstufen aus Layout-Angaben ab, rundet auf 100 px und dünnt zu dichte Stufen aus.
- Nutzung & Bestand – zeigt, welche Sets und Breiten Module und Templates tatsächlich anfordern, und stellt dem die Breiten der Originalbilder gegenüber. Daraus entstehen Hinweise auf überflüssige Stufen und auf solche, die nur Hochskalierungen liefern würden.
- Demo & Prüfung – erzeugt jede Variante, misst sie nach und vergleicht sie mit dem Descriptor. Dazu eine Live-Anzeige, welche Datei der eigene Browser gerade geladen hat.
Weitere Neuerungen
- Abschaltbare HTML-Platzhalterersetzung. Der
OUTPUT_FILTERdurchsucht jede Seitenausgabe per regulärem Ausdruck. Wer nur die PHP-API nutzt, kann ihn jetzt abschalten. Standard: bei Neuinstallationen aus, bei Updates an – damit bestehende Templates weiter funktionieren. - Extension Point
MEDIA_SRCSET_PRESETSzum Ergänzen und Ändern von Sets aus anderen Addons. - Englische Übersetzung sowie
README.en.mdundAPI.en.md. - PHPStan Level 8 über das gesamte Addon ohne Findings.
Zusammenspiel
focuspoint ist optional: Mit dem Addon folgen Ratio-Zuschnitte dem gesetzten Fokuspunkt, ohne wird zentriert geschnitten. Die Ausgabemaße sind identisch – es unterscheidet sich nur, wo geschnitten wird. media_negotiator wird unterstützt, Sets kommen dann als AVIF oder WebP.
Systemanforderungen
REDAXO ^5.18.0 · PHP >= 8.1 · media_manager ^2.5.6
Vollständige Liste der Änderungen im CHANGELOG, Dokumentation in README.md und API.md.
2.3.0
New features (fully backward compatible, opt-in)
- SVG support:
.svgfiles are now detected and served directly from the media pool, bypassing media manager processing entirely (nosrcset/sizes, no cache generation) — SVGs scale natively in the browser and gain nothing from resolution variants. - Layout-based
sizes: new optional$layoutparameter forgetTag()/getImgTag()/getPictureTag()computes thesizesattribute from container width + column counts instead of merely restating the srcset breakpoints. Omitting it keeps prior behavior unchanged; an explicit$attributes['sizes']still always wins.
2.2.1
Security Fixes @alexwenz
Fixed some possible XSS
2.2.0
What's Changed
- Patch cukabeka sizes alpha by @cukabeka in https://github.com/FriendsOfREDAXO/media_srcset/pull/33
New Contributors
- @cukabeka made their first contribution in https://github.com/FriendsOfREDAXO/media_srcset/pull/33
Full Changelog: https://github.com/FriendsOfREDAXO/media_srcset/compare/2.1.0...2.2.0
2.1.0
add: getPictureTag helper, add srcset helper
add: getImgTag helper
added new methods to readme
@eaCe
What's Changed
- feat: adds getImgTag helper by @eaCe in https://github.com/FriendsOfREDAXO/media_srcset/pull/31
- add getPictureTag helper, add srcset helper by @eaCe in https://github.com/FriendsOfREDAXO/media_srcset/pull/32
New Contributors
- @eaCe made their first contribution in https://github.com/FriendsOfREDAXO/media_srcset/pull/31
Full Changelog: https://github.com/FriendsOfREDAXO/media_srcset/compare/2.0.5...2.1.0
2.0.5
Setzt einen Defaultwert auf Standardbreite.
Wichtiger Hinweis: Standardbreite muss angegeben werden
2.0.4
Fixes; Trying to access array offset on value of type null, thx @Hirbod