silverstripe-framework/docs/en/02_Developer_Guides/15_Customising_the_Admin_Interface/05_Typography.md

46 lines
1.1 KiB
Markdown
Raw Normal View History

2014-11-07 20:43:57 +01:00
title: WYSIWYG Styles
summary: Add custom CSS properties to the rich-text editor.
# WYSIWYG Styles
SilverStripe lets you customise the style of content in the CMS. This is done by setting up a CSS file called
2018-01-16 00:36:00 +01:00
`editor.css` in either your theme or in your `mysite` folder. This is set through yaml config:
```yaml
---
name: MyCSS
---
SilverStripe\Forms\HTMLEditor\TinyMCEConfig:
editor_css:
- 'mysite/css/editor.css'
```
2014-11-07 20:43:57 +01:00
Will load the `mysite/css/editor.css` file.
2018-01-16 00:36:00 +01:00
## Custom style dropdown
2018-01-16 00:36:00 +01:00
The custom style dropdown can be enabled via the `importcss` plugin bundled with admin module.
Use the below code in `mysite/_config.php`:
```php
2018-01-16 00:36:00 +01:00
use SilverStripe\Forms\HTMLEditor\TinyMCEConfig;
TinyMCEConfig::get('cms')
->addButtonsToLine(1, 'styleselect')
->setOption('importcss_append', true);
```
2014-11-07 20:43:57 +01:00
Any CSS classes within this file will be automatically added to the `WYSIWYG` editors 'style' dropdown. For instance, to
add the color 'red' as an option within the `WYSIWYG` add the following to the `editor.css`
```css
.red {
color: red;
}
```
2014-11-07 20:43:57 +01:00
## API Documentation
* [HtmlEditorConfig](api:SilverStripe\Forms\HTMLEditor\HtmlEditorConfig)