aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authorYves Senn <yves.senn@gmail.com>2013-01-23 09:31:16 +0100
committerYves Senn <yves.senn@gmail.com>2013-02-06 20:56:09 +0100
commit69f28a7d8dfc018b948d9f70fc65a8a1b7735b8f (patch)
tree2177c3b7cf691bb201f49b52e042a66d5ea47242 /guides
parent99bb2fd892a2a876ba0f4017bd3cc87033a4deb3 (diff)
downloadrails-69f28a7d8dfc018b948d9f70fc65a8a1b7735b8f.tar.gz
rails-69f28a7d8dfc018b948d9f70fc65a8a1b7735b8f.tar.bz2
rails-69f28a7d8dfc018b948d9f70fc65a8a1b7735b8f.zip
ruby constant syntax is not supported as routing `:controller` option.
The current implementation only works correctly if you supply the `:controller` with directory notation (eg. `:controller => 'admin/posts'`). The ruby constant notation (eg. `:controller => 'Admin::Posts`) leads to unexpected problems with `url_for`. This patch prints a warning for every non supported `:controller` option. I also added documentation how to work with namespaced controllers. The warning links to that documentation in the rails guide.
Diffstat (limited to 'guides')
-rw-r--r--guides/source/routing.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/guides/source/routing.md b/guides/source/routing.md
index 14f23d4020..4614169653 100644
--- a/guides/source/routing.md
+++ b/guides/source/routing.md
@@ -832,6 +832,19 @@ will recognize incoming paths beginning with `/photos` but route to the `Images`
NOTE: Use `photos_path`, `new_photo_path`, etc. to generate paths for this resource.
+For namespaced controllers you can use the directory notation. For example:
+
+```ruby
+resources :user_permissions, controller: 'admin/user_permissions'
+```
+
+This will route to the `Admin::UserPermissions` controller.
+
+NOTE: Only the directory notation is supported. specifying the
+controller with ruby constant notation (eg. `:controller =>
+'Admin::UserPermissions'`) can lead to routing problems and results in
+a warning.
+
### Specifying Constraints
You can use the `:constraints` option to specify a required format on the implicit `id`. For example: