welcome: please sign in

The following 220 words could not be found in the dictionary of 0 words and are highlighted below:
ability   able   abuse   abused   add   address   addresses   All   also   an   An   and   Anonymous   anonymous   anything   arbitrary   are   argument   as   assumed   automatic   avoiding   be   being   below   between   blanks   bot   both   bots   bright   But   but   by   can   case   click   clickable   client   collected   collecting   commercial   comparing   Contents   converting   correctly   could   course   critical   danger   desire   differentiate   directly   do   does   dropped   each   earned   easily   effects   email   empty   enter   especially   etc   even   exa   example   examples   except   fear   ffffcc   First   Firstname   following   follows   For   for   fulfilled   general   generated   get   gets   Given   hard   has   have   having   helps   hopefully   How   human   humans   if   If   in   includes   intelligent   internet   interpret   into   is   it   its   Lastname   le   less   like   link   literal   logged   Logged   Macro   macro   made   mail   Mail   mailto   make   manually   Markup   Me   miss   more   mp   Myself   name   net   no   normal   not   obstacles   Of   of   one   only   or   Other   other   otherwise   out   outputs   parameter   passed   problem   processes   protection   publish   Pure   purpose   putting   raise   rather   read   readable   readers   recognize   recognizing   Regarding   removed   replaced   Result   right   robots   rowbgcolor   safe   samples   see   sending   simply   single   So   some   someone   something   spam   spammer   sprinkle   string   Table   text   that   The   the   them   There   these   they   They   things   This   this   those   to   To   unlikely   unsolicited   Usage   use   user   users   Using   usual   very   via   way   We   well   What   which   who   wiki   will   without   words   works   would   You   you   your  

Clear message
location: HelpOnMacros / MailTo

MailTo

Contents

  1. MailTo
    1. Usage
    2. What does it do?
      1. Logged-in users
      2. Anonymous users
    3. How it works and more samples

Using the MailTo-Macro helps you putting your email address into a wiki in a rather safe way without having to fear that it gets collected by spam bots (robots collecting email addresses) and abused by some spammer.

Usage

<<MailTo(Firstname DOT Lastname AT example DOT net)>>

or

<<MailTo(Firstname DOT Lastname AT example DOT net, link text)>>

What does it do?

We have to differentiate between logged-in and anonymous users (which includes spam bots).

Logged-in users are assumed to have the right to read and easily use the email address via a single click (otherwise, one would not publish it in a wiki).

Regarding anonymous users things get more critical - those could be "normal" users, but also someone or something (like a spam bot) collecting email addresses to abuse them by sending unsolicited commercial email to them (this is a very general problem in the internet).

Logged-in users

They will get the following:

So they get a directly readable and clickable mailto: link.

Anonymous users

Anonymous users (like spam bots and other bots) will only get the literal argument text as passed to the macro:

Pure text, no mailto: link. An intelligent human being will be able to interpret that and enter that email address manually into an email client.

But an automatic bot hopefully can't make anything out of that and will simply miss it (except if it is an especially bright bot, for that case see below) - and the macro has fulfilled its purpose, avoiding spam.

How it works and more samples

For anonymous users, the macro simply outputs the literal argument text as passed to the macro.

For logged-in users, the macro processes the parameter string as follows:

  1. The following ALL-UPERCASE words will be replaced:

    • AT

      @

      DOT

      .

      DASH

      -

  2. Other ALL-UPPERCASE words like e.g. NO SPAM NOSPAM WHATEVER I DONT WANT SPAM etc. will simply be dropped (replaced by an empty string).
  3. All blanks get removed.

  4. A clickable mailto: link is generated.

There is of course some danger of an especially bright spam bot recognizing usual spam protection words like AT, DOT and NOSPAM and converting them correctly. This is made more unlikely if you sprinkle in arbitrary words and blanks. A spam bot who can even recognize that has well earned your email address. ;)

You can easily see the effects of MailTo by comparing these examples for logged-in and anonymous users:

Markup

Result

<<MailTo(Firstname DOT Lastname AT example DOT net)>>

<Firstname DOT Lastname AT example DOT net>

<<MailTo(Firstname . Lastname AT exa mp le DOT n e t)>>

<Firstname . Lastname AT exa mp le DOT n e t>

<<MailTo(Firstname I DONT WANT SPAM . Lastname@example DOT net)>>

<Firstname I DONT WANT SPAM . Lastname@example DOT net>

<<MailTo(First name DOT I Lastname DONT AT WANT SPAM example DOT n e t)>>

<First name DOT I Lastname DONT AT WANT SPAM example DOT n e t>

<<MailTo(Firstname DOT Lastname AT example DOT net, "Me, Myself, and I")>>

Me, Myself, and I <Firstname DOT Lastname AT example DOT net>

(!) Given the ability to add CAPS words, each user can raise the obstacles for both bots and humans as they desire. If you make it hard for human readers, you will get less mail. ;)