[BUGFIX] Ensure manually updated slug is saved correctly
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.0 / Breaking-72826-RemovedCustomCharsetConfigurationForLocales.rst
1
2 .. include:: ../../Includes.txt
3
4 ===================================================================
5 Breaking: #72826 - Removed custom charset configuration for locales
6 ===================================================================
7
8 See :issue:`72826`
9
10 Description
11 ===========
12
13 The TYPO3 Frontend resolved the TypoScript option `config.locale_all` and stored the charset part within
14 `$TSFE->localeCharset`. If the option `locale_all` did not provide a charset (e.g. when it is set to `de_AT`
15 instead of `de_AT.UTF-8` a "best guess" was done based on a static list set up in 2004.
16
17 The option `$TSFE->localeCharset` has been removed, along with the following calculation options and methods
18 available in the CharsetConverter class:
19
20     * CharsetConverter->lang_to_script
21     * CharsetConverter->script_to_charset_unix
22     * CharsetConverter->script_to_charset_windows
23     * CharsetConverter->locale_to_charset
24     * CharsetConverter->get_locale_charset()
25
26 The localeCharset option was solely used within the TypoScript functionality `stdWrap.strftime` when no
27 custom character set was given, and a character set conversion from the "localeCharset" (based on the best guess
28 or explicitly set via `config.locale_all = de_AT.UTF-8` and it was different than the renderCharset option of
29 the TYPO3 Frontend.
30
31
32 Impact
33 ======
34
35 When custom locales are configured in TypoScript which are not present on the server, or the character set of
36 `config.locale_all` differs from the `config.renderCharset`, or `config.locale_all` does not set a character set,
37 could lead to unexpected output in the TYPO3 Frontend.
38
39
40 Affected Installations
41 ======================
42
43 Instances which have a different `config.locale_all` character set given than set via `config.renderCharset`, or on
44 servers that don't have the charset of the locale available but the output should be a certain but not given character set.
45
46
47 Migration
48 =========
49
50 As this is a misconfiguration and only necessary if e.g. can not handle UTF-8 locales, `config.set_locale` can explicitly
51 be set to `de_AT@iso-8859-15` and the output should be renderCharset. On instances where `stdWrap.strftime`is used,
52 the subproperty `charset` can be set to the custom character set (e.g. `iso-8859-15`).
53
54 In each case, it should be configured that the `config.locale_all` option should have a character set given, to avoid
55 any side-effects with the TypoScript stdWrap option `strftime`.
56
57 .. index:: PHP-API, TypoScript, Frontend