Whelton / solidus_editor

Adds support for WYSIWYG editors to Solidus

Solidus Editor

This extension provides an inline rich-text editor for Solidus. It is based off spree_editor. It implements different types of editors:

• CKEditor
• TinyMCE

Please not that this extension is just a simple integration of some pretty complex gems: ckeditor and tinymce-rails.

If you have issues, please check their issues trackers first.

---

Installation

1. Add the Solidus Editor gem to your Gemfile:

gem 'solidus_editor', github: 'solidusio-contrib/solidus_editor', branch: 'master'

2. Run:

$ bundle install
$ rails g solidus_editor:install

3. If using CKEditor, and would like to enable file uploads run the ckeditor generator:

$ rails g ckeditor:install --orm=active_record --backend=paperclip && rake db:migrate

4. In order to secure your file uploads to only be accessed by admins you will also need to configure config/initializers/ckeditor.rb:

config.authorize_with :cancan, Spree::Ability

5. In order to precompile CKEditor's generated assets, you will need to add a line in config/initializers/assets.rb:

Rails.application.config.assets.precompile += %w( ckeditor/*)

---

Configuration

Preferences can be updated within the admin panel under "configuration" then "rich editor".

Or you may set them with an initializer within your application:

SpreeEditor::Config.tap do |config|
  config.ids = 'product_description page_body event_body'

  # change the editor to CKEditor
  config.current_editor = 'CKEditor'
end

The default preference is:

{
  enabled: true,
  current_editor: 'TinyMCE',
  ids: 'product_description page_body'
}

---

Language-Support

To obtain support for multiple languages with TinyMCE add tinymce-rails-langs to your Gemfile:

gem 'tinymce-rails-langs'

TinyMCE will not be loaded unless it finds a language package matching your Spree::Config.default_locale.

---

Contributing

See corresponding guidelines

---

Copyright (c) 2016 James Whelton and other contributors, released under the New BSD License