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:
      http://camaleon.tuzitio.com/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 http://localhost:3000/
     
  8. Open a browser and navigate to http://localhost:3000 (First time will show new site form)


  9. Access information for your site


  10. That's it.