## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnMacros/MailTo
##master-date:unknown-date
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language it
<<Navigation(siblings)>>
<<BR>><<BR>>

La macro '''`MailTo`''' ti aiuta ad inserire il tuo indirizzo email in un wiki in modo sicuro, senza avere paura che questo venga rilevato dagli spam bots (robots che raccolgono indirizzi email) ed 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? =
Dobbiamo fare una differenza tra utenti registrati e anonimi (inclusi gli spam bots).

Gli utenti registrati devono avere il diritto di leggere ed utilizzare facilmente gli indirizzi email con un solo click (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 uno spam bot) che raccoglie indirizzi email al fine di abusarne inviandogli 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 cliccabile direttamente.

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

 Nome DOT Cognome AT example DOT net

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

Ma un bot automatico non può fare nient'altro che ciò che sa e lo perderà semplicemente (a meno che non sia un bot più intelligente, nel qual caso vedi più giù) - e la macro avrà pienamente raggiunto il suo scopo, evitando lo spam.

= Come funziona ed 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 ad es. NO SPAM NOSPAM WHATEVER I DONT WANT SPAM etc. verranno semplicemente ignorate (rimpiazzate da una stringa vuote).
 1. Tutti gli spazi saranno rimossi.
 1. Verrà generato un collegamento `mailto:` cliccabile.

Rimane naturalmente un pericolo legato ad uno spam bot 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''. Uno spam bot che riesce a riconoscerlo ha ben meritato il tuo indirizzo email. ;)

Puoi facilmente vedere gli effetti di `MailTo` comparando questi esempi per utenti registrati ed 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 possibilita di aggiungere parole MAIUSCOLE, qualsiasi utente può ostacolare sia i bots che gli umani come desidera. Se lo rendi difficile per un lettore umano, riceverai meno posta. ;)
