[BUGFIX] Respect GET parameters when generating canonicalized URLs
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Important-86577-QueryParametersAreNowIncludedInCanonicalizedUrls.rst
1 .. include:: ../../Includes.txt
2
3 ===========================================================================
4 Important: #86577 - Query parameters are now included in canonicalized URLs
5 ===========================================================================
6
7 See :issue:`86577`
8
9 Description
10 ===========
11
12 Canonicalized URLs include all query parameters which are needed to define what content to show
13 on a page. These URLs are used for the canonical URL and the hreflang URLs.
14 This is especially important with for example detail pages of records. The query parameters are 
15 crucial to show the right content.
16
17 Possibility to define query parameters to be included in canonicalized URLs
18 ---------------------------------------------------------------------------
19
20 By default only parameters that are needed to calculate the cHash are included in the
21 canonicalized URLs. If you want to add your own parameters that should be included in those
22 URLs, you can use the newly introduced configuration option
23 :php:`$GLOBALS['TYPO3_CONF_VARS']['FE']['additionalCanonicalizedUrlParameters']`. You can add
24 your own query parameters by adding them as elements of the array.
25
26 An example:
27
28 .. code-block:: php
29
30    $GLOBALS['TYPO3_CONF_VARS']['FE']['additionalCanonicalizedUrlParameters'] => [
31        'queryParam1',
32        'queryParam2',
33    ]
34
35 This example will add query parameters `queryParam1` and `queryParam2` to the canonicalized
36 URLs if they are provided.
37
38 .. important::
39
40     Be careful when adding your own parameters. Only add those parameters which will change the
41     content of your page. Otherwise search engines will most likely indicate your pages as
42     duplicate content.
43
44 .. index:: ext:seo, ext:frontend, PHP-API