Internationalization and Localization (UXPROD-779)

[UXPROD-3149] UI language switcher widget Created: 29/Jun/21  Updated: 02/Dec/21

Status: Open
Project: UX Product
Components: None
Affects versions: None
Fix versions: None
Parent: Internationalization and Localization

Type: New Feature Priority: TBD
Reporter: Peter Murray Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: i18n
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original estimate: Not Specified

Attachments: PNG File FOLIO popover locale switcher.png     PNG File Kware_theme_switcher.png     PNG File image-2021-07-31-17-33-21-779.png    
Issue links:
Defines
is defined by STCOR-552 Add UI language switcher to top bar Open
is defined by UX-400 UX Review of KWare's User-Level Local... In Progress
Epic Link: Internationalization and Localization
Development Team: None
PO Rank: 0
Rank: Cornell (Full Sum 2021): R3

 Description   

Current situation or problem: The function to change the locale of the user interface is buried in the Settings app and contains a long list of locales that are not used for a tenant.

In scope

  • Modify the Settings → Tenant → Language and localization setting allow for the creation of a pre-defined list of locales to be presented to users from among all of the locales defined in the tenant.
  • Add an option to the app bar that allows the user to select a pre-defined locale for the current session.

Out of scope

Use case(s)

As a tenant administrator, I want to:

  • limit the list of locales presented to users, to eliminate unneeded locales and reduce user confusion.
  • set the default date format for each selected locale in the list (this is UXPROD-3150 Open )

As a FOLIO Stripes user, I want to:

  • easily access the list of pre-defined locales for the current session (from any app screen in FOLIO)
  • maintain the current session (i.e. editing a user/ bib record) without having to save the changes first
  • via my profile, limit the list of locales to be presented to me as per my languages requirements
  • via my profile, set my preferred locale in my profile to be set to at login and after screen refresh
  • via my profile, set my preferred numbers shape when in the Arabic locale mode (this is UXPROD-3150 Open )

Proposed solution/stories:

KnowledgeWare has developed the user-defined locale switcher widget to meet the use cases above.  

          Username: kware_test      Password: kware_test                                    Preferred Locale: English 

As a tenant administrator, go to the “Settings → Tenant → Language and localization” screen to display all locales available in the tenant, put checkboxes next to locales that become the “pre-defined locale list”, and select the default date format for each selected locale. 

As a FOLIO Stripes user, go to "My profile → Language" screen to add your preferred languages out of the pre-defined locales available for the tenant , and if the Arabic locale is in your preferred locales list, select your preferred numbers shape (Arabic-Latin or Arabic-Hindu).

As described by Filip in UX-400 In Progress , topic 2, option A: add as a “popover app” in the popover app section next to the existing Help (question mark) icon (see mockup below).
Unable to render embedded object: File (01-language-switcher.png) not found.

Links to additional info

Questions



 Comments   
Comment by Peter Murray [ 30/Jul/21 ]

We should get this one started through the process of getting it included as well. The pull requests for this change should be separate from the ones for UXPROD-3149 Open . In the case of the language switcher widget, there is already a Stripes-Core issue: https://folio-org.atlassian.net/browse/STCOR-552 — please include a mention of that Stripes issue in the Pull Request.

Comment by Massoud Alshareef [ 31/Jul/21 ]

Peter Murray Filip's suggestion  in UX-400, topic 2, option A, suggests a “popover app” in the popover app section next to the full-screen app section. We have accomplished this via the theme switcher proposed as a PoC demonstrated in Kware's FOLIO test environment (see URL above).

As a tenant administrator, go to the “Settings → Tenant → Themes Switcher” screen to display all themes available in the tenant. We currently have two themes available: FOLIO standard theme and Kware theme. Select "FOLIO standard theme" then save, and you will get the popover app for the user-level locale switcher like this:

 

For those service providers who believe that it is critical to provide an experience that will make FOLIO libraries and their staff feel ownership of the system, we are introducing the "Identity bar" via Kware theme.

Go to “Settings → Tenant → Themes Switcher” screen, select "Kware theme" and save, and you will get the "identity bar" on top of the apps nav bar, like this:

 The identity bar has been added on top of the apps nav bar to represent the library identity (Library Logo, User name and Photo, Circulation desk name, User-level Locale Switcher, Today date when the full-screen mode is enabled).

In case a user feels that the new identity bar is consuming unnecessary screen real estate, he/she can pick one the following options:

  • Hide/ unhide the "identity bar" (press the arrow up/ down icon at the top far right above) to retain the screen real state
  • Further screen real estate space can be gained by going to the full-screen mode (press on the rectangle left to the arrow)

 

We think with this implementation we have satisfied both needs, saving space for functional elements on the screen and providing system ownership via the identity bar.

Comment by Peter Murray [ 02/Aug/21 ]

Hi Massoud. The theme-switcher is out of scope for this issue and a pull request for UXPROD-3149 Open that contains that functionality will likely not make it through review by the Stripes Force team. The identity-bar/theme-switcher you are describing is UXPROD-3152 Open plus a whole lot more. I don't have the capacity to be a product owner for UXPROD-3152 Open . I've removed some of the changes you made to the description to return the scope of this feature to just the language switcher. Let's just get the UI language switcher and the Translations app ( UXPROD-3148 Open ) in for Juniper.

Since this issue and UXPROD-3148 Open involve changes to Stripes, our deadline to get the code changes in place is 27-Aug-2021, the date of API freeze for the platform (Okapi/Stripes/RMB/Spring). Let's get the code changes for these two issues into GitHub pull requests as soon as possible so they can be reviewed. Since this is Knowledgeware's first code contribution to the FOLIO project and because it is affecting core parts of the system, we should allow for as much time as possible before the 27th in case there are questions about code style and implementation.

Generated at Fri Feb 09 00:29:43 UTC 2024 using Jira 1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d.