aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/routing.md
diff options
context:
space:
mode:
authorBryan Larsen <bryan@larsen.st>2012-09-25 13:29:53 -0300
committerBryan Larsen <bryan@larsen.st>2012-09-25 13:29:53 -0300
commit2029c2ac18c12a08f0ddfdcadf90e50c54520895 (patch)
tree1a803cbd3e8b4141bf2904afebf889e5499ab222 /guides/source/routing.md
parentbfafa999ddaa203224ac0222203517a0d2a3f6bf (diff)
downloadrails-2029c2ac18c12a08f0ddfdcadf90e50c54520895.tar.gz
rails-2029c2ac18c12a08f0ddfdcadf90e50c54520895.tar.bz2
rails-2029c2ac18c12a08f0ddfdcadf90e50c54520895.zip
Update guides/source/routing.md
Diffstat (limited to 'guides/source/routing.md')
-rw-r--r--guides/source/routing.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/guides/source/routing.md b/guides/source/routing.md
index 27fd2a35c4..3acb7fa0e5 100644
--- a/guides/source/routing.md
+++ b/guides/source/routing.md
@@ -401,6 +401,18 @@ resources :photos do
end
```
+#### Adding Routes for Additional New Actions
+
+To add an alternate new action using the `:on` shortcut:
+
+```ruby
+resources :comments do
+ get 'preview', :on => :new
+end
+```
+
+This will enable Rails to recognize paths such as `/comments/new/preview` with GET, and route to the `preview` action of `CommentsController`. It will also create the `preview_new_comment_url` and `preview_new_comment_path` route helpers.
+
#### A Note of Caution
If you find yourself adding many extra actions to a resourceful route, it's time to stop and ask yourself whether you're disguising the presence of another resource.