kitzberger/rte-ckeditor-dl

TYPO3 CKEditor Rich Text Editor: Definition lists

2.0.0 2025-07-22 15:54 UTC

Requires

• typo3/cms-core: ^12.4 || ^13.4

GPL-2.0-or-later

• TYPO3 CMS

README

A simple wrapper extension to ckeditor5-definitionlist into TYPO3's default editor ckeditor 5.

Installation

• composer require kitzberger/rte-ckeditor-dl
• Install extension via extension manager in the backend

Load PageTS

Simply load the RTE configuration default+dl provided by this extension via PageTS to the root page of your page tree. This'll set the default RTE configuration enhanced by this plugin as a default for all RTEs in that page tree.

Custom RTE config

Alternatively to enabling the default+dl configuration you can create your own RTE configuration and simply import the yaml file as described below.

EXT:custom/ext_localconf.php

$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['custom'] = 'EXT:custom/Configuration/RTE/Default.yaml';

EXT:custom/Configuration/RTE/Default.yaml

# Load default processing options + the dl plugin
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml" }
  - { resource: "EXT:rte_ckeditor_dl/Configuration/RTE/Plugin.yaml" }

Add insert button

To add the 'insert definition list' button to the editors toolbar:

editor:
  config:
    toolbar:
      items:
        ...
        - definitionList
        ...

Trouble shooting

Weird <p> tags show up in markup like this here?

<dl>
	<dt>Foo</dt>
	<dd>
		<p class="bodytext">Bar</p>
	</dd>
	<dt>Fuu</dt>
	<dd>
		<p class="bodytext">Bat</p>
	</dd>
	<p class="bodytext">&nbsp;</p>
</dl>

Tweak TYPO3's pareFunc_RTE a little to get rid of that:

lib.parseFunc_RTE.externalBlocks.dl.callRecursive >
lib.parseFunc_RTE.externalBlocks.dl.stdWrap.parseFunc =< lib.parseFunc