atd / station

Rails Content Management System engine

This URL has Read+Write access

name age
history
message
file LGPL-LICENSE Mon Jan 28 08:46:44 -0800 2008 Initial import git-svn-id: svn+ssh://rubyfor... [atd]
file README.rdoc Thu Oct 29 08:59:02 -0700 2009 Merge categories and tags [atd]
file Rakefile Tue Oct 06 08:54:54 -0700 2009 Documentation [atd]
directory app/ Mon Dec 21 06:19:47 -0800 2009 Clearer and safer code in OpenidServerControlle... [atd]
directory config/ Fri Nov 20 09:17:13 -0800 2009 Tags list [atd]
directory db/ Fri Nov 06 01:53:33 -0800 2009 Add Tag#taggings_count [atd]
directory doc/ Mon Feb 02 03:19:42 -0800 2009 Enhance doc git-svn-id: svn+ssh://rubyforge.or... [atd]
directory examples/ Tue Dec 22 08:39:25 -0800 2009 Copy Oxygen icons task [atd]
directory generators/ Fri Jan 08 02:21:28 -0800 2010 Fix params_from_atom method in scaffold model [atd]
file init.rb Fri Nov 13 04:19:22 -0800 2009 Merge vcc branch: tags and categories merged, s... [atd]
file install.rb Fri May 08 03:26:24 -0700 2009 Station Refactorization [atd]
directory lib/ Fri Jan 08 09:01:55 -0800 2010 Use block_given? syntax in StationResources#index [atd]
directory tasks/ Tue Dec 22 08:39:25 -0800 2009 Copy Oxygen icons task [atd]
directory test/ Mon Jan 28 08:46:44 -0800 2008 Initial import git-svn-id: svn+ssh://rubyfor... [atd]
file uninstall.rb Mon Jan 28 08:46:44 -0800 2008 Initial import git-svn-id: svn+ssh://rubyfor... [atd]
README.rdoc

Station

Station is to Rails in Content Management System like Rails is to Ruby in Web Development. 

  Rails   = Ruby  + Web Development
  Station = Rails + Content Management

Station provides your Rails application with a "CMS framework". This means authentication, authorization, roles, permissions, tags, etc… but from a very flexible scope.

Webpage - Blog - Code - Documentation

Features

  • Authentication: Login/Password, OpenID, Central Authentication Service (CAS), CookieToken
  • Authorization: Access Control, Roles and Permissions (RBAC)
  • Activation: Email validation, Password reset
  • Atom feeds, RFC 4287
  • AtomPub protocol, RFC 5023
  • Taxonomies: Categories, Categories Domains
  • Folksonomies: Tags, Taggable models
  • Logos for models
  • Sortable lists for models
  • Integration with exception_notification plugin

Requirements

  • Rails 2.3.4
  • RubyGems:
    • mislav-will_paginate
    • ruby-openid (optional)
    • atom-tools (optional)
    • hpricot (optional)
  • Rails Plugins:
    • attachment_fu
    • exception_notification (optional)

Installation

Plugins

You need attachment_fu for Logos and Attachments support: 

  script/plugin install git://github.com/atd/attachment_fu.git

To install Station, run: 

  script/plugin install -r stable git://github.com/atd/station.git

Install exception_notification plugin if you want to receive debugging emails from your application 

  script/plugin install git://github.com/rails/exception_notification.git

Gems

Run rake gems:install to install the required gem, mislav-will_paginate

You can install this aditional gems:

  • ruby-openid, for OpenID authentication support
  • atom-tools, for AtomPub support
  • hpricot, for HTML discovery

Architecture

You can add this functionality to any of your ActiveRecord models:

Basic

ActiveRecord::Resource:a model that have, at least, CRUD operations and can be imported/exported in different formats.
ActiveRecord::Content:a Resource that belongs to a Container, e.g. a Post
ActiveRecord::Container:a model that have many Contents, e.g. a Space
ActiveRecord::Agent:a model with authentication, authorization and potencial to perform actions over Resources, e.g. a User
ActiveRecord::Stage:a model that defines an RBAC Authorization framework for Agents, e.g. a Group

Complements

ActiveRecord::CategoriesDomain:a model which instances define Ontology domains
ActiveRecord::Categorizable:a model that can be classified in any Category
ActiveRecord::Taggable:a model that can be tagged
ActiveRecord::Logoable:a model with Logo
ActiveRecord::Sortable:a model with a sortable list

Generators

Agents

An Agent has the capability to post Contents to Containers. An User is the example of Agent 

  script/generate station_agent Model

Resources

  script/generate station_scaffold Model attributes

Example

Blog

Create personal blogs with a pair of commands: 

  script/generate station_agent User
  script/generate station_scaffold Article content:text

  rake db:migrate

Users now can entry their own Articles

You can add AtomPub support for Articles creation. You must implement params_from_atom method in Article model: 

  def self.params_from_atom(entry)
    { :body => entry.content.xml.to_s }
  end

TODO

  • Agents authentication support: OAuth
  • Microformats
  • RDF: FOAF + SIOC

Copyright © 2008-2009 Antonio Tapiador, released under the LGPL license