Files
cms-core/Documentation/Changelog/14.0/Breaking-104422-SeoParameterNamespace.rst

59 lines
1.6 KiB
ReStructuredText

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