Language Change NPM Resource Changed PR-5.3-dev Pending

User tests: Successful: Unsuccessful:

avatar coolcat-creations
coolcat-creations
11 Oct 2024

Summary of Changes

This PR rearranges the Joomla login screen for improved clarity and user experience. Previously, the login button was positioned below the alternate login options, which caused confusion for users. This change groups the "Username" and "Password" fields together, followed by the login button, and clearly separates them from the alternate login options.

The new layout includes headlines such as "Login with username and password" and an "OR" separator before the alternate login methods. This approach is consistent with login patterns observed in other services and aligns with established usability practices, ensuring users have a clear and intuitive path when logging in.

Sorry the screenshots are German but "Oder" means or and you see the Login options grouped:

Screenshot 1 Screenshot 2
Screenshot 3 Screenshot 4

Reasons for Change
Enhanced Usability: By grouping the username and password fields with the login button, users can more easily identify and complete the standard login process without distraction.

Clarity: The addition of a separator and relevant headlines distinguishes the primary login method from the alternate options, reducing confusion and improving the visual hierarchy.

Consistency with Modern Standards: Following login patterns used by popular services provides users with a familiar experience, which increases ease of use and reduces cognitive load.

Testing Instructions

Login with Username and Password:
Navigate to the admin login screen.
Enter valid credentials (username and password) and click the login button.
Verify that login is successful and that the grouping of the fields appears correctly.

Alternative Login Methods:
Enable Passkey Login if not Enabled
On the login screen, click on the available alternate login option.
Ensure the visual separation and headlines make it clear these options are alternatives to the standard login.

Disable Alternate Logins
Ensure the Alternative Login "Group" (Headline "OR" ) is not shown.

Responsive and Accessibility Testing:
Test the new layout on various screen sizes (mobile, tablet, desktop) to ensure it remains clear and functional.
Use a screen reader and keyboard navigation to verify that the new layout is accessible and navigable for users with disabilities.

Language Options
The Language Selection is now at the top, ensure it's still visible

Actual result BEFORE applying this Pull Request

Actual result before PR

Expected result AFTER applying this Pull Request

Expected result after PR

Link to documentations

Please select:

  • Documentation link for docs.joomla.org:

  • Maybe new Screenshots?

  • No documentation changes for docs.joomla.org needed

  • Pull Request link for manual.joomla.org:

  • No documentation changes for manual.joomla.org needed

avatar coolcat-creations coolcat-creations - open - 11 Oct 2024
avatar coolcat-creations coolcat-creations - change - 11 Oct 2024
Status New Pending
avatar joomla-cms-bot joomla-cms-bot - change - 11 Oct 2024
Category Administration Language & Strings Modules Repository NPM Change
avatar coolcat-creations coolcat-creations - change - 11 Oct 2024
The description was changed
avatar coolcat-creations coolcat-creations - edited - 11 Oct 2024
avatar coolcat-creations coolcat-creations - change - 11 Oct 2024
The description was changed
avatar coolcat-creations coolcat-creations - edited - 11 Oct 2024
avatar coolcat-creations coolcat-creations - change - 11 Oct 2024
Labels Added: Language Change NPM Resource Changed PR-5.3-dev
avatar richard67 richard67 - change - 11 Oct 2024
The description was changed
avatar richard67 richard67 - edited - 11 Oct 2024
avatar richard67 richard67 - change - 11 Oct 2024
The description was changed
avatar richard67 richard67 - edited - 11 Oct 2024
avatar richard67
richard67 - comment - 11 Oct 2024

@coolcat-creations I've allowed myself to fix the markdown formatting of the description so the headings for actual and expected result are shown as expected in our PR template, and the check boxes for documentation are right.

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

@coolcat-creations I've allowed myself to fix the markdown formatting of the description so the headings for actual and expected result are shown as expected in our PR template, and the check boxes for documentation are right.

Thank you for your help, Richard!

avatar dautrich dautrich - test_item - 11 Oct 2024 - Tested unsuccessfully
avatar dautrich
dautrich - comment - 11 Oct 2024

I have tested this item 🔴 unsuccessfully on 52e7bff

Didn't see anything about passwordless login on the admin login screen.


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/44228.
avatar dautrich
dautrich - comment - 11 Oct 2024

grafik

System plugin for passwordless login was enabled.

BTW: I couldn't see the language switcher with the prebuild package because the language pack for i.e. German does not yet exist.

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

That's odd - for me it works. Did you test then with English? Are you sure the "Passkey" Plugin is enabled?

avatar dautrich
dautrich - comment - 11 Oct 2024

I used the prebuilt package. And I have verified that the plugin for the Passkey (~ passwordless) Login was enabled.

avatar richard67
richard67 - comment - 11 Oct 2024

@dautrich And you have once edited your user and registered your passkey like described here? https://docs.joomla.org/WebAuthn_Passwordless_Login

avatar richard67
richard67 - comment - 11 Oct 2024

Regarding other language than English for 5.3 so you have multi language: You can download a language pack for 5.1 (or 5.2 soon) and install it with the normal extensions installer.

avatar dautrich
dautrich - comment - 11 Oct 2024

@richard67 That hasn't been the problem. I'm on localhost and use Laragon. The issue was that I wasn't under https://. Now I've convinced Laragon to allow https:// and I can see the login:
grafik

avatar richard67
richard67 - comment - 11 Oct 2024

@dautrich Yes, passkey requires https. Maybe you ran into this issue #44208 but haven't seen the error message because debug not enabled and/or error reporting not on maximum?

avatar dautrich
dautrich - comment - 11 Oct 2024

@richard67 Next issue: Tried to download a German language pack from joomla.org, but only see a white screen with the word "Error".

avatar richard67
richard67 - comment - 11 Oct 2024

@richard67 Next issue: Tried to download a German language pack from joomla.org, but only see a white screen with the word "Error".

@dautrich Works for me, https://downloads.joomla.org/language-packs/translations-joomla5/downloads/joomla5-german/5-1-4-1 .

avatar chmst
chmst - comment - 11 Oct 2024

Re-Arranging the screen is a great idea. But do we relly need the Text "login with your username and password"? What else could the user expect on a login screen?

avatar dautrich
dautrich - comment - 11 Oct 2024

@richard67 Has been a hickup on the joomla.org website, obviously.

avatar dautrich
dautrich - comment - 11 Oct 2024

Things are improving after I installed a German language pack and set German as the default language for frontend, backend, and content:

grafik

Two remarks:

  1. There is an unnecessary language string (marked in red).
  2. I agree with @chmst that the text is redundant (marked in green).

For 1.: There is a class "visually-hidden" missing in the legend of the fieldset. If inserted, it looks like this:
grafik

avatar dautrich
dautrich - comment - 11 Oct 2024

Using keyboard navigation (tab key), the language selection is barely unreachable. By default, focus is on the username field, and you have to tab through all available elements (including the browser header), before you finally reach the language selector.
Would be better to give this field the initial focus.

avatar brianteeman
brianteeman - comment - 11 Oct 2024

Using keyboard navigation (tab key), the language selection is barely unreachable. By default, focus is on the username field, and you have to tab through all available elements (including the browser header), before you finally reach the language selector. Would be better to give this field the initial focus.

thats no different to the current behaviour

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

Re-Arranging the screen is a great idea. But do we relly need the Text "login with your username and password"? What else could the user expect on a login screen?

The first option is username and password and the other option has the headline: Or
I think if we say be, we have to say A ? What do you think ?

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

About the language and the focus - I wonder if we should do a second PR where the language actually changes by changing this dropdown? Because it does not and if you don't understand "Sign in with a pass key" in Chinese the dropdown is not really helpful.

avatar dautrich
dautrich - comment - 11 Oct 2024

The first option is username and password and the other option has the headline: Or I think if we say be, we have to say A ? What do you think ?

I'm with @chmst : Why should we need "Log in with your username and password", when immediately below there is a form asking for username and password? We could safely omit this line (which eliminates the task to translate the sentence as well).

We would end up like this:
grafik

avatar dautrich
dautrich - comment - 11 Oct 2024

About the language and the focus - I wonder if we should do a second PR where the language actually changes by changing this dropdown? Because it does not and if you don't understand "Sign in with a pass key" in Chinese the dropdown is not really helpful.

Maybe you're right. If you want to avoid a second PR, you might consider using something like a horizontal ruler instead of the "OR".

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

But the "OR" is intentional...

avatar dautrich
dautrich - comment - 11 Oct 2024

Doesn't fit very well to German.

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

Why ? My screenshots are all German and show exactly this just a HR is not enough

avatar chmst
chmst - comment - 11 Oct 2024

The first option is username and password and the other option has the headline: Or
I think if we say be, we have to say A ? What do you think ?

Correct. But as a user I don't see that these text fragments form one sentence. Suppose you are blind then the screenreander reads the first part of the sentence .. the labels, announces the input field .. then says "or" ...

What, if we start with a complete sentence: "Login with username and password or with a passkey" - then the two clearly separated blocks?

At the moment I have no good testing environment - can someone listen to the screenreader?

avatar dautrich
dautrich - comment - 11 Oct 2024

Why ? My screenshots are all German and show exactly this just a HR is not enough

My screenshot above is German as well, but it shows "OR", which obviously is not correct in German.

avatar richard67
richard67 - comment - 11 Oct 2024

Why ? My screenshots are all German and show exactly this just a HR is not enough

My screenshot above is German as well, but it shows "OR", which obviously is not correct in German.

@dautrich A new language string added by this PR to the English file can't be available in the German translation yet :-) https://github.com/joomla/joomla-cms/pull/44228/files#diff-749c19a3bc27785f12905b9c65fe7600eedf704f0bb0093fbf838b266713fa29R11

@coolcat-creations Have you checked if there isn't already a global language string for "OR" (or "Or" or "or") which we could use here instead of creating a new string?

avatar brianteeman
brianteeman - comment - 11 Oct 2024

@coolcat-creations Have you checked if there isn't already a global language string for "OR" (or "Or" or "or") which we could use here instead of creating a new string?

There isnt and its not a good idea to add one for the reasons stated above by @chmst

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

@coolcat-creations Have you checked if there isn't already a global language string for "OR" (or "Or" or "or") which we could use here instead of creating a new string?

There isnt and its not a good idea to add one for the reasons stated above by @chmst

I thought maybe someone wants to override it with something else than or, it's not possible when I take the general "OR"
Otherwise all OR will be replaced with "or use one of these methods" 😅

avatar universewrld
universewrld - comment - 11 Oct 2024

@coolcat-creations I think this could be improved:

изображение

this text could be inside the field, as @google did with its login page (and many other services):

изображение

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

That actually not so good UX if in the moment you click in the Field the label disappears

avatar universewrld
universewrld - comment - 11 Oct 2024

@coolcat-creations also I think the or could be between the two lines (not above the lines) as done by Amazon and in your examples above:

изображение

avatar universewrld
universewrld - comment - 11 Oct 2024

That actually not so good UX if in the moment you click in the Field the label disappears

this is how it works, it's very convenient, you can check it by opening a new tab in private mode:
https://accounts.google.com/ServiceLogin

изображение

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

That actually not so good UX if in the moment you click in the Field the label disappears

this is how it works, it's very convenient, you can check it by opening a new tab in private mode:

https://accounts.google.com/ServiceLogin

изображение

Yes but changing all Inputs/ Labels are not scope of this PR, if I do it here I would need to do it everywhere.

avatar universewrld
universewrld - comment - 11 Oct 2024

Yes but changing all Inputs/ Labels are not scope of this PR, if I do it here I would need to do it everywhere.

there's still a lot of time until version 5.3, I think it's worth it to make the login form better.

avatar chmst
chmst - comment - 11 Oct 2024

When you work on new login form, please make sure, that it is accessible for all. WCAG 2.2

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

Yes but changing all Inputs/ Labels are not scope of this PR, if I do it here I would need to do it everywhere.

there's still a lot of time until version 5.3, I think it's worth it to make the login form better.

Yes but changing Input Fields in Joomla is a bigger scope, it can't be part of this PR

avatar coolcat-creations
coolcat-creations - comment - 11 Oct 2024

When you work on new login form, please make sure, that it is accessible for all. WCAG 2.2

Was this directed to me ?

avatar chmst
chmst - comment - 11 Oct 2024

It was for @universewrld.
@coolcat-creations I agree with you that it is not in scope of this PR. Re-arranging the fields is an improvement and enough.

avatar fgsw
fgsw - comment - 14 Oct 2024

@dautrich how do you get the screen at #44228 (comment)?

There is always shown the Constant like in your #44228 (comment):

Ohne Titel

avatar Fedik
Fedik - comment - 14 Oct 2024

@coolcat-creations thanks for your work, looks very nice.
Please keep language field as it was, after the username and password field.
It is an optional input, it should not be first on the page.

avatar coolcat-creations
coolcat-creations - comment - 14 Oct 2024

@Fedik ok,but it should also not be between two alternate sign in options. Then I put it at the very end?

avatar Fedik
Fedik - comment - 14 Oct 2024

Then I put it at the very end?

Not sure, but can try. We probably could even make it "hiddable" somehow, but that another topic 😃
My concern (currently) that it should not be the first input that User will see 😉

avatar dautrich
dautrich - comment - 14 Oct 2024

@fgsw It's a mockup. I installed locally and modified administrator/modules/mod_login/tmpl/default.php. I added a 'class="visually-hidden"' to line 31 and deleted line 42.

avatar dautrich
dautrich - comment - 14 Oct 2024

@Fedik ok,but it should also not be between two alternate sign in options. Then I put it at the very end?

Maybe yes, but it should somehow be obvious that the language selection belongs to both login options.

avatar fgsw
fgsw - comment - 14 Oct 2024

Info Please fill in this field is shown partiell above "Log in"-Button:

Ohne Titel

avatar fgsw
fgsw - comment - 15 Oct 2024

Beside the 2 mentioned Issues i found no more.

Test as Instructions say but not screen reader. Looked at Desktop, iPad, iPhone; Light/Dark mode; RTL-Language (Farsi).

@dautrich Can you reset your test result to "Not tested" so it not count als failed.

avatar dautrich dautrich - test_item - 15 Oct 2024 - Tested successfully
avatar dautrich
dautrich - comment - 15 Oct 2024

I have tested this item ✅ successfully on 52e7bff


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

I tested with different viewport sizes (desktop, tablet, smartphone) and using keyboard. No further issues.

Add a Comment

Login with GitHub to post a comment