meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:ckeditor [2024/07/06 08:09] – [Location of CKEditor] duncanc | plugin:ckeditor [2025/06/07 05:55] (current) – [Upgrade CKEditor] duncanc | ||
---|---|---|---|
Line 13: | Line 13: | ||
---- | ---- | ||
- | This plugin provides CKEditor for editing messages and templates. It also integrates the KCFinder file manager to provide file uploading and browsing. | + | This plugin provides CKEditor |
+ | |||
+ | Both CKEditor 4 and KCFinder are "end of life", which means they do not receive any code fixes or security updates. The plugin uses the last freely available version of CKEditor 4, version 4.22.1. There is a paid-for version that does have security patches, see [[https:// | ||
===== Installation ===== | ===== Installation ===== | ||
Line 52: | Line 54: | ||
The Settings page has a CKEditor group where you can configure the plugin. | The Settings page has a CKEditor group where you can configure the plugin. | ||
+ | {{: | ||
- | * | + | * The URL of ckeditor.js |
- | * | + | * The path to a custom configuration file. This is the path from the web root. |
- | * The width and height of the editor window. | + | * You can select to generate a full HTML page when editing a campaign. The message |
- | * | + | * Whether |
- | * Similarly you can select | + | * If using the Dressprow theme, the width and height of the editor window can be specified. |
- | * | + | * The path to KCFinder. This is the path from the web root or a relative path from the '' |
- | * | + | * In some web server configurations the plugin will not be able to correctly derive the file system path to the upload image directory from the value of '' |
* | * | ||
Line 87: | Line 90: | ||
===== Upgrade CKEditor ===== | ===== Upgrade CKEditor ===== | ||
- | The plugin | + | CKEditor 4 became end-of-life in June 2023 which means it has had no further updates or security fixes since then. The plugin |
===== Upgrade KCFinder ===== | ===== Upgrade KCFinder ===== | ||
Line 94: | Line 97: | ||
The plugin includes KCFinder 3.20 but the KCFinder package is no longer developed or supported. | The plugin includes KCFinder 3.20 but the KCFinder package is no longer developed or supported. | ||
- | ===== Upgrade from phplist 2.10.x with FCKEditor ===== | ||
- | |||
- | In phplist 2.10 the FCKIMAGES_DIR value in config.php defines the directory into which images will be uploaded. The value is relative to the phplist root directory. | ||
- | |||
- | In phplist 3.x a different value, UPLOADIMAGES_DIR, | ||
===== Issues ===== | ===== Issues ===== | ||
Line 134: | Line 132: | ||
If you cannot resolve the problem then a work-around is to change one line in the KCFinder config file, setting '' | If you cannot resolve the problem then a work-around is to change one line in the KCFinder config file, setting '' | ||
- | ==== Only a template or a message can be edited as a full HTML page, not both. This message will use only limited HTML. ==== | ||
- | |||
- | By default, CKEditor allows only a limited set of HTML elements to be used. If you want it to generate a full HTML page, including the structural elements ('' | ||
- | |||
- | When one of those settings is enabled, CKEditor will ensure that the HTML structural elements are present, even if not entered directly. This means that it is not sensible to edit both templates and messages as full HTML pages because both will include structural elements leading to badly-formed HTML when a template includes a message using the [CONTENT] placeholder. | ||
- | |||
- | If both of those settings are enabled then the one for templates takes precedence, and CKEditor will allow only limited HTML when editing a message. | ||
- | If you want to create only full page HTML messages and do not use templates then set "Allow templates ..." to No and "Allow messages ..." to Yes. | ||
====== Support ====== | ====== Support ====== | ||
Please raise any questions or problems in the user forum https:// | Please raise any questions or problems in the user forum https:// |