email-encoder-bundle
Last commit date
images
13 years ago
js
13 years ago
lang
13 years ago
email-encoder-bundle.php
13 years ago
readme.txt
13 years ago
screenshot-1.png
13 years ago
screenshot-2.png
13 years ago
screenshot-3.png
13 years ago
readme.txt
178 lines
| 1 | === Email Encoder Bundle === |
| 2 | Contributors: freelancephp |
| 3 | 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 |
| 4 | Requires at least: 3.0.0 |
| 5 | Tested up to: 3.5.1 |
| 6 | Stable tag: 0.70 |
| 7 | |
| 8 | Encode mailto links and (plain) email addresses and hide them from spambots. Easy to use, plugin works directly when activated. Save way to protect email addresses on your site. |
| 9 | |
| 10 | == Description == |
| 11 | |
| 12 | Encode mailto links and (plain) email addresses and hide them from spambots. Easy to use, plugin works directly when activated. Save way to protect email addresses on your site. |
| 13 | |
| 14 | = Features = |
| 15 | * Protect all emails and mailto links |
| 16 | * Check posts, widgets, comments and RSS feeds |
| 17 | * Encode all kind of content (text and html) |
| 18 | * Email Encoder Form (in admin and also for your site) |
| 19 | * Use params in mailto links, like: cc, bcc, subject, body |
| 20 | * And more... |
| 21 | |
| 22 | = Documentation = |
| 23 | See help tab on the plugin page in the WP Admin Panel. |
| 24 | |
| 25 | = Support = |
| 26 | Supports PHP 4.3+ and WP 3.0+. |
| 27 | |
| 28 | = Contact = |
| 29 | [Send your comment](http://www.freelancephp.net/email-encoder-php-class-wp-plugin/)[ or question](http://www.freelancephp.net/contact/) |
| 30 | |
| 31 | == Installation == |
| 32 | |
| 33 | 1. Go to `Plugins` in the Admin menu |
| 34 | 1. Click on the button `Add new` |
| 35 | 1. Search for `Email Encode Bundle` and click 'Install Now' or click on the `upload` link to upload `email-encode-bundle.zip` |
| 36 | 1. Click on `Activate plugin` |
| 37 | |
| 38 | == Frequently Asked Questions == |
| 39 | |
| 40 | = How do I encode my emailaddress(es)? = |
| 41 | |
| 42 | In the posts you can use this shortcode: |
| 43 | `[email_encode email="myname@test.nl" display="My Email"]` |
| 44 | |
| 45 | By default mailto links like this will also be encoded: |
| 46 | `<a href="mailto:myname@test.nl">My Email</a>` |
| 47 | |
| 48 | The default method is `JavaScript ASCII` the following output will be created in the source code of the page: |
| 49 | `<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>` |
| 50 | |
| 51 | This code is not readable by spambots and protects your emailaddress. |
| 52 | |
| 53 | = How to create mailto links that opens in a new window? = |
| 54 | |
| 55 | You could add extra params to the mailto link and add `target='_blank'` for opening them in a new window, like: |
| 56 | `[encode_email email="yourmail@test.nl" display="My Mail" extra_attrs="target='_blank'"]` |
| 57 | |
| 58 | In html this will look like: |
| 59 | `<a href="mailto:yourmail@test.nl" target="_blank">My Mail</a>` |
| 60 | |
| 61 | = How can I encode content of BBPress, WP e-Commerce or other plugins? = |
| 62 | |
| 63 | If you use other plugins that needs to be encoded you can add a callback to the action "init_email_encoder_bundle". |
| 64 | For Example: |
| 65 | |
| 66 | `add_action('init_email_encoder_bundle', 'extra_encode_filters'); |
| 67 | |
| 68 | function extra_encode_filters($filter_callback) { |
| 69 | // add filters for BBPress |
| 70 | add_filter('bbp_get_reply_content', $filter_callback); |
| 71 | add_filter('bbp_get_topic_content', $filter_callback); |
| 72 | }` |
| 73 | |
| 74 | = How to encode emails in all widgets (and not only text widgets)? = |
| 75 | |
| 76 | If the option 'All text widgets' is activated, only text widgets will be filtered for encoding. |
| 77 | It's possible to filter all widgets by using the Widget Logic plugin and activate the 'widget_content' filter. |
| 78 | |
| 79 | [Do you have another question? Please ask me](http://www.freelancephp.net/contact/) |
| 80 | |
| 81 | == Screenshots == |
| 82 | |
| 83 | 1. Admin Options Page |
| 84 | 1. Check encoded email/content when logged in as admin |
| 85 | 1. Email Encoder Form on the Site |
| 86 | |
| 87 | == Changelog == |
| 88 | |
| 89 | = 0.70 (latest) = |
| 90 | * Fixed bug with extra params |
| 91 | * Changed texts and added help tabs on admin options page |
| 92 | * Changed visual check for encoded mails/content by showing icon and success message |
| 93 | * Solved that all attributes of mailto links remain when encoding |
| 94 | |
| 95 | = 0.60 = |
| 96 | * Added hook "init_email_encoder_form" to add custom filters (of other plugins) |
| 97 | * Added JavaScript code encapsulation for ASCII method |
| 98 | * Solved reinstalling bug for setting right encoding method |
| 99 | * Solved bug shortcodes encoded with HTML method |
| 100 | |
| 101 | = 0.50 = |
| 102 | * Added encode method for all kind of contents (template function and shortcode "encode_content") |
| 103 | * Added extra param for additional html attributes (f.e. target="_blank") |
| 104 | * Added option to skip certain posts from being automatically encoded |
| 105 | * Added option custom protection text |
| 106 | * Removed "method" folder. Not possible to add own methods anymore. |
| 107 | * Other small changes and some refactoring |
| 108 | |
| 109 | = 0.42 = |
| 110 | * Widget Logic options bug |
| 111 | |
| 112 | = 0.41 = |
| 113 | * Solved bug by improving regular expression for mailto links |
| 114 | * Changed script attribute `language` to `type` |
| 115 | * Script only loaded on options page (hopefully this solves the dashboard toggle problem some people are experiencing) |
| 116 | * Added support for widget_content filter of the Logic Widget plugin |
| 117 | |
| 118 | = 0.40 = |
| 119 | * Added option for setting CSS classes |
| 120 | * Improved RSS protection |
| 121 | * Removed Lim_Email_Encoder class (now all handled by the main class) |
| 122 | * Enabled setting checkbox for filtering posts |
| 123 | * Fixed PHP / WP notices |
| 124 | * Added param for encode methods: $obj |
| 125 | |
| 126 | = 0.32 = |
| 127 | * Fix IE bug |
| 128 | * Bug plain emails |
| 129 | * Optional "method" param for tag and template function, f.e. [encode_email email="test@domain.com" method="ascii"] |
| 130 | * Small adjustments |
| 131 | |
| 132 | = 0.31 = |
| 133 | * Fixed tiny bug (incorrect var-name $priority on line 100 of email-encoder-bundle.php) |
| 134 | |
| 135 | = 0.30 = |
| 136 | * Added protection for emails in RSS feeds |
| 137 | * Improved filtering tags [encode_email ... ] |
| 138 | * Improved ASCII and Escape method and added noscript message |
| 139 | * Solved an option bug (encode mailto links VS encode plain emails) |
| 140 | * Made some cosmetical adjustments on the options page |
| 141 | * Code refactoring |
| 142 | |
| 143 | = 0.22 = |
| 144 | * First decodes entities before encoding email |
| 145 | * Added more wp filters for encoding |
| 146 | |
| 147 | = 0.21 = |
| 148 | * Changed Encoder Form: HTML markup and JavaScript |
| 149 | * Made some minor adjustments and fixed little bugs |
| 150 | |
| 151 | = 0.20 = |
| 152 | * Implemented internalization (including translation for nl_NL) |
| 153 | * Improved user-interface of the Admin Settings Page and the Encoder Form |
| 154 | * Added template function: encode_email_filter() |
| 155 | * Kept and added only high-quality encoding methods |
| 156 | * Refactored the code and changed method- and var-names within the classes |
| 157 | * Removed 3rd param $encode_display out of the encoding methods, display should always be encoded |
| 158 | * Added prefix 'lim_email_' to the encoding methods |
| 159 | |
| 160 | = 0.12 = |
| 161 | * Nothing changed, but 0.11 had some errors because /methods directory was missing in the repository. |
| 162 | |
| 163 | = 0.11 = |
| 164 | * also possible to use encode tag in widgets by activating the "filter widget" option |
| 165 | |
| 166 | = 0.10 = |
| 167 | * Works with PHP4 and PHP5 |
| 168 | * Methods: default_encode, wp_antispambot, anti_email_spam, email_escape, hide_email |
| 169 | * Use the tags: `[email_encode email=".." display=".."]`, `[email_encoder_form]` |
| 170 | * Template function: `email_encode()` |
| 171 | |
| 172 | == Other Notes == |
| 173 | |
| 174 | = Credits = |
| 175 | * [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/) |
| 176 | * [Tyler Akins](http://rumkin.com) for the encode method 'JavaScript ASCII Mixer' |
| 177 | * Title icon on Admin Options Page was made by [Jack Cai](http://www.doublejdesign.co.uk/) |
| 178 |