Pitfalls 

Wrong Entry Point 

This extension needs an entry point with a protokoll and domain to proper fetch internal pages.

An entry point with just a slash ("/") will not work!

This value can be set here "Sites Module" > "Edit site" > "General" > "Entry Point".

If you e.g. use the introduction package, this value is set to "/" by default!

Self Signed Certificates 

If you use a self signed certificate, you should also check, that "HTTP" > "verify" is set to "0".

This can be done under "Admin Tools" > "Settings" > "Configure Installation Wide Options" > Filter by "verify" > enter "0" > Press "Write configuration"

The same setting can be done by adding this to the (additional) settings.php:

$GLOBALS['TYPO3_CONF_VARS']['HTTP'][GuzzleHttp\RequestOptions::VERIFY] = false;

Embedding Images & Basic Auth 

If your system is protected by basic auth (e.g. because it's a staging system) you can set HTTP username and password in the mail wizard settings.

This will add the Guzzle "auth" option to the MailerUtility::fetchContentFromUrl method, which enables MAIL to fetch the html code for the mail wizard preview.

If you also activate image embedding, the basic auth credentials has to be add at a second place to enable the MAIL Service, which runs in a different context (CLI), to fetch the images as well.

To do so, add this to the (additional) settings.php of the Basic Auth Protected system (e.g. staging):

$GLOBALS['TYPO3_CONF_VARS']['HTTP'][GuzzleHttp\RequestOptions::AUTH] = ['username', 'password'];

Jumpurl and TYPO3 14.3 LTS 

At the time of writing this documentation there was no TYPO3 14.3 LTS compatible (TER) or tagged (github) version of jumpurl.

To use the current master, which works at least for TYPO3 14.3 and MAIL 4, you have to change your composer.json slighly.

Instead of using the current version 9 like so:

"require": {
    "friendsoftypo3/jumpurl": "^9"
}

you need to change the version contraint to:

"require": {
    "friendsoftypo3/jumpurl": "dev-master"
}

After this change you have to make a "composer update".

If you do not use composer, you can download a zip file of the current master here:

https://github.com/FriendsOfTYPO3/jumpurl/archive/refs/heads/master.zip

After downloading upload it inside the TYPO3 Extension Management Backend Modul.