.. include:: /Includes.rst.txt

.. _pitfalls:

========
Pitfalls
========

.. _wrong-entry-point:

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:

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:

.. code-block:: php

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

.. _embedding-images-with-basic-auth:

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):

.. code-block:: php

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

.. _jumpurl-error-messages:

Jumpurl Error Messages
----------------------

The current version of jumpurl found in ter (8.0.3) has some php 8 issues:

*   https://github.com/FriendsOfTYPO3/jumpurl/issues/33
*   https://github.com/FriendsOfTYPO3/jumpurl/issues/36
*   https://github.com/FriendsOfTYPO3/jumpurl/issues/37

There is already a pending pull request, which unfortunately stuck in that state
since a while:

*   https://github.com/FriendsOfTYPO3/jumpurl/pull/35

To help your self out, you could download the zip of the pull request repo, which
contains the necessary fixes under this url:

*   https://github.com/woodyc79/jumpurl_t3v11/archive/refs/heads/master.zip

After downloading, rename the master.zip to jumpurl_8.0.3.zip and upload it within
the extension manager.