Skip to content

Commit 437c07f

Browse files
authored
[TASK] Update page based routing page (#5401)
Releases: main, 13.4
1 parent 6506b6f commit 437c07f

File tree

1 file changed

+20
-26
lines changed

1 file changed

+20
-26
lines changed
Lines changed: 20 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,30 @@
1-
:navigation-title: Page based
1+
:navigation-title: Page-based Routing
2+
23
.. include:: /Includes.rst.txt
3-
.. index:: Routing; Page based
4+
5+
.. index:: Routing; Page-based
46
.. _routing-page-based-routing:
57

68
==================
7-
Page based Routing
9+
Page-based routing
810
==================
911

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.
2414

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.
2519

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.
3023

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.
3328

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

Comments
 (0)