AddOn

FOR Sa11y - Accessibility checker

Beschreibung

FOR sa11y adds "Sa11y" to the REDAXO frontend, when a user is logged in.
Vendor: https://sa11y.netlify.app/
Sa11y visually highlights accessibilty content issues at the source with a simple tooltip on how to fix them.
github.com/FriendsOfREDAXO/for_sa11y

Umsetzung

FriendsOfREDAXO

Versionen

4.4.42

Für REDAXO
^5.16.0
Veröffentlicht am
10.02.2026
Require / PHP
>=8.1, <9
  • nonce fixed

4.4.41

Für REDAXO
^5.16.0
Veröffentlicht am
29.12.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.40...4.4.41

4.4.40

Für REDAXO
^5.16.0
Veröffentlicht am
19.12.2025
Require / PHP
>=8.1, <9

Update sa11y to version 4.4.0

Hier ist eine deutsche Zusammenfassung der Release Notes von Sa11y 4.4.0 (Barrierefreiheits-Tool für Web-Inhalte) vom GitHub-Projekt ryersondmp/sa11y: ([GitHub][1])

Wichtigste Neuerungen in Sa11y 4.4.0

Benutzerfreundliche Verbesserungen
**

  • Die APCA-Schriftgrößen-Empfehlung im Tooltip ist jetzt anklickbar – ein Klick kopiert den empfohlenen Wert direkt in die Zwischenablage. ([GitHub][1])

Verbesserte Prüfregeln
**

  • Link-Text-Erkennung verbessert: Links, deren einziger Text z. B. „öffnet neuen Tab“ ist, werden jetzt als nicht beschreibend erkannt. ([GitHub][1])
  • Platzhalter-Wörter wurden zur Standard-Liste hinzugefügt (z. B. „hero image“, „featured image“, „untitled“), damit Platzhaltertexte besser erkannt werden. ([GitHub][1])
  • Der Check für automatisch generierten Alt-Text (z. B. aus KI) wurde von Warnung zu Fehler hochgestuft, weil er sehr wahrscheinlich ein echtes Problem anzeigt. ([GitHub][1])

Breaking Changes (Inkompatibilitäten)
**

  • Die Props contrastAPCA und contrastAAA wurden entfernt und durch eine einzige neue Prop contrastAlgorithm ersetzt. ([GitHub][1])
  • Die Prop linksAdvancedPlugin ist veraltet/entfernt – statt dessen kann jede Prüfung einzeln ausgeschaltet werden. ([GitHub][1])

Verbesserungen für Entwickler
**

Multi-Root-Support

  • checkRoot kann nun mehrere Selektoren akzeptieren, damit Sa11y mehrere Bereiche gleichzeitig prüft. ([GitHub][1])
  • fixedRoots: Direkte DOM-Referenzen können als Prüfziel übergeben werden. ([GitHub][1])
  • linkIgnoreStrings und headerIgnoreStrings akzeptieren jetzt Arrays, Strings oder Regex-Angaben. ([GitHub][1])

Readability & Scope

  • Lesbarkeits-Checks (readability results) werden jetzt in den Haupt-Ergebnis-Array aufgenommen → gut für headless-Tests. ([GitHub][1])
  • Neue Option ignoreContentOutsideRoots: Inhalte außerhalb der definierten Wurzeln werden komplett ignoriert. ([GitHub][1])

Verbesserte Ausgabe und Kontrolle

  • Issues enthalten jetzt einen klaren test-Key, was die Identifikation von Prüfungen erleichtert (z. B. für serverseitige Integrationen). ([GitHub][1])

  • Neue Props zur Ausschluss-Steuerung bei der Berechnung des zugänglichen Namens:

    • ignoreAriaOnElements
    • ignoreTextInElements ([GitHub][1])
  • Neue initialHeadingLevel-Prop zur Kontrolle der erwarteten Reihenfolge von Überschriften. ([GitHub][1])
  • altPlaceholder-Prop zur Behandlung bekannter CMS-Platzhaltertexte, sodass dekorative Bilder korrekt erkannt werden. ([GitHub][1])

Performance & Bugfixes
**

  • Optimierungen in mehreren Bereichen, u. a. im link text-Modul und bei der Kontrast-Tooltip-Berechnung. ([GitHub][1])
  • Diverse Fehlerbehebungen, z. B. bei Seiten-Outline-Panel-Navigation, accessible name-Berechnung bei <input>-Feldern oder falschen Alt-Text-Fällen. ([GitHub][1])

Refactoring & Build-Tooling
**

  • Kontrast- und Lesbarkeitsfunktionen wurden neu refaktoriert und können als ES6-Module genutzt werden. ([GitHub][1])
  • SCSS wurde vollständig in vanilla CSS umgewandelt. ([GitHub][1])
  • Developer-Toolchain modernisiert (z. B. Vite, LightningCSS, Biome). ([GitHub][1])
  • Weniger Laufzeit- und Dev-Dependencies. ([GitHub][1])

Kompatibilität
**

  • Unterstützt gängige Browser mit minimalen visuellen Abweichungen, getestet z. B. bis Chrome 88, Firefox 84 und Safari 14. ([GitHub][1])

thx to @adamchaboryk @itmaybejj @Hackwar

4.4.34

Für REDAXO
^5.16.0
Veröffentlicht am
02.12.2025
Require / PHP
>=8.1, <9

Bugfix für Rechte

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.33...4.4.34

4.4.33

Für REDAXO
^5.16.0
Veröffentlicht am
19.11.2025
Require / PHP
>=8.1, <9

Version 4.4.33

Bugfixes

LocalStorage-Invalidierung bei Konfigurationsänderungen (Issue #57)

  • Config-Hash wird generiert und mit dem im Browser gespeicherten Hash verglichen
  • Bei Änderungen der Backend-Konfiguration wird der LocalStorage automatisch zurückgesetzt
  • Neue Einstellungen werden sofort im Frontend wirksam
  • Löst das Problem, dass Änderungen an root, ignore oder custom_settings nicht sofort übernommen wurden

Neue Features

Erweiterte Konfigurationsseite mit Beispielen

  • Neues Accordion mit 12 praktischen Custom Settings Beispielen
  • Beispiele umfassen: Panel-Position, Verzögerung, Custom Content, Buttons ausblenden, Kontrast-Plugin, Formular-Labels, Custom Checks, Readability, SPA-Support, Link-Kennzeichnung, APCA-Kontrast, Check-Anpassungen
  • Hinweise zur korrekten Verwendung (Kommas, Anführungszeichen, Browser-Konsole)
  • Vollständig zweisprachig (Deutsch/Englisch)
  • Link zur vollständigen Sa11y-Dokumentation

Verbesserungen

Code-Qualität

  • Alle PHPStan-Checks bestanden (Level: max)
  • Alle Psalm-Fehler behoben (100% Type-Coverage)
  • Code-Style mit php-cs-fixer korrigiert
  • Verbesserte Null-Checks und Type-Casts
  • Bessere Code-Dokumentation

4.4.32

Für REDAXO
^5.16.0
Veröffentlicht am
28.10.2025
Require / PHP
>=8.1, <9

This release introduces a new check that detects automatically generated or placeholder alt text values, such as ~ai-3a3cb8f0-1554-4e2b-b159. These are often inserted by AI systems, CMS exports, or image pipelines instead of meaningful human-written descriptions. This check helps identify meaningless placeholders, ensuring that alt text provides useful and descriptive information.

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.31...4.4.32

4.4.31

Für REDAXO
^5.16.0
Veröffentlicht am
29.09.2025
Require / PHP
>=8.1, <9

Vendor update to

4.4.30

Für REDAXO
^5.16.0
Veröffentlicht am
15.09.2025
Require / PHP
>=8.1, <9

Bug fix for rare type error.

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.21...4.4.30

4.4.21

Für REDAXO
^5.16.0
Veröffentlicht am
08.09.2025
Require / PHP
>=8.1, <9

What's Changed

https://github.com/ryersondmp/sa11y/releases/tag/4.2.1
LABELS_PLACEHOLDER check can now be disabled. Issue https://github.com/ryersondmp/sa11y/issues/130.
Added contrast checking support for SVGs that use . Related to https://github.com/ryersondmp/sa11y/issues/129.

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.20...4.4.21

4.4.20

Für REDAXO
^5.16.0
Veröffentlicht am
01.09.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.15...4.4.20

4.4.15

Für REDAXO
^5.16.0
Veröffentlicht am
26.07.2025
Require / PHP
>=8.1, <9
  • Vendor: Sa11y 4.1.10
  • Increased control panel width for certain languages from 350px to 365px.
  • More precise German phrases to improve localization coverage. The changes expand the German language translation file with additional terms and variations that users might encounter. @skerbis!

4.4.14

Für REDAXO
^5.16.0
Veröffentlicht am
18.06.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.13...4.4.14

4.4.13

Für REDAXO
^5.16.0
Veröffentlicht am
21.04.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.12...4.4.13

4.4.12

Für REDAXO
^5.16.0
Veröffentlicht am
09.04.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.11...4.4.12

4.4.11

Für REDAXO
^5.16.0
Veröffentlicht am
30.03.2025
Require / PHP
>=8.1, <9

Update sa11y to version 4.1.3

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.10...4.4.11

4.4.10

Für REDAXO
^5.16.0
Veröffentlicht am
21.02.2025
Require / PHP
>=8.1, <9

Minor enhancements. View update notes for Sa11y 4!

The alt text check for file extensions now also detects image dimensions, e.g., alt="banner-900x400". The regex looks for image dimensions (like "900 x 400") by matching two numbers separated by "x," and uses word boundaries to avoid mistakes with similar phrases like "10x zoom."
Added new props to configure the edit button in the Image Outline:
ignoreEditImageURL (Array) – If an image's src attribute contains any of the strings in this array, the edit button will not be shown for that image.
ignoreEditImageClass (Array) – If an image has any of the class names listed in this array, the edit button will be hidden.

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.9...4.4.10

4.4.9

Für REDAXO
^5.16.0
Veröffentlicht am
14.02.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.5...4.4.9

4.4.5

Für REDAXO
^5.16.0
Veröffentlicht am
10.02.2025
Require / PHP
>=8.1, <9
  • Vendorupdaten 4.0.5
  • Bugfix: Removed a cycle dependency error.

4.4.4

Für REDAXO
^5.16.0
Veröffentlicht am
06.02.2025
Require / PHP
>=8.1, <9

Bug fixes

Enhanced accuracy of the LINK_CLICK_HERE check by using regex with word boundaries, preventing false positives in cases like "iClicker" or "clicked".
Added a visible alert when the readability target area is missing (Issue https://github.com/ryersondmp/sa11y/issues/107 — thanks @brianteeman).
Fixed the logic for props designed to add "Edit" links to the image outline.

https://github.com/ryersondmp/sa11y/releases/tag/4.0.4

4.4.3

Für REDAXO
^5.16.0
Veröffentlicht am
03.02.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.2...4.4.3

4.4.2

Für REDAXO
^5.16.0
Veröffentlicht am
27.01.2025
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.4.0...4.4.2

4.4.0

Für REDAXO
^5.16.0
Veröffentlicht am
17.01.2025
Require / PHP
>=8.1, <9

Release 4.4.0
Vendor-Update to:
Sa11y 4.0:

Kurze Zusammenfassung der Neuerungen

Sa11y 4.0: Kurze Zusammenfassung der Neuerungen

  • Einfacher: Klare Trennung von Prüfungen für Redakteure und Entwickler, einfacheres Einstellungsmenü.
  • Bessere Farbprüfung: Automatischer Kontrast-Check mit Farbvorschlägen, Farbwähler und Eye-Dropper.
  • Mehr Dismissal-Optionen: Einfaches Ausblenden von Warnungen, auch temporär.
  • Neue Redakteurs-Prüfungen: Warnungen für häufige Fehler (z.B. Blocksatz, zu kleiner Text, fehlende Bildbeschreibungen).
  • Erweiterte Entwickler-Prüfungen: Mehr Warnungen für Entwickler (z.B. fehlende Barrierefreiheit von Buttons, Formulare, Listenelemente).
  • Anpassbar: Prüfungen können individuell konfiguriert werden.
  • Bugfixes: Viele Fehler behoben, Performance verbessert.
  • Kontrast: Verbesserte Kontrastprüfung, Unterstützung für mehr Farben, optionale APCA-Unterstützung (Beta).

thanks to: @ryersondmp @brianteeman
We love it ❤️

4.3.1

Für REDAXO
^5.16.0
Veröffentlicht am
02.09.2024
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.3.0...4.3.1

Sa11y 3.2.3 Latest
New prop: showGoodImageButton Set to false to hide "Good" annotations for images.
New: All toggleable checks are enabled by default.
Bug fix: Fixed a couple small design regressions regarding the notification badge icon and tooltips.
Bug fix: fakeListQA prop fixed.
Bug fix: Fixed a serious bug where contrast checking would stop flagging issues once it comes across a visually hidden element (for example, an .sr-only class).
Bug fix: Fixed an issue with the duplicate ID check. Thank you @jbrulotte! https://github.com/ryersondmp/sa11y/issues/92
Bug fix: Annotations will be inserted before [role="link"], [role="button"] in addition to a, button
Bug fix: Fixed a couple tooltip formatting issues for English (US).
Bug fix: Ensure missing target root alert only appears when headless is set to false.

4.3.0

Für REDAXO
^5.16.0
Veröffentlicht am
23.08.2024
Require / PHP
>=8.1, <9

Adds custom settings field to set properties

example:

panelPosition: "top-right",

sets the Position of the widget.
More Settings here:

https://sa11y.netlify.app/developers/props/

4.2.4

Für REDAXO
^5.16.0
Veröffentlicht am
20.08.2024
Require / PHP
>=8.1, <9

fixed: https://github.com/FriendsOfREDAXO/for_sa11y/issues/35

4.2.3

Für REDAXO
^5.16.0
Veröffentlicht am
20.08.2024
Require / PHP
>=8.1, <9
  • Link fix for css
  • NEU: Testergebnisse-Eport

4.2.1

Für REDAXO
^5.16.0
Veröffentlicht am
11.08.2024
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.2.0...4.2.1

4.2.0

Für REDAXO
^5.16.0
Veröffentlicht am
22.06.2024
Require / PHP
>=8.1, <9

Im Bilder-Tab kann man jetzt direkt die ALT-Infos der Bilder überprüfen

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/4.1.1...4.2.0

4.1.1

Für REDAXO
^5.16.0
Veröffentlicht am
15.05.2024
Require / PHP
>=8.1, <9

version: '4.1.1'

vendors: 'Sa11y 3.1.5'

4.1.0

Für REDAXO
^5.16.0-beta1
Veröffentlicht am
18.03.2024
Require / PHP
>=8.1, <9

Major-Update

Neu:

  • Settingsseite zur Aktivierung / Deaktivierung
  • Es können Ignore-Selektoren definiert werden
  • Der Root-Selektor kann ausgewählt werden /default: body
  • Userrechte es kann bestimmt werden, wer testen darf und ob die Settings verwendet werden dürfen

RexStan Prüfung Stufe 9 bestanden 👍🏻

Der Root-Selektor kann nur durch den Admin festgelegt werden.

What's Changed

4.0.0

Für REDAXO
^5.16.0-beta1
Veröffentlicht am
18.03.2024
Require / PHP
>=8.1, <9

Major-Update

Neu:

  • Settingsseite zur Aktivierung / Deaktivierung
  • Der Root-Selektor kann ausgewählt werden /default: body
  • Userrechte es kann bestimmt werden, wer testen darf und ob die Settings verwendet werden dürfen

RexStan Prüfung Stufe 9 bestanden 👍🏻

Der Root-Selektor kann nur durch den Admin festgelegt werden.

What's Changed

3.1.0

Für REDAXO
^5.16.0-beta1
Veröffentlicht am
17.03.2024
Require / PHP
>=8.1, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/3.0.1...3.1.0

3.0.1

Für REDAXO
^5.16.0-beta1
Veröffentlicht am
04.03.2024
Require / PHP
>=8.1, <9

3.0.0
Added: current Vendor 3.0.8
Changed: Namespace-Korrektur:

Achtung neuer Aufruf per:
<?=\FriendsOfRedaxo\Sa11y\Sa11y::get()?>

3.0.0

Für REDAXO
^5.16.0-beta1
Veröffentlicht am
16.02.2024
Require / PHP
>=8.1, <9

Added: current Vendor 3.0.8
Changed: Namespace-Korrektur:

Achtung neuer Aufruf per:
<?=\FriendsOfRedaxo\Sa11y\Sa11y::get()?>

2.0.7

Für REDAXO
^5.12.0
Veröffentlicht am
12.01.2024
Require / PHP
>=7.4, <9

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/2.0.6...2.0.7

2.0.6

Für REDAXO
^5.12.0
Veröffentlicht am
10.01.2024
Require / PHP
>=7.4, <9

Verdor- und Security-Update

What's Changed

New Contributors

Full Changelog: https://github.com/FriendsOfREDAXO/for_sa11y/compare/2.0.3...2.0.6

2.0.3

Für REDAXO
^5.12.0
Veröffentlicht am
25.07.2023
Require / PHP
>=7.4, <9

update to Vendor 3.0.3

2.0.2

Für REDAXO
^5.12.0
Veröffentlicht am
01.06.2023
Require / PHP
>=7.4, <9

Vendor-Uodate: 3.0.2

2.0.0

Für REDAXO
^5.12.0
Veröffentlicht am
05.05.2023
Require / PHP
>=7.4, <9
  • Vendor Update auf 3.0
  • 🔔Achtung der Code muss jetzt in `<body>‘ abgelegt werden.

@elricco und @ansichtsache steuerten die Übersetzung für das final Release bei. Danke

1.0.0

Für REDAXO
^5.12.0
Veröffentlicht am
19.04.2023
Require / PHP
>=7.4, <9

Kleine Korrekturen.
Finale 1.0

0.1.0

Für REDAXO
^5.12.0
Veröffentlicht am
28.01.2023
Require / PHP
>=7.4, <9

Automatische Spracherkennung de/en

0.0.4

Für REDAXO
^5.12.0
Veröffentlicht am
27.01.2023
Require / PHP
>=7.4, <9
  • Selbst erstellte deutsche Sprachdatei hinzugefügt. Danke @elricco @ansichtsache
  • Security fixes for Vendor

0.0.3

Für REDAXO
^5.12.0
Veröffentlicht am
27.01.2023
Require / PHP
>=7.4, <9
  • Selbst erstellte deutsche Sprachdatei hinzugefügt. Danke @elricco @ansichtsache
  • Security fixes for Vendor

0.0.2

Für REDAXO
^5.14.0
Veröffentlicht am
22.01.2023
Require / PHP
>=8.0, <9

Erstes Release im Installer.
Um es auszuführen, einfach for_sa11y::get(); im Template <head> aufrufen

Bitte auch die Readme lesen