plan2net/link-alchemy

Rewrite absolute URLs that point to internal pages/files, converting them to internal TYPO3 URLs

13.1.0 2025-10-23 11:20 UTC

Requires

• php: >=8.1
• typo3/cms-core: ^12.4 || ^13.4

Requires (Dev)

• ergebnis/composer-normalize: ^2.48
• friendsofphp/php-cs-fixer: ^3
• slevomat/coding-standard: ^8
• squizlabs/php_codesniffer: ^3
• typo3/testing-framework: *
• vimeo/psalm: ^5

GPL-2.0-or-later

• extension
• link
• typo3
• rte
• internal-urls

README

What does it do?

The link_alchemy extension rewrites external links in TCA type=link and RTE text fields that refer to internal TYPO3 pages or files. These links are converted to internal TYPO3 links (t3://page..., t3://file...).

Installation and configuration

To install the extension, use Composer:

composer require plan2net/link-alchemy

No configuration is required. The extension automatically hooks into the DataHandler for TCA fields and into the RTE content transformation process.

Compatibility

Versions 12.0.0 and higher are compatible with the corresponding TYPO3 versions.

If you already overwrite the class RteHtmlParser in your project, you may need to adjust the XCLASS configuration in ext_localconf.php.

Usage

The extension automatically hooks into the RTE content transformation process. No additional setup is required. When RTE content is processed, external links that refer to internal pages or files will be rewritten to use TYPO3's internal link format.

Example

Here is an example of how the extension transforms a link in an RTE text field:

• Before: <a href="https://example.com/internal-page">Link</a>
• After: <a href="t3://page?uid=123">Link</a>

This ensures that links are correctly handled within the TYPO3 CMS environment, providing better integration and consistency.

Internals

Plan2net\LinkAlchemy\Xclass\RteHtmlParser

This class extends the core RteHtmlParser to include custom transformations for internal links.

Plan2net\LinkAlchemy\Hooks\DataHandlerHook

This class handles the transformation of internal links within TCA type=link fields.

Plan2net\LinkAlchemy\RteTransformation\InternalLinkTransformation

This class handles the transformation of internal links within the RTE content.

Plan2net\LinkAlchemy\Service\UrlParser

This class parses the urls to internal links.

TODO

• Unit-Tests for UrlParser

Acknowledgements

This extension was inspired by Georg Ringers's uri2link extension that only transforms TCA type=link fields.