Installation

Para can be installed in 5 minutes, going through the following steps :

1. Install the gem

For now, only the Bundler installation is possible, since there's no released gem on RubyGems.

Add the following line to the Gemfile

gem 'para', github: 'para-cms/para'

Then run :

bundle install

2. Setting up the engine

Setting up Para is easy. Run this command to generate all needed files

rails g para:install

This will do the following

• Create a configuration initializer at : config/initializers/para.rb
• Copy the needed migrations
• Add the required gems if they're not already in the Gemfile, and optionally run their :install generator in you app. See gems list in the section "Gems added to the Gemfile"
• Create a default admin user
• Mount the para engine

Warning : Ensuring root_path is defined

Please note that you should add a root path to your routes.rb, in the form of :

root to: 'home#index'

If you don't, you'll get errors when trying to access the admin panel.

Gems added to your Gemfile

• Devise : Authentication of admin users
• CanCan : Authorizations depending on admin roles (Note : uses the Cancancan fork)
• Rolify : Admins roles management
• Active Decorator : For adding helper methods to models without including them in models
• Simple Form : Form builder
• Simple Form Extension : Additional fields for Simple Form
• Ransack : Search DSL
• Paperclip : File and images uploads
• Friendly Id : Pretty URLs with model slugs instead of plain ids
• Kaminari : Pagination