..  include:: /Includes.rst.txt
..  index:: Events; BeforeTypoLinkEncodedEvent
..  _BeforeTypoLinkEncodedEvent:

==========================
BeforeTypoLinkEncodedEvent
==========================

..  versionadded:: 13.0
    This event has been introduced to avoid :ref:`extending/XCLASSing <xclasses>`
    the :php:`\TYPO3\CMS\Core\LinkHandling\TypoLinkCodecService`.
    Extending/XCLASSing no longer works since TYPO3 v13, as the
    :php:`TypoLinkCodecService` has been declared as :php:`final` and
    :php:`readonly`.

The PSR-14 event :php:`\TYPO3\CMS\Core\LinkHandling\Event\BeforeTypoLinkEncodedEvent`
allows developers to fully manipulate the encoding of
:ref:`TypoLinks <t3tsref:typolink>`.

A common use case for extensions is to extend the TypoLink parts to allow
editors adding additional information, for example, custom attributes can be
inserted to the link markup.

..  seealso::
    :ref:`AfterTypoLinkDecodedEvent`

Example
=======

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

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

API
===

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