Accesso ai dati dell'utente corrente

Un plug-in, così come altro codice scritto in PHP e che fa affidamento su Sar-At, può ricevere dal sistema informazioni sull'utente che sta guardando la pagina web.

Per verificare se l'utente corrente è registrato come parte di un gruppo (oppure se ha diritto di accedere a una certa sezione).

  $utente = SaratUserLogged($istanza, $id_gruppo=NULL, $sezione=NULL);

Per eseguire il login dell'utente corrente:

  $utente = SaratLogin($istanza, $provider, $id_gruppo, $username=NULL, $password=NULL);

Primo esempio: nel vostro blog volete accettare commenti ma senza costringere i lettori a compilare un modulo di iscrizione. Potete accettare le loro credenziali Facebook o Twitter

Secondo esempio: state realizzando un CRM online per i clienti di una azienda e volete consentire l'accesso a chiunque sia inserito nella base dati dell'azienda, senza doverne ricevere una copia completa e tenerla aggiornata. È sufficiente che il CRM offre una interfaccia standard OpenID per ottenere il risultato senza scrivere una sola riga di codice.

Le funzioni SaratUserLogged e SaratLogin restituiscono un record così composto

Campo

Valore

$utente['islogged']

true o false a seconda che l'utente corrente sia registrato o meno

$utente['username']

nome utente

$utente['groupname']

nome gruppo utenti registrati di cui fa parte

$utente['groupid']

id numerico del gruppo utenti registrati di cui fa parte

$utente['provider']

fonte dell'autenticazione

$utente['sanitizedname']

nome utente in un formato immune dalle SQL injection e che può venire usato direttamente in una query alla base dati

La fonte dell'autenticazione vale "Sar-At" per un login tradizionale effettuato dal nostro programma. Per log-in di nuovo tipo avremo come fonte il nome del servizio di autenticazione -- un social network o un server OpenID. Ecco i valori possibili predefiniti e preconfigurati

AOL

Facebook

Foursquare

Google

LinkedIn

Live

Twitter

Yahoo