ComfortableMexicanSofa

Gem Version Build Status Dependency Status Code Climate Coverage Status

ComfortableMexicanSofa is a powerful Rails 4 CMS Engine

Features

Installation

Add gem definition to your Gemfile:

gem 'comfortable_mexican_sofa', '~> 1.12.0'

Then from the Rails project's root run:

bundle install
rails generate comfy:cms
rake db:migrate

Now take a look inside your config/routes.rb file. You'll see where routes attach for the admin area and content serving. Make sure that content serving route appears as a very last item.

comfy_route :cms_admin, :path => '/admin'
comfy_route :cms, :path => '/', :sitemap => false

When upgrading from the older version please take a look at Upgrading ComfortableMexicanSofa

Installation for Rails 3

For Rails 3 apps feel free to use 1.8 release

gem 'comfortable_mexican_sofa', '~> 1.8.0'

Quick Start Guide

After finishing installation you should be able to navigate to http://yoursite/admin

Default username and password is 'username' and 'password'. You probably want to change it right away. Admin credentials (among other things) can be found and changed in the cms initializer: /config/initializers/comfortable_mexican_sofa.rb

Before creating pages and populating them with content we need to create a Site. Site defines a hostname, content path and its language.

After creating a Site, you need to make a Layout. Layout is the template of your pages; it defines some reusable content (like header and footer, for example) and places where the content goes. A very simple layout can look like this:

<html>
  <body>
    <h1>{{ cms:page:header:string }}</h1>
    {{ cms:page:content:rich_text }}
  </body>
</html>

See Wiki entry on available Tags you can use

Once you have a layout, you may start creating pages and populating content. It's that easy.

For more information please refer to Wiki.

Sofa's Page Edit View

Dependencies

As long as you sucessfuly ran bundle install you should be ok. However, Paperclip requires ImageMagick to be installed to handle thumbnail generation.

Help and Contact

GoogleGroups: http://groups.google.com/group/comfortable-mexican-sofa Twitter: @GroceryBagHead


ComfortableMexicanSofa is released under the MIT license

Copyright 2009-2014 Oleg Khabarov


DOGE: DMTBhZjcgUZunCKMpKCJogBXBhQx2h7h5c