Slickr

Short description and motivation.

You must have both Active Admin and Webpacker with React already installed and setup.

Add these lines to your application's Gemfile:

gem 'active_admin_slickr'
gem 'slickr'

And then execute:

bundle

Then run the generator:

rails g slickr:install

followed by

rake db:migrate

and finally

yarn install

If running the generator again you can run:

rails g slickr:install --skip

Firstly, please comment out the default Active Admin stylesheets.

// Active Admin's got SASS!
// @import "active_admin/mixins";
// @import "active_admin/base";

Then add the following in active_admin.scss:

@import 'active_admin_slickr';
@import 'slickr/slickr_styles';

• In the active_admin.js file, you require:

//= require active_admin/base
//= require active_admin_slickr
//= require slickr/slickr_javascript

You will have some basic default roles added to your AdminUser model which you can easily add to. Roles are managed by CanCanCan and can be altered in the Ability model.

To alter the roles, change the values in the ROLES constant located at app/models/admin_user.rb

Then you can manage permissions at app/models/ability.rb

Finally, ensure your AdminUser has been assigned one of the roles.

The AdminUser file within the app/admin path is already setup through this gem so you can remove your own version. If however you need to extend it you can still create the admin_users.rb file within the app/admin folder but set it up like so:

ActiveAdmin.register AdminUser, as: "Users" do
end

If your site is using HTTP Basic Auth and media files are stored at an external location then please add the following to the relevant config/environments file with your own user and password details.

config.slickr_http_basic_auth_required = true
config.slickr_http_basic_auth_user = 'Joe'
config.slickr_http_basic_auth_password = 'Bloggs'

Updates

Navigation

Image Processing

Slickr comes with set of default modules which you can apply to new content types. You probably want to use Uploadable on most of your models. Previewable and Metatagable should probably go together as they both are very helpful for models with individual pages. You may also want to consider Schedulable when you generate individual model items pages.

Previewable allow generation of admin preview of the webpages. Read more

Metatagable enables additional Open Graph fields configuration for pages. Read more

Restorable enables soft deletes on modeles. Read more

Schedulable enables items future scheduling. Read more

Uploadable adds the media library functionality to model. Read more

Helpers

Error page configuration

Model ordering setup

Sitemap configuration

Megadraft configuration

Developing with slickr_cms

Contribution directions go here.

The gem is available as open source under the terms of the MIT License.