Il form di login di WordPress

È spesso necessario portare nel front-end il form di login di WordPress.

La funzione wp_login_form() fa proprio questo: genera un semplice form di login da collocare dove si desidera all’interno di un template.

Volendo, è anche possibile creare uno shortcode che permetta di inserire il form in qualunque pagina del sito.

Per prima cosa va creato lo shortcode:

function register_theme_settings() {
	add_shortcode( 'login-form', 'build_login_form' );
}
add_action('init', 'register_theme_settings');

add_shortcode() richiede due argomenti: il nome dello shortcode e una funzione di callback, che può essere anche la seguente:

function build_login_form( $atts ){
	if ( is_user_logged_in() )
		return '';

	$atts = shortcode_atts( array( 'redirect' => get_bloginfo( 'url' ) ), $atts, 'login_form' );

	$output = '
		<div id="login">
	';
	$args = array(
		'echo' => false,
		'redirect' => esc_url( $atts['redirect'] ), 
		'form_id' => 'loginform',
		'label_username' => __( 'Username' ),
		'label_password' => __( 'Password' ),
		'label_remember' => __( 'Remember Me' ),
		'label_log_in' => __( 'Log In' ),
		'id_username' => 'user_login',
		'id_password' => 'user_pass',
		'id_remember' => 'rememberme',
		'id_submit' => 'wp-submit',
		'remember' => true,
		'value_username' => NULL,
		'value_remember' => true
	);
	$output .= wp_login_form( $args );
	$output .= '
		</div><!-- #login-form -->
	';
	return $output;
}

Niente di difficile. L’unica particolarità riguarda la funzione shortcode_atts(), la cui funzione è quella di definire gli attributi dello shortcode e impostarne i valori predefiniti. In questo caso, si è previsto l’unico attributo redirect, e gli si è assegnato il valore della URL della home page (get_bloginfo( 'url' )).

Così, se l’amministratore inserisce lo shortcode senza attributi, l’utente sarà reindirizzato alla home page dopo il login.

[login-form]

Se, invece, viene passato l’attributo redirect, sarà questo a impostare una diversa pagina di reindirizzamento:

[login-form redirect="http://www.example.com/profile"]