Get language settings from backend (#7125)

Co-authored-by: Steve Piercy <[email protected]>
Co-authored-by: Piero Nicolli <[email protected]>

Author: 3 people

docs/source/configuration/environmentvariables.md

@@ -186,7 +186,17 @@ You can also generate builds on your continuous integration, then deploy them an
     ```
 
 `SITE_DEFAULT_LANGUAGE`
-    This is a runtime environment variable that sets the `config.settings.defaultLanguage`, allowing you to specify the default language of a site. It needs to match the default language that is configured in the backend's Language control panel.
+    ```{versionremoved} Volto 19
+    This environment variable was removed in Volto 19.
+    Instead, Volto uses the default language configured in the backend.
+    ```
+
+    ```{seealso}
+    See {ref}`multilingual configuration in Volto <multilingual-volto-configuration-label>`.
+    ```    
+
+    This is a runtime environment variable that sets the `config.settings.defaultLanguage`, allowing you to specify the default language of a site.
+    It needs to match the default language that is configured in the backend's {guilabel}`Language` control panel in {guilabel}`Site Setup`.
 
     ```shell
     SITE_DEFAULT_LANGUAGE=ca pnpm start

docs/source/configuration/how-to.md

@@ -46,9 +46,6 @@ You must provide a function as default export in your `src/config.js`:
 export default function applyConfig(config) {
   config.settings = {
     ...config.settings,
-    isMultilingual: true,
-    supportedLanguages: ['en', 'de'],
-    defaultLanguage: 'de',
     navDepth: 3,
   };
 

docs/source/configuration/multilingual.md

@@ -14,9 +14,30 @@ It is included with Plone 5 and later.
 You can enable it through the {guilabel}`Add-ons` control panel in the administrative interface.
 
 
+
+(multilingual-volto-configuration-label)=
+
 ## Volto configuration
 
-You need to enable multilingual in Volto's configuration object.
+Multilingual configuration in Volto depends on its version.
+
+### Volto 19 and later
+
+In Volto 19 and later, both the default language and available languages are defined in the Plone site configuration.
+A site administrator can configure these values in the {guilabel}`Languages` control panel in {guilabel}`Site Setup`.
+A developer can configure them using GenericSetup.
+
+```{versionchanged} Volto 19
+Use multilingual configuration from the backend, instead of Volto config settings for the frontend.
+```
+
+### Volto 18 and earlier
+
+```{versionremoved} Volto 19
+The environment variable `SITE_DEFAULT_LANGUAGE` was removed in Volto 19.
+```
+
+In Volto 18 and earlier, enable the multilingual feature in Volto's configuration settings.
 
 ```js
 import config from '@plone/volto/registry'

docs/source/configuration/settings-reference.md

@@ -487,13 +487,37 @@ showRelatedItems
     ```{versionadded} 18.5.0
     ```
 
-
 showTags
     If true, the `Tags` component will show tags from the `subjects` field. Default: true.
 
+isMultilingual
+    If `true`, features for translating content to multiple languages are available.
+    Default: `false`.
+
+    ````{versionremoved} Volto 19
+    This setting was removed in Volto 19.
+    Instead, Volto checks whether the backend has multilingual features enabled.
+    
+    ```{seealso}
+    See {ref}`multilingual configuration in Volto <multilingual-volto-configuration-label>`.
+    ```
+    ````
 
 defaultLanguage
-    Defines the default language of the site.
+    Sets the default language of the site.
+
+    ````{versionremoved} Volto 19
+    This setting was removed in Volto 19.
+    Instead, the default language is loaded from the backend.
+
+    ```{seealso}
+    See {ref}`multilingual configuration in Volto <multilingual-volto-configuration-label>`.
+    ```
+    ````
+
+supportedLanguages
+    A list of locales which are included in the bundled code.
+
 ```
 
 ## Views settings

docs/source/contributing/acceptance-tests.md

@@ -147,8 +147,6 @@ You can modify the main Volto settings on the fly.
 
 ```js
 cy.settings().then(settings => {
-  settings.defaultLanguage = 'de';
-  settings.isMultilingual = true;
   settings.supportedLanguages = ['de', 'en'];
 });
 ```

docs/source/upgrade-guide/index.md

@@ -64,6 +64,13 @@ These packages have been removed from the Volto repository as they are no longer
 - `@plone/volto-guillotina`: No longer actively maintained
 - `@plone/volto-testing`: Testing functionality is now integrated directly in Volto core
 
+### Removed language settings
+```{versionremoved} Volto 19
+```
+
+The `defaultLanguage` and `isMultilingual` settings have been removed.
+Instead, these values are fetched from the backend API.
+The `supportedLanguages` setting now only controls which locales are included in the build.
 
 (upgrading-to-volto-18-x-x)=
 
@@ -2101,7 +2108,6 @@ import config from '@plone/volto/registry'
 ...
 
 console.log(config.settings.apiPath)
-config.settings.isMultilingual = true
 ...
 ```
 
@@ -2218,9 +2224,6 @@ Let's show it in an example. Let's say you have this config in your project's `s
 ```js
 export const settings = {
   ...defaultSettings,
-  isMultilingual: true,
-  supportedLanguages: ['en', 'de'],
-  defaultLanguage: 'de',
   navDepth: 3,
 };
 ```
@@ -2231,9 +2234,6 @@ then you'll add the `applyConfig()` function as default export and copy that set
 export default function applyConfig(config) {
   config.settings = {
     ...config.settings,
-    isMultilingual: true,
-    supportedLanguages: ['en', 'de'],
-    defaultLanguage: 'de',
     navDepth: 3,
   };
   return config;
@@ -2325,9 +2325,6 @@ showing in the diff the default ones, you should have your configuration inside
 ```js
 export const settings = {
   ...defaultSettings,
-  isMultilingual: true,
-  supportedLanguages: ['en', 'de'],
-  defaultLanguage: 'de',
   navDepth: 3,
 };
 ```
@@ -2363,9 +2360,6 @@ the end of `src/config.js`:
 +function applyConfig(config) {
 +  config.settings = {
 +    ...config.settings,
-+    isMultilingual: true,
-+    supportedLanguages: ['en', 'de'],
-+    defaultLanguage: 'de',
 +    navDepth: 3,
 +  };
 ```

packages/coresandbox/src/index.ts

@@ -174,7 +174,6 @@ const listing = (config: ConfigType) => {
 };
 
 export const multilingualFixture = (config: ConfigType) => {
-  config.settings.isMultilingual = true;
   config.settings.supportedLanguages = ['en', 'it'];
 
   return config;

packages/types/news/7125.bugfix

@@ -0,0 +1 @@
+Removed the `isMultilingual` and `defaultLanguage` settings. @davisagli

packages/types/src/config/Settings.d.ts

@@ -52,9 +52,7 @@ export interface SettingsConfig {
   openExternalLinkInNewTab: boolean;
   notSupportedBrowsers: string[];
   defaultPageSize: number;
-  isMultilingual: boolean;
   supportedLanguages: string[]; // TODO: Improve list of possible values
-  defaultLanguage: string;
   navDepth: number;
   expressMiddleware: unknown;
   defaultBlockType: string; // TODO: Improve list of possible values