WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/wp signon

Descrizione

Autentica un utente con l'opzione di memorizzazione credenziali. Sostituisce la funzione deprecata wp_login.

Utilizzo

 <?php wp_signon$credentials$secure_cookie ?> 

Parametri

$credentials
(array) (opzionale) Informazioni dell'utente per effettuare l'autenticazione.
Default: Nessuno
$secure_cookie
(boolean) (opzionale) Indica se utilizzare cookie sicuri.
Default: Nessuno

NOTA: Se non si fornisce $credentials, wp_signon utilizza la variabile $_POST (le cui chiavi sono "log", "pwd" e "rememberme").

Valori restituiti

(object) 
Un WP_Error in caso di fallimento, un WP_User in caso di successo.

Esempi

Questa funzione e azione può essere inserita nel file functions.php del tema. Utilizzare l'aggancio after_setup_theme farà si che venga eseguita prima che gli header e i cookie vengano inviati, cosicché può impostare i cookie necessari per il login.

function custom_login() {
	$creds = array();
	$creds['user_login'] = 'esempio';
	$creds['user_password'] = 'password';
	$creds['remember'] = true;
	$user = wp_signon( $creds, false );
	if ( is_wp_error($user) )
		echo $user->get_error_message();
}
// eseguire prima che gli header e i cookie vengano inviati
add_action( 'after_setup_theme', 'custom_login' );

Note

  • Questa funzione invia gli header alla pagina. Deve essere eseguita prima di restituire qualsiasi contenuto.
  • Questa funzione imposta un cookie di autenticazione. Gli utenti non saranno autenticati se questo non viene inviato.

Log delle modifiche

Da: 2.5.0

File sorgente

wp_signon() si trova in wp-includes/user.php.

Correlati

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.