=== Email Encoder Bundle ===
Contributors: freelancephp
Tags: email address, protect, antispam, mailto, spambot, secure, e-mail, email, mail, obfuscate, encode, encoder, encrypt, hide, bot, crawl, spider, robots, spam, protection, harvest, harvesting, security
Requires at least: 3.0.0
Tested up to: 3.5.1
Stable tag: 0.71
Encode mailto links and (plain) email addresses on your site and hide them from spambots. Easy to use, plugin works directly when activated.
== Description ==
Encode mailto links and (plain) email addresses on your site and hide them from spambots. Easy to use, plugin works directly when activated.
= Features =
* Protect all emails and mailto links
* Check posts, widgets, comments and RSS feeds
* Encode all kind of content (text and html)
* Email Encoder Form (in admin and also for your site)
* Use params in mailto links, like: cc, bcc, subject, body
* And more...
= Documentation =
See help tab on the plugin page in the WP Admin Panel.
= Support =
Supports PHP 4.3+ and WP 3.0+.
= Contact =
[Send your comment](http://www.freelancephp.net/email-encoder-php-class-wp-plugin/)[ or question](http://www.freelancephp.net/contact/)
== Installation ==
1. Go to `Plugins` in the Admin menu
1. Click on the button `Add new`
1. Search for `Email Encode Bundle` and click 'Install Now' or click on the `upload` link to upload `email-encode-bundle.zip`
1. Click on `Activate plugin`
== Frequently Asked Questions ==
= How do I encode my emailaddress(es)? =
In the posts you can use this shortcode:
`[email_encode email="myname@test.nl" display="My Email"]`
By default mailto links like this will also be encoded:
`My Email`
The default method is `JavaScript ASCII` the following output will be created in the source code of the page:
``
This code is not readable by spambots and protects your emailaddress.
= How to create mailto links that opens in a new window? =
You could add extra params to the mailto link and add `target='_blank'` for opening them in a new window, like:
`[encode_email email="yourmail@test.nl" display="My Mail" extra_attrs="target='_blank'"]`
In html this will look like:
`My Mail`
= How can I encode content of BBPress, WP e-Commerce or other plugins? =
If you use other plugins that needs to be encoded you can add a callback to the action "init_email_encoder_bundle".
For Example:
`add_action('init_email_encoder_bundle', 'extra_encode_filters');
function extra_encode_filters($filter_callback) {
// add filters for BBPress
add_filter('bbp_get_reply_content', $filter_callback);
add_filter('bbp_get_topic_content', $filter_callback);
}`
= How to encode emails in all widgets (and not only text widgets)? =
If the option 'All text widgets' is activated, only text widgets will be filtered for encoding.
It's possible to filter all widgets by using the Widget Logic plugin and activate the 'widget_content' filter.
[Do you have another question? Please ask me](http://www.freelancephp.net/contact/)
== Screenshots ==
1. Admin Options Page
1. Check encoded email/content when logged in as admin
1. Email Encoder Form on the Site
== Changelog ==
= 0.71 (latest) =
* Option to make own menu item (in admin panel) for this plugin
* Option for showing "successfully encoded" check
* Fixed bug showing errors for calling wrong translate function
* Fixed bug always showing encoded check on site (for html encode method)
* Added workaround for saving disabled checkboxes in options table
* Fixed bug where encoded check was also applied on output of encoding form
= 0.70 =
* Fixed bug with extra params
* Changed texts and added help tabs on admin options page
* Changed visual check for encoded mails/content by showing icon and success message
* Solved that all attributes of mailto links remain when encoding
= 0.60 =
* Added hook "init_email_encoder_form" to add custom filters (of other plugins)
* Added JavaScript code encapsulation for ASCII method
* Solved reinstalling bug for setting right encoding method
* Solved bug shortcodes encoded with HTML method
= 0.50 =
* Added encode method for all kind of contents (template function and shortcode "encode_content")
* Added extra param for additional html attributes (f.e. target="_blank")
* Added option to skip certain posts from being automatically encoded
* Added option custom protection text
* Removed "method" folder. Not possible to add own methods anymore.
* Other small changes and some refactoring
= 0.42 =
* Widget Logic options bug
= 0.41 =
* Solved bug by improving regular expression for mailto links
* Changed script attribute `language` to `type`
* Script only loaded on options page (hopefully this solves the dashboard toggle problem some people are experiencing)
* Added support for widget_content filter of the Logic Widget plugin
= 0.40 =
* Added option for setting CSS classes
* Improved RSS protection
* Removed Lim_Email_Encoder class (now all handled by the main class)
* Enabled setting checkbox for filtering posts
* Fixed PHP / WP notices
* Added param for encode methods: $obj
= 0.32 =
* Fix IE bug
* Bug plain emails
* Optional "method" param for tag and template function, f.e. [encode_email email="test@domain.com" method="ascii"]
* Small adjustments
= 0.31 =
* Fixed tiny bug (incorrect var-name $priority on line 100 of email-encoder-bundle.php)
= 0.30 =
* Added protection for emails in RSS feeds
* Improved filtering tags [encode_email ... ]
* Improved ASCII and Escape method and added noscript message
* Solved an option bug (encode mailto links VS encode plain emails)
* Made some cosmetical adjustments on the options page
* Code refactoring
= 0.22 =
* First decodes entities before encoding email
* Added more wp filters for encoding
= 0.21 =
* Changed Encoder Form: HTML markup and JavaScript
* Made some minor adjustments and fixed little bugs
= 0.20 =
* Implemented internalization (including translation for nl_NL)
* Improved user-interface of the Admin Settings Page and the Encoder Form
* Added template function: encode_email_filter()
* Kept and added only high-quality encoding methods
* Refactored the code and changed method- and var-names within the classes
* Removed 3rd param $encode_display out of the encoding methods, display should always be encoded
* Added prefix 'lim_email_' to the encoding methods
= 0.12 =
* Nothing changed, but 0.11 had some errors because /methods directory was missing in the repository.
= 0.11 =
* also possible to use encode tag in widgets by activating the "filter widget" option
= 0.10 =
* Works with PHP4 and PHP5
* Methods: default_encode, wp_antispambot, anti_email_spam, email_escape, hide_email
* Use the tags: `[email_encode email=".." display=".."]`, `[email_encoder_form]`
* Template function: `email_encode()`
== Other Notes ==
= Credits =
* [Adam Hunter](http://blueberryware.net) for the encode method 'JavaScript Escape' which is taken from his plugin [Email Spam Protection](http://blueberryware.net/2008/09/14/email-spam-protection/)
* [Tyler Akins](http://rumkin.com) for the encode method 'JavaScript ASCII Mixer'
* Title icon on Admin Options Page was made by [Jack Cai](http://www.doublejdesign.co.uk/)