Applying rich text editor custom classes

Question

I have a custom css class that has been patched which I have verified in showconfig.aspx

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <settings>
      <setting name="WebStylesheet" value="/css/rte.css" />
    </settings>
  </sitecore>
</configuration>

I have verified the css via that url.

But in rich text editor I'm not seeing any classes under Apply Css Class. In both the content editor - rich text editor or the SXA rendering.

Is there a step I've missed doing? Using Sitecore 9.1 with SXA 1.8

My css is just:

.module-title {
  color: #373A40;
  text-align: center;
  margin-bottom: 1.5em;
  font-weight: 100;
}

Do I also have to update the ToolsFile.xml? I thought it would automatically pick up all the classes from the css file, and you only needed to use the xml to restrict what classes you wanted specifically to show.

Answer 1

We encountered the same issue and fixed it in the ToolsFile.xml. Our experience is that the classes section of that file should be empty to have the classes from your attached css file to be imported in the dropdown of the RT editor.

This way there should be no need to add all your classes in the xml file and you can just use the external css file. Remember to clear (browser) caches when you make changes to it (the css file gets cached).

Answer 2

A method I much prefer for user-friendliness is to create a new paragraph type in the RTE Profile:

It looks like this in the Rich Text Editor window:

This way you can choose the type of DOM element you want and can specify multiple classes.

Answer 3

It should pick up automatically, but you can try to add it to ToolsFile.xml

<classes>
<class name="Your Class 1" value="your-class-1" />
<class name="Your Class 2" value="your-class-2" />
<class name="Your Class 3" value="your-class-3" />
</classes>

toolsfile is located under <webroot>\sitecore\shell\Controls\Rich Text Editor\ folder.

Personally, I prefer creating snippets instead of adding a custom CSS class to a rich-text editor. It is a bit more user-friendly solution. You can add custom HTML snippets in the rich text editor profile, in the core database. e.g here /sitecore/system/Settings/Html Editor Profiles/Rich Text Full/Snippets