module ActionDispatch::Routing::Mapper::Resources

resources :posts, path: "admin/posts"
# resource actions are at /admin/posts.

resources :posts, module: "admin"
# routes call Admin::PostsController

### Examples


: Allows you to override the default param name of `:id` in the URL.
:param

disable it by supplying `false`.
: Allows you to specify the default value for optional `format` segment or
:format

sekret_comment DELETE /comments/:id(.:format)
sekret_comment PATCH/PUT /comments/:id(.:format)
sekret_comment GET /comments/:id(.:format)
edit_sekret_comment GET /comments/:id/edit(.:format)
new_post_comment GET /posts/:post_id/comments/new(.:format)
post_comments POST /posts/:post_id/comments(.:format)
post_comments GET /posts/:post_id/comments(.:format)

it:
The `comments` resource here will have the following routes generated for

end
end
resources :comments, shallow: true
resources :posts do
scope shallow_prefix: "sekret" do

: Prefixes nested shallow route names with specified prefix.
:shallow_prefix

comment DELETE /sekret/comments/:id(.:format)
comment PATCH/PUT /sekret/comments/:id(.:format)
comment GET /sekret/comments/:id(.:format)
edit_comment GET /sekret/comments/:id/edit(.:format)
new_post_comment GET /posts/:post_id/comments/new(.:format)
post_comments POST /posts/:post_id/comments(.:format)
post_comments GET /posts/:post_id/comments(.:format)

it:
The `comments` resource here will have the following routes generated for

end
end
resources :comments, shallow: true
resources :posts do
scope shallow_path: "sekret" do

: Prefixes nested shallow routes with the specified path.
:shallow_path

parameter.
Set `shallow: false` on a child resource to ignore a parent's shallow

to be shortened to just `/comments/1234`.
as a comment on a blog post like `/posts/a-long-permalink/comments/1234`
This allows URLs for resources that otherwise would be deeply nested such

resources :comments, only: [:show, :edit, :update, :destroy]
end
resources :comments, except: [:show, :edit, :update, :destroy]
resources :posts do

Is the same as:

end
resources :comments
resources :posts, shallow: true do

resource, generates shallow routes for all nested resources.
: Generates shallow routes for nested resource(s). When placed on a parent
:shallow

resources :cows, except: [:show, :index]
resources :cows, except: :show

: Generate all routes except for the given actions.
:except

resources :cows, only: [:show, :index]
resources :cows, only: :show

: Only generate routes for the given actions.
:only

/posts.
The resource and all segments will now route to /postings instead of

resources :posts, path: 'postings'

: Allows you to change the path prefix for the resource.
:path

The above example will now change /posts/new to /posts/brand_new.

resources :posts, path_names: { new: "brand_new" }

actions. Actions not specified are not changed.
: Allows you to change the segment component of the `edit` and `new`
:path_names

Takes same options as [match](rdoc-ref:Base#match) as well as:
### Options

DELETE /photos/:photo_id/comments/:id
PATCH/PUT /photos/:photo_id/comments/:id
GET /photos/:photo_id/comments/:id/edit
GET /photos/:photo_id/comments/:id
POST /photos/:photo_id/comments
GET /photos/:photo_id/comments/new
GET /photos/:photo_id/comments

This generates the following comments routes:

end
resources :comments
resources :photos do

Resources can also be nested infinitely by using this block syntax:

DELETE /photos/:id
PATCH/PUT /photos/:id
GET /photos/:id/edit
GET /photos/:id
POST /photos
GET /photos/new
GET /photos

`Photos` controller:
creates seven different routes in your application, all mapping to the

resources :photos

CRUD operations in a database. A single entry in the routing file, such as
and controller actions. By convention, each action also maps to particular
In Rails, a resourceful route provides a mapping between HTTP verbs and URLs

def resources(*resources, &block)
  options = resources.extract_options!.dup
  if apply_common_behavior_for(:resources, resources, options, &block)
    return self
  end
  with_scope_level(:resources) do
    options = apply_action_options :resources, options
    resource_scope(Resource.new(resources.pop, api_only?, @scope[:shallow], options)) do
      yield if block_given?
      concerns(options[:concerns]) if options[:concerns]
      collection do
        get  :index if parent_resource.actions.include?(:index)
        post :create if parent_resource.actions.include?(:create)
      end
      new do
        get :new
      end if parent_resource.actions.include?(:new)
      set_member_mappings_for_resource
    end
  end
  self
end