readme.md

Refinery CMS

An open source Ruby on Rails content management system for Rails 3.

More information at http://refinerycms.com

[](https://flattr.com/submit/auto?user_id=parndt&url=https://github.com/resolve/refinerycms&title=Refinery CMS&language=en_GB&tags=github&category=software)

Requirements

• Bundler
• ImageMagick
  • Mac OS X users should use homebrew's brew install imagemagick or the magick-installer.

How to

• Install Refinery CMS
• Install Refinery CMS on Heroku
• Contribute to Refinery CMS

Getting Started

If you're new to Refinery, start with this guide:

• Getting started with Refinery

What's it good at?

Refinery is great for sites where the client needs to be able to update their website themselves without being bombarded with anything too complicated.

Unlike other content managers, Refinery is truly aimed at the end user making it easy for them to pick up and make changes themselves.

For developers

• Easily customise the look to suit the business.
• Extend with custom extensions to do anything Refinery doesn't do out of the box.
• Sticks to "the Rails way" as much as possible; we don't force you to learn new templating languages.
• Uses jQuery for fast and concise Javascript.

Wanna see Refinery for yourself? Try the demo

Help and Documentation

• Getting Started
• Guides
• Google Group Discussion
• IRC Channel
• GitHub repository
• Developer/API documentation
• Twitter Account

Features

Pages

• Easily edit and manage pages with a WYSIWYG visual editor.
• Manage you site's structure.

Images & Files

• Easily upload and insert images.
• Upload and link to resources such as PDF documents.
• Uses the popular Dragonfly.
• Supports storage on Amazon S3.

Dashboard

• Get an overview of what has been updated recently and see recent inquiries.

Authentication & Users

• Manage who can access Refinery.
• Control which extensions each user has access to.
• Uses the popular devise.

Extend Refinery easily by running the Refinery extension generator. For help run the command without any options:

rails generate refinery:engine

Popular Engines

• Blog - A simple blogging extension that supports posts, categories and comments (with moderation support if you choose to enable it)
• Portfolio - manage groups of images like an image gallery.
• News - post and manage news items.

Full extension list here

Example Site Showcase

List here (add your link when you're done)

License

Refinery is released under the MIT license and is copyright (c) 2005-2012 Resolve Digital

Credits

Many of the icons used in Refinery CMS are from the wonderful Silk library by Mark James.