[FEATURE] Add "auto" absRefPrefix option
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Feature-58366-AutomaticAbsRefPrefix.rst
1 ===========================================================
2 Feature: #58366 - Add "auto" Option for config.absRefPrefix
3 ===========================================================
4
5 Description
6 ===========
7
8 The TypoScript setting config.absRefPrefix can be used to allow URL rewriting like URL giving a hard
9 prefix for all relative paths. As an alternative to config.baseURL to be set to a specific domain
10 absRefPrefix can autodetect the site root and use that instead of manually setting this option.
11
12 Frontend:
13
14 The new option can be set like this:
15
16 .. code-block:: typoscript
17
18 config.absRefPrefix = auto
19
20 instead of hardcoded values for different environments or when moving installations in subfolders.
21
22 .. code-block:: typoscript
23
24 [ApplicationContext = Production]
25 config.absRefPrefix = /
26
27 [ApplicationContext = Testing]
28 config.absRefPrefix = /my_site_root/
29
30 As the feature only works with path prefixes, and not with host name variables from the server,
31 the new option is also safe for multi-domain environments to avoid duplicate caching mechanism.
32
33
34 Impact
35 ======
36
37 The new special option can be used to automatically set up installations and distributions like
38 the Introduction Package where a site configuration is shipped with the system but might need
39 to be adjusted.