[FEATURE] Add Upgrade Wizard to migrate to pagepath segment for pages
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Feature-85928-UpgradeWizardToMigratePagesToSpeakingURLs.rst
1 .. include:: ../../Includes.txt
2
3 ==================================================================
4 Feature: #85928 - Upgrade wizard to migrate pages to speaking URLs
5 ==================================================================
6
7 See :issue:`85928`
8
9 Description
10 ===========
11
12 TYPO3 now supports "Speaking URLs" for pages, and in order to fully make use of this feature, an
13 upgrade wizard builds up the URL segment (pagepath) for all pages that do not have a value
14 set already.
15
16 In order to ease the pain when upgrading from previous versions that supported RealURL,
17 the upgrade wizard checks for additional tables "tx_realurl_pathcache" (realurl v1) and
18 "tx_realurl_pathdata" (realurl v2+) if they exist in the database, to fill the page paths based
19 on these values - however they will get sanitized to match the slug layout with a prefixed "/".
20
21 Pages that contain value in their "alias" database field, this takes priority over "regular" pages
22 and values from RealURL, whereas alias fields will result in a slug like "/my-alias-value".
23
24
25 Impact
26 ======
27
28 After running the upgrade wizard, it is possible to use all of the speaking URL functionality for
29 all pages that support a site configuration.
30
31 The upgrade wizard also runs through all pages that do not have a site configuration yet, in
32 order to ensure consistent state throughout the database. It is encouraged to create a site
33 configuration for a pagepath before running this upgrade wizard.
34
35 Please take note that running the upgrade wizard does not migrate a previously configured RealURL
36 project fully to the new structure. It only eases the migration, but the full migration depends
37 on many more previous URL generation configurations used.
38
39 Also: if `simulate_static`, `realurl` or `cooluri` or any other extension for URL rewriting was
40 used, it is highly possible that pages are now available under different URLs than before.
41
42 .. index:: Database