An open source Ruby on Rails content management system. More information at http://refinerycms.com
Wanna see Refinery for yourself? Try the demo
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.
- Easily Theme and customise the look to suit the business
- Extend with custom plugins 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's gem requirements are:
- acts_as_indexed = 0.6.3
- authlogic = 2.1.5
- friendly_id = 3.0.6
- rails = 2.3.8
- rmagick ~> 2.12.0
- truncate_html = 0.3.2
- will_paginate = 2.3.14
Other dependencies
- RMagick - Install docs or for Mac OS 10.5+ users this shell install script will be easier.
- Install Refinery
- Update Refinery to the latest version
- Install Refinery on Heroku
- Run the Refinery test suite
gem install refinerycms
refinery path/to/project
git clone git://github.com/resolve/refinerycms.git mynewsite.com
cd ./mynewsite.com
git remote rm origin
git remote add origin [email protected]:you/yournewsite.git
mv ./config/database.yml.example ./config/database.yml
Firstly, edit config/database.yml to reflect your database server details.
Next create your database and fill it with Refinery's default data:
rake db:setup
After your database exists, you'll need to install the gems that Refinery depends on. You can do this by running:
rake gems:install
Note: The news engine that was previously in Refinery's core was extracted into a separate gem / plugin to be found here:p
http://github.com/resolve/refinerycms-news
Now, news should be up and running.
- Easily edit and manage pages with a WYSIWYG visual editor
- Manage you site's structure
- Easily upload and insert images
- Upload and link to resources such as PDF documents
- Uses the popular attachment_fu Rails plugin
- Supports storage on Amazon S3
- Collect inquiries from a contact form
- Manage your inquiries and be notified when new ones come in
- Checks new inquiries for spam
- Manage the behaviour of Refinery
- Easily integrate with Google Analytics
- Get an overview of what has been updated recently and see recent inquiries.
- Manage who can access Refinery
- Control which plugins each user has access to
- Uses the popular authlogic authentication Rails plugin
- Customise Refinery to look exactly how you want
- The Rails Way: use regular Rails erb views, no templating languages here!
...Want more? Extend with Plugins
Extend Refinery easily by running the Refinery generator
ruby script/generate refinery_plugin
to get help on how to use that. Or read the full documentation on writing plugins for Refinery
Refinery is released under the MIT license and is copyright (c) 2005-2010 Resolve Digital Ltd.