=== Email Encoder Bundle ===
Contributors: freelancephp
Tags: email, hide, mailto, spam, protection, spambots, encoder, encrypt, encode, obfuscate, antispam, spamming
Requires at least: 2.7.0
Tested up to: 3.5.0
Stable tag: 0.60

Protect email addresses on your site from spambots and being used for spamming. This plugin encodes all email adresses so spambots cannot read them.

== Description ==

Protect email addresses on your site from spambots and being used for spamming. This plugin encodes all email adresses so spambots cannot read them.

= Features =
* Protect plain emails and mailto links
* Encode all kind of content (text and html)
* Scanning posts, widgets, comments and RSS feeds
* Choose one of the high-quality encoding methods
* Supports querystrings like 'info@myemail.com?subject=Plugin'
* Put an Email Encoder Form on your site

= Tags =
Encode the given email, "display" is optional:
`[encode_email email="..." display="..."]`

Encode content, "method" is optional:
`[encode_content method="..."]...[/encode_content]`

Puts an encoder form in your post:
`[email_encoder_form]`

= Template functions =
Encode the given email (other params are optional):
`<?php echo encode_email($email, [$display], [$method], [$extra_attrs]); ?>`

Encode the given content for emails to encode (other param is optional):
`<?php echo encode_content($content, [$method]); ?>`

Filter the given content for emails to encode (other params are optional):
`<?php echo encode_email_filter($content, [$enc_tags], [$enc_mailtos], [$enc_plain_emails]); ?>`

= Hooks =
Add extra code on initialize the Email Encoder Bundle (f.e. add extra filters for encoding):
`add_action('init_email_encoder_bundle', 'extra_encode_filters');

function extra_encode_filters($filter_callback) {
	add_filter('some_filter', $filter_callback);
}`

= Support =
Supports PHP4.3+ and up to latest WP version.

= Contact =
[Send our 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 the option `Encode mailto links` and that means this of html snippet will also be encoded:
`<a href="mailto:myname@test.nl">My Email</a>`

The default method is `JavaScript ASCII` the following output will be created in the source code of the page:
`<script type="text/javascript">/*<![CDATA[*/ML="mo@k<insc:r.y=-Ehe a\">f/lMt";MI="4CB8HC77=D0C5HJ1>H563DB@:AF=D0C5HJ190<6C0A2JA7J;6HDBBJ5JHA=DI<B?0C5HDEI<B?0C5H4GCE";OT="";for(j=0;j<MI.length;j++){OT+=ML.charAt(MI.charCodeAt(j)-48);}document.write(OT);/*]]>*/</script><noscript>*protected email*</noscript>`

This code is not readable by spambots and protects your emailaddress.

= Which encoding method should I use? =

The `Html Encode` method is a simple method. Probably JavaScript methods like JavaScript ASCII` would be a better protection against spambots.

= 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'"]`

= How can I encode content of BBPress plugin? =

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_filter('bbp_get_reply_content', $filter_callback);
	add_filter('bbp_get_topic_content', $filter_callback);
}`

= How to encode emails in ALL 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. Email Encoder Form on the Site

== Changelog ==

= 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/)