From 7677940a4d9b24cb15251f7d3e345b052193ee98 Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 5 Jul 2023 12:37:31 +0300 Subject: [PATCH 1/2] Added RTE configuration to use custom CKEditor build --- docs/add-ons/rte.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/add-ons/rte.md b/docs/add-ons/rte.md index 7300af469..d0813f346 100755 --- a/docs/add-ons/rte.md +++ b/docs/add-ons/rte.md @@ -73,6 +73,7 @@ The following are the buttons that can be enabled in tool set to manipulate the
  • Superscript
  • Block quote
  • Code
    • +
  • Code block
  • Heading / Format
  • Remove formatting (CKEditor only)
  • Style (Redactor only)
    • @@ -95,6 +96,7 @@ The following are the buttons that can be enabled in tool set to manipulate the
  • "Read More" separator
  • Font color / background
  • Fullscreen (Redactor only)
    • +
  • HTML Source editing
    • #### Custom Stylesheet @@ -148,6 +150,7 @@ To delete a tool set, check the tool set's checkbox in the tool set table listin - **Default RTE tool set** - select the tool set that will be selected by default when creating a field. - **File Browser** - select file browser that will be used when browsing for images and files from RTE fields. ExpressionEngine's FilePicker is used by default, third-party add-ons can provide their own filepickers +- **Use custom CKEditor build** - Allows using custom CKEditor build with extra plugins. If enabled, RTE instances running CKEditor will be built using the script in `themes/user/rte/javascript/` folder. NOTE: **Note:** If using the [Multiple Site Manager](msm/overview.md), this preference is per-site. @@ -170,7 +173,7 @@ NOTE: **Warning** Doing this requires advanced development skills. In order to create custom CKEditor build: - Clone [GitHub repo](https://github.com/ExpressionEngine/ExpressionEngine/) - Install NPM packages by running `npm install` - - Follow the installation instructions for the plugin itself - - Make your changes to `js-src\ckeditor5-build-classic\src\ckeditor.js` and other files as necessary. + - Follow the installation instructions for the extra CKEditor plugins that you need + - Make your changes to `js-src/ckeditor5-build-classic/src/ckeditor.js` and other files as necessary. - Run the command `npm run build:ckeditor` - - Copy the files from `themes/ee/asset/javascript/src/fields/rte/ckeditor` to same folder on your EE installation + - Copy the files from `themes/ee/asset/javascript/src/fields/rte/ckeditor` to `themes/user/rte/javascript/` folder on your EE installation From e77048cfe0b6962313d188c1fbad8d26656fbfc8 Mon Sep 17 00:00:00 2001 From: Yuri Salimovskiy Date: Wed, 5 Jul 2023 12:57:06 +0300 Subject: [PATCH 2/2] note about buttons --- docs/add-ons/rte.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/add-ons/rte.md b/docs/add-ons/rte.md index d0813f346..60d09738c 100755 --- a/docs/add-ons/rte.md +++ b/docs/add-ons/rte.md @@ -177,3 +177,5 @@ In order to create custom CKEditor build: - Make your changes to `js-src/ckeditor5-build-classic/src/ckeditor.js` and other files as necessary. - Run the command `npm run build:ckeditor` - Copy the files from `themes/ee/asset/javascript/src/fields/rte/ckeditor` to `themes/user/rte/javascript/` folder on your EE installation + +TIP: Buttons provided by extra plugins might be not availble with visual toolbar builder. You will need to use Advanced Configuration JSON file to add those. \ No newline at end of file