[TASK] Deprecate ContentObjectRenderer->calcIntExplode()
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Important-85361-EXTrte_ckeditor-Re-addTheSoftHyphenButton.rst
1 .. include:: ../../Includes.txt
2
3 ====================================================================
4 Important: #85361 - EXT:rte_ckeditor - re-add the soft hyphen button
5 ====================================================================
6
7 See :issue:`85361`
8
9 Description
10 ===========
11
12 With the switch from htmlArea to CKEditor the soft hyphen button was gone. This functionality is now
13 re-added as custom CKEditor plugin.
14
15 It is loaded like each other existing CKEditor plugin in the TYPO3 core via
16 :file:`EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml`. It's automatically loaded in
17 the RTE presets "default" and "full". The shortcut `Ctrl` + `-` for adding a soft hyphen works
18 without showing the button in the CKEditor button bar.
19
20 Impact
21 ======
22
23 By using the shipped RTE presets "default" or "full", the functionality and the toolbar button is
24 automatically added to CKEditor toolbar. This helps the editor immensely to create better content for
25 the responsive web these days.
26
27 How to activate the functionality in a custom RTE preset
28 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
29
30 The functionality is automatically added if you are importing
31 :file:`EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml` in your custom RTE preset. If your
32 custom RTE preset can't rely on that file, you can explicitly import this plugin as shown:
33
34 .. code-block::
35
36    editor:
37      externalPlugins:
38        softhyphen:
39          resource: "EXT:rte_ckeditor/Resources/Public/JavaScript/Plugins/softhyphen/"
40          # set whether the shortcut for this plugin is activated or not
41          enableShortcut: true
42
43 How to add the button in a custom RTE preset
44 ''''''''''''''''''''''''''''''''''''''''''''
45
46 The button with the buttonName `softHyphen` of the plugin is assigned to a toolbarGroup named
47 `insertcharacters`. Based on how you like to configure the toolbar in your RTE preset you must either
48 use the toolbarGroup or the buttonName to display the button at the desired location in the toolbar.
49
50 Please take look into the supplied RTE presets to see working examples:
51 - :file:`EXT:rte_ckeditor/Configuration/RTE/Default.yaml`
52 - :file:`EXT:rte_ckeditor/Configuration/RTE/Full.yaml`
53
54 More information can be found in the official CKEditor 4 documentation (toolbar concepts):
55 - https://docs.ckeditor.com/ckeditor4/latest/guide/dev_toolbarconcepts.html
56
57 .. index:: RTE, ext:rte_ckeditor