Deprecation-65934-PrefixLocalAnchorsMovedToLegacyExtension.rst 1.41 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

.. include:: ../../Includes.txt

====================================================================================
Deprecation: #65934 - "Prefix Local Anchors" functionality moved to legacy extension
====================================================================================

See :issue:`65934`

Description
===========

Prefixing local anchors is not considered best practice in web sites anymore as the same is achieved with
absolute prefixes for links (see `config.absRefPrefix`). Therefore the according functionality has been moved to
the legacy extension EXT:compatibility6.

The following TypoScript option has been marked for deprecation:

19
.. code-block:: typoscript
20

21
   config.prefixLocalAnchors
22
23
24
25
26

The following PHP methods have been marked for deprecation:

.. code-block:: php

27
28
   TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController::prefixLocalAnchorsWithScript()
   TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController::doLocalAnchorFix()
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47


Impact
======

The content output of the TYPO3 frontend is not prefixed with local anchors anymore unless EXT:compatibility6 is loaded.


Affected installations
======================

Any installation having the TypoScript option `config.prefixLocalAnchors` set will have different behaviour in the
frontend rendering.


Migration
=========

For TYPO3 CMS 7, installing EXT:compatibility6 brings back the existing functionality.
48
49
50


.. index:: TypoScript, Frontend