refinerycms 0,0,2,5,0,0,0,2 rspec travis-ci ruby Rubygems

An extendable Ruby on Rails CMS that supports Rails 4.2+

2 years after MIT

Refinery CMS

An open source content management system for Rails 4.2+

More information at http://refinerycms.com

Build Status Code Climate Coverage Status

You can chat with us using Gitter:

Gitter chat

Requirements

  • Bundler
  • ImageMagick
    • :warning: Warning: ImageMagick currently has a serious security vulnerability, CVE-2016–3714. After installing, you must disable certain features in ImageMagick's policy configuration. Please see the following for details:
    • https://imagetragick.com/
    • Mac OS X users should use homebrew's brew install imagemagick or the magick-installer.

How to

Getting Started

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

If you want to use 3-0-stable branch of Refinery with Rails 4.2.x. Install using this template:

rails new app_name -m http://refinerycms.com/t/3-0-stable

If you want to use edge branch of Refinery. Install using this template:

rails new app_name -m http://refinerycms.com/t/edge

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.

Demo

Wanna see Refinery for yourself? Try the demo.

Help and Documentation

Features

Pages

  • Easily edit and manage pages with a visual editor.
  • Manage your 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.

Authentication & Users

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

Custom Extensions

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

rails generate refinery:engine

Popular Extensions

  • Blog - A simple blogging extension that supports posts, categories and comments with optional moderation support.
  • Portfolio - manage groups of images like an image gallery.
  • News - post and manage news items.
  • Inquiries - simple contact form that notifies you and customer when an inquiry is made.

Full extension list here

Example Site Showcase

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

Contributing

See contributing.md and Contributing to Refinery guide for details about contributing and running test.

License

Refinery is released under the MIT license. See the license.md file for details.

Credits

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

Related Repositories

refinerycms-search

refinerycms-search

Search Plugin for RefineryCMS ...

refinerycms-wordpress-import

refinerycms-wordpress-import

Gem to import a WordPress XML dump into refinerycms and refinerycms-blog ...

refinerycms-mailchimp

refinerycms-mailchimp

A plugin to manage your Mailchimp campaigns from RefineryCMS ...

refinerycms-blog

refinerycms-blog

Blog plugin for RefineryCMS. Currently out-of-sync with RefineryCMS, see i.resol ...

refinerycms-pods

refinerycms-pods

Pods engine for RefineryCMS ...


Top Contributors

parndt ugisozols djones myabc bricesanchez simi moretea joemsak robyurkowski awagener gogogarrett peterz anitagraham semaperepelitsa keram phiggins jimjimovich hvirring CJBrew suweller knewter gwagener koa mirosr bofrede reset kivanio joshnuss darmenise johanb

Releases

-   3.0.4 zip tar
-   3.0.3 zip tar
-   3.0.2 zip tar
-   3.0.1 zip tar
-   3.0.0 zip tar
-   2.1.5 zip tar
-   2.1.4 zip tar
-   2.1.3 zip tar
-   2.1.2 zip tar
-   2.1.1 zip tar
-   2.1.0 zip tar
-   2.0.10 zip tar
-   2.0.9 zip tar
-   2.0.8 zip tar
-   2.0.7 zip tar
-   2.0.6 zip tar
-   2.0.5 zip tar
-   2.0.4 zip tar
-   2.0.3 zip tar
-   2.0.2 zip tar
-   2.0.1 zip tar
-   2.0.0 zip tar
-   1.0.11 zip tar
-   1.0.10 zip tar
-   1.0.9 zip tar
-   1.0.8 zip tar
-   1.0.7 zip tar
-   1.0.6 zip tar
-   1.0.5 zip tar
-   1.0.4 zip tar