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

Für REDAXO
^5.18.0
Veröffentlicht am
10.10.2026
Require / PHP
>=8.1

3.0.1] - 2026-10-10

Fixed (Behoben)

  • Update von 2.x legt den Basistyp media_srcset_set an. REDAXO führt bei einem Update update.php aus, nicht install.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.php bindet die (idempotente) install.php ein – damit greift beim Update auch die Voreinstellung der HTML-Platzhalterersetzung (an, wenn das Projekt den klassischen srcset-Effekt nutzt).

3.0.0

Für REDAXO
^5.18.0
Veröffentlicht am
23.09.2026
Require / PHP
>=8.1

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_FILTER durchsucht 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_PRESETS zum Ergänzen und Ändern von Sets aus anderen Addons.
  • Englische Übersetzung sowie README.en.md und API.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

Für REDAXO
^5.10.0
Veröffentlicht am
06.09.2026
Require / PHP
>=7.3

New features (fully backward compatible, opt-in)

  • SVG support: .svg files are now detected and served directly from the media pool, bypassing media manager processing entirely (no srcset/sizes, no cache generation) — SVGs scale natively in the browser and gain nothing from resolution variants.
  • Layout-based sizes: new optional $layout parameter for getTag()/getImgTag()/getPictureTag() computes the sizes attribute 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

Für REDAXO
^5.10.0
Veröffentlicht am
06.09.2026
Require / PHP
>=7.3

Security Fixes @alexwenz
Fixed some possible XSS

2.2.0

Für REDAXO
^5.4.0
Veröffentlicht am
09.08.2024
Require / PHP
>=7.3

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/media_srcset/compare/2.1.0...2.2.0

2.1.0

Für REDAXO
^5.4.0
Veröffentlicht am
02.05.2022
Require / PHP
>=7.3

add: getPictureTag helper, add srcset helper
add: getImgTag helper
added new methods to readme

@eaCe

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/media_srcset/compare/2.0.5...2.1.0

2.0.5

Für REDAXO
^5.4.0
Veröffentlicht am
29.12.2021
Require / PHP
>=5.6

Setzt einen Defaultwert auf Standardbreite.
Wichtiger Hinweis: Standardbreite muss angegeben werden

2.0.4

Für REDAXO
^5.4.0
Veröffentlicht am
14.03.2021
Require / PHP
>=5.6

Fixes; Trying to access array offset on value of type null, thx @Hirbod