|
1 | | -:navigation-title: Page based |
| 1 | +:navigation-title: Page-based Routing |
| 2 | + |
2 | 3 | .. include:: /Includes.rst.txt |
3 | | -.. index:: Routing; Page based |
| 4 | + |
| 5 | +.. index:: Routing; Page-based |
4 | 6 | .. _routing-page-based-routing: |
5 | 7 |
|
6 | 8 | ================== |
7 | | -Page based Routing |
| 9 | +Page-based routing |
8 | 10 | ================== |
9 | 11 |
|
10 | | -TYPO3 allows page based routing (that is mapping pages to routes) out of the box. |
11 | | - |
12 | | -Configuration |
13 | | -============= |
14 | | - |
15 | | -To enable page based routing, add a site configuration (see :ref:`sitehandling`) for your web site. |
16 | | -To see which route gets mapped to which page, open the page properties and look at the `slug` field. |
17 | | - |
18 | | -.. hint:: |
19 | | - To enable editors to change the slug (or update the slug when they change the page title for example) make sure that your |
20 | | - editor groups have access to the `slug` field. |
21 | | - |
22 | | -How a page slug is generated is configured via TCA configuration of the pages table (field `slug`). You can adjust that configuration |
23 | | -in your extensions' :file:`TCA/Overrides/pages.php`. See TCA reference (see :ref:`t3tca:columns-slug` for available options). |
| 12 | +TYPO3 provides built-in support for page-based routing, mapping pages to |
| 13 | +routes automatically. |
24 | 14 |
|
| 15 | +Page-based routing is always enabled in TYPO3 and requires a site |
| 16 | +configuration (see :ref:`sitehandling`) for your website. Each page's route |
| 17 | +is determined by its `slug` field, which can be viewed in the page |
| 18 | +properties. |
25 | 19 |
|
26 | | -.. index:: |
27 | | - Routing; Upgrade |
28 | | - RealURL |
29 | | - see: RealURL; Routing |
| 20 | +.. hint:: |
| 21 | + Ensure that editors have the necessary permissions to modify the `slug` |
| 22 | + field if they need to change or update slugs when modifying page titles. |
30 | 23 |
|
31 | | -Upgrading |
32 | | -========= |
| 24 | +The generation of page slugs is controlled via the TCA configuration of the |
| 25 | +`pages` table (`slug` field). This configuration can be customized in your |
| 26 | +extension’s :file:`TCA/Overrides/pages.php`. Refer to the TCA reference |
| 27 | +(:ref:`t3tca:columns-slug`) for available options. |
33 | 28 |
|
34 | | -An upgrade wizard has been provided that will take care of generating slugs for all existing pages. If you used RealURL before, the |
35 | | -wizard tries to use the RealURL caches to generate matching slugs. However, this will not be successful in all cases and you should |
36 | | -recheck the generated slugs if you want the URL structure to stay the same after an upgrade. |
| 29 | +If the system extension :composer:`typo3/cms-redirects` is installed, |
| 30 | +redirects are automatically generated when a slug is adjusted by and editor. |
0 commit comments