RealApps Content Management System
===

This plugin will generate the components necessary for a lightweight content management system. It is designed to be a base upon which you can build.

To install the CMS, first make sure the plugin is unzipped in the vendor/plugins/realapps_cms directory.  Then go to the root directory of your rails application and type these two commands:

	ruby script/generate realapps_cms # creates CMS components
	rake migrate # creates the cms_contents, cms_contents_live table in your database
	rake migrate RAILS_ENV=production # creates the same tables in your production environment

The first command will create the necessary files in your components/ directory to install the CMS. The second command will create the database tables necessary for the CMS in your development database.

If you wish, you can ensure the installation is working by running unit and functional tests:

	rake test_units
	rake test_functional

Next, you must first configure a username and password for the CMS. Open the generated file components/realapps/cms_authorization_config.rb. Update the two lines found inside:

	Realapps::Cms::Authorization.username = <username>
	Realapps::Cms::Authorization.password = <password>

The CMS administrative pages will not run without this configuration. Now, to access the CMS itself, use this URL:

	/realapps/cms

Add any content you wish, and give each piece a unique 'placement ID'. Your own views can then display the content using this call:

	<%= @controller.publish(<placement id>) %>

The accompanying USER_GUIDE gives more information, and is intended to distribute to end users of the CMS. You, as the programmer, should be able to hand it to anyone for whom you implement a CMS.

Find out more about the CMS, and other Kinetic Theory RealApps, by following the links below:

http://www.kinetictheoryinc.com/realapps - Home for all of Kinetic Theory's Real Apps projects.
http://realapps-cms.rubyforge.org/ - Project files specific to the CMS.

License
===

Copyright (c) 2006 Kinetic Theory, Inc.

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
