Breaking: #98488 - Typolink option "addQueryString" only includes resolved query arguments¶

Description¶

The Typolink option typolink.addQueryString previously set all given GET parameters to a generated URL that were handed in to the request.

This option is also used under the hood for the Fluid ViewHelpers <f:link.typolink>, <f:uri.typolink>, <f:link.page>, <f:uri.page>, <f:link.action>, <f:link.action> and <f:form>.

With TYPO3 v9 and routing, this option now only adds the query arguments that have been resolved during the routing process. This way, additional query arguments are never added by default.

Impact¶

Setting typolink.addQueryString = 1 now adds only arguments resolved by Route Enhancers, any other query arguments are rejected.

As a consequence, arbitrary query arguments are not reflected in the canonical link reference anymore. Declaring corresponding route definitions is required to have those values reflected again.

Affected installations¶

TYPO3 installations relying on typolink.addQueryString.

Migration¶

It is recommended to keep the setting as is, as TYPO3 can identify valid query arguments via Routing.

However, to ensure the previous behaviour, the option typolink.addQueryString can be set to untrusted to add all given.

The same value is also possible for the Fluid ViewHelpers <f:link.typolink>, <f:uri.typolink>, <f:link.page>, <f:uri.page>, <f:link.action>, <f:link.action> and <f:form>.