https://github.com/plan2net/link-alchemy
Rewrite absolute URLs that point to internal pages/files, converting them to internal TYPO3 URLs
https://github.com/plan2net/link-alchemy
typo3 typo3-extension
Last synced: 7 months ago
JSON representation
Rewrite absolute URLs that point to internal pages/files, converting them to internal TYPO3 URLs
- Host: GitHub
- URL: https://github.com/plan2net/link-alchemy
- Owner: plan2net
- License: gpl-2.0
- Created: 2024-09-24T11:39:00.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-21T09:19:01.000Z (7 months ago)
- Last Synced: 2025-12-23T02:12:16.036Z (7 months ago)
- Topics: typo3, typo3-extension
- Language: PHP
- Homepage:
- Size: 53.7 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TYPO3 Extension `link_alchemy`
## 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:
```bash
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**: `Link`
- **After**: `Link`
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](https://github.com/georgringer)'s uri2link extension that only transforms TCA `type=link` fields.