Download the PHP package plan2net/link-alchemy without Composer
On this page you can find all versions of the php package plan2net/link-alchemy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download plan2net/link-alchemy
More information about plan2net/link-alchemy
Files in plan2net/link-alchemy
Package link-alchemy
Short Description Rewrite absolute URLs that point to internal pages/files, converting them to internal TYPO3 URLs
License GPL-2.0-or-later
Homepage https://www.plan2.net/
Informations about the package link-alchemy
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:
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.