Installation on Existent Project

Camaleon CMS can be integrated into existent Rails Project.

Note: Check here for updated install steps.
Steps to install:

1. Add camaleon_cms to your Gemfile (review github for the last stable version)

   gem "camaleon_cms", '>= 2.4.3'

2. Only Rails 5 support (Add your your Gemfile)
   In your Gemfile, change sass-rails version into '~> 5.0' (Camaleon doesn't support for sprockets >= 4 which is included in sass-rails >= 6)
   Add in your Gemfile draper for Rails 5
   

   gem 'draper', github: 'drapergem/draper'
   gem 'sass-rails', '~> 5.0'
   

   Also add this configuration to your config/application.rb

   config.active_record.belongs_to_required_by_default = false

3. Install the gem

   bundle install

4. Install the CMS (This will copy some basic templates and plugins in your project)

   rails generate camaleon_cms:install

5. Before continue (Very Important)
   1. Open camaleon cms configuration in config/system.json (review and modify according your needs)
   2. You can customize your admin url path by "admin_path_name": "secret_admin"
   3. You can avoid overwrite your DB tables by adding a prefix by "db_prefix": "myprefix_"
   4. You can add camaleon cms within a url prefix by (all urls of camaleon will be prefixed with this value) "relative_url_root": "blog"
   5. You can reuse your existent user authentication to access into camaleon admin panel:
      https://camaleon.website/documentation/category/139779-faqs/custom-login.html
   6. Check full configurations here:
      https://github.com/owen2345/camaleon-cms/blob/master/config/system.json

6. Generate database structure

   rake db:migrate

7. Start your server

   rails server # and then go to your browser https://localhost:3000/

8. Open a browser and navigate to https://localhost:3000 (First time will show new site form)
   
   
   
9. Access information for your site
   
   
   
10. That's it.