pnModFunc
pnModFunc — esegue una
funzione del modulo
Sintassi
mixed
pnModFunc(modname,
type,
func);
string
modname,
, string type,
, string func
;
BAD_PARAM
MODULE_FUNCTION_NOT_EXIST
Descrizione
pnModFunc()
chiama una funzione specifica del modulo
Parametri
modname
nome del modulo dal quale
eseguire la funzione
type
Il tipo di funzione da eseguire;
attualmente di tipo 'user' o 'admin'
func
Il nome della funzione del modulo
da eseguire
Valori restituiti
Questa funzione ritorna
qualunque valore della funzione risultante se ha successo. Questa
funzione ritorna void se viene incontrata un'eccezzione. Si noti che
gli standard dello stato dei moduli di Envolution dicono che le
funzioni del modulo chiamate in questo modo devono restituire i
valori specifici di essi stessi.
Per maggiori informazioni su
questo, fai riferimento all'Envolution Module Development Guide.
Eccezioni
La funzione restituisce BAD_PARAM
se si passza un parametro non valido. Restituisce
MODULE_FUNCTION_NOT_EXIST se la funzione del modulo non esiste.
Restituisce parametri ritornati dalle funzioni del modulo..
Note
Prima di chiamare questa
funzione BISOGNA AVER caricato il modulo con pnModLoad.
Per maggiori informazioni sui
nomi dei moduli far riferimento alla documentazione su pnModGetVar()
Esempi
|
//
Mostra le news
$return
= pnModFunc('News', 'user', 'display');
|
Vedere anche
pnModGetVar(),
pnModLoad(),
pnModAPIFunc()
pnModGetAdminMods
pnModGetAdminMods —
restituisce la lista dei moduli di amministrazione
Sintassi
array
pnModGetAdminMods();
DATABASE_ERROR
Descrizione
Restituisce informazioni sui
moduli in questo sistema Envolution che sono attivi e hanno un
componente amministrativo tra essi.
Valori restituiti
Questa funzione restituisce
un'array di infomazioni dei moduli se i moduli vengono trovati.
Questa funzione restituisce void se viene incontrata un'eccezione.
Eccezioni
La funzione restituisce
DATABASE_ERROR se c’è un errore nell’interrogare i
dati .
Note
Ogni array del modulo contiene lo
stesso set di articoli come quando chiami pnModGetInfo()
Esempi
|
//
Avere la lista di moduli disponibili con l'interfaccia di
amministrazione
$modarray
= pnModGetAdminMods();
if
(!$modarray) {
die('Errore creazione lista dei moduli amministrativi');
}
|
Vedere anche
pnModGetInfo(),
pnModGetUserMods()
pnModGetIDFromName
pnModGetIDFromName —
restituisce l’id del modulo partendo dal nome
Sintassi
int
pnModGetIDFromName(module);
string
module
;
BAD_PARAM
DATABASE_ERROR
MODULE_NOT_EXIST
Descrizione
pnModGetIDFromName()restituisce
l’ID del modulo su un sistema Envolution.
Parametri
module
il nome del modulo per averne
l’ID
Valori restituiti
Questa funzione restituisce l'ID
del modulo per il dato modulo. Questa funzione restituisce void se
viene incontrata un'eccezione.
Eccezioni
La funzione ritorna BAD_PARAM se
si passa un parametro non valido. La funzione ritorna DATABASE_ERROR
se c’è un errore nell’interrogare i dati. La
funzione restituisce MODULE_NOT_EXIST se il modulo è
inesistente.
Note
Per maggiori informazioni sui
nomi dei moduli fai riferimento alla documentazione su pnModGetVar()
Esempio
|
//
Avere l’ID del modulo News
$modid
= pnModGetIDFromName('News');
|
Vedere anche
pnModGetInfo()
pnModgetInfo
pnModGetInfo —avere
informazioni sul modulo
Sintassi
array
pnModGetInfo(modid);
int
modid
;
BAD_PARAM
DATABASE_ERROR
ID_NOT_EXIST
Descrizione
Fornisce informazioni sul modulo
in questo sistema Envolution.
Parametri
modid
L'id di questo modulo nel sistema
Envolution.
Valori restituiti
Questa funzione restituisce
un'array di informazioni sul modulo se il modulo viene trovato.
Questa funzione restituisce void se viene incontrata un'eccezione.
Eccezioni
La funzione ritorna BAD_PARAM se
si passa un parametro non valido. La funzione ritorna DATABASE_ERROR
se c’è un errore nell’interrogare i dati. La
funzione restituisce ID_NOT_EXIST se il modulo è inesistente.
Note
L’array del modulo
contienen i seguenti termini::
name
nome del modulo
directory
la cartella del file system in
cui si trovano i files del modulo
displayname
Il nome comune di questo modulo
description
Una breve descrizione delle
funzionalità di questo modulo
Per maggiori informazioni sui
nomi dei moduli fai riferimento alla documentazione su pnModGetVar()
Esempi
|
//
Avere informazioni sul modulo News
$modid
= pnModGetIDFromName('News');
$modinfo
= pnModGetInfo($modid);
|
Vedere anche
pnModGetIDFromName(),
pnModGetUserMods(),
pnModGetAdminMods(),
pnModGetVar()
pnModGetName
pnModGetName — per avere il
nome dell'attuale modulo di livello superiore
Sintassi
string
pnModGetName();
;
Descrizione
pnModGetName()restituisce
il nome dell'attuale modulo di livello superiore
Valori restituiti
Questa funzione attualmente
restituisce il nome dell'attuale modulo di livello superiore, false
se non in un modulo.
Esempio
|
//
nome del modulo
$name
= pnModGetName();
|
pnModGetUserMods
pnModGetUserMods — avere
una lista dei moduli utenti
Sintassi
array
pnModGetUserMods();
DATABASE_ERROR
Descrizione
pnModGetUserMods() Ottiene
informazioni sui moduli in questo sistema Envolution che sono attivi
e hanno un componente dell'utente.
Valori restituiti
Questa funzione restituisce
un'array di array di informazioni dei moduli se il modulo viene
trovato. Questa funzione restituisce void se viene incontrata
un'eccezione.
Eccezioni
La funzione restituisce
DATABASE_ERROR se c’è un errore nell’interrogazione
dei dati.
Note
Ogni array del modulo contiene lo
stesso elenco di termini di una chiamata a pnModGetInfo()
Esempi
|
//
si ottiene una lista di moduli disponibili con un'interfaccia
utente
$modarray
= pnModGetUserMods();
if
(!$modarray) {
die('Error getting list of user modules');
}
|
Vedere anche
pnModGetInfo(),
pnModGetAdminMods()
pnModGetVar
pnModGetVar — si ottiene
una variabile del modulo
Sintassi
mixed
pnModGetVar(module,
name);
string
module,
, string name
;
BAD_PARAM
DATABASE_ERROR
Descrizione
pnModGetVar()si
ottiene una variabile specifica dal sistema Envolution.
Parametri
module
Il nome del modulo per ottenere
la variabile
name
Il nome della variabile da
ottenere
Valori restituiti
Questa funzione restituisce la
variabile richiesta se esiste. Se la variabile non esiste allora sarà
resituito void. Questa funzione resituisce void se viene incontrata
un'eccezione.
Eccezioni
La funzione ritorna BAD_PARAM se
si passa un parametro non valido. La funzione ritorna DATABASE_ERROR
se c’è un errore nell’interrogare i dati.
Note
Il nome del modulo è
l'unico nome con cui viene riconosciuto il modulo nella community di
Envolution. Il nome del modulo normalmente corrisponde alla directory
in cui si trova il suo codice; le informazioni del modulo possono
essere trovate in ogni sistema Envolution andando nella sezione
amministrazione.
Esempi di nomi di moduli sono
'News', 'FAQ', e 'Comments'.
Questa funzione non fornisce le
informazioni di configurazioni del modulo. Per ottenere le
informazioni quali l'ID del modulo o il suo status attuale bisogna
usare le altre chiamate all'API disponibili in Envolution.
Esempi
|
//
Per avere la versione del modulo 'News'
$newsmodver
= pnModGetVar('News', 'Version');
|
Vedere anche
pnModSetVar(),
pnModDelVar()
pnModLoad
pnModLoad — carica il
modulo
Sintassi
int
pnModLoad(modname,
type);
string
modname,
, string type
;
BAD_PARAM
DATABASE_ERROR
MODULE_FILE_NOT_EXIST
MODULE_NOT_EXIST
Descrizione
pnModLoad()
carica le funzioni di visualizzazione extra del sistema Envolution
che estendono le sue funzionalità.
Parametri
modname
Il nome comune del modulo da
caricare
type
Il tipo delle funzioni id modulo
da caricare, da ‘utente’ e da ‘admin’
Valori restituiti
La funzione restituisce true se
la funzione è caricata con successo. Restituisce void se viene
incontrata un'eccezione.
Eccezioni
La funzione ritorna BAD_PARAM se
si passa un parametro non valido. La funzione ritorna DATABASE_ERROR
se c’è un errore nell’interrogare i dati. La
funzione restituisce MODULE_NOT_EXIST se il modulo è
inesistente. Restituisce MODULE_FILE_NOT_EXIST se il file del modulo
non esiste.
Note
L'API di Envolution tiene
traccia di che modulo è stato caricato, perciò multiple
chiamate a pnModLoad() con gli stessi parametri restituiranno ogni
volta true.
Per maggiori informazioni sui
nomi comuni dei moduli fai riferimento alla documentazione su
pnModGetVar()
Questa funzione non si carica
automaticamente nella relativa funzionalità dell'API per
questo modulo, ciò deve essere effettuato con una chiamata
separata a pnModAPILoad().
Esempi
|
//
Controllare se il modulo News è disponibile
if
(pnModAvailable('News')) {
// Carica il modulo News
if (!pnModLoad('News', 'user')) {
die('Modulo News: fallito caricamento');
}
}
|
Vedere anche
pnModAPILoad(),
pnModGetVar()
pnModRegisterHook
pnModRegisterHook —
Registra una funzione di aggancio
Sintassi
bool
pnModRegisterHook(hookobject,
hookaction,
hookarea,
hookmodule,
hooktype,
hookfunc);
string
hookobject,
string hookaction,
string hookarea,
string hookmodule,
string hooktype,
string hookfunc
;
DATABASE_ERROR
Descrizione
pnModRegisterHook()Registra
una funzione di aggancio
Parametri
hookobject
L’oggetto gancio- sia
'item' che 'category'
hookaction
L’azione per cui è
chiamato- 'create', 'delete', 'transform', o 'display'
hookarea
L’ambiente del gancio (sia
'GUI' che 'API')
hookmodule
Il nome del modulo gancio
hooktype
Il nome del tipo di gancio
('user' o 'admin')
hookfunc
Il nome della funzione di gancio
Valori restituiti
Questa funzione restituisce tue
se ha successo. Questa funzione restituisce void se viene incontrata
un'eccezione.
Eccezioni
La funzione restituisce
DATABASE_ERROR se c’è un errore nell’interrogazione
dei dati.
Note
La lista di azioni gancio viene
costantemente ridefinita. Guardare il codice sorgente per la lista
aggiornata.
Esempi
|
// Imposta un gancio modulo
if (!pnModRegisterHook('item',
'display',
'GUI',
'Ratings',
'user',
'display')) {
return false;
}
|
Vedere anche
pnModUnregisterHook()
pnModSetVar
pnModSetVar — imposta una
variabile del modulo
Sintassi
bool
pnModSetVar(module,
name,
value);
string
module,
, string name,
, string value
;
BAD_PARAM
DATABASE_ERROR
Descrizione
pnModSetVar()imposta
una variabile specifica del modulo nel sistema Envolution. Se la
variabile non esiste essa verrà creata.
Parametri
module
Il nome comune del modulo nel
quale impostare la variabile
name
Il nome della variabile di modulo
da settare
value
Il valore da assegnare alla
variabile di modulo
Valori restituiti
Questa funzione restituisce true
se l'aggiornamento ha successo. Questa funzione restituisce void se
viene incontrata un'eccezione.
Eccezioni
La funzione ritorna BAD_PARAM se
si passa un parametro non valido. La funzione ritorna DATABASE_ERROR
se c’è un errore nell’interrogare i dati.
Note
Per maggiori informazioni sui ben
conosciuti nomi dei moduli fai riferimento alla documentazione su
pnModGetVar()
Esempi
|
//
Impostare le informazioni di versione per il modulo 'News'
pnModSetVar('News',
'Version', 2);
|
Vedere anche
pnModGetVar(),
pnModDelVar()
pnModUnregisterHook
pnModUnregisterHook —
toglie dal registro una funzione gancio
Sintassi
bool
pnModUnregisterHook(hookobject,
hookaction,
hookarea,
hookmodule,
hooktype,
hookfunc);
string
hookobject,
string hookaction,
string hookarea,
string hookmodule,
string hooktype,
string hookfunc
;
DATABASE_ERROR
Descrizione
pnModUnregisterHook()toglie
dal registro una funzione gancio
Parametri
hookobject
L’oggetto gancio - 'item' o
'category'
hookaction
L’azione del gancio
chiamato - 'create', 'delete', 'transform', o 'display'
hookarea
L’ambiente del gancio
(‘GUI' o 'API')
hookmodule
Il nome del modulo gancio
hooktype
Il tipo di gancio ('user' o
'admin')
hookfunc
Il nome della funzione di gancio
Valori restituiti
Questa funzione restituisce true
se ha successo. Questa funzione restituisce void se si incontra una
eccezione.
Eccezioni
La funzione restituisce
DATABASE_ERROR se c’è un errore nell’interrogare i
dati.
Note
La lista di azioni gancio viene
costantemente ridefinita. Guarda il codice sorgente per la lista
corrente.
Esempi
|
// Rimuove un gancio
if (!pnModUnregisterHook('item',
'display',
'GUI',
'Ratings',
'user',
'display')) {
pnSessionSetVar('errormsg', _RATINGSCOULDNOTUNREGISTER);
}
|
Vedere anche
pnModRegisterHook()
pnModURL
pnModURL — crea un URL del
modulo
Sintassi
string
pnModURL(modname,
type,
func,
args);
string
modname,
, string type,
, string func,
, array args
;
BAD_PARAM
Descrizione
pnModURL()Crea
un'url compatibile per una specifica funzione dl modulo.
Parametri
modname
Il nome comune del modulo del
quale creare l’URL
type
Il tipo dei funzione della quale
creare l’URL, 'user' o 'admin'
func
La funzione corrente del modulo
per la quale creare l’URL
args
Un array associativo di
argomenti. Il numero esatto e il tipo di argomenti dipende dalla
funzione
Valori restituiti
Questa funzione restituisce la
stringa dell'URL del modulo se ha successo. Questa funzione
resituisce void se viene incontrata un'eccezione.
Eccezioni
La funzione restituisace
BAD_PARAM se si passa un parametro non valido.
Note
Per maggiori informazioni sui ben
conosciuti nomi dei moduli fai riferimento alla documentazione su
pnModGetVar()
Esempi
|
//
Crea un URL alla funzione 'view' di News con i parametri 'sid'
impostati a 3
//
e 'index' impostato a '0'
$url
= pnModURL('News', 'user', 'view', array('sid' => 3, 'index' =>
0));
|
Vedere anche
pnModGetVar(),
pnModFunc()
pnRedirect
pnRedirect — redirect to
another page
Sintassi
void
pnRedirect(url);
string
url,
;
Descrizione
pnRedirect()crea
un'url assoluto a una pagina Envolution e di conseguenza imposta il
relativo header HTTP.
Parametri
url
L’URL a cui si viene
diretti. L’URL può avere il parametro GET aggiunto
normalmente.
Note
pnRedirect()
può trattare sia URL assoluti che relativi. E’ usato
insieme a funzioni di generazione-URL quale pnModURL.
pnRedirect()
effettua una ridirezione HTTP1.1-compliant. Questa funzione non
dovrebbere essere usata quando un'output è già
richiesto, poichè l'output non sarà visualizzato.
Esempi
|
//
Ridireziona alla index
pnRedirect('index.php');
//
Ridireziona a nuova pagina
pnRedirect(pnModURL('News',
'user',
'view',
array('sid' => 3, 'index' => 0)));
//
Ridireziona all’esterno del sito
pnRedirect('http://www.sitoremoto.com');
|
Vedere anche
pnModURL()
pnSecAddSchema
pnSecAddSchema — aggiunge
uno schema di sicurezza
Sintassi
void
pnSecAddSchema(component,
schema);
string
component,
, string schema
;
Descrizione
pnSecAddSchema()aggiunge
uno schema nel sistema Envolution. La lista del componente schema non
può essere usata in nessuna parte all'interno di Envolution,
ma può essere visualizzata come componente di una funzione
della GUI per aiutare nella configurazione del sistema dei permessi
di Envolution.
Parametri
component
Il componente al quale si
riferisce lo schema delle autorizzazioni
schema
Lo schema delle autorizzazioni
Valori restituiti
La funzione restituisce true se
lo schema delle autorizzazioni è aggiunto con successo , false
se lo schema non è aggiunto con successo (normalmente dovuto a
un nome del componente duplicato), e void se c’è un
errore interno nelle API mentre viene aggiunto lo schema.
Note
Una descrizione completa del
sistema di autorizzazione di Envolution va oltre la portata di questo
documento. Per maggiori informazioni sul sistema di autorizzazione e
sul relativo uso dei permessi, i componenti e le istanze, fai
riferimento alla Envolution Authorisation System documentation. Si
noti che questa funzione è stata precedentemente usata come
addinstanceschemainfo(). Quel nome è stato disapprovato ma è
ancora funzionale in questa versione dell'API di Envolution; e si
raccomanda di cambiare tutte le chiamate che attualmente sono fatte
con addinstanceschemainfo() con pnSecAddSchema().
Esempi
|
//
Aggiunge uno schema di sicurezza al modulo foo
pnSecAddSchema('Foo::',
'Name of foo:Type of foo:foo ID');
|
pnSecAuthAction
pnSecAuthAction — autorizza
tentativi d’azione
Sintassi
bool
pnSecAuthAction(realm,
component,
instance,
level,
uid(opt));
int
realm,
, string component,
, string instance,
, int level,
int uid(opt)
;
DATABASE_ERROR
Descrizione
pnSecAuthAction()
controlla le informazioni sulle autorizzazioni del sistema Envolution
per decidere se un livello particolare di autorizzazione può
essere permesso.
Parametri
realm
il permesso a questa
autorizzazione, impostato a 0
component
il componente che chiede
quest’autorizzazione
instance
l’istanza che chiede
quest’autorizzazione
level
Il livello d’accesso
richiesto dall’autorizzazione per essere permessa
uid
L’uid dell’utente per
controllare l’autorizzazione
Valori restituiti
Questa funzione restituisce true
se il livello di autorizzazione assegnato all'utente per gli
argomenti dati è superiore o uguale al livello richiesto,
false se il livello di autorizzazione assegnato all'utente per gli
argomenti richiesti è minore del livello richiesto. Questa
funzione restituisce void se viene incontrata un'eccezione.
Eccezioni
La funzione restituisce
DATABASE_ERROR se c’è un errore nell’interrogare i
dati.
Note
Una descrizione completa del
sistema di autorizzazione di Envolution va oltre la portata di questo
documento. Per maggiori informazioni sul sistema di autorizzazione e
sul relativo uso dei permessi, dei componenti e delle istanze, far
riferimento alla Envolution Authorisation System documentation.
Quusta funzione era
precedentemente conosciuta come authorised(). Questo nome è
disapprovato ma ancora funzionale in questa versione dell'API di
Envolution; si suggerisce di cambiare tutte le chiamate che
attualmente fanno riferimento ad authorised() a pnSecAuthAction().
Esempi
|
//
Controlla se è autorizzato ad accedere alle funzioni di
amministrazione del modulo 'foo'
if
(pnSecAuthAction(0,
'Foo::',
'My Foo:Foos of the world:4',
ACCESS_ADMIN)) {
// Yes
}
else {
// No
}
|
pnSessionDelVar
pnSessionDelVar — cancella
una variabile di sessione
Sintassi
bool
pnSessionDelVar(name);
string
name
;
Descrizione
pnSessionDelVar()Cancella
una variabile specifica di sessione da un sistema Envolution.
Parametri
name
Il nome della variabile di
sessione da cancellare
Valori restituiti
Questa fuzione restituisce trie
se la variabile viene cancellata con successo, e void se incontra
un'errore nell'API durante la cancellazione.
Note
Vedere anche
pnSessionGetVar(),
pnSessionSetVar()
pnSessionGetVar
pnSessionGetVar — si
ottiene una variabile di sessione
Sintassi
mixed
pnSessionGetVar(name);
string
name
;
Descrizione
pnSessionGetVar()
si ottiene una variabile specifica di sessione da un sistema
Envolution.
Parametri
name
Il nome della variabile di
sessione da ottenere
Valori restituiti
Questa funzione restituisce la
variabile richiesta se esiste, false se la variabile non esiste, e
void se ci fosse un errore interno di api mentre sta tentando di
ottenere la variabile.
Note
L'esistenza delle variabili di
sessione non è garantita da un processo che viene fatto
funzionare al seguente. Regole interne potrebbero rimuovere le
sessioni che sono state inattive per periodi di tempo lunghi, in modo
da non usare le variabili di sessione per memorizzare le informazioni
di lunga durata.
Vedere anche
pnSessionSetVar(),
pnSessionDelVar()
pnSessionInit
pnSessionInit — inizializza
la sessione
Sintassi
bool
pnSessionInit();
Descrizione
pnSessionInit()
inizializza una nuova sessione, impostando i cookie dell’utente
come necessario e ricevendo le variabili della sessione corrente.
Valori restituiti
La funzione restituisce true
se la inizializzazione della sessione è andata a buon fine ,
false
in caso contrario, e void
se c’è un errore interno delle API durante il tentativo
di inizializzazione della sessione.
Note
La funzione viene di solito
chiamata da pnInit(),
e non dovrebbe mai essere chiamata dai moduli o altri processi dello
sviluppatore.
Vedere anche
pnInit(),
pnSessionSetup()
pnSessionSetup
pnSessionSetup —istituisce
una sessione
Sintassi
bool
pnSessionSetup();
Descrizione
pnSessionSetup()
imposta un certo numero di variabili di configurazioni di PHP che
permettono al sistema Envolution di trattare sessioni utente
persistenti tra varie connessioni HTTP .
Valori restituiti
La funzione ritorna true
se la sessione va a buon fine, false
in caso contrario, e void
se c’è un errore interno alle API nel tentativo di
iniziare una sessione.
Note
La funzione viene di solito
chiamata da pnInit(),
e non dovrebbe mai essere chiamata dai moduli o altri processi dello
sviluppatore.
Vedere anche
pnInit(),
pnSessionInit()
pnSessionSetVar
pnSessionSetVar — imposta
una variabile di sessione
Sintassi
bool
pnSessionSetVar(name,
value);
string
name,
string value
;
Descrizione
pnSessionSetVar()imposta
una variabile specifica di sessione nel sistema envolution.Se la
variabile non esiste essa viene creata.
Parametri
name
il nome della variabile di
sessione da settare
value
il valore da settare
con la variabile di sessione
Valori restituiti
Questa funzione restituisce true
se la variabile viene settata, e void se ci fosse un errore interno
di api mentre sta tentando di settare la variabile.
Note
L'esistenza delle variabili di
sessione non è garantita da un processo che viene fatto
funzionare al seguente. Regole interne potrebbero rimuovere le
sessioni che sono state inattive per periodi di tempo lunghi, in modo
da non usare le variabili di sessione per memorizzare le informazioni
di lunga durata.
Vedere anche
pnSessionGetVar(),
pnSessionDelVar()
pnThemeLoad
pnThemeLoad — carica un
tema di visualizzazione
Sintassi
bool
pnThemeLoad();
Descrizione
pnThemeLoad()carica
un tema di visualizzazione come specificato dall'utente, e imposta il
numero di variabili globali per una compatibilità all'indietro
con i vecchi temi di visualizzazione.
Valori restituiti
Questa funzione restituisce true
se il tema viene caricato con successo, e false se il tema non viene
caricato con successo.
Esempi
|
//
Carica il tema dell’utente
if
(!pnThemeLoad()) {
die('Problem loading theme');
}
|
pnUserGetAll
pnUserGetAll — per ottenere
informazioni base su tutti gli utenti
Sintassi
array
pnUserGetAll();
Descrizione
pnUserGetAll()
per ottenere un set di informazioni base su tutti gli utenti attivi
nel sistema Envolution.
Attenzione:
pnUserGetAll()è
disapprovato ma ancora funzionale in questa versione dell'API di
Envolution. Tu non dovresti usarlo, poiché sarà rimosso
quando Envolution raggiungerà la versione 1,0. Invece sei
consigliato fortemente a usare la funzione del getall del modulo API
degli utenti: $users = pnModAPIFunc('users', 'user', 'getall');
Valori restituiti
Questa funzione restituisce
un'array di array associativi. gli elementi degli array sono riferiti
per UID per un veloce accesso alle informazioni su un user specifico.
Ogni arry corrisponde a un particolare utente e possiete i seguenti
mebri dell'array:
uname
il nome utente
uid
l’ID utente
name
il nome completo dell’utente
email
l’indirizzo e-mail
dell’utente
url
l’URL dell’utente
avatar
l’avatar dell’utente
Note
Solo i campi uname e uid sono
garantiti di essere riempiti; gli altri campi potrebbero essere
vuoti.
Esempi
|
//
tutti gli utenti
$allusers
= pnUserGetAll();
//
mostra username e uid di ogni utente
foreach
($allusers as $user) {
echo "User ID $user[uid] has user name
$user[uname]
";
}
//
mostra nome dell’utente uid 5
echo
"User ID 5 is called {$allusers[5]['name']}
";
|