aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/imailhide.mdwn
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