RTC Language Change a11y NPM Resource Changed PR-6.2-dev Pending

User tests: Successful: Unsuccessful:

avatar mbeganyi-a11y
mbeganyi-a11y
22 Oct 2026

Pull Request resolves #48373.

  • I read the Generative AI policy and my contribution is either not created with the help of AI or is compatible with the policy and GNU/GPL 2 or later.

Summary of Changes

Adds translated alternative text to the QR image displayed when setting up the Verification code multi-factor authentication method. The generated QR code now has alt="QR code for setting up your authenticator app".

This PR:

  • Adds an alphabetically ordered, plugin-specific language string
  • Registers the string for JavaScript through Text::script()
  • Passes the translated string to the existing QR image generation function

The implementation applies wherever the TOTP plugin supplies its setup screen, including frontend and administrator setup.

Testing Instructions

Backend admin template:

  1. Start a screen reader
  2. Sign in to the administrator backend using your Super User account
  3. Ensure the Multi-factor Authentication – Verification Code plugin is enabled
  4. Go to Users > Manage and open the account you are currently signed in as
  5. Open the Multi-factor Authentication tab
  6. Add a new Verification code method
  7. Note the QR code is generated on the following screen
  8. Navigate to the QR code using screen reader shortcuts or use the arrow keys to move item by item until you reach the QR code (the NVDA shortcut to go to graphics on a page is 'G', for example).
  9. Listen for the announcement. It should be: "QR code for setting up your authenticator app"
  10. If you're comfortable doing so and want to doubly confirm, inspect the DOM in the browser's DevTools and confirm the presence of the < alt > attribute
  11. Continue through the registration process to ensure that the QR code method works as intended without any regression. (My testing includes this confirmation.)

Frontend Cassiopeia template:

  1. Start a screen reader
  2. Sign in to the frontend using a disposable test account
  3. Open the account’s MFA management screen through its profile, or use: index.php?option=com_users&view=methods appended to the end of your local site
  4. Add a new Verification code method
  5. Repeat the screen reader and image inspection checks above

Below are two images depicting the successful fix in both templates. The QR code has been modified to be unreadable in the screenshots:

Alt text present for QR image in admin template Alt text present for QR image in front-end template

Actual result BEFORE applying this Pull Request

The generated QR image does not have a meaningful text alternative identifying its purpose. Screen reader users may not know the QR code is present.

Expected result AFTER applying this Pull Request

The generated QR image has a translated alternative identifying it as the QR code for setting up an authenticator app. Context is provided to screen reader users.

Link to documentations

Please select:

  • Documentation link for guide.joomla.org:

  • No documentation changes for guide.joomla.org needed

  • Pull Request link for manual.joomla.org:

  • No documentation changes for manual.joomla.org needed

avatar mbeganyi-a11y mbeganyi-a11y - open - 22 Oct 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 22 Oct 2026
Status New ⇒ Pending
avatar joomla-cms-bot joomla-cms-bot - change - 22 Oct 2026
Category ⇒ Administration Language & Strings JavaScript NPM Change Front End Plugins
avatar mbeganyi-a11y mbeganyi-a11y - change - 22 Oct 2026
Labels Added: Language Change a11y NPM Resource Changed PR-6.2-dev
avatar brianteeman
brianteeman - comment - 22 Oct 2026

seems to be ok - not sure how usable a qr code is though when you are using a screen reader

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 22 Oct 2026

Yikes. It's not only blind people who use screen readers, if that's what you're implying...

avatar brianteeman
brianteeman - comment - 22 Oct 2026

No of course not but for the people who are blind it is of questinable value although I suppose the qr reader on their phone could announce when it can see the qr code

avatar brianteeman brianteeman - test_item - 22 Oct 2026 - Tested successfully
avatar brianteeman
brianteeman - comment - 22 Oct 2026

I have tested this item ✅ successfully on e192194


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar brianteeman
brianteeman - comment - 22 Oct 2026

I have tested this item ✅ successfully on e192194


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar exlemor exlemor - test_item - 29 Oct 2026 - Tested successfully
avatar exlemor
exlemor - comment - 29 Oct 2026

I have tested this item ✅ successfully on e192194

I have successfully tested this PR Fix. Thanks @mbeganyi-a11y! (in the process, I discovered/tested and used a new screen reader for Mac so that's a bonus).


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar exlemor
exlemor - comment - 29 Oct 2026

I have tested this item ✅ successfully on e192194

I have successfully tested this PR Fix. Thanks @mbeganyi-a11y! (in the process, I discovered/tested and used a new screen reader for Mac so that's a bonus).


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar alikon alikon - change - 29 Oct 2026
The description was changed
Status Pending ⇒ Ready to Commit
avatar alikon
alikon - comment - 29 Oct 2026

RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar alikon
alikon - comment - 29 Oct 2026

RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48687.

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 29 Oct 2026

I have successfully tested this PR Fix. Thanks @mbeganyi-a11y! (in the process, I discovered/tested and used a new screen reader for Mac so that's a bonus).

My pleasure to help, Emmanuel!

Very cool about the screen reader; thanks for testing!

avatar drmenzelit drmenzelit - change - 2 Nov 2026
The description was changed
Labels Added: RTC
avatar drmenzelit drmenzelit - change - 2 Nov 2026
Status Ready to Commit ⇒ Fixed in Code Base
Closed_Date 0000-00-00 00:00:00 ⇒ 2026-11-02 15:08:46
Closed_By ⇒ drmenzelit
avatar drmenzelit drmenzelit - close - 2 Nov 2026
avatar drmenzelit drmenzelit - merge - 2 Nov 2026
avatar drmenzelit
drmenzelit - comment - 2 Nov 2026

Thanks

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 2 Nov 2026

Thanks for saying thanks, @drmenzelit, and for merging!

Add a Comment

Login with GitHub to post a comment