[TASK] Mark several parts within RteHtmlParser as internal
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-86440-InternalMethodsAndPropertiesWithinRteHtmlParser.rst
1 .. include:: ../../Includes.txt
2
3 ==========================================================================
4 Deprecation: #86440 - Internal Methods and properties within RteHtmlParser
5 ==========================================================================
6
7 See :issue:`86440`
8
9 Description
10 ===========
11
12 The PHP class :php:`TYPO3\CMS\Core\Html\RteHtmlParser` hasn't been fully touched since the dawn
13 of PHP 5, and exposes all properties and methods has public, although these are fully configurable
14 and writable. Their visibility has been changed from public to protected, and some additional
15 functionality has been marked as deprecated, as this has been replaced with the new RTE configuration
16 since TYPO3 v8.
17
18 The following properties are marked as protected:
19 - :php:`blockElementList`
20 - :php:`recPid`
21 - :php:`elRef`
22 - :php:`tsConfig`
23 - :php:`procOptions`
24 - :php:`TS_transform_db_safecounter`
25 - :php:`getKeepTags_cache`
26 - :php:`allowedClasses`
27
28 The following public methods have changed visibility to protected:
29 - :php:`TS_images_db()`
30 - :php:`TS_links_db()`
31 - :php:`TS_transform_db()`
32 - :php:`TS_transform_rte()`
33 - :php:`HTMLcleaner_db()`
34 - :php:`getKeepTags()`
35 - :php:`divideIntoLines()`
36 - :php:`setDivTags()`
37 - :php:`getWHFromAttribs()`
38 - :php:`urlInfoForLinkTags()` (deprecated, not in use anymore)
39 - :php:`TS_AtagToAbs()`
40
41 The following processing options (`RTE.proc.`) have been deprecated.
42 - keepPDIVattribs
43 - dontRemoveUnknownTags_db
44
45
46 Impact
47 ======
48
49 Setting any of the option, calling the methods above or accessing the properties will trigger
50 a deprecation message.
51
52
53 Affected Installations
54 ======================
55
56 TYPO3 installations with extensions on custom usages for RTE handling (e.g. `l10nmgr`).
57
58
59 Migration
60 =========
61
62 Migrate to use the public API only and use other options (such as `allowAttributes` instead of
63 `dontRemoveUnknownTags_db`) in order to only run certain instructions on the RteHtmlParser object.
64
65 .. index:: RTE, FullyScanned