wp_dropdown_users() (funzione WordPress) visualizza l’elenco degli utenti WordPress in un menu a discesa HTML (<select>).
tips&tricks
Sintassi
wp_dropdown_users($opzioni[facoltativo])
| parametro | descrizione |
|---|---|
| $opzioni | Array, secondo il seguente formato
$opzioni = array(
'show_option_all' => "Scegli un utente", // Testo eventualmente da mostrare come prima riga dell'utente. Default: null
'show_option_none' => null, // Testo da mostrare quando non sono stati trovati utenti. Default: null.
'option_none_value' => -1, // Valore da utilizzare per $show_option_none quando non sono stati trovati utenti.Default: -1.
'hide_if_only_one_author' => null, // Non genera il menu a discesa se è stato trovato un solo utente. Default: visualizza. Default: null.
'orderby' => 'display_name', // Campo di ordinamento degli utenti. Accetta anche "ID" e "user_nicename". Default: 'display_name'
'order'=> 'ASC', // Modo di ordinamento. Accetta anche "DESC".
'include' => null, // Array o elenco separato da virgole dei soli ID utente da visualizzare. Ad esempio, "include = 4,12" significa che SOLO gli ID 4 e 12 degli utenti saranno mostrati nel menu. Non può essere valorizzato insieme al successivo elemento "exclude" (si annullerebbero a vicenda e sarebbero mostrati tutti gli utenti). Default: utenti tutti inclusi (null).
'exclude' => null, // Array o elenco separato da virgole dei soli ID utente da non visualizzare. Ad esempio, "exclude = 4,12" significa che gli ID 4 e 12 degli utenti non saranno mostrati nel menu. Non può essere valorizzato insieme al successivo elemento "exclude" (si annullerebbero a vicenda e sarebbero mostrati tutti gli utenti). Default: nessun utente escluso (null).
'multi' => true, // Valore booleano che specifica se saltare (true) o meno (false) l'attributo ID dell'elemento select. Default: false.
'show' => 'display_name', // Dati utente da visualizzare. Accetta qualsiasi campo utente nonché 'display_name_with_login' (che mostra il nome dell'utente e la sua username tra parentesi). Predefinito 'display_name'.
'echo' => true, // Valore booleano. Specifica se restituire il menu a discesa (true) o meno (false). In questo secondo caso, la funzione restituisce l'elenco degli utenti che può essere usato nel codice PHP. Default: true.
'selected' => false, // L'ID dell'utente pre-selezionato. Default: nessuno (false o 0)
'include_selected' => true, // Valore booleano. Specifica se visualizzare (true) o meno (false) l'ID degli utenti. Default: no (false)
'name' => 'user', // Nome (querystring) dell'elemento selezionato. Deafult: user
'id' => null, // Attributo HTML id dell'elemento selezionato. Deafult: lo stesso valore del precedente elemento 'user' (null)
'class' => null, // Attributo HTML classe dell'elemento selezionato. Deafult: null
'blog_id' => $GLOBALS['blog_id'], // L'ID del blog (multi-sito). Default: il blog corrente ($GLOBALS['blog_id'])
'who' => null, // Array o stringa. Quale tipo di utenti visualizzare. Al momento, è supportato solo 'authors'. Default: tutti gli utenti (null)
'role' => null, // Array o elenco separato da virgole dei nomi dei ruoli utente da visualizzare. E' un elenco inclusivo, sicché nel caso siano indicati più ruoli, sono visualizzati solo gli utenti che soddisfano tutti i ruoli. Default: nessuna restrizione (null)
'role__in' => null, // Array dei nome dei ruoli utente da visualizzare. Non è un elenco inclusivo, sicché nel caso siano indicati più ruoli, sono visualizzati solo gli utenti che soddisfano anche uno solo dei ruoli. Default: nessuna restrizione (null)
'role__not_in' => null, // Array dei nome dei ruoli utente da non visualizzare. Non è un elenco inclusivo, sicché nel caso siano indicati più ruoli, non sono visualizzati gli utenti che soddisfano anche uno solo dei ruoli da escludere. Default: nessuna restrizione (null)
);
|
Esempi
$opzioni = [v. dettagli array nel relativo parametro] <form action="" method="get"> <?php wp_dropdown_users($opzioni); ?> <input type="submit" /> </form>
Contenuti correlati
- CSS
- HTML
- JavaScript
- jQuery
- PHP
- SQL
- WORDPRESS
0 Comment