method

mail_to

v1.1.6 - Show latest stable - Class: ActionView::Helpers::UrlHelper

mail_to(email_address, name = nil, html_options = {})

public

Creates a link tag for starting an email to the specified email_address, which is also used as the name of the link unless name is specified. Additional <a href="/rails/HTML">HTML</a> options, such as class or id, can be passed in the html_options hash.

You can also make it difficult for spiders to harvest email address by obfuscating them. Examples:

  mail_to "[email protected]", "My email", :encode => "javascript"  # =>
    <script type="text/javascript" language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%69%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%22%3e%4d%79%20%65%6d%61%69%6c%3c%2f%61%3e%27%29%3b'))</script>

  mail_to "[email protected]", "My email", :encode => "hex"  # =>
    <a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d">My email</a>

You can also specify the cc address, bcc address, subject, and body parts of the message header to create a complex e-mail using the corresponding cc, bcc, subject, and body html_options keys. Each of these options are URI escaped and then appended to the email_address before being output. Be aware that javascript keywords will not be escaped and may break this feature when encoding with javascript. Examples:

  mail_to "[email protected]", "My email", :cc => "[email protected]", :bcc => "[email protected]", :subject => "This is an example email", :body => "This is the body of the message."   # =>
    <a href="mailto:[email protected]?cc="ccaddress@domain.com"&bcc="bccaddress@domain.com"&body="This%20is%20the%20body%20of%20the%20message."&subject="This%20is%20an%20example%20email">My email</a>

# File actionpack/lib/action_view/helpers/url_helper.rb, line 208
      def mail_to(email_address, name = nil, html_options = {})
        html_options = html_options.stringify_keys
        encode = html_options.delete("encode")
        cc, bcc, subject, body = html_options.delete("cc"), html_options.delete("bcc"), html_options.delete("subject"), html_options.delete("body")

        string = ''
        extras = ''
        extras << "cc=#{CGI.escape(cc).gsub("+", "%20")}&" unless cc.nil?
        extras << "bcc=#{CGI.escape(bcc).gsub("+", "%20")}&" unless bcc.nil?
        extras << "body=#{CGI.escape(body).gsub("+", "%20")}&" unless body.nil?
        extras << "subject=#{CGI.escape(subject).gsub("+", "%20")}&" unless subject.nil?
        extras = "?" << extras.gsub!(/&?$/,"") unless extras.empty?

        email_address_obfuscated = email_address.dup
        email_address_obfuscated.gsub!(/@/, html_options.delete("replace_at")) if html_options.has_key?("replace_at")
        email_address_obfuscated.gsub!(/\./, html_options.delete("replace_dot")) if html_options.has_key?("replace_dot")

        if encode == 'javascript'
          tmp = "document.write('#{content_tag("a", name || email_address, html_options.merge({ "href" => "mailto:"+email_address.to_s+extras }))}');"
          for i in 0...tmp.length
            string << sprintf("%%%x",tmp[i])
          end
          "<script type=\"text/javascript\">eval(unescape('#{string}'))</script>"
        elsif encode == 'hex'
          for i in 0...email_address.length
            if email_address[i,1] =~ /\w/
              string << sprintf("%%%x",email_address[i])
            else
              string << email_address[i,1]
            end
          end
          content_tag "a", name || email_address_obfuscated, html_options.merge({ "href" => "mailto:#{string}#{extras}" })
        else
          content_tag "a", name || email_address_obfuscated, html_options.merge({ "href" => "mailto:#{email_address}#{extras}" })
        end
      end

2Notes

Javascript encoding DOES work!

Bounga · Jan 20, 20095 thanks

grosser assertion is false :

mail_to('[email protected]', nil, :encode => :javascript)
# => "<script type=\\"text/javascript\\">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%69%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%78%78%78%40%78%78%78%2e%63%6f%6d%22%3e%78%78%78%40%78%78%78%2e%63%6f%6d%3c%2f%61%3e%27%29%3b'))</script>"

Use "nil" as the second parameter to tell mail_to that you want to use the first parameter for both text and email link

email_to('xxx@xxx','xxx@xxx',:encode=>'javascript') does NOT work

grosser · Aug 1, 20082 thanks

as i always want the email in the link text, email_to does not help me...

so here comes the rescue!

#http://unixmonkey.net/?p=20
# Takes in an email address and (optionally) anchor text,
# its purpose is to obfuscate email addresses so spiders and
# spammers can't harvest them.
def js_antispam_email_link(email, linktext=email)
user, domain = email.split('@')
# if linktext wasn't specified, throw email address builder into js document.write statement
linktext = "'+'#{user}'+'@'+'#{domain}'+'" if linktext == email 
out =  "<noscript>#{linktext} #{user}(ät)#{domain}</noscript>\

" out += "
" return out end

mail_to

2Notes

Javascript encoding DOES work!

email_to('xxx@xxx','xxx@xxx',:encode=>'javascript') does NOT work

Related methods