wp_login_form с версии 3.0.0

Описание

Выводит форму авторизации на сайте.

Функция выводит на экран HTML код формы авторизации. Если указать параметр echo=0, то результат будет возвращен для дальнейшей обработки.

Использование

<?php wp_login_form( $args ); ?>

Параметры по умолчанию

$args = array(
        'echo' => true,
        'redirect' => site_url( $_SERVER['REQUEST_URI'] ),
        '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' => false );

Параметры

$args (строка/массив)

Массив аргументов, контролирующих результат.
По умолчанию: параметры по умолчанию

Аргументы параметра $args

echo (логический)

Вывести на экран (1) или возвратить (0).
По умолчанию: 1

redirect (строка)

УРЛ на который перекинет после авторизации.
По умолчанию: текущая страница

form_id (строка)

id атирбут тега <form id="loginform">.
По умолчанию: 'loginform'

label_username (строка)

Текст заголовка поля "имя пользователя".
По умолчанию: '__( 'Username' )'

label_password (строка)

Текст заголовка поля "пароль".
По умолчанию: '__( 'Password' )'

label_remember (строка)

Текст заголовка поля "запомнить меня".
По умолчанию: '__( 'Remember Me' )'

label_log_in (строка)

Текст кнопки сабмита.
По умолчанию: '__( 'Log In' )'

id_username (строка)

Значение атрибута id: <input id="user_login" />
По умолчанию: 'user_login'

id_password (строка)

Значение атрибута id: <input id="user_login" />
По умолчанию: 'user_pass'

id_remember (строка)

Значение атрибута id: <input id="user_login" />
По умолчанию: 'rememberme'

id_submit (строка)

Значение атрибута id: <input id="user_login" />
По умолчанию: 'wp-submit'

remember (логический)

Запомнить значения полей (1) или нет (0).
По умолчанию: 1

value_username (строка)

Имя пользователя по умолчанию.
По умолчанию: ''

value_remember (строка)

Значение атрибута value, поля "запомнить меня". По умолчанию 1 - галочка отмечена. 0 - галочка снята.
По умолчанию: 1

Примеры

1. Обычное отображение формы:

<?php wp_login_form(); ?>

Выведет на экран:

<form name="loginform" id="loginform" action="http://wp-kama.ru/wp-login.php" method="post">

	<p class="login-username">
		<label for="user_login">Логин</label>

		<input type="text" name="log" id="user_login" class="input" value="" size="20" tabindex="10" />
	</p>
	<p class="login-password">
		<label for="user_pass">Пароль</label>
		<input type="password" name="pwd" id="user_pass" class="input" value="" size="20" tabindex="20" />
	</p>

	<p class="login-remember"><label><input name="rememberme" type="checkbox" id="rememberme" value="forever" tabindex="90" /> Запомнить меня</label></p>

	<p class="login-submit">
		<input type="submit" name="wp-submit" id="wp-submit" class="button-primary" value="Войти" tabindex="100" />
		<input type="hidden" name="redirect_to" value="http://wp-kama.ru/s" />
	</p>

</form>

wp_login_form()

function wp_login_form( $args = array() ) {
	$defaults = array( 'echo' => true,
						'redirect' => ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'], // Default redirect is back to the current page
	 					'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' => '',
						'value_remember' => false, // Set this to true to default the "Remember me" checkbox to checked
					);
	$args = wp_parse_args( $args, apply_filters( 'login_form_defaults', $defaults ) );

	$form = '
		<form name="' . $args['form_id'] . '" id="' . $args['form_id'] . '" action="' . esc_url( site_url( 'wp-login.php', 'login_post' ) ) . '" method="post">
			' . apply_filters( 'login_form_top', '', $args ) . '
			<p class="login-username">
				<label for="' . esc_attr( $args['id_username'] ) . '">' . esc_html( $args['label_username'] ) . '</label>
				<input type="text" name="log" id="' . esc_attr( $args['id_username'] ) . '" class="input" value="' . esc_attr( $args['value_username'] ) . '" size="20" tabindex="10" />
			</p>
			<p class="login-password">
				<label for="' . esc_attr( $args['id_password'] ) . '">' . esc_html( $args['label_password'] ) . '</label>
				<input type="password" name="pwd" id="' . esc_attr( $args['id_password'] ) . '" class="input" value="" size="20" tabindex="20" />
			</p>
			' . apply_filters( 'login_form_middle', '', $args ) . '
			' . ( $args['remember'] ? '<p class="login-remember"><label><input name="rememberme" type="checkbox" id="' . esc_attr( $args['id_remember'] ) . '" value="forever" tabindex="90"' . ( $args['value_remember'] ? ' checked="checked"' : '' ) . ' /> ' . esc_html( $args['label_remember'] ) . '</label></p>' : '' ) . '
			<p class="login-submit">
				<input type="submit" name="wp-submit" id="' . esc_attr( $args['id_submit'] ) . '" class="button-primary" value="' . esc_attr( $args['label_log_in'] ) . '" tabindex="100" />
				<input type="hidden" name="redirect_to" value="' . esc_url( $args['redirect'] ) . '" />
			</p>
			' . apply_filters( 'login_form_bottom', '', $args ) . '
		</form>';

	if ( $args['echo'] )
		echo $form;
	else
		return $form;
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.