#107421Allow configuration/usage of multiple richtext editor implementations
Description
No description.
Reviews 1
Files 5
History 1050
Show 525 earlier messages
-
Gerrit Code Review pushed patch set 6 for main to change 90612 status
In ProgressUnder Review <span data-processor="relativetime" data-value="2025-09-10T09:18:39+00:00" > 09/10/25, 09:18 </span> -
Andreas Nedbal commented <span data-processor="relativetime" data-value="2025-09-10T09:59:05+00:00" > 09/10/25, 09:59 </span>
-
Andreas Nedbal commented and changed attached Screenshot 2025-09-10 at 16.57.14.png attached Screenshot 2025-09-10 at 16.57.26.png attached Screenshot 2025-09-10 at 16.57.43.png <span data-processor="relativetime" data-value="2025-09-10T14:58:30+00:00" > 09/10/25, 14:58 </span>
Made some sketches of the flow of data of the current, prototype and next implementation of this changeset.
-
Gerrit Code Review pushed patch set 7 for main to change 90612 <span data-processor="relativetime" data-value="2025-09-11T13:37:38+00:00" > 09/11/25, 13:37 </span>
-
Gerrit Code Review pushed patch set 8 for main to change 90612 <span data-processor="relativetime" data-value="2025-09-19T17:03:08+00:00" > 09/19/25, 17:03 </span>
-
Gerrit Code Review pushed patch set 9 for main to change 90612 <span data-processor="relativetime" data-value="2025-09-19T17:35:52+00:00" > 09/19/25, 17:35 </span>
-
Andreas Nedbal commented and changed attached Screenshot 2025-09-19 at 19.29.52.png attached Screenshot 2025-09-19 at 19.35.28.png <span data-processor="relativetime" data-value="2025-09-19T17:42:49+00:00" > 09/19/25, 17:42 </span>
Did some more work on this:
Configuration loading kind of became an issue. We envisioned an idea that RichtextEditorBuilders would solely be responsible to load configuration in whatever way they fancy, and thus we can remove configuration handling in that regard from the core (configuration handling here being “load the YAML preset”). HOWEVER, I remembered that processing configuration is also part of that, and it does make sense that processing can be adjusted per-editor as well. And, in regards of loading order, the processing information is required before the FormEngine element is rendered, at the RteHtmlParser step (that’s roughly somewhere between TCA processing and rendering FormEngine).
So, to handle this, I extended the RichtextEditorBuilderInterface with a getConfiguration method, which handles resolving of the configuration. This is then used instead of the (now removed) getConfigurationFromPreset method in the Richtext class.
I’m not too sure about this approach, maybe we should split off processing configuration somehow, and make at least that standardized? I’d need feedback on that.
——
Additionally, I implemented a FallbackEditorBuilder. If a non-registered RTE is requested, or none is configured, this fallback editor is returned, which simply renders a textarea. Above the textarea is a warning notice explaining why it is shown (either one of the earlier reasons). So now, no default configuration is set/required and no exception occurs either. (example screenshots are attached to the comment)
-
Gerrit Code Review pushed patch set 10 for main to change 90612 <span data-processor="relativetime" data-value="2025-09-28T17:39:43+00:00" > 09/28/25, 17:39 </span>
-
Gerrit Code Review pushed patch set 11 for main to change 90612 <span data-processor="relativetime" data-value="2025-09-28T17:53:08+00:00" > 09/28/25, 17:53 </span>
-
Andreas Nedbal commented <span data-processor="relativetime" data-value="2025-10-01T09:07:48+00:00" > 10/01/25, 09:07 </span>
I think I’m mostly done with the registry/builder and general element stuff, works as it should and has a sensible fallback.
While integrating another RTE into TYPO3 I noticed some other things though that should be worked on:
- BrowseLinksController is currently “RTE-specific” by design and resides in
rte_ckeditoras well. The only thing it really does in terms of being RTE-specific is loading a JS-file that sends the finalized link back to CKEditor. We should move that into Backend as well, so it’s a general implementation and pull the required JS file via the RTE registry. - On note of that specific JS file, that should also be generalized so that implementation is way simpler and you only need to provide two methods to finalize and remove a link.
- BrowseLinksController is currently “RTE-specific” by design and resides in
-
Gerrit Code Review pushed patch set 12 for main to change 90612 <span data-processor="relativetime" data-value="2025-10-31T14:31:17+00:00" > 10/31/25, 14:31 </span>
-
Gerrit Code Review pushed patch set 13 for main to change 90612 <span data-processor="relativetime" data-value="2025-10-31T15:02:51+00:00" > 10/31/25, 15:02 </span>
-
Gerrit Code Review pushed patch set 14 for main to change 90612 <span data-processor="relativetime" data-value="2025-10-31T15:27:11+00:00" > 10/31/25, 15:27 </span>
-
Gerrit Code Review pushed patch set 15 for main to change 90612 <span data-processor="relativetime" data-value="2025-10-31T15:45:05+00:00" > 10/31/25, 15:45 </span>
-
Gerrit Code Review pushed patch set 16 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-10T08:20:09+00:00" > 11/10/25, 08:20 </span>
-
Gerrit Code Review pushed patch set 17 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-10T08:59:40+00:00" > 11/10/25, 08:59 </span>
-
Gerrit Code Review pushed patch set 18 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-10T11:08:42+00:00" > 11/10/25, 11:08 </span>
-
Gerrit Code Review pushed patch set 19 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-13T11:37:15+00:00" > 11/13/25, 11:37 </span>
-
Gerrit Code Review pushed patch set 20 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-13T12:01:52+00:00" > 11/13/25, 12:01 </span>
-
Gerrit Code Review pushed patch set 21 for main to change 90612 <span data-processor="relativetime" data-value="2025-11-13T12:49:27+00:00" > 11/13/25, 12:49 </span>
-
Gerrit Code Review pushed patch set 22 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T10:56:36+00:00" > 01/23/26, 10:56 </span>
-
Gerrit Code Review pushed patch set 23 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T12:14:28+00:00" > 01/23/26, 12:14 </span>
-
Oliver Hader changed target version <span data-processor="relativetime" data-value="2026-01-23T12:29:50+00:00" > 01/23/26, 12:29 </span>
-
Gerrit Code Review pushed patch set 24 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T13:34:15+00:00" > 01/23/26, 13:34 </span>
-
Gerrit Code Review pushed patch set 25 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T13:52:13+00:00" > 01/23/26, 13:52 </span>
-
Gerrit Code Review pushed patch set 26 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T14:46:45+00:00" > 01/23/26, 14:46 </span>
-
Gerrit Code Review pushed patch set 27 for main to change 90612 <span data-processor="relativetime" data-value="2026-01-23T16:24:36+00:00" > 01/23/26, 16:24 </span>
-
Andreas Nedbal commented <span data-processor="relativetime" data-value="2026-01-28T09:37:30+00:00" > 01/28/26, 09:37 </span>
@ghi Moving this conversation here because it’s more concept than implementation:
> As a reader I wonder, how is RTEProc with HTML input/output processing affected? As this is often defined within the processing YAML of ckeditor.
>
> I assume the specific implementations would then need to take care of transforming/creating TSconfig for orocessing based on their own systems? If so, a paragraph about that would helpThis is the part that I struggled with the most conceptually. Previously this all was in one file (or in PageTS).
Now that we technically handling off configuration loading to the implementer, I’m not 100% satisfied with this. If they just keep things “as-is” and follow the “”“standard”“” of adding a processing key to the root of their configuration, things work just fine…but that’s also quite strict for an otherwise “do-as-you-like” system.
I thought about adding a
getProcessingConfiguration(string presetName)method to the builder interface, which could for CKEditor just resolve the default configuration and pull the processing key out of it. But here I’m also concerned about increasing the complexity through this. (or rather perceived complexity for an implementer) -
Garvin Hicking commented <span data-processor="relativetime" data-value="2026-01-28T10:59:07+00:00" > 01/28/26, 10:59 </span>
> I thought about adding a
getProcessingConfiguration(string presetName)method to the builder interface, which could for CKEditor just resolve the default configuration and pull the processing key out of it. But here I’m also concerned about increasing the complexity through this. (or rather perceived complexity for an implementer)How about:
getProcessingConfigurationFromYaml(string $fileNameOfRteFile = ‘EXT:rte_ckeditor/Configuration/RTE/Processing.yaml’)
getProcessingConfigurationFromArray(array $someArray)
Then implementations could choose if they “just parse existing YAML” (they will have the challenge of offering custom configuration values that will need to point to these files). But they could also choose to completely deliver the “processing” configuration as a PHP array, and choose whatever configuration they want for it.
Another way of course is to mention to RTE implementations that they will need to point their users toward using PageTS for definining processing. That on the other hand kind of busts all documentation about the YAML processing. So… I would argue we should try to “reuse” people’s existing YAML and hint alternate RTE implementations to “pretty please” re-use the “processing” configuration YAML directives.
Does that make sense to you?
-
Gerrit Code Review pushed patch set 28 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-02T11:28:09+00:00" > 02/02/26, 11:28 </span>
-
Gerrit Code Review pushed patch set 29 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-02T11:34:01+00:00" > 02/02/26, 11:34 </span>
-
Gerrit Code Review pushed patch set 30 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-02T14:34:14+00:00" > 02/02/26, 14:34 </span>
-
Gerrit Code Review pushed patch set 31 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-02T17:00:11+00:00" > 02/02/26, 17:00 </span>
-
Gerrit Code Review pushed patch set 32 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-03T14:48:40+00:00" > 02/03/26, 14:48 </span>
-
Gerrit Code Review pushed patch set 33 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-03T14:57:50+00:00" > 02/03/26, 14:57 </span>
-
Gerrit Code Review pushed patch set 34 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-03T19:53:55+00:00" > 02/03/26, 19:53 </span>
-
Gerrit Code Review pushed patch set 35 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-03T20:28:31+00:00" > 02/03/26, 20:28 </span>
-
Gerrit Code Review pushed patch set 36 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-04T09:55:47+00:00" > 02/04/26, 09:55 </span>
-
Gerrit Code Review pushed patch set 37 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-04T10:44:16+00:00" > 02/04/26, 10:44 </span>
-
Gerrit Code Review pushed patch set 38 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-04T10:46:51+00:00" > 02/04/26, 10:46 </span>
-
Gerrit Code Review pushed patch set 39 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-04T10:52:31+00:00" > 02/04/26, 10:52 </span>
-
Gerrit Code Review pushed patch set 40 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-04T11:22:13+00:00" > 02/04/26, 11:22 </span>
-
Gerrit Code Review pushed patch set 41 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-05T11:20:50+00:00" > 02/05/26, 11:20 </span>
-
Gerrit Code Review pushed patch set 42 for main to change 90612 <span data-processor="relativetime" data-value="2026-02-05T11:26:11+00:00" > 02/05/26, 11:26 </span>
-
Andreas Nedbal commented <span data-processor="relativetime" data-value="2026-02-05T15:50:30+00:00" > 02/05/26, 15:50 </span>
If you want to test the current (review-ready) progress using TipTap, you can now do so.
You can utilize the test-distribution inside the TYPO3 Core development setup, following these steps:- Setup a TYPO3 development environment (https://docs.typo3.org/m/typo3/guide-contributionworkflow/main/en-us/)
- Check out my patch https://review.typo3.org/c/Packages/TYPO3.CMS/+/90612 in it
- Set up the TYPO3 test distribution in
Build/composer/- Clone
typo3-tiptapinto thepackagessubfolder and check out the branch90612_editor_configuration - Copy the
composer.dist.jsontocomposer.json - Run
./Build/Scripts/runTests.sh -s composerTestDistribution -b docker - Add
"in2code/typo3-tiptap": "dev”@ to the required packages - Run
composer updateinBuild/composer(either in DDEV, Docker, locally, whereever your setup is) - Set the web root of your web server to
Build/composer/publicand restart it - If you already have a running TYPO3 instance from core development, just copy your config from
typo3conf/configtoBuild/composer/config
- Clone
Log in and verify the extension is installed, now every RTE should be TipTap.
Recommended steps:- Try setting a different default editor through known means
- Global setting
- TCA field options
- PageTS (global, record and/or field specific, etc.)
- Take a look at the integration in https://github.com/in2code-de/typo3-tiptap/tree/90612_editor_configuration verifying readability, ease-of-implementation etc.
-
Benni Mack changed target version <span data-processor="relativetime" data-value="2026-03-31T09:05:26+00:00" > 03/31/26, 09:05 </span>
-
Benni Mack changed target version <span data-processor="relativetime" data-value="2026-04-21T11:23:01+00:00" > 04/21/26, 11:23 </span>
-
Gerrit Code Review pushed patch set 43 for main to change 90612 <span data-processor="relativetime" data-value="2026-07-23T12:41:45+00:00" > 07/23/26, 12:41 </span>
-
Gerrit Code Review pushed patch set 44 for main to change 90612 <span data-processor="relativetime" data-value="2026-09-16T07:54:51+00:00" > 09/16/26, 07:54 </span>
-
Gerrit Code Review pushed patch set 45 for main to change 90612 <span data-processor="relativetime" data-value="2026-11-13T12:57:16+00:00" > 11/13/26, 12:57 </span>
Okay, the basics for this change are somewhat done. Further testing and a full-on feature RST are missing as of yet, but that’s because I’m not 100% satisfied myself yet with what I currently built. So, feedback appreciated.
This change allows configuring multiple richtext editors side-by-side, instead of one just taking over the reigns completely. This comes in line with us making rte_ckeditor independent of the Core as well (it’s still a sysext but it can be removed without side-effects now).
Anyway, my main gripe with my implementation is configuration:
As of writing this comment, multi-RTE configuration works like this:
$GLOBALS['TYPO3_CONF_VARS']['RTE']['defaultEditor']to your globally preferred editor.textyou can set...['config']['richtextEditor']to the preferred editor of that field.RTE.default.richtextEditorRTE.config.tt_content.bodytext.richtextEditorfor field-specific adjustments as wellWhat about presets?
richtextEditoris configured, we have a graceful fallback to the old behavior and per deprecation strategy we keep$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']for v14 anyway.richtextEditoris configured…...['config']['richtextConfiguration']), because it’s in tandem with the other setting. (while writing this I realized this probably won’t work this way)RTE.default.{{ editor }}.presetorRTE.config.tt_content.bodytext.{{ editor }}.presetckeditor5as an implemented example, the paths areRTE.default.ckeditor5.presetorRTE.config.tt_content.bodytext.ckeditor5.presetrespectively$GLOBALS['TYPO3_CONF_VARS']['RTE'][$editor]['Presets']ckeditor5:$GLOBALS['TYPO3_CONF_VARS']['RTE']['ckeditor5']['Presets']To define/pick the fitting rendering per configured editor, I did the following:
I moved
RichTextNodeResolverback intoEXT:core. It now checks for$GLOBALS['TYPO3_CONF_VARS']['RTE']['defaultEditor']or...['config']['richtextEditor']being set, otherwise it falls back tockeditor5for now.Once that is set, it tries to pull the FQCN from
$GLOBALS['TYPO3_CONF_VARS']['RTE'][$editor]['Element']to return to FormEngine for building the node.In case the default fallback is happening and
Anyway, to my own gripes that I would like an opinion on:rte_ckeditorhappens to not be installed, the user is greeted with aNo richtext element configured for editor "ckeditor5"exception.RTE.*usually only contains preset-related configuration I thought it’d be okay to make per-editor keys directly inside it. I also picked this approached and not sayRTE.presets.{{ editor }}.{{ presetName }}because the logic would then involve a lot of “is whatever is inside presets an array or a string?” and I honestly dislike that more than introducing a new top-level key.TYPO3_CONF_VARS, especially things like this. I personally dabbled with the idea of adding service provider stuff and adding an attribute like#[AsRichtextEditor(editor: 'ckeditor5')]which you could slap on the fitting FormEngine element, but that feels somewhat overkill. But I’m open to implementing this anyway if people prefer this.You can check out the current implementation in the attached patch which is already a WIP on Gerrit. As mentioned above, feedback is appreciated!