blob: 6009aa01261221bae3345a198995c7c5cc1e9804 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
[[!template id=plugin name=imailhide author="Peter_Vizi"]]
[[!tag type/widget type/html]]
# Mailhide Plugin for Ikiwiki
This plugin provides the directive mailhide, that uses the [Mailhide
API][1] to protect email addresses from spammers.
## Dependencies
The [Captcha::reCAPTCHA::Mailhide][2] perl module is required for this
plugin.
## Download
You can get the source code from [github][3].
## Installation
Copy `imailhide.pm` to `/usr/share/perl/5.10.0/IkiWiki/Plugin` or
`~/.ikiwiki/IkiWiki/Plugin`, and enable it in your `.setup` file
add_plugins => [qw{goodstuff imailhide ....}],
mailhide_public_key => "8s99vSA99fF11mao193LWdpa==",
mailhide_private_key => "6b5e4545326b5e4545326b5e45453223",
mailhide_default_style => "short",
## Configuration
### `mailhide_public_key`
This is your personal public key that you can get at [Google][4].
### `mailhide_private_key`
This is your personal private key that you can get at [Google][4].
### `mailhide_default_style`
As per the recommendation of the [Mailhide API documentation][5], you
can define this as `short` or `long`. The `short` parameter will
result in `<a href="...">john</a>` links, while the `long` parameter
will result in `joh<a href="...">...</a>@example.com`.
## Parameters
### `email`
*Required.* This is the email addres that you want to hide.
### `style`
*Optional.* You can set the style parameter individually for each
`mailhide` call. See `mailhide_default_style` for details.
## Known Issues
1. [opening new window when displaying email address][6]
[1]: http://www.google.com/recaptcha/mailhide/
[2]: http://search.cpan.org/perldoc?Captcha::reCAPTCHA::Mailhide
[3]: http://github.com/petervizi/imailhide
[4]: http://www.google.com/recaptcha/mailhide/apikey
[5]: http://code.google.com/apis/recaptcha/docs/mailhideapi.html
[6]: http://github.com/petervizi/imailhide/issues#issue/1
|