Installation & Deployment Guide: Application Integration

Wheelhouse CMS can be easily integrated into your existing Rails applications, allowing you to add content management functionality to your web app with very little effort.

Assuming you do not have any existing routes beneath /admin, you will not need to change anything within your application. Your application's routes will take precedence over those of Wheelhouse and over any pages created by Wheelhouse.

Ensure your system has the required dependencies as described in Installing Dependencies.

1. Add Wheelhouse to your Gemfile

From within your Wheelhouse Account (available soon), copy the source for your license into your app's Gemfile:

source 'http://6e76a20fd07a86d62922a4ef1da34171@gems.wheelhousecms.com/'
gem 'wheelhouse'

Run bundle install after updating your Gemfile to download and install the gems.

2. Create a symlink to the Wheelhouse media directory

Creating a media link allows your web server to statically access media files.

$ cd public
$ ln -s ../media media

If a media folder does not exist in your Rails root, Wheelhouse will create it for you on startup.

3. Run the Wheelhouse setup process

Start the rails server as you usually would and browse to http://localhost:3000/admin/setup to begin the three-stage setup process.

You will probably now want to create a new Wheelhouse theme for your content-managed pages, which can be done with rails generate wheelhouse:theme mytheme (a server restart will be required for Wheelhouse to recognize the theme).