Language switcher on the login screen

[johnbillion]

Since [41692] it's possible to control the language of the login screen using the wp_lang query variable (eg. wp-login.php?wp_lang=it_IT). This is a hidden feature that's only used by the interim login modal.

A language switcher should be introduced on the login screen that makes use of this so users can use the login screen, the password reset screens, and the registration screen in their own language. The behaviour would be the same as the language choosers that are used elsewhere in core, for example on the General Settings screen and on the Multisite registration screens.

One thing that needs to be considered is how the language persists between screens, how to persist POSTed values such as redirect_to, and whether it should persist in user meta once the user successfully logs in. Suggestions welcome.

[swissspidy]

How has this been implemented on WordPress.org?

[netweb]

Replying to swissspidy:

How has this been implemented on WordPress.org?

I've not looked at it personally but the code is here: ​https://meta.trac.wordpress.org/browser/sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-login

[Nikschavan]

Seems this was the main commit for adding this to WordPress.org - ​https://meta.trac.wordpress.org/changeset/6677

[Nikschavan]

Patch 43700.1.diff​ is the first pass at adding the language switcher to the login window.

One thing that needs to be considered is how the language persists between screens, how to persist POSTed values such as redirect_to, and whether it should persist in user meta once the user successfully logs in. Suggestions welcome.

This attached patch adds the $_GET parameters to hidden variables so that they are retained after the page is reloaded.
Currently three $_GET parameters are handled interim-login, redirect_to, action.

[johnbillion]

43700.diff​ is a work in progress patch that continues the work of @Nikschavan. Changes:

• Ensure the language switcher only appears when there are language choices available
• Store the selected language in a cookie so it persists between all of the possible login screens and actions
• Take the cookie into account when determining the user's locale
• Allow the user to switch to en_US when it's not the site's default language

[Nikschavan]

43700.2.diff​ Refreshes @johnbillion's patch with latest trunk and fixes 2 PHP notices.

• Set default value of explicit_option_en_us as false in wp_dropdown_languages() to avoid PHP notice for undefined index on Line 1511 in src/wp-includes/l10n.php
• Use esc_url_raw() instead of sanitize_url() to remove depracation warning in wp-login.php

@johnbillion, @swissspidy - Can this ticket be considered for the 5.3 release cycle?

[Nikschavan]

Another question would be - should the value of wp_lang be set to user locale after successful login, If user locale is currently empty?

Trac ticket: https://core.trac.wordpress.org/ticket/43700

This continues the work on the patches already uploaded to 43700. It introduces a language switcher to the login screen, which also affects its derivatives such as the password reset screens and user registration.

The following closely related functionality has also been implemented:

• Add the language parameter to the login and password reset URLs in the email sent to a user when they are added to a site.
• Ensure the password reset email is always sent to the user in their chosen language.
• Add the language parameter to the URL in the password reset email.

Still to do:

• Decide whether, upon login, the user's locale should be updated to the one they chose on the login screen. Probably yes.

[davidbaumwald]

@johnbillion IS this one still on your list to tackle before 5.5 Beta 1 in a few days time? Anything else needed here besides testing?

[afercia]

Testing 43700.2.diff​ there are a couple accessibility issues that need to be fixed:

1. Using the change event on a select is a usability and accessibility issue and needs to be avoided. Users should be in control of triggering the language switch, thus there's the need of a button to submit the language form. See also #40925 and #25103.
2. Minor CSS issue: the language form uses overflow: hidden thus the select focus style is slightly cut-off on the top and bottom edges. See attached screenshot.

[afercia]

Focus style cut-off

[johnbillion]

This needs some more work, including further functional work that I haven't finalised yet, plus design work to improve the layout now that we have several links of different styles at the bottom of this screen, plus the a11y issues mentioned above. Punting to 5.6.

[afercia]

Replying to johnbillion:

Punting to 5.6.

Forgot to punt? :)

[johnbillion]

This needs some design discussion, design work, and accessibility work. Punting for now.

[sabernhardt]

using "Change" submit button

[sabernhardt]

Patch is updated for accessibility concerns and a few other changes. (The since note is still the placeholder because this may not be ready for 5.6.)

• Reduces padding above logo
• Removes border around language switcher
• Shows overflow (focus outline)
• Adds "Change" submit button (reusing text string from wp-admin/includes/class-wp-users-list-table.php)
• Centers language switcher instead of aligning under the links
• Centers submit button below the select and label at screen widths up to 400px
• Code consistency:

1. replacing spaces with tabs
2. method="get" lowercase
3. adding zero for "0.5em"
4. moving aria-hidden attribute after classes to match the show password button's order

[johnbillion]

Thanks @sabernhardt could you add a screenshot please?

[sabernhardt]

switcher with submit button

[sabernhardt]

submit button with focus outline

[sabernhardt]

I also considered moving the language switcher above the username/password form, but that probably would mean changing the focused element on page load.

[garrett-eclipse]

Thanks for the patch and screens @sabernhardt discussing in a design triage it's looking great.

We would suggest leaving it after the form as the primary focus of the page is the login. And this is a secondary action which once used isn't going to be re-used as often as login would.

Also the icon seems like it's baseline it would be good to have that vertically centred.

[johnbillion]

I think this needs some more in-depth design discussion. The bottom of the login screen can contain quite a few elements now and it's getting messy as the four existing items have three different appearances between them.

• Register
• Lost your password?
• ← Back to [site]
• Privacy Policy
• Language switcher

[karmatosed]

I sort of think putting it before the lost password could be better, sorry to pop in with a counter point. How about we pop back the label as I do agree with you @johnbillion here that section can get quite large if those things are added. Maybe some mocks even if quickly produced?

[johnbillion]

Some visual mockups would be great

[garrett-eclipse]

Concept: Language Selector at bottom, register/lostpassword links inside form white, and no need for back as logo does that.

[garrett-eclipse]

Same concept but with a back link

[garrett-eclipse]

I put together two quick concepts using login.wordpress.org as the basis (so yes there's no button for submit in my concept but should be one for accessibility). I moved the Register and Lost your password links into the form area as they're tied to the login. And for the Back I didn't really feel it needed as there's the logo for that, but did provide a mock including it above the form as I assume it's beneficial for accessibility.

We can also try a mock with the selector above the form, just note the logo is up there and currently is fairly clean.

[paaljoachim]

I am removing the Needs design feedback keyword from this ticket. If it is a mistake then please add it back in again.

[keyur5]

Tested @sabernhardt patch (43700.3.diff). Worked as expected.

[paaljoachim]

At what stage is this ticket at?
I see that the patch has been approved.

[paaljoachim]

I have tested the latest patch and it works well.

[Clorith]

I like the direction of those patches @garrett-eclipse, big fan of keeping it simple and grouped by relevance like that, some quick feedback from looking at them, and my first thoughts on what might need refining;

The "back" link shouldn't come so close to the WordPress logo, since the logo is a link to WordPress.org, while the back link takes you to the main URL of that site. These two types of links should ideally be separated by a non-link element of some kind to avoid accidental navigation to the wrong place. (I saw your mention of this, so making note that the logo always links to WordPress.org, unless someone has changed this with code)

Could we also get some mockups for the password reset, and password recovery screens, these should also have the language switcher available ideally, in case you somehow got the wrong language, or (after WordPress 5.7) a reset link was sent directly to you, and you did not set your language from the login page.

There are also more "back"-type links on those two pages, on the lost password screen for example there's the same link back to the front page, but also a link back to the login page, which perhaps need to be presented in a different way from the login view it self? (I don't know here, but bringing it up for the sake of completeness)

[tobifjellner]

What languages should be offered in the drop-down?
One way is to offer any language that is available for WordPress core.
Upside: Great for a real user who want to log in but doesn't know the main language of the site.
Downside: An attacker could force the site it to download a lot of unnecessary language files, using more traffic and storage space. (Remember that once a certain language is installed, WordPress will automatically download available translations of these languages for all installed plugins and themes...

Possible mitigations:
Either only offer languages that are already installed. (If the site uses English US and no other languages are installed, then the language chooser should be removed or at least hidden.)
Or prepare a special micro language package that only covers login/password reset and won't trigger download of any more language files until the user has authenticated or registered correctly.
Perhaps the choice of approach should be available to the site admin, if not as a setting, then via filter or a constant.

[joedolson]

I think that defaulting to only languages that are already installed is a good option. It covers most practical cases. A special micro language pack could be created - but that seems like it would be a larger project to cover a handful of edge cases.

[johnbillion]

With the current patch the currently installed languages are listed. This means the language picker on the log in screen works the same way as that on the user profile editing screen.

[joedolson]

Let's try and get this done in 5.9. @johnbillion If you don't think you'll have time to shepherd this, feel free to assign me as the owner.

[johnbillion]

👍