ResourcefulParenting
====================
A rails plugin that makes working with nested resources easier.
It provides the following methods to your RESTful controllers:
* parent : Returns the most immediate parent resource
* parent(-1) : Same as parent
* parent(-2) : Returns the parent resource's parent
* parent(N) : Returns the Nth parent resource
* parent(0) : Returns the top level parent
* parents : Returns an array of all the parent resources
* polymorphic_p_url : Same as calling polymorphic_url but adding parents to the list
* polymorphic_p_path : Same as calling polymorphic_path but adding parents to the list
polymotphic_p_url and polymorphic_p_path are automatically exposed as helper methods for usage in the views. Feel free to expose the others via helper_method in your ApplicationController
Installation
============
Add to your Gemfile:
gem 'resourceful_parenting'
Example
=======
Assuming the classical problem of a comments resource nested under several different parent resources:
class CommentsController < ApplicationController
def create
# regular create work, then:
redirect_to parent # Back to the parent's show page
# OR
redirect_to polymorphic_p_url(@comment) # Back to /parents/ID/comments/ID
# OR
redirect_to polymorphic_p_url(:comments) # Back to /parents/ID/comments
end
end
Todo
====
A respectable test suite. This plugin was just a bunch of ApplicationController methods I decided to extract.
Notes
=====
There is similar functionality in other plugins, however they often do lots more which I didn't need.
This plugin was inspired after watching Ryan Bates hand-roll a custom method for doing this for the Nth time.
Copyright
=========
Copyright (c) 2009 Mina Naguib, released under the MIT license