Hikari Email & URL Obfuscator

Don’t I really need to change anything in my links for them to be obfuscated?

No, you don’t. Hikari Email & URL Obfuscator plugin uses WordPress hooks to filter links on the fly, it automatically finds all your links and obfuscate them for you, directly in your posts / comments / text widgets.

Does your plugin change ANYTHING in my content stored in database?

This is a dilemma I always have with plugins that I install and I feel in need to explicitly explaining it.

No, Hikari Email & URL Obfuscator plugin does NOT touch your content database! Its filter runs in read time, AFTER your content is queried from database and before it is sent to your visitor. Your original content and your original links will remain untouched, and as soon as you deactivate the plugin your site will go back to what it was before it ever knew the plugin existed.

Can I have a usage exemple?

You can go to my sites at Hikari WebSite or Consciência Planetária and take a look, they use it. Verify its page source and how links look like with JavaScript disabled and then enabled.

Is there any way to customize the plugin default behavior?

Yes, it has custom parameters that are used as CSS classes, in the same way some microformats do. You can see a list of them, with description and exemples at Hikari Email & URL Obfuscator – Advanced Usage.

Is there any way to block it from obfuscating one of my links?

Yes, in the previous question I mensioned custom parameters.

One of them is hkmuob_no_obfuscate, and when used the link won’t be obfuscated.

Are my internal links obfuscated too?

No, links with your website URL and relative links (without http:// ) are not obfuscated.

How can I obfuscate stuff out of post / comment / text widget areas?

If you wanna obfuscate emails and URLs that are our of these areas (in the theme templates or in another plugin for exemple), it’s pretty easy.If you wanna obfuscate emails and URLs that are out of these areas (in the theme templates or in another plugin for exemple), it’s pretty easy.

First you prepare the content and store it in a string variable normally, let’s say it is in $footerContent. Once you have the string, you verify if the plugin is activated by testing if its class HkMuob exists, and if so you grab it’s object $hkMuob and call the method $hkMuob->filter($footerContent). It will return a string variable with your content already obfuscated and ready to be echoed. Attention! You must use the global object the plugin creates, because it has internal variabled that will be used in the page footer to interact with JavaScript, if you create another object it will not work! Here’s a full exemple:

<?php

// first we repare our content with anything we want, and store it in a variable
$footerContent = "I'm a neat content with links inside." .
    ' <a href="mailto:no.spam@spam.com" title="c\'mon mail me!" target="_blank" class="stylish-class">mail me</a>';

// if the class exists, then the plugin is availabe and we can use it to obfuscate any content
// if not, then we just echo the original content without obfuscating
if(class_exists('HkMuob')){

    // class is available, let's get its global variable
    global $hkMuob;

    // now we ask the plugin to filter our content and add any found link to plugin's internal queue
    $footerContent = $hkMuob->filter($footerContent);

    // now $footerContent has the same content as before, but with obfuscated links
}

// whether or not we were able to obfuscate our links, let's print our neat content
echo $footerContent;

?>

You can see a more detailed explanation at Manually filtering other links

Help! My link has a small text and large URL, and now it is breaking my layout!

Oh man, it can happen for links with small texts in small places.

Fortunately, there are a bunch of custom parameters that can help you tune up your links when JavaScript is disabled. Just take a look on the link referenced in previous questions and read about these custom parameters, you’ll be able to do some interesting stuff with them 🙂

0.08

• Fixed styling incompatibility with Sociable plugin
• Fixed wp_enqueue_style() not providing media parameter
• Fixed adding JS code to wp_footer, now properly using wp_print_scripts
• addes support for PHP Code Widget plugin’s filter

0.07

• New: Finally an options page!
• Options page made the plugin incompatible with WordPress 2.7, now it requires 2.8 to work.
• New: Whitelist and Blacklist, to list URLs and emails to not be obfuscated (Whitelist) and to be forced to (Blacklist).
• New: Also added options related to the position of JavaScript calls for de-obfuscation , and how these calls should be marked up.
• New: Options page also has a proper uninstall feature, which deletes all data the plugin had added to database and also can be used to reset options to default.
• New: If you want a whole block of content (a post, a comment, a text widget, etc) to be skipped from having its links obfuscated, just add to it a comment <!-- HkMuob NO OBFUSCATE -->.
• Further tests for XHTML valid code, now I hope I can assure it 🙂

0.06

• Fix: plugin CSS is no longer being added to Admin Pages.
• JavaScript decoding code is back to header, instead of footer.
• Added option for JavaScript call be done just after the link it decodes, I belive having those calls spreaded across the page is harder for spam bots to crack than having all of them inside a unique <script></script> at the footer… but WordPress breaks XHTML validation, gg.
• Increased filter’s priority to surpass raw-html plugin filter.

0.05

• Fix: now plugin’s js is added only when there are links to be obfuscated.
• Fix: now plugin folder name is not hardcoded anymore, we can use any folder name we want.

0.04

• First public release.