## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnMacros/MailTo
##master-date:2007-12-22 23:03:05
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language it

<<Navigation(siblings)>>
<<BR>><<BR>>

La macro '''`MailTo`''' consente di inserire il proprio indirizzo email in un wiki in modo sicuro, senza avere paura che questo venga rilevato dai bot spam (robot che raccolgono indirizzi email) e utilizzato dagli spammer.

= Utilizzo =
{{{
<<MailTo(Nome DOT Cognome AT example DOT net)>>
}}}

o
{{{
<<MailTo(Nome DOT Cognome AT example DOT net, testo del collegamento)>>
}}}

= Che cosa fa? =
È necessario differenziare tra utenti registrati e anonimi (inclusi i bot spam).

Gli utenti registrati devono avere il diritto di leggere e utilizzare facilmente gli indirizzi email con un solo clic (altrimenti nessuno li pubblicherebbe in un wiki).

Per gli utenti anonimi le cose diventano più critiche, dato che potrebbero essere utenti "normali", ma anche qualcuno o qualcosa (come un bot spam) che raccoglie indirizzi email, al fine di abusarne inviando email commerciali non richieste (questo è un problema molto diffuso su internet).

== Utenti registrati ==
Vedranno qualcosa tipo:
 Nome.Cognome@example.net

Quindi vedono un collegamento `mailto:` leggibile e selezionabile direttamente.

== Utenti anonimi ==
Gli utenti anonimi (come i bot spam o altri bot) vedranno solo il testo dell'argomento come passato letteralmente alla macro:

 Nome DOT Cognome AT example DOT net

Testo puro, non un collegamento `mailto:`. Un essere umano intelligente sarà capace di interpretarlo e inserire quell'indirizzo email in un programma email.

Ma un bot automatico non può fare nient'altro oltre a quello per cui è programmato e lo perderà semplicemente (a meno che non sia un bot più intelligente, consultare sotto) e la macro avrà pienamente raggiunto il suo scopo, evitando lo spam.

= Come funziona e altri esempi =
Per gli utenti anonimi, la macro mostra semplicemente il testo letterale dell'argomento come passato alla macro stessa.

Per utenti registrati, la macro processa i parametri della stringa nel modo seguente:

 1. Le parole seguenti TUTTE-MAIUSCOLE verranno sostituite:

  || AT   || `@` ||
  || DOT  || `.` ||
  || DASH || `-` ||

 1. Le altre parole TUTTE-MAIUSCOLE come, per esempio, NO SPAM NOSPAM WHATEVER I DONT WANT SPAM etc., verranno semplicemente ignorate (rimpiazzate da una stringa vuota).
 1. Tutti gli spazi saranno rimossi.
 1. Verrà generato un collegamento `mailto:` selezionabile.

Rimane naturalmente un pericolo legato a unbot spam particolarmente intelligente che riconosce le normali parole di protezione come AT, DOT e NOSPAM e le converte correttamente. Ciò viene reso più improbabile aggiungendo parole e spazi ''arbitrari''. Un bot spam che riesce a riconoscerlo ha ben meritato il tuo indirizzo email. ;)

È possibile facilmente vedere gli effetti di `MailTo` comparando questi esempi per utenti registrati e anonimi:

 * `<<MailTo(Nome DOT Cognome AT example DOT net)>>` diventa <<MailTo(Nome DOT Cognome AT example DOT net)>>
 * `<<MailTo(Nome . Cognome AT ex am ple DOT n e t)>>` diventa <<MailTo(Nome . Cognome AT ex am ple DOT n e t)>>
 * `<<MailTo(Nome NON VOGLIO SPAM . Cognome@example DOT net)>>` diventa <<MailTo(Nome NON VOGLIO SPAM . Cognome@example DOT net)>>
 * `<<MailTo(No me . NON Cognome VOGLIO AT SPAM example DOT n e t)>>` diventa <<MailTo(No me . NON Cognome VOGLIO AT SPAM example DOT n e t)>>
 * `<<MailTo(Nome DOT Cognome AT example DOT net, Io, Me stesso, e Me Medesimo)>>` diventa <<MailTo(Nome DOT Cognome AT example DOT net, Io, Me stesso, e Me Medesimo)>>

(!) Data la possibilità di aggiungere parole MAIUSCOLE, qualsiasi utente può ostacolare sia i bot che gli umani come desidera. Se lo si rende difficile per un lettore umano, si riceverà meno posta. ;)