namespace
- 1.0.0
- 1.1.6
- 1.2.6
- 2.0.3
- 2.1.0
- 2.2.1
- 2.3.8
- 3.0.0 (0)
- 3.0.9 (38)
- 3.1.0 (-6)
- 3.2.1 (-4)
- 3.2.8 (0)
- 3.2.13 (0)
- 4.0.2 (0)
- 4.1.8 (0)
- 4.2.1 (0)
- 4.2.7 (0)
- 4.2.9 (0)
- 5.0.0.1 (0)
- 5.1.7 (0)
- 5.2.3 (0)
- 6.0.0 (0)
- 6.1.3.1
- 6.1.7.7
- 7.0.0
- 7.1.3.2
- 7.1.3.4
- What's this?
namespace(path, options = {})
public
Scopes routes to a specific namespace. For example:
namespace :admin do resources :posts end
This generates the following routes:
admin_posts GET /admin/posts(.:format) admin/posts#index admin_posts POST /admin/posts(.:format) admin/posts#create new_admin_post GET /admin/posts/new(.:format) admin/posts#new edit_admin_post GET /admin/posts/:id/edit(.:format) admin/posts#edit admin_post GET /admin/posts/:id(.:format) admin/posts#show admin_post PUT /admin/posts/:id(.:format) admin/posts#update admin_post DELETE /admin/posts/:id(.:format) admin/posts#destroy
Options
The :path, :as, :module, :shallow_path and :shallow_prefix options all default to the name of the namespace.
For options, see Base#match. For :shallow_path option, see Resources#resources.
Examples
# accessible through /sekret/posts rather than /admin/posts namespace :admin, :path => "sekret" do resources :posts end # maps to <tt>Sekret::PostsController</tt> rather than <tt>Admin::PostsController</tt> namespace :admin, :module => "sekret" do resources :posts end # generates +sekret_posts_path+ rather than +admin_posts_path+ namespace :admin, :as => "sekret" do resources :posts end
Without module
If you want to have only the path prefix without namespacing your controller, pass :module => false.
Normal:
namespace :account do resources :transactions, :only => [:index] end account_transactions GET /account/transactions(.:format) {:controller=>"account/transactions", :action=>"index"}
With :module => false:
namespace :account, :module => false do resources :transactions, :only => [:index] end account_transactions GET /account/transactions(.:format) {:controller=>"transactions", :action=>"index"}
with a params constant
If you want to have a params with the same value on all of the urls in this namespace, you can write this :
with a constant param :admin set to true
namespace :admin, :admin => true do resources :posts end
all of the urls like /admin/post have a param :admin with the value true.
It works also with :
scope 'admin', :admin => true do ... end match 'administration', :admin => true => 'posts#index' get 'administration', :admin => true
etc…