Skip to content
peakpg edited this page Mar 28, 2012 · 42 revisions

BrowserCMS is a general purpose, open source Web Content Management System (CMS), written in Ruby on Rails. It is designed to support three distinct groups of people:

  1. Non-technical web editors who want a humane system to manage their site, without needing to understand what HTML or even Rails is.
  2. Designers who want to create large and elegantly designed websites with no artificial constraints by the CMS.
  3. Developers who want create CMS driven websites for their clients, or add a CMS to their Rails applications.
  • There is another sequence of reading these documents, as given by the numbers in parenthesis.

Documentation / Guides

  1. Getting Started – (1) Installing BrowserCMS and creating your first project.
  2. User's Manual – (5) How site builders can use the user interface to create sites.
  3. Upgrading a BrowserCMS Project – (2) How to upgrade your project to a newer version.
  4. Deployment Guide – How to configure your production server (using Apache/Passenger)
  5. Articles – A list of articles contributed by the Community on how to use, customize and extend BrowserCMS.
  6. API DocsYARD API documents for the latest version of the project.
  7. Proposals – A landing page for proposals that would be significant changes or improvements to either the Core CMS or modules.
  8. Adding BrowserCMS to an Existing Rails project – A guide to ‘CMSifying’ your existing Rails appliciation
  9. Setting up Mobile Sites – A guide to configuring BrowserCMS to serve mobile content. – Coming in v3.5, see [bcms_mobile](https://github.com/browsermedia/bcms_mobile) until then

Extending BrowserCMS

  1. Content Blocks – (6) How to defining new content types for your site.
  2. Portlets – (7) How to fetch and dynamically display content
  3. Templates – (3) How to create a theme/design for a site.
  4. Building BrowserCMS from Edge – How to work with the very latest version of BrowserCMS from github
  5. Controllers with Authentication – How to create ActionControllers which use CMS authentication
  6. Working with the Content API – Understanding a few of the ‘gotchas’ between ActiveRecord and Content Blocks.

Modules

  1. Installing a Module – (4) How to add new functionality (modules) to your project
  2. Building Modules – Creating your own modules to share with the community.
  3. Upgrading modules to 3.3 – How to update modules to BrowserCMS 3.3 / Rails 3.
  4. Module List – Modules are the reusable way for developers to extends and share new BrowserCMS functionality.

Reference guides for older versions (BrowserCMS 3.1) are still available.

Code Tips / Snippets

Check out our page with some handy tips and snippets

Contributing to the Project

Discussion

If you have questions, you can also find us in a few places.

  1. Our google group/mailing list.
  2. On Twitter at @browsercms.
  3. In IRC at irc.freenode.net #browsercms
Clone this wiki locally