Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Ruby on Rails CMS that supports Rails 3
Ruby JavaScript

This branch is 7 commits ahead, 3742 commits behind refinery:master

Failed to load latest commit information.
app/views Clean up more files that weren't synced.
authentication import generator project from external git repository
autotest Made it so that the generator actually copies the files that it was a…
base import generator project from external git repository
bin Deprecation warning contained incorrect generator name
config Cucumber - it was fun and all but we just have to say goodbye now.
core import generator project from external git repository
dashboard import generator project from external git repository
db Work in progress getting specs refactored and modular with common com…
doc Update guides to reflect new testing strategy for engines
generators Generators should not be a submodule - oops!
images
lib Spec directory should be ignored when generating gemspec
pages import generator project from external git repository
public/javascripts Renamed RefinerySetting to Refinery::Setting. Might have missed a few.
resources import generator project from external git repository
script Cucumber - it was fun and all but we just have to say goodbye now.
settings import generator project from external git repository
spec Clean up rspec config.
testing Merge pull request #875 from enmasse-entertainment/engine-generator-u…
.gitignore
.rspec Added fuubar gem to testing engine for instant rspec feedback (ht: Mo…
.travis.yml We want to test every possible database.
.yardopts We don't want config etc
Gemfile therubyracer is not being used
Gemfile.lock import generator project from external git repository
Guardfile Add a Guardfile to the refinerycms main project. Now you can use Guar…
Rakefile
changelog.md Merge branch '1-0-stable'
config.ru Refinery::RefineryApp -> ::RefineryApp
license.md
readme.md Added Travis CI build status image.
refinerycms.gemspec import generator project from external git repository

readme.md

Refinery CMS

Travis CI Build Status

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

More information at http://refinerycms.com

Requirements

How to

Getting Started

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

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 engines 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.

Refinery Dashboard

Wanna see Refinery for yourself? Try the demo

Help and Documentation

Features

Pages

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.

Inquiries

  • Collect inquiries from a contact form.
  • Manage your inquiries and be notified when new ones come in.
  • Checks new inquiries for spam.

Settings

Dashboard

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

Authentication & Users

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

...Want more? Extend with Engines

Extend Refinery easily by running the Refinery engine generator

rails generate refinery_engine

to get help on how to use that. Or read the full documentation on writing engines for Refinery

Popular Engines

  • Blog - A simple blogging engine 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 engine 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-2011 Resolve Digital

Credits

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

Something went wrong with that request. Please try again.