UITEN-340 Use locale API to fetch and update tenant locale settings. by BogdanDenis · Pull Request #486 · folio-org/ui-tenant-settings

BogdanDenis · 2026-01-26T13:40:14Z

Description

Context: With the Trillium release, Language & locale settings were moved from mod-configuration to the /locale API of mod-settings. These settings are tenant level (a user can also set user preference for language at some other API).

Front-end modules that use these tenant settings need to call the /locale endpoint to get these settings.
Update required interfaces and required permissions from mod-configuration to mod-settings.
If this work is not completed in Trillium then any workflows using locale settings will not work as expected.

Also this work is required for mod-configuration deprecation.

Approach

Add hooks to fetch/store locale settings via /locale API.
Change <Locale> component to use the new locale api if it's available, and /configurations/entries as a fall-back

Issues

UITEN-340

Related PRs

folio-org/stripes-core#1691

… settings.

github-actions · 2026-01-26T13:42:46Z

Jest Unit Test Results

1 files ± 0 45 suites +2 2m 19s ⏱️ ±0s
166 tests +10 161 ✅ +8 5 💤 +2 0 ❌ ±0
168 runs +10 163 ✅ +8 5 💤 +2 0 ❌ ±0

Results for commit 524f478. ± Comparison against base commit 653aa76.

This pull request skips 2 tests.

Locale should choose and save locale ‑ Locale should choose and save locale
Locale should render localization form ‑ Locale should render localization form

♻️ This comment has been updated with latest results.

NikitaSedyx · 2026-02-04T12:53:48Z

package.json

        "displayName": "Settings (tenant): Can view language, localization, and currency",
        "subPermissions": [
-          "mod-settings.entries.collection.get",
          "mod-settings.global.read.stripes-core.prefs.manage",


I believe mod-settings.global.read.stripes-core.prefs.manage not required anymore

NikitaSedyx · 2026-02-04T12:54:28Z

package.json

-          "mod-settings.entries.collection.get",
          "mod-settings.global.read.stripes-core.prefs.manage",
+          "locale.item.get",
+          "locale.item.put",


view set shouldn't include put

SerhiiNosko · 2026-02-19T07:43:32Z

@BogdanDenis can we merge this PR, since it has already 2 approvals, we have 5 BE stories already that waiting this PR merged to merge them in the same time

zburke · 2026-02-19T11:35:30Z

Sorry, @SerhiiNosko, I didn't realize other work was blocked on this. I'll take a look in the next few hours.

Dmytro-Melnyshyn · 2026-02-19T12:25:56Z

src/hooks/useTenantLocale/useTenantLocale.js

+    // for some reason react-query returns isLoading as true even for disabled queries...this is an expected behaviour according to them
+    // so we need to also check for a present interface to not have false positives


This is most likely because stripes.hasInterface returns undefined instead of false. enabled requires a boolean value.

I think it's a bug/weird convention within react-query itself. I had tried explicitly converting into a bool value and still the first render gave isLoading: true

Dmytro-Melnyshyn · 2026-02-19T12:35:20Z

src/settings/Locale/Locale.js

+        isUsingLocaleApi
+          ? renderLocaleApiForm()
+          : renderSettingsEntriesForm()


Is there a chance that /locale will not be included in Trillium?

It's a requirement in stripes-core to not have breaking changes and to have a fallback on mod-configurations, and so we need to support it here too.

I think it was about stripes-core/smart/components, not ui-* modules. cc @zburke

It was, but I think if stripes-core can potentially fall-back to using mod-configurations, then UI should also do the same so that admins can change tenant locale via UI

You're both right :) In this release, stripes-core must avoid breaking changes and thus retain the ability to read from mod-configuration, even as we move these values to the new /locale endpoint on mod-settings. Does that mean ui-tenant-settings, likewise, must retain the ability to write to mod-configuration?

Technically no. It's messy. We are caught in the middle here: we pledged not to break the component APIs in @folio/stripes but in many cases UI apps already broke Okapi-interface APIs (e.g. by bumping their minimum interface version from 1.0 to 1.1 so they can take advantage of the new features, or by adding a new required interface, or bumping to a new major version of an existing interface). Probably it's very unlikely a tenant (or an operator) would choose to update their UI out of step with the backend, or update some UI modules without also updating @folio/stripes, but that is what we pledged to enable.

Given we have the fallback implemented already, @BogdanDenis, I'd love to keep it for now and only remove it when we do the corresponding work in stripes-core. But if you want to remove it now, as @Dmytro-Melnyshyn seems to be suggesting, I would not fight you.

zburke · 2026-02-19T15:34:26Z

src/settings/Locale/index.js

@@ -0,0 +1 @@
+export { default as Locale } from './Locale';


Plugins/index.js and others just do export { default }, allowing settings/index.js to continue with

import Locale from './Locale';

instead of

import { Locale } from './Locale';

This is fine, obviously, but the consistency might be nice. Your call.

sonarqubecloud · 2026-02-24T10:59:46Z

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
88.7% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

…& locale settings (#1691) ## Description **Context**: With the Trillium release, Language & locale settings were moved from mod-configuration to the /locale API of mod-settings. These settings are tenant level (a user can also set user preference for language at some other API). - Front-end modules that use these tenant settings need to call the /locale endpoint to get these settings. - Update required interfaces and required permissions from mod-configuration to mod-settings. - If this work is not completed in Trillium then any workflows using locale settings will not work as expected. Also this work is required for mod-configuration deprecation. ## Approach - Fetch tenant locale settings from `/locale` API. - Removed calls to fetch tenant locale settings from `/settings/entries` and `/configurations/entries` - Removed calls to fetch user locale settings from `/configurations/entries` - User locale settings are now fetched from `/settings/entries` ## Issues [STCOR-1027](https://folio-org.atlassian.net/browse/STCOR-1027) ## Related PRs folio-org/ui-tenant-settings#486

UITEN-340 *BREAKING* Use locale API to fetch and update tenant locale…

4f9bbd0

… settings.

BogdanDenis added 2 commits January 27, 2026 16:00

UITEN-340 updated tests

e762afe

Merge remote-tracking branch 'origin/master' into UITEN-340

0fb9974

BogdanDenis marked this pull request as ready for review January 27, 2026 15:22

BogdanDenis mentioned this pull request Jan 27, 2026

STCOR-1027 Use GET mod-settings /locale API to get tenant language & locale settings folio-org/stripes-core#1691

Merged

BogdanDenis requested review from a team and zburke January 27, 2026 15:29

OleksandrHladchenko1 approved these changes Jan 29, 2026

View reviewed changes

OleksandrHladchenko1 requested a review from a team January 29, 2026 14:49

vashjs approved these changes Feb 2, 2026

View reviewed changes

NikitaSedyx reviewed Feb 4, 2026

View reviewed changes

UITEN-340 fix permissions for view/edit tenant locale

20e852b

BogdanDenis requested a review from NikitaSedyx February 4, 2026 13:12

BogdanDenis added 2 commits February 11, 2026 13:49

UITEN-340 use settings/entries endpoint as a backup for Locale settings

9bf92df

UITEN-340 added tests

afc04ce

BogdanDenis changed the title ~~UITEN-340 *BREAKING* Use locale API to fetch and update tenant locale settings.~~ UITEN-340 Use locale API to fetch and update tenant locale settings. Feb 11, 2026

BogdanDenis added 4 commits February 11, 2026 15:03

Merge remote-tracking branch 'origin/master' into UITEN-340

691e5b4

UITEN-340 use mod-configurations as a back-up for tenant locale

7701f84

Merge remote-tracking branch 'origin/UITEN-340' into UITEN-340

862cc28

UITEN-340 update tests

454e3aa

Dmytro-Melnyshyn reviewed Feb 19, 2026

View reviewed changes

zburke reviewed Feb 19, 2026

View reviewed changes

zburke approved these changes Feb 19, 2026

View reviewed changes

BogdanDenis added 2 commits February 20, 2026 11:36

UITEN-340 export Locale as default

35e00bf

Merge remote-tracking branch 'origin/master' into UITEN-340

9b7d58c

Dmytro-Melnyshyn approved these changes Feb 20, 2026

View reviewed changes

Merge branch 'master' into UITEN-340

524f478

BogdanDenis merged commit 7fb6b18 into master Feb 24, 2026
15 checks passed

BogdanDenis deleted the UITEN-340 branch February 24, 2026 11:00

		// for some reason react-query returns isLoading as true even for disabled queries...this is an expected behaviour according to them
		// so we need to also check for a present interface to not have false positives

Comments

Conversation

BogdanDenis commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Approach

Issues

Related PRs

Uh oh!

github-actions bot commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Jest Unit Test Results

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SerhiiNosko commented Feb 19, 2026

Uh oh!

zburke commented Feb 19, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sonarqubecloud bot commented Feb 24, 2026

Quality Gate passed

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

BogdanDenis commented Jan 26, 2026 •

edited

Loading

github-actions bot commented Jan 26, 2026 •

edited

Loading