h1. Radiant CMS Portfolio Management Tool

A straight-forward project management gallery originally designed for creative agencies to display their work on a Radiant CMS-based website.

Note: this version has been updated for Radiant 0.9.x. If you are using an older version of Radiant, please checkout the 0.8 branch.

h1. Features

• Allows you to create a portfolio gallery in Radiant and display on a page.
• In addition to naming the project, providing a url, and main description, the tool also allows you to upload supporting images of the project complete with drag-and-drop order sorting.
• Projects can be tagged to categorize them on the front-end display.
• Front-end display includes Previous/Next functionality to navigate between projects.
• Image gallery is pulled-in to the Flash via and XML file produced in the image.rxml view in app/view/projects.
• Included is index.rxml to provide an xml feed of all project data in the database if you need it.

h1. Requirements

*Radiant Extensions* Shared-Layout, "http://github.com/radiant/radiant-share-layouts-extension":http://github.com/radiant/radiant-share-layouts-extension

*Imagemagick*
"http://www.imagemagick.org/script/index.php":http://www.imagemagick.org/script/index.php

*SWFObject*
"http://blog.deconcept.com/swfobject":http://blog.deconcept.com/swfobject

*Gems/Plugins*
Paperclip, "http://github.com/thoughtbot/paperclip":http://github.com/thoughtbot/paperclip

Rmagick, "http://rmagick.rubyforge.org":http://rmagick.rubyforge.org

h1. How to Install

Grab the extensions from GitHub and place it in vendor/extensions

  git clone git://github.com/scullygroup/radiant-portfolio.git vendor/extensions/portfolio

Run the following commands:

  rake radiant:extensions:portfolio:migrate
  rake radiant:extensions:portfolio:update

h1. Notes

In your template, reference swfobject.js:

Be sure to vendor Paperclip in environment.rb

config.gem 'paperclip'

This extension uses Sean Cribbs excellent radiant-share-layouts-extension (http://github.com/radiant/radiant-share-layouts-extension). The project show view is wrapped in a block (in this example, this queries the body column):

<% content_for :p_body do %>

In order to invoke the view on a Radiant page, create a layout called "Project" and insert the following radial tags wherever you want the gallery to appear:

You can, of course, style these however you wish, but this will pull all database fields for the portfolio project. A particular project is viewed using a RESTful URL (e.g. http://www.mydomain.com/project/:id). Previous/Next links are also displayed in order to navigate between projects. Copyright (c) 2010 Scully Group, released under the MIT License