WMTUserData è un servizio innovativo che risponde ad una delle più sentite esigenze di chi ha un sito ma non può usare script lato server (ASP, PHP, JSP, CGI, etc.): conoscere l'
IP-Address e l'
HostName dei propri utenti.
Semplicemente registrando nel nostro database la URL della pagina in cui verrà inserito il servizio, sarà possibile disporre dei due dati in due maniere diverse:
- due variabili JavaScript a disposizione dei vostri script;
- un campo, TEXT o HIDDEN, per inserire i valori in un form e riceverli tramite il form stesso.
Per ottenere due variabili JavaScript sarà sufficiente inserire, immediatamente dopo il tag <HEAD> della vostra pagina, questo script incluso:
<script type='text/javascript' src='http://www.wmtools.it/WMTUserData.php?userid=IDSERVIZIO&k=1'></script>
Lo script va inserito all'inizio della sezione HEAD semplicemente per assicurarsi che le due variabili vengano caricate dal browser del vostro visitatore prima del resto del documento, in modo da essere sicuri che esistano e siano già valorizzate quando il vostro script cercherà di usarle.
Nel vostro documento verrà creato uno script simile a questo:
. . .
<script>
var WMTUserIP='38.107.191.101';
var WMTUserHost='38.107.191.101';
</script>
. . .
cioè due stringhe contenenti i dati voluti che possono essere lette e manipolate dal vostro script come se aveste dichiarato le variabili nel vostro documento.
Per ottenere invece i campi di form dovrete usare una di queste due sintassi:
<script type='text/javascript' src='http://www.wmtools.it/WMTUserData.php?userid=IDSERVIZIO&k=2&ft=h'></script>
<script type='text/javascript' src='http://www.wmtools.it/WMTUserData.php?userid=IDSERVIZIO&k=2&ft=t'></script>
Con la prima verrà generato un campo HIDDEN:
. . .
<input type='hidden' name='WMTUserData' value='38.107.191.101 - 38.107.191.101' />
. . .
con la seconda invece un campo TEXT:
. . .
<input type='text' class='UserData' name='WMTUserData' value='38.107.191.101 - 38.107.191.101' />
. . .
Notate che nel secondo caso al vampo TEXT viene assegnato uno stile ("UserData") che dovrete definire nel vostro foglio di stile se desiderate formattare il campo.
In pratica per ottenere uno dei tre formati, fermo restando l'USERID associato al vostro account in WMTools.it, dovrete dare ai due parametri
k ("kind") e
ft ("fieldtype") dei valori come indicato nella seguente tabella:
| Risultato | Parametro " k " | Parametro " ft " |
| Variabili JavaScript | 1 | [nessun valore] |
| Campo HIDDEN | 2 | h |
| Campo TEXT | 2 | t |
Il servizio restituisce di default le
Variabili JavaScript se viene indicato un valore errato per uno qualsiasi dei due parametri.