Redmine CKEditor plugin¶ ↑

This plugin adds the text formatting for using CKEditor to Redmine.

Since version 1.0.0, it includes Rich and supports image uploads.

What is CKEditor?¶ ↑

CKEditor is a WYSIWYG text editor. See the official site for more details.

Requirements¶ ↑

ImageMagick (Since version 1.0.0)

# Ubuntu
apt-get install imagemagick
# Mac OS X
brew install imagemagick

• Redmine 4.x (version 1.2.3)

• Redmine 3.x, (version 1.1.7)

• Redmine 2.3.x, Ruby 1.9.2 or higher (version 1.0.20)

• Redmine 2.3.x (version 0.4.0)

• Redmine 2.2.x (version 0.3.0)

• Redmine 2.1.x (version 0.2.1)

• Redmine 2.0.x (version 0.1.1)

• Redmine 1.1.0 - 1.4.2 (version 0.0.6)

Plugin installation and setup¶ ↑

1. Download the zip package and extract the directory that it contains into the plugins directory (make sure the name is redmine_ckeditor)

2. Install the required gems (in the Redmine root directory)

   bundle install --without development test

3. Execute migration

   rake redmine:plugins:migrate RAILS_ENV=production

4. Start Redmine

5. Change the text formatting (Administration > Settings > General > Text formatting) to CKEditor

6. Configure the plugin (Administration > Plugins > Configure)

Upgrade¶ ↑

1. Replace the plugin directory (plugins/redmine_ckeditor)

2. Install the required gems

   bundle install --without development test

3. Execute migration

   rake redmine:plugins:migrate RAILS_ENV=production

4. Delete old assets

   rm -r public/plugin_assets/redmine_ckeditor

5. Restart Redmine

Uninstall¶ ↑

1. Change the text formatting (Administration > Settings > General > Text formatting) to textile

2. Rollback the migration

   rake redmine:plugins:migrate  NAME=redmine_ckeditor VERSION=0 RAILS_ENV=production

3. Delete the plugin directory (plugins/redmine_ckeditor)

CKEditor customization¶ ↑

Plugins¶ ↑

You can download plugins from Add-ons Repository. To activate the plugin you have to copy the plugin directory into assets/ckeditor-contrib/plugins and restart Redmine, then configure toolbar settings.

Skins¶ ↑

You can select third-party skins placed in assets/ckeditor-contrib/skins directory.

Configuration¶ ↑

You can configure CKEditor settings and HTML sanitizer by using the REDMINE_ROOT/config/ckeditor.yml file.

cp plugins/redmine_ckeditor/config/ckeditor.yml.example config/ckeditor.yml

Migration notes¶ ↑

This plugin stores contents in HTML format and renders as is. If you have old contents, these look weird.

You can use redmine_per_project_formatting plugin for backward compatibility or execute redmine_ckeditor:migrate task for migrating old text to HTML.

rake redmine_ckeditor:migrate RAILS_ENV=production FROM=textile TO=html

You can also use PROJECT parameter to migrate only specific projets

rake redmine_ckeditor:migrate RAILS_ENV=production PROJECT=project_identifier1,project_identifier2 FROM=textile TO=html

This task requires to install Pandoc.

Upgrading CKEditor (for development)¶ ↑

1. Checkout the new version of CKEditor(full package) in the submodule directory

   git submodule update --init
   cd app/assets/javascripts/ckeditor-releases
   git checkout FULL_VERSION (e.g. full/4.4.6)

2. Execute generator

   rails generate redmine_ckeditor:rich_assets