Module ActionController::UrlWriter
In: vendor/rails/actionpack/lib/action_controller/url_rewriter.rb

Write URLs from arbitrary places in your codebase, such as your mailers.

Example: 

  class MyMailer
    include ActionController::UrlWriter
    default_url_options[:host] = 'www.basecamphq.com'

    def signup_url(token)
      url_for(:controller => 'signup', action => 'index', :token => token)
    end
 end

In addition to providing url_for, named routes are also accessible after including UrlWriter.

Methods

url_for  

Public Instance methods

url_for(options)

Generate a url with the provided options. The following special options may effect the constructed url: 

  * :host Specifies the host the link should be targetted at. This option
    must be provided either explicitly, or via default_url_options.
  * :protocol The protocol to connect to. Defaults to 'http'
  * :port Optionally specify the port to connect to.

[Source]

    # File vendor/rails/actionpack/lib/action_controller/url_rewriter.rb, line 40
40:     def url_for(options)
41:       options = self.class.default_url_options.merge(options)
42:       
43:       raise "Missing host to link to! Please provide :host parameter or set default_url_options[:host]" unless options[:host]
44:       
45:       url = ''
46:       url << (options.delete(:protocol) || 'http')
47:       url << '://'
48:       url << options.delete(:host)
49:       url << ":#{options.delete(:port)}" if options.key?(:port)
50:       url << Routing::Routes.generate(options, {})
51:       return url
52:     end

[Validate]