TYPO3 Logo
TYPO3 Core Changelog
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

TYPO3 Core Changelog

  • ChangeLog v14
    • 14.0 Changes
    • 14.x Changes by type
  • ChangeLog v13
    • 13.4.x Changes
    • 13.4 Changes
    • 13.3 Changes
    • 13.2 Changes
    • 13.1 Changes
    • 13.0 Changes
    • 13.x Changes by type
  • ChangeLog v12
    • 12.4.x Changes
    • 12.4 Changes
    • 12.3 Changes
    • 12.2 Changes
    • 12.1 Changes
    • 12.0 Changes
    • 12.x Changes by type
  • ChangeLog v11
    • 11.5.x Changes
    • 11.5 Changes
    • 11.4 Changes
    • 11.3 Changes
    • 11.2 Changes
    • 11.1 Changes
    • 11.0 Changes
    • 11.x Changes by type
  • ChangeLog v10
    • 10.4.x Changes
    • 10.4 Changes
    • 10.3 Changes
    • 10.2 Changes
    • 10.1 Changes
    • 10.0 Changes
    • 10.x Changes by type
  • ChangeLog v9
    • 9.5.x Changes
    • 9.5 Changes
    • 9.4 Changes
    • 9.3 Changes
    • 9.2 Changes
    • 9.1 Changes
    • 9.0 Changes
    • 9.x Changes by type
  • ChangeLog v8
    • 8.7.x Changes
    • 8.7 Changes
    • 8.6 Changes
    • 8.5 Changes
    • 8.4 Changes
    • 8.3 Changes
    • 8.2 Changes
    • 8.1 Changes
    • 8.0 Changes
    • 8.x Changes by type
  • ChangeLog v7
    • 7.6.x Changes
    • 7.6 Changes
    • 7.5 Changes
    • 7.4 Changes
    • 7.3 Changes
    • 7.2 Changes
    • 7.1 Changes
    • 7.0 Changes
    • 7.x Changes by type
  • Documenting Changes
  • Sitemap
  1. TYPO3 Core Changelog
  2. ChangeLog v9
  3. 9.4 Changes
  4. Feature: #86057 - Improved typolink / URL link generation
Give feedback Edit on GitHub

Feature: #86057 - Improved typolink / URL link generation

See forge#86057

Description

With new site-based handling, the de-facto standard GET parameter "L" (for language) became obsolete.

Instead, in order to create a link to a specific language via TypoScript's typolink functionality, a new parameter typolink.language is introduced.

page.10 = TEXT
page.10.value = Link to the page with the ID in the current language
page.10.typolink.parameter = 23
page.20 = TEXT
page.20.value = Link to the page with the ID in the language 3
page.20.typolink.parameter = 23
page.20.typolink.language = 3
Copied!

Omitting the parameter language will use the current language. If a page is not available in the requested language, the link will not be generated, however a fallback to the default language can be built, as the HMENU TypoScript functionality does.

Due to the new page-linking functionality, the following TypoScript settings are not necessary anymore and should be removed for TypoScript configurations on page trees with a site configuration:

  • Including the "L" parameter in config.linkVars, as the L parameter is not evaluated for page requests with a site configuration.
  • config.absRefPrefix is only necessary for links to files or images, but not for page links, as they are always built against the absolute path, or - if typolink.forceAbsoluteUrl is explicitly set. The option is set to auto by default for site configuration TypoScripts, so this is not necessary anymore in regular installations.
  • One of the major strengths allows to link across sites / domains with specifically knowing all available languages of a different page tree. Using the config.typolinkEnableLinksAcrossDomains is not necessary anymore for TypoScript within a site configuration.

Impact

When using typolink.additionalParams = &L=1, this is automatically mapped to the typolink.language parameter, but if both are set, the typolink.language option takes precedence.

When generating links with &L= query parameters, this parameter is stripped, and the correct base URL for the site is fetched, and the query parameter is not added anymore.

By setting the target page ID via typolink.parameter it is also possible to set the page ID to a localized page ID, automatically resolving to the correct language if neither typolink.parameter nor typolink.additionalParams = L= is set.

  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: Jun 06, 2025 06:00

© since 1997 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy