WordPress.org

Make WordPress Core

Ticket #40462: 40462.2.patch

File 40462.2.patch, 5.6 KB (added by ramiy, 2 years ago)

phpDocs alignment

  • wp-includes/general-template.php

     
    366366 * @param array $args {
    367367 *     Optional. Array of options to control the form output. Default empty array.
    368368 *
    369  *     @type bool   $echo           Whether to display the login form or return the form HTML code.
    370  *                                  Default true (echo).
    371  *     @type string $redirect       URL to redirect to. Must be absolute, as in "https://example.com/mypage/".
    372  *                                  Default is to redirect back to the request URI.
    373  *     @type string $form_id        ID attribute value for the form. Default 'loginform'.
    374  *     @type string $label_username Label for the username or email address field. Default 'Username or Email Address'.
    375  *     @type string $label_password Label for the password field. Default 'Password'.
    376  *     @type string $label_remember Label for the remember field. Default 'Remember Me'.
    377  *     @type string $label_log_in   Label for the submit button. Default 'Log In'.
    378  *     @type string $id_username    ID attribute value for the username field. Default 'user_login'.
    379  *     @type string $id_password    ID attribute value for the password field. Default 'user_pass'.
    380  *     @type string $id_remember    ID attribute value for the remember field. Default 'rememberme'.
    381  *     @type string $id_submit      ID attribute value for the submit button. Default 'wp-submit'.
    382  *     @type bool   $remember       Whether to display the "rememberme" checkbox in the form.
    383  *     @type string $value_username Default value for the username field. Default empty.
    384  *     @type bool   $value_remember Whether the "Remember Me" checkbox should be checked by default.
    385  *                                  Default false (unchecked).
     369 *     @type bool   $echo                 Whether to display the login form or return the form HTML code.
     370 *                                        Default true (echo).
     371 *     @type string $redirect             URL to redirect to. Must be absolute, as in
     372 *                                        "https://example.com/mypage/". Default is to redirect back to the
     373 *                                        request URI.
     374 *     @type string $form_id              ID attribute value for the form. Default 'loginform'.
     375 *     @type string $label_username       Label for the username or email address field. Default
     376 *                                        'Username or Email Address'.
     377 *     @type string $label_password       Label for the password field. Default 'Password'.
     378 *     @type string $label_remember       Label for the remember field. Default 'Remember Me'.
     379 *     @type string $label_log_in         Label for the submit button. Default 'Log In'.
     380 *     @type string $id_username          ID attribute value for the username field. Default 'user_login'.
     381 *     @type string $id_password          ID attribute value for the password field. Default 'user_pass'.
     382 *     @type string $id_remember          ID attribute value for the remember field. Default 'rememberme'.
     383 *     @type string $id_submit            ID attribute value for the submit button. Default 'wp-submit'.
     384 *     @type string $placeholder_username Placeholder attribute value for the username field. Default empty.
     385 *     @type string $placeholder_password Placeholder attribute value for the password field. Default empty.
     386 *     @type bool   $remember             Whether to display the "rememberme" checkbox in the form.
     387 *     @type string $value_username       Default value for the username field. Default empty.
     388 *     @type bool   $value_remember       Whether the "Remember Me" checkbox should be checked by default.
     389 *                                        Default false (unchecked).
    386390 *
    387391 * }
    388392 * @return string|void String when retrieving.
     
    401405                'id_password' => 'user_pass',
    402406                'id_remember' => 'rememberme',
    403407                'id_submit' => 'wp-submit',
     408                'placeholder_username' => '',
     409                'placeholder_password' => '',
    404410                'remember' => true,
    405411                'value_username' => '',
    406412                // Set 'value_remember' to true to default the "Remember me" checkbox to checked.
     
    460466                        ' . $login_form_top . '
    461467                        <p class="login-username">
    462468                                <label for="' . esc_attr( $args['id_username'] ) . '">' . esc_html( $args['label_username'] ) . '</label>
    463                                 <input type="text" name="log" id="' . esc_attr( $args['id_username'] ) . '" class="input" value="' . esc_attr( $args['value_username'] ) . '" size="20" />
     469                                <input type="text" name="log" id="' . esc_attr( $args['id_username'] ) . '" class="input" placeholder="' . esc_attr( $args['placeholder_username'] ) . '" value="' . esc_attr( $args['value_username'] ) . '" size="20" />
    464470                        </p>
    465471                        <p class="login-password">
    466472                                <label for="' . esc_attr( $args['id_password'] ) . '">' . esc_html( $args['label_password'] ) . '</label>
    467                                 <input type="password" name="pwd" id="' . esc_attr( $args['id_password'] ) . '" class="input" value="" size="20" />
     473                                <input type="password" name="pwd" id="' . esc_attr( $args['id_password'] ) . '" class="input" placeholder="' . esc_attr( $args['placeholder_password'] ) . '" value="" size="20" />
    468474                        </p>
    469475                        ' . $login_form_middle . '
    470476                        ' . ( $args['remember'] ? '<p class="login-remember"><label><input name="rememberme" type="checkbox" id="' . esc_attr( $args['id_remember'] ) . '" value="forever"' . ( $args['value_remember'] ? ' checked="checked"' : '' ) . ' /> ' . esc_html( $args['label_remember'] ) . '</label></p>' : '' ) . '