Skip to content
indigoxela edited this page Oct 5, 2024 · 21 revisions

TinyMCE module documentation, work in progress...

Format settings section

Editor profiles

A profile is a defined template of available editing options and buttons.

Most settings ship with profiles. These profiles are JSON files, exportable with the Configuration manager on /admin/config/development/configuration/single/export.

Select Configuration group - Editor profiles and the Configuration name of profile to export.

By default this module ships with three profile variants: Default, Full and Small.

All three profiles for comparison

New profiles can get created on admin/config/content/tinymce-builder (Configuration / Content authoring / TinyMCE profiles).

Profile builder form

Why does this module separate format settings and editor profile?

TinyMCE provides lots of options to control its appearance and behavior. Way too many to get handled in a settings form.

Reducing the settings available on admin/config/content/formats/FORMAT to only profile, skin and content CSS helps to not overwhelm admins with too many (possibly irrelevant) options. Not everyone want's to dive into the details, and the format settings form already has many things to keep an eye on.

Reducing the settings available in the builder to only menubar (on/off), autoresize (on/off) and toolbar buttons provides enough flexibility to customize according to the most common use-cases. Still without overwhelming with options.

For admins, who really want to adjust all the details, the JSON file provides full control. However, if you customized your profile in code, it's not recommended to use the admin form on admin/config/content/tinymce-builder/YOURPROFILE/edit, as it might override or drop some adaptions.

For coders there's hook_tinymce_options_alter(), which gives full control over every aspect, loaded plugins, appearance, behavior... To use any of the hundreds of available TinyMCE library options to make your editor a perfect fit for every possible use case.

Clone this wiki locally