[WORDPRESS] [Funzione] wp_dropdown_users()

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

Fonti esterne

funzioni wordpress, wordpress

Related Articles

0 Comment

Rispondi