Guts

Build Status Docs Gem Version

A mountable, multisite, CMS engine for Rails 4.

Intensions

This engine is simply released to provide a basic, but full-featured CMS solution for Rails applications. It is not indented to mimic or become an all-inclusive Wordpress system.

Installation

Include the gem in your Gemfile:

gem 'guts', "~> 1.0"
# or for master: gem "guts", git: "[email protected]:tyler-king/guts.git"

Next, run the following commands:

bundle # fetches the new gem
bundle exec rake guts:install:migrations # installs Guts migrations
bundle exec rake db:migrate # load migrations into your database
bundle exec rake guts:db:seed # pre-configures some content type, groups, etc (creates an "Admins" group which is important)
bundle exec rake guts:user:create[{name},{email},{password},true] # creates a user (replace the values)

Open config/routes.rb in your Rails application and add:

mount Guts::Engine => "/admin"

You will now be able to access Guts by visiting /admin in your Rails application.

Configuration

See configurations in docs.

Documentation

See extra under docs for information. The docs contain information for configuration usage, extending, and how to implement multisite support.

Commands

To see all commands available simply run bundle exec rake -T guts. It contains tasks for user cretion, user deletion, changing user passwords, database seeds for install, and migration installs.

Features

  • Multisite support
  • Unit tested and documented
  • Dynamic content types
  • File management
  • Image processing via Paperclip
  • WYSIWYG via TinyMCE (with custom plugin which uses the file management)
  • Metafields
  • Dynamic navigation builders
  • Categories
  • Basic user management
  • Basic user groups
  • Basic session management
  • And more...

Screenshots

Check out this album for some screenshots.

Todo

  • Create a project page
  • Generators for installing (useful?)
  • Add configurable roles for users (suggestions?)
  • Scope users and groups for multisite

License

This project is released under the "BSD New" license. See LICENSE file for more details.