Proporciona un formulario de inicio de sesión simple para usar en cualquier lugar dentro de WordPress.

Descripción

El HTML del formulario de inicio de sesión se repite de forma predeterminada. Pase un valor falso para $echo para devolverlo en su lugar.

Parámetros

$ args

(formación)(Opcional)Matriz de opciones para controlar la salida del formulario.

  • ‘eco’
    (bool) Ya sea para mostrar el formulario de inicio de sesión o devolver el código HTML del formulario. Verdadero predeterminado (eco).
  • ‘redireccionar’
    (cuerda) URL a la que redirigir. Debe ser absoluto, como en “https://example.com/mypage/“. El valor predeterminado es redirigir al URI de la solicitud.
  • ‘form_id’
    (cuerda) Valor de atributo de ID para el formulario. ‘Formulario de inicio de sesión’ predeterminado.
  • ‘label_username’
    (cuerda) Etiqueta para el campo de nombre de usuario o dirección de correo electrónico. ‘Nombre de usuario o dirección de correo electrónico’ predeterminado.
  • ‘label_password’
    (cuerda) Etiqueta para el campo de contraseña. Contraseña predeterminada’.
  • ‘label_remember’
    (cuerda) Etiqueta para el campo recordar. Predeterminado ‘Recordarme’.
  • ‘label_log_in’
    (cuerda) Etiqueta para el botón de enviar. ‘Iniciar sesión’ predeterminado.
  • ‘id_username’
    (cuerda) Valor de atributo de ID para el campo de nombre de usuario. Por defecto ‘user_login’.
  • ‘id_password’
    (cuerda) Valor de atributo de ID para el campo de contraseña. ‘User_pass’ predeterminado.
  • ‘id_remember’
    (cuerda) Valor de atributo de ID para el campo de recuerdo. Por defecto ‘recuérdame’.
  • ‘id_submit’
    (cuerda) Valor de atributo de ID para el botón de envío. Por defecto ‘wp-submit’.
  • ‘recordar’
    (bool) Si mostrar la casilla de verificación “recordarme” en el formulario.
  • ‘value_username’
    (cuerda) Valor predeterminado para el campo de nombre de usuario.
  • ‘value_remember’
    (bool) Si la casilla de verificación “Recordarme” debe estar marcada de forma predeterminada. Falso predeterminado (sin marcar).

Valor predeterminado: array ()

Regreso

(vacío | cadena) No válido si el argumento ‘echo’ es verdadero, formulario de inicio de sesión HTML si ‘echo’ es falso.

Fuente

Expediente: wp-includes / general-template.php

functionwp_login_form($args=array())$defaults=array('echo'=>true,// Default 'redirect' value takes the user back to the request URI.'redirect'=>(is_ssl()?'https://':'http://').$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'],'form_id'=>'loginform','label_username'=>__('Username or Email Address'),'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'=>'',// Set 'value_remember' to true to default the "Remember me" checkbox to checked.'value_remember'=>false,);/**
	 * Filters the default login form output arguments.
	 *
	 * @since 3.0.0
	 *
	 * @see wp_login_form()
	 *
	 * @param array $defaults An array of default login form arguments.
	 */$args=wp_parse_args($args,apply_filters('login_form_defaults',$defaults));/**
	 * Filters content to display at the top of the login form.
	 *
	 * The filter evaluates just following the opening form tag element.
	 *
	 * @since 3.0.0
	 *
	 * @param string $content Content to display. Default empty.
	 * @param array  $args    Array of login form arguments.
	 */$login_form_top=apply_filters('login_form_top','',$args);/**
	 * Filters content to display in the middle of the login form.
	 *
	 * The filter evaluates just following the location where the 'login-password'
	 * field is displayed.
	 *
	 * @since 3.0.0
	 *
	 * @param string $content Content to display. Default empty.
	 * @param array  $args    Array of login form arguments.
	 */$login_form_middle=apply_filters('login_form_middle','',$args);/**
	 * Filters content to display at the bottom of the login form.
	 *
	 * The filter evaluates just preceding the closing form tag element.
	 *
	 * @since 3.0.0
	 *
	 * @param string $content Content to display. Default empty.
	 * @param array  $args    Array of login form arguments.
	 */$login_form_bottom=apply_filters('login_form_bottom','',$args);$form='
		
'.$login_form_top.'

'
.$login_form_middle.' '.($args['remember']?'

'
:'').'

'
.$login_form_bottom.' '
;if($args['echo'])echo$form;elsereturn$form;

Relacionado

Usos

Usos Descripción
wp-includes / l10n.php:__ ()

Recupere la traducción de $ text.

wp-includes / formatting.php:esc_url ()

Comprueba y limpia una URL.

wp-includes / formatting.php:esc_attr ()

Escapar de atributos HTML.

wp-includes / formatting.php:esc_html ()

Escapar de bloques HTML.

wp-includes / general-template.php:login_form_defaults

Filtra los argumentos de salida del formulario de inicio de sesión predeterminado.

wp-includes / general-template.php:login_form_top

Filtra el contenido para mostrarlo en la parte superior del formulario de inicio de sesión.

wp-includes / general-template.php:login_form_middle

Filtra el contenido para mostrarlo en el medio del formulario de inicio de sesión.

wp-includes / general-template.php:login_form_bottom

Filtra el contenido para mostrarlo en la parte inferior del formulario de inicio de sesión.

wp-includes / load.php:is_ssl ()

Determina si se utiliza SSL.

wp-includes / functions.php:wp_parse_args ()

Fusiona argumentos definidos por el usuario en una matriz predeterminada.

wp-includes / link-template.php:Sitio URL()

Recupera la URL del sitio actual donde se puede acceder a los archivos de la aplicación de WordPress (por ejemplo, wp-blog-header.php o la carpeta wp-admin /).

wp-includes / plugin.php:aplicar_filtros ()

Llama a las funciones de devolución de llamada que se han agregado a un enlace de filtro.

Registro de cambios

Versión Descripción
3.0.0 Introducido.