..  include:: /Includes.rst.txt

..  _breaking-104422-1721646316:

================================================================
Breaking: #104422 - Move GET parameters in sitemap into namespace
================================================================

See :issue:`104422`

Description
===========

The names of the GET parameters used in the sitemap generated by EXT:seo have
been changed from `page` and `sitemap` to `tx_seo[page]` and `tx_seo[sitemap]`,
respectively.

Impact
======

Applications, routing configurations, and third-party tools that rely on the
parameters being named `page` and `sitemap` will break.

Affected installations
======================

This affects installations that use the arguments `page` and `sitemap` or
override the sitemap templates of EXT:seo.

Migration
=========

If the arguments are mapped in the routing configuration, the code needs to
be slightly adapted. A working example:

..  code-block:: yaml

    routeEnhancers:
      Sitemap:
        type: Simple
        routePath: 'sitemap-type/{sitemap}'
        aspects:
          sitemap:
            type: StaticValueMapper
            map:
              pages: pages
              tx_news: tx_news
              my_other_sitemap: my_other_sitemap
        _arguments:
          sitemap: 'tx_seo/sitemap'

If the templates in `EXT:seo/Resources/Private/Templates/XmlSitemap/Index.xml`
have been modified, adjust the generated links to match the original ones.

If the URL to a single sitemap has been provided to a third-party tool such as
a crawler or search engine, it must be re-added using the new URL.

..  index:: Frontend, ext:seo, NotScanned
