Описание
Выводит форму авторизации на сайте.
Функция выводит на экран 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()
из файла: /wp-includes/general-template.php WP 3.3.2function 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 и Теги Шаблона.