..  include:: /Includes.rst.txt
..  index:: Events; AfterLinkResolvedByStringRepresentationEvent
..  _AfterLinkResolvedByStringRepresentationEvent:

============================================
AfterLinkResolvedByStringRepresentationEvent
============================================

..  versionadded:: 13.0
    This event has been introduced as a more powerful replacement for the
    removed hook
    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['Link']['resolveByStringRepresentation']`.

The PSR-14 event :php:`\TYPO3\CMS\Core\LinkHandling\Event\AfterLinkResolvedByStringRepresentationEvent`
is being dispatched after the :php:`\TYPO3\CMS\Core\LinkHandling\LinkService`
has tried to resolve a given `t3://` :abbr:`URN (Uniform Resource Name)` using
defined :ref:`link handlers <linkhandler>`.

The event can not only be used to resolve custom link types, but also to modify
the link result data of existing link handlers. Additionally, it can be used to
resolve situations where no handler could be found for a `t3://` URN.

..  note::
    The event is always dispatched, even if a handler successfully resolved
    the URN and also even in cases, TYPO3 would have thrown the
    :php:`\TYPO3\CMS\Core\LinkHandling\Exception\UnknownLinkHandlerException`
    exception.



Example
=======

..  literalinclude:: _AfterLinkResolvedByStringRepresentationEvent/_MyEventListener.php
    :language: php
    :caption: EXT:my_extension/Classes/LinkHandling/EventListener/MyEventListener.php

..  include:: /_includes/EventsAttributeAddedNew.rst.txt

API
===

..  include:: /CodeSnippets/Events/Core/LinkHandling/AfterLinkResolvedByStringRepresentationEvent.rst.txt