0.0
No commit activity in last 3 years
No release in over 3 years
HancockCMS
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

HancockCMS

DEVELOPMENT VERSION

Rails + RailsAdmin + Mongoid/PostgreSQL CMS. Very opinionated and tuned for my needs.

Inspired by RocketCMS

Remaded from EnjoyCMS

Installation

RAILS 5 (Hancock 2)

Add this line to your application's Gemfile:

gem 'hancock_cms_mongoid', '~> 2.0'

or:

gem 'hancock_cms_activerecord', '~> 2.0'

Only PostgreSQL is tested or supported for AR(from root repo). Others will probably work, but untested. And then execute:

$ bundle

Or install it yourself as:

$ gem install hancock_cms -v 2.0

For activerecord, generate migrations and run them

rails g rails_admin_settings:migration
rails g hancock_cms:migration
rake db:migrate

RAILS 4 (Hancock 1)

Add this line to your application's Gemfile:

gem 'hancock_cms_mongoid', '~> 1.0'

or:

gem 'hancock_cms_activerecord', '~> 1.0'

Only PostgreSQL is tested or supported for AR(from root repo). Others will probably work, but untested. And then execute:

$ bundle

Or install it yourself as:

$ gem install hancock_cms -v 1.0

For activerecord, generate migrations and run them

rails g rails_admin_settings:migration
rails g hancock_cms:migration
rake db:migrate

Usage

RAILS 5 (Hancock 2): Using app generator

Make sure you have rails 5.0 installed

rails -v

If not, uninstall rails and install again

gem uninstall rails
gem install rails -v 5.0

Then, for mongoid:

rails new my_app -B -T -O -m https://raw.githubusercontent.com/red-rocks/hancock_cms/master/template.rb
cd my_app
rails g hancock:cms:setup

for ActiveRecord:

rails new my_app -B -T --database=postgresql -m https://raw.githubusercontent.com/red-rocks/hancock_cms/master/template.rb
cd my_app
rails g hancock:cms:setup

generator creates a new RVM gemset, runs bundle install and setup some files (assets, config/initializers/*, routes, etc).

RAILS 4 (Hancock 1): Using app generator

Make sure you have rails 4.2.7 installed

rails -v

If not, uninstall rails and install again

gem uninstall rails
gem install rails -v 4.2.7

Then, for mongoid:

rails new my_app -B -T -O -m https://raw.githubusercontent.com/red-rocks/hancock_cms/1.0/template.rb
cd my_app
rails g hancock:cms:setup

for ActiveRecord:

rails new my_app -B -T --database=postgresql -m https://raw.githubusercontent.com/red-rocks/hancock_cms/1.0/template.rb
cd my_app
rails g hancock:cms:setup

generator creates a new RVM gemset, runs bundle install and setup some files (assets, config/initializers/*, routes, etc).

Localization

All models included in the gem support localization via either hstore_translate or built-in Mongoid localize: true option.

You can get a nice admin UI for editing locales by adding rails_admin_hstore_translate or rails_admin_mongoid_localize_field

Enable localization in HancockCMS:

Hancock.configure do |hancock|
  hancock.localize = true
  ...
end

Add rails_admin_hstore_translate or hstore_translate gem if using PostgreSQL:

gem 'rails_admin_hstore_translate'

or

gem 'hstore_translate'

Add rails_admin_mongoid_localize_field gem if using MongoDB:

gem 'rails_admin_mongoid_localize_field'

Documentation

It's basically Mongoid + Rails Admin + some of my common models and controllers, etc.

See their documentation for more info

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request