Module: ResourcesController::Helper

Defined in:
lib/resources_controller/helper.rb

Overview

Often it won’t be appropriate to re-use views, but sometimes it is. These helper methods enable reuse by referencing whatever resource the controller is for.

Example:

instead of writing:

<% for event in @events %>
  <%= link_to 'edit', edit_event_path(event) %>

you may write:

<% for event in resources %>
  <%= link_to 'edit', edit_resource_path(event) %>

Enclosing resource

For controllers with enclosing resources instead of writing:

<%= link_to 'back to Forum', forum_path(@forum) %>

you may write: (which will work for any enclosing path)

<%= link_to "back to #{enclosing_resource.class.name.titleize}", enclosing_resource_path %>

Enclosing named routes:

In addition you can reference named routes that are ‘below’ the current resource by appending resource_ to that named route.

Example: shared polymorphic view

Let’s say you have a resource controller for tags, and you’re writing the taggable views. In a view shared amongst taggables you can write

<%= link_to 'tags', resource_tags_path %>
<%= link_to 'edit tag', edit_resource_tag_path(@tag) %>

or:

<% for taggable in resources %>
  <%= link_to 'tags', resource_tags_path(taggable) %>

Class Method Summary collapse

Instance Method Summary collapse

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object

Delegate named_route helper method to the controller. Create the delegation to short circuit the method_missing call for future invocations.



81
82
83
84
85
86
87
88
 
# File 'lib/resources_controller/helper.rb', line 81

def method_missing(method, *args, &block)
  if controller.resource_named_route_helper_method?(method)
    self.class.send(:delegate, method, :to => :controller)
    controller.send(method, *args)
  else
    super(method, *args, &block)
  end
end

Class Method Details

.included(base) ⇒ Object 



42
43
44
45
46
 
# File 'lib/resources_controller/helper.rb', line 42

def self.included(base)
  base.class_eval do
    delegate :resource_name, :resources_name, :resource, :resources, :enclosing_resource, :enclosing_resource_name, :to => :controller
  end
end

Instance Method Details

#form_for_resource(*args, &block) ⇒ Object

DEPRECATED: you should just be able to use form_for resource

Calls form_for with the apropriate action and method for the resource

resource.new_record? is used to decide between a create or update action

You can optionally pass a resource object, default is to use self.resource

You may also override the url by passing :url, or pass extra options to resource path url with :url_options

Example

<% form_for_resource do |f| %>
  <%= f.text_field :name %>
  <%= f.submit resource.new_record? ? 'Create' : 'Update'
<% end %>

<% for attachment in resources %>
  <% form_for_resource attachment, :html => {:multipart => true} %>
    <%= f.file_field :uploaded_data %>
    <%= f.submit 'Update' %>
  <% end %>
<% end %>



73
74
75
76
77
 
# File 'lib/resources_controller/helper.rb', line 73

def form_for_resource(*args, &block)
  options = args.extract_options!
  resource = args[0] || self.resource
  form_for(resource, form_for_resource_options(resource, resource_name, options), &block)
end

#respond_to?(*args) ⇒ Boolean

delegate url help method creation to the controller

Returns:

  • (Boolean) 


91
92
93
 
# File 'lib/resources_controller/helper.rb', line 91

def respond_to?(*args)
  super(*args) || controller.resource_named_route_helper_method?(args.first)
end