actionview-encoded_mail_to
Deprecated support for email address obfuscation within the mail_to helper method. Restores the options :encode
, :replace_at
, and :replace_dot
, which were removed from Rails in version 4.0.
Any call to mail_to that doesn't include any of these options will be passed through to the core mail_to helper (in ActionView::Helpers::UrlHelper).
Installation
Add this line to your application's Gemfile:
gem 'actionview-encoded_mail_to'
And then execute:
$ bundle
Or install it yourself as:
$ gem install actionview-encoded_mail_to
Usage
Use the mail_to
helper method just as you did prior to Rails 4.0.
Restored Options
-
:encode
- This key will accept the strings "javascript" or "hex". Passing "javascript" will dynamically create and encode the mailto link then eval it into the DOM of the page. This method will not show the link on the page if the user has JavaScript disabled. Passing "hex" will hex encode the email_address before outputting the mailto link. -
:replace_at
- When the link name isn't provided, the email_address is used for the link label. You can use this option to obfuscate the email_address by substituting the @ sign with the string given as the value. -
:replace_dot
- When the link name isn't provided, the email_address is used for the link label. You can use this option to obfuscate the email_address by substituting the.
in the email with the string given as the value.
Examples
mail_to "me@domain.com", "My email", encode: "javascript"
# => <script id="mail_to-sz6xohiu">eval(decodeURIComponent('%64%6f%63...%27%29%3b'))</script>
mail_to "me@domain.com", "My email", encode: "hex"
# => <a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d">My email</a>
mail_to "me@domain.com", nil, replace_at: "_at_", replace_dot: "_dot_", class: "email"
# => <a href="mailto:me@domain.com" class="email">me_at_domain_dot_com</a>
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request