/trusty-cms

TrustyCMS is a modern, Ruby on Rails-driven CMS that can be extended for any business needs.

Primary LanguageRubyMIT LicenseMIT

Welcome to TrustyCMS

Gem Version

TrustyCMS is a branch of Radiant CMS. Its goal is to pull the Radiant framework into Rails 5 with minimal changes to its infrastructure.

TrustyCMS is a no-fluff, open source content management system designed for small teams. It is similar to Textpattern or MovableType, but is a general purpose content management system (not just a blogging engine). TrustyCMS is a Rails engine and is built to be installed into an existing Rails 5 application as a gem.

TravisCI: Build Status

CodeClimate: Code Climate

TrustyCMS features:

  • An elegant user interface
  • The ability to arrange pages in a hierarchy with drag and drop
  • Flexible templating with layouts, snippets, page parts, and a custom tagging language
  • A simple user management/permissions system
  • Support for Markdown and Textile as well as traditional HTML (it's easy to create other filters)
  • An advanced plugin system
  • Asset management
  • Serve multiple sites (domains) from a single instance
  • Social sharing buttons
  • Reusable bits of content (Snippets)
  • Allows Rails controllers/actions to use Trusty CMS layouts as their "layout"
  • Operates in two modes: dev and production depending on the URL
  • A caching system which expires pages every 5 minutes
  • Built using Ruby on Rails (version 5)

License

TrustyCMS is released under the MIT license. The Radiant portions of the codebase are copyright (c) John W. Long and Sean Cribbs; anything after the fork is copyright (c) Pittsburgh Cultural Trust. A copy of the MIT license can be found in the LICENSE file.

Installation and Setup for Use

TrustyCMS is a traditional Ruby on Rails engine, meaning that you can configure and run it the way you would a normal gem, like Devise.

See the INSTALL.md file for more instructions.

Installation and Setup for Contributing to TrustyCMS

Setup

Prerequisites:

Steps:

  1. Fork this repository to your Github account.

  2. Clone your fork to your machine.

  3. cd into the directory you just cloned into.

  4. Follow the INSTALL.md instructions to setup an empty app with TrustyCMS installed. To modify TrustyCMS, point your dependency to the local path of your fork.

    gem 'trusty-cms', path: '../trusty-cms'

  5. Set up your databases in your Rails application:

     bundle exec rake db:create
     bundle exec rake db:migrate
    
  6. Run the tests to make sure they pass (If they don't, file a bug!):

     rspec
    

When you're ready to make a change:

  1. Add the pgharts fork as a git remote called "upstream": git remote add upstream https://github.com/pgharts/trusty-cms.git so that you can keep up with changes that other people make.
  2. Fetch the remote you just added: git fetch upstream.
  3. Start a new branch for the change you're going to make. Name it something having to do with the changes, like "fix-queries" if you are going to try to fix some queries. Base this branch on upstream/master by running git checkout -b fix-queries upstream/master.
  4. Make your changes and commit them. Please include tests!
  5. Run the tests and make sure they pass.
  6. Push your changes to your github fork: git push origin fix-queries.
  7. Send a pull request to the pgharts fork.

Support

All of the development for TrustyCMS happens on Github:

https://github.com/pgharts/trusty-cms

TrustyCMS is supported in part by:

Enjoy!

-- The TrustyCMS Dev Team