glebtv-ckeditor 4.11.1 → 4.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0603cf877f654ef3b6b8a03a9ab39000688a79e968340d4a0366dbc0e991062a
-  data.tar.gz: cd8fd5bebce7098578a6f0d0c5acbb6bdc34be7d5e0da0261a1abf0dac76dd13
+  metadata.gz: 881f253d2e0e32b89e8e76a07418a2a4eddea2afc47f3d9d2fdceed0aa31beca
+  data.tar.gz: 1303bc2e529ea50c3373f22341036a6a7f7b1f06852bb3dbc42f5883e0716e58
 SHA512:
-  metadata.gz: 2283617d51ccc0e7a93563980223917b2166a65f5e3976caadcf515f9a461b6a9cdc4cd0cfbc3571f316b76a1796216ddc8d44ceda9a396f5c703e48029fc189
-  data.tar.gz: cc9fd7bdeb7229799b319e95416d5ad1896a4af07c6359ad7d8b0ccf63f21cedf3ed7b5d0349c999ad1366d5b24e05ece10200cbdb4989ae9f70a0fb9d07a974
+  metadata.gz: bd1e56487215d54355ec48449cc368e76a81611a638c13ab4a5bbf4930cafb6f53d110cd15a1625c1730a25376d7c38c432cf8187c46d97b1e4ea9cd180004e5
+  data.tar.gz: 1fb70e818b8e4b4e16a43ac25c47a38aaadb421aa4185034347ae14231ed91ff759d8924b000f0989ad92364ba5236cb8672c9e8603ed523e33789b6b8baf21a

data/Gemfile

@@ -1,35 +1,36 @@
+# frozen_string_literal: true
+
 source 'http://rubygems.org'
 
 gemspec
 
-gem 'rails', '4.2.10'
+gem 'rails', '5.2.2.1'
 
 platforms :ruby do
-  gem 'sqlite3'
   gem 'sass'
-
-  group :development do
-    gem 'unicorn', '~> 4.0.1'
-  end
+  gem 'sqlite3', '~> 1.3.6'
 
   group :development, :test do
-    gem 'jquery-rails', '~> 4.0.4'
     gem 'capybara', '>= 0.4.0'
+    gem 'jquery-rails', '~> 4.3.3'
     gem 'mynyml-redgreen', '~> 0.7.1', require: 'redgreen'
+    gem 'rails-controller-testing'
   end
 
   group :active_record do
-    gem 'paperclip'
     gem 'carrierwave'
     gem 'dragonfly'
     gem 'mini_magick'
-    gem 'refile', require: 'refile/rails'
-    gem 'refile-mini_magick'
+    gem 'paperclip', '~> 6.1.0'
   end
 
   group :mongoid do
-    gem 'mongoid', '~> 5.0.0'
-    gem 'mongoid-paperclip', require: 'mongoid_paperclip'
+    gem 'bson_ext'
     gem 'carrierwave-mongoid', require: 'carrierwave/mongoid'
+    gem 'mongoid', '~> 7.0.2'
+    gem 'mongoid-paperclip', require: 'mongoid_paperclip'
+    gem 'shrine'
+    gem 'shrine-mongoid'
+    gem 'image_processing'
   end
 end

data/README.md

@@ -1,3 +1,359 @@
-# glebtv-ckeditor
+# Ckeditor
 
-This is a fork https://github.com/galetahub/ckeditor preconfigured for our needs.
+[![Build Status](https://semaphoreci.com/api/v1/igor-galeta/ckeditor/branches/master/shields_badge.svg)](https://semaphoreci.com/igor-galeta/ckeditor)
+[![Code Climate](https://codeclimate.com/github/galetahub/ckeditor/badges/gpa.svg)](https://codeclimate.com/github/galetahub/ckeditor)
+
+CKEditor is a WYSIWYG text editor designed to simplify web content creation. It brings common word processing features directly to your web pages. Enhance your website experience with our community maintained editor. Currently this gem supports [ckeditor 4](https://ckeditor.com/ckeditor-4/) only.
+
+## Features
+
+* CKEditor version 4.x (https://ckeditor.com/ckeditor-4/)
+* Rails 5.x, 4.2.x integration
+* Files browser
+* HTML5 file uploader
+* Hooks for formtastic and simple_form forms generators
+* Integrated with authorization frameworks [CanCanCan](https://github.com/CanCanCommunity/cancancan) and [Pundit](https://github.com/varvet/pundit)
+
+## Installation
+
+For basic usage just include the ckeditor gem:
+
+```
+gem 'ckeditor'
+```
+
+or if you'd like to use the latest version from Github:
+
+```
+gem 'ckeditor', github: 'galetahub/ckeditor'
+```
+
+The last version works with Rails 3.2.x is 4.1.3
+
+```ruby
+gem 'ckeditor', '4.1.3'
+```
+
+Include this inside your `config/initializers/assets.rb`:
+
+```
+Rails.application.config.assets.precompile += %w[ckeditor/config.js]
+```
+
+For file upload support, you must generate the necessary file storage models.
+The currently supported backends are:
+
+* ActiveRecord (paperclip, carrierwave, dragonfly)
+* Mongoid (paperclip, carrierwave, dragonfly)
+
+### How to generate models to store uploaded files
+
+#### ActiveRecord + paperclip
+
+To use the active_record orm with paperclip (i.e. the default settings):
+
+```
+gem 'paperclip'
+
+rails generate ckeditor:install --orm=active_record --backend=paperclip
+```
+
+#### ActiveRecord + active_storage
+
+```
+gem "mini_magick"
+
+rails active_storage:install # if you not install active_storage yet
+rails generate ckeditor:install --orm=active_record --backend=active_storage
+```
+
+#### ActiveRecord + carrierwave
+
+```
+gem 'carrierwave'
+gem 'mini_magick'
+
+rails generate ckeditor:install --orm=active_record --backend=carrierwave
+```
+
+#### ActiveRecord + dragonfly
+
+Requires Dragonfly 1.0 or greater.
+
+```
+gem 'dragonfly'
+
+rails generate ckeditor:install --orm=active_record --backend=dragonfly
+```
+
+#### Mongoid + paperclip
+
+```
+gem 'mongoid-paperclip', require: 'mongoid_paperclip'
+
+rails generate ckeditor:install --orm=mongoid --backend=paperclip
+```
+
+#### Mongoid + active_storage
+
+Active Storage support **only** Active Record, see for [more info](https://github.com/rails/rails/issues/31408#issuecomment-351128111)
+
+#### Mongoid + carrierwave
+
+```
+gem 'carrierwave-mongoid', require: 'carrierwave/mongoid'
+gem 'mini_magick'
+
+rails generate ckeditor:install --orm=mongoid --backend=carrierwave
+```
+
+#### Load generated models
+
+All ckeditor models will be generated in the app/models/ckeditor directory.
+Models are autoloaded in Rails 4. For earlier Rails versions, you need to add them to the autoload path (in application.rb):
+
+```ruby
+config.autoload_paths += %w(#{config.root}/app/models/ckeditor)
+```
+
+Mount the Ckeditor::Engine in your routes (config/routes.rb):
+
+```ruby
+mount Ckeditor::Engine => '/ckeditor'
+```
+
+## Usage
+
+### Load editor via CKEditor CDN
+
+Setup editor version to load (more info here http://cdn.ckeditor.com/)
+
+```ruby
+# in config/initializers/ckeditor.rb
+
+Ckeditor.setup do |config|
+  # //cdn.ckeditor.com/<version.number>/<distribution>/ckeditor.js
+  config.cdn_url = "//cdn.ckeditor.com/4.6.1/basic/ckeditor.js"
+end
+```
+
+In view template include ckeditor CDN:
+
+```slim
+= javascript_include_tag Ckeditor.cdn_url
+```
+
+Precompile ckeditor/config.js:
+
+```ruby
+# in config/initializers/assets.rb
+
+Rails.application.config.assets.precompile += %w[ckeditor/config.js]
+```
+
+### Form helpers
+
+```slim
+= form_for @page do |form|
+  = form.cktext_area :notes, class: 'someclass', ckeditor: { language: 'uk'}
+  = form.cktext_area :content, value: 'Default value', id: 'sometext'
+  = cktext_area :page, :info, cols: 40, ckeditor: { uiColor: '#AADC6E', toolbar: 'mini' }
+```
+
+*It also works with bootstrap-form*
+
+```slim
+= bootstrap_form_for resource do |form|
+  = form.cktext_area :text, ckeditor: { language: 'uk'}
+```
+
+### Customize ckeditor
+
+All ckeditor options can be found [here](http://docs.ckeditor.com/#!/api/CKEDITOR.config)
+
+In order to configure the ckeditor default options, create the following files:
+
+```
+app/assets/javascripts/ckeditor/config.js
+
+app/assets/javascripts/ckeditor/contents.css
+```
+
+#### Custom toolbars example
+
+Adding a custom toolbar:
+
+```javascript
+# in app/assets/javascripts/ckeditor/config.js
+
+CKEDITOR.editorConfig = function (config) {
+  // ... other configuration ...
+
+  config.toolbar_mini = [
+    ["Bold",  "Italic",  "Underline",  "Strike",  "-",  "Subscript",  "Superscript"],
+  ];
+  config.toolbar = "mini";
+
+  // ... rest of the original config.js  ...
+}
+```
+
+When overriding the default `config.js` file, you must set all configuration options yourself as the bundled `config.js` will not be loaded. To see the default configuration, run `bundle open ckeditor`, copy `app/assets/javascripts/ckeditor/config.js` into your project and customize it to your needs.
+
+#### Install additional plugins
+
+You should download necessary plugins with all dependencies and extract them in `app/assets/javascripts/ckeditor/plugins/`.
+After that you can include your plugins in `app/assets/javascripts/ckeditor/config.js` in this way:
+
+```javascript
+CKEDITOR.editorConfig = function (config) {
+  config.extraPlugins = 'eqneditor,autosave,';
+}
+```
+
+### AJAX
+
+jQuery sample:
+
+```html
+<script type='text/javascript' charset='UTF-8'>
+  $(document).ready(function(){
+    $('form[data-remote]').bind('ajax:before', function(){
+      for (instance in CKEDITOR.instances){
+        CKEDITOR.instances[instance].updateElement();
+      }
+    });
+  });
+</script>
+```
+
+### Formtastic integration
+
+```slim
+= form.input :content, as: :ckeditor
+= form.input :content, as: :ckeditor, input_html: { ckeditor: { height: 400 } }
+```
+
+### SimpleForm integration
+Note that the toolbar option should match the case specified in the config. If the config is not found it defaults to all available toolbar items.
+
+i.e. config.toolbar_mini becomes {toolbar: 'mini'} in the form.
+
+```slim
+= form.input :content, as: :ckeditor, input_html: { ckeditor: { toolbar: 'Full' } }
+```
+
+### Turbolink integration
+Create a file app/assets/javascripts/init_ckeditor.coffee
+
+```coffee
+ready = ->
+  $('.ckeditor').each ->
+    CKEDITOR.replace $(this).attr('id')
+
+$(document).ready(ready)
+$(document).on('page:load', ready)
+```
+Make sure the file is loaded from your app/assets/javascripts/application.js
+
+### CanCanCan integration
+
+To use cancan with Ckeditor, add this to an initializer:
+
+```ruby
+# in config/initializers/ckeditor.rb
+
+Ckeditor.setup do |config|
+  config.authorize_with :cancancan
+end
+```
+
+At this point, all authorization will fail and no one will be able to access the filebrowser pages.
+To grant access, add the following abilities (usually `ability.rb`)
+
+```ruby
+# Always performed
+can :access, :ckeditor   # needed to access Ckeditor filebrowser
+
+# Performed checks for actions:
+can [:read, :create, :destroy], Ckeditor::Picture
+can [:read, :create, :destroy], Ckeditor::AttachmentFile
+```
+
+### Pundit integration
+
+Just like CanCanCan, you can write this code in your config/initializers/ckeditor.rb file:
+
+```ruby
+Ckeditor.setup do |config|
+  config.authorize_with :pundit
+end
+```
+
+Then, generate the policy files for model **Picture** and **AttachmentFile**
+
+```
+$ rails g ckeditor:pundit_policy
+```
+By this command, you will got two files:
+> app/policies/ckeditor/picture_policy.rb
+app/policies/ckeditor/attachment_file_policy.rb
+
+By default, only the user that logged in can access the models (with actions *index* and *create*) and only the owner of the asset can **destroy** the resource.
+
+You can customize these two policy files as you like.
+
+## Engine configuration
+
+* To override the default CKEditor routes create a [config.js](https://github.com/galetahub/ckeditor/blob/master/app/assets/javascripts/ckeditor/config.js) file within the host application at `app/assets/javascripts/ckeditor/config.js`
+
+* By default, the engine inherits from `ApplicationController`. To override the default parent controller:
+```
+# in config/initializers/ckeditor.rb
+
+Ckeditor.setup do |config|
+  config.parent_controller = 'MyCKEditorBaseController'
+end
+```
+
+Based on this, if you want to secure CKEditor controller actions and you can't authenticate in ApplicationController, you could do so with a custom controller after configuring the override above, like so:
+
+```
+class MyCKEditorBaseController < ActionController::Base
+
+  before_action :authenticate_user! # or some other auth/permission logic here, like Pundit
+
+end
+```
+
+## I18n
+
+```yml
+en:
+  ckeditor:
+    page_title: 'CKEditor Files Manager'
+    confirm_delete: 'Delete file?'
+    buttons:
+      cancel: 'Cancel'
+      upload: 'Upload'
+      delete: 'Delete'
+      next: 'Next'
+```
+
+## Tests
+
+```bash
+$> rake test CKEDITOR_BACKEND=paperclip
+$> rake test CKEDITOR_BACKEND=active_storage
+$> rake test CKEDITOR_BACKEND=carrierwave
+$> rake test CKEDITOR_BACKEND=dragonfly
+$> rake test CKEDITOR_BACKEND=shrine
+$> rake test CKEDITOR_ORM=mongoid
+
+$> rake test:controllers
+$> rake test:generators
+$> rake test:integration
+$> rake test:models
+```
+
+This project rocks and uses the MIT-LICENSE.

data/Rakefile

@@ -1,4 +1,5 @@
-# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'rubygems'
 begin
   require 'bundler/setup'
@@ -7,49 +8,57 @@ rescue LoadError
 end
 
 require 'rake'
-require 'bundler/gem_tasks'
 require 'rake/testtask'
 
+require 'bundler/gem_tasks'
+
+task default: :test
+
 Rake::TestTask.new(:test) do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/**/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-Rake::TestTask.new("test:controllers") do |t|
+Rake::TestTask.new('test:controllers') do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/controllers/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-Rake::TestTask.new("test:generators") do |t|
+Rake::TestTask.new('test:generators') do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/generators/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-Rake::TestTask.new("test:integration") do |t|
+Rake::TestTask.new('test:integration') do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/integration/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-Rake::TestTask.new("test:models") do |t|
+Rake::TestTask.new('test:models') do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/models/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-Rake::TestTask.new("test:functional") do |t|
+Rake::TestTask.new('test:functional') do |t|
   t.libs << 'lib'
   t.libs << 'test'
   t.pattern = 'test/functional/*_test.rb'
   t.verbose = false
+  t.warning = false
 end
 
-task :default => :test