Login Form

Display

This form will display in place of blocked content if enabled for that post type in the plugin’s main options.

This form can be displayed directly using the shortcode [wpmem_form login]

HTML

The following is the default HTML that is generated when the login form is displayed either in place of blocked content or from the [wpmem_form login] shortcode. This output can be changed by the use of filters in the functions used to create the form.

<div id="wpmem_login"><a name="login"></a>
  <form action="http://example.com/login-page/" method="POST" id="" class="form">
    <fieldset>
      <legend>Existing Users Log In</legend>
      <label for="log">Username</label>
      <div class="div_text">
        <input name="log" type="text" id="log" value="" class="username">
      </div>
      <label for="pwd">Password</label>
      <div class="div_text">
        <input name="pwd" type="password" id="pwd" class="password">
      </div>
      <input name="redirect_to" type="hidden" value="http://wpmem.butlerblog.com/login/">
      <input name="a" type="hidden" value="login">
      <div class="button_div">
        <input name="rememberme" type="checkbox" id="rememberme" value="forever">
        &nbsp;Remember Me&nbsp;&nbsp;
        <input type="submit" name="Submit" value="Log In" class="buttons">
      </div>
      <div align="right" class="link-text">Forgot password?&nbsp;<a href="http://example.com/user-profile-page/?a=pwdreset">Click here to reset</a></div>
      <div align="right" class="link-text">New User?&nbsp;<a href="http://example.com/register-page/">Click here to register</a></div>
    </fieldset>
  </form>
</div>

Filters

Text and HTML in the login form can be changed by various filters that run during the process of building the form.

wpmem_inc_login_inputs
Filters information about the input fields including text labels, input field type, ID, class, and div wrapper class. Runs in wpmem_inc_login().

wpmem_inc_login_args
Filters information for the form including heading (legend tag), form action, button text, redirect. It can also filter the inputs from wpmem_inc_login_inputs as an array. Runs in wpmem_inc_login().

wpmem_login_form_args 
Filters the defaults for the form. Most of these are HTML tags that can be filtered and changed in order to set up custom attributes if you are tying into specific CSS other than WP-Members CSS.  Also filters specifc IDs and classes assigned to the form tag and the button tag.  Runs in wpmem_login_form().

wpmem_login_form_rows
Filters components that will build each row in the form (for the login form there are 2 rows – username and password).  Rows are a numeric array containing information to assemble the HTML for the form.  This includes the label tag, HTML that comes before the input, the input field tag, and any HTML wrapping the row.  Runs in wpmem_login_form().

wpmem_login_hidden_fields
Filters the HTML for hidden fields in the form.  Runs in wpmem_login_form().

wpmem_login_form_buttons
Filters the HTML for the form button area.  NOTE: if you want to change the button text, do that with wpmem_inc_login_args.  Runs in wpmem_login_form().

wpmem_forgot_link
Filters the forgot password URL used in the forgot password link.  Runs in wpmem_login_form().

wpmem_forgot_link_str 
Filters the forgot password link as a string.   Runs in wpmem_login_form().

wpmem_reg_link 
Filters the register URL used in the register link.  Runs in wpmem_login_form().

wpmem_reg_link_str 
Filters the register  link as a string.   Runs in wpmem_login_form().

wpmem_login_form_before  
This filter allows you to add HTML to display before the form.  This is an older filter and is generally not used.  It remains in the plugin for legacy purposes.  Runs in wpmem_login_form().

wpmem_login_form 
Filters the generated form HTML once all of it has been assembled.  This filter generally is not used as the previous filters allow direct control over specific text, HTML tags, and properties that might be used for CSS styles.  However, it may be helpful in cases where a larger change may be necessary.  Runs in wpmem_login_form().

Functions

wpmem_inc_login( $page, $redirect_to, $show );

This function is called to display the login form.  It sets up the heading, some of the HTML to be used, form field information, and ultimately runs the function to assemble the form HTML.  Upon completion, it returns a string of HTML for the form (see above).
[view function]

wpmem_login_form( $page, $arr );

This function actually builds the form based on the settings passed from wpmem_inc_login(). wpmem_login_form() is used to build the login form, but also password change, reset, and forgot username forms, so the HTML returned is based on settings passed to the function.
[view function]