Search Results for: short code

What causes this?

WP-Members has two functions for generating forms – one for “short” forms such as the login, password reset, etc, and one for “long” forms like registration and user profile.

For “short” forms, for each form type (i.e. login, password reset, etc), there is a function that sets up the fields that will be used in the form.  In most default cases, this will be two fields (such as username and email).

While the legacy (old) password reset required both a username and a password, the plugin’s current process only uses a single field in which the user can enter either a username or a password.

In legacy instances, to create a form that only required a username or email address, the wpmem_resetpassword_form_defaults filter could be used to remove the second field of the form. address.

If you see no fields in the form, then somewhere you have an instance of the wpmem_resetpassword_form_defaults filter to remove a field and it is removing the single remaining field (thus leaving you with none).

How to correct it

You need to locate the instance of wpmem_resetpassword_form_defaults that is removing the field remaining. 

There are only two possibilities:

1. Either you are using the plugin’s Advanced Options extension with the “Require only email for password reset” turned on;
2. Or, you are manually applying customization using wpmem_resetpassword_form_defaults to remove a field from the form.

If you have Advanced Options and the “Require only email for password reset” setting is enabled, disable this setting.

If you do not have Advanced Options, or you do but you don’t have the “Require only email for password reset” setting enabled, then you have manually applied a custom filter function using one of the following hooks, and you will need to remove that filter from wherever you saved it.

• wpmem_reset_password_form_defaults
• wpmem_inc_resetpassword_inputs. 

The “forgot password” link in the login form is generated based on the plugin’s User Profile page setting. The return link in the password reset email is also built from this same setting.

Generally, this page will contain the [wpmem_profile] shortcode. It is a general shortcode that handles changing a password and updating registration data for logged in users, as well as resetting a forgotten password, login, and registration for logged out users.

Basic setup

1. Create a page containing the [wpmem_profile] shortcode
2. Go to Settings > WP-Members and select the page in the dropdown for the “User Profile Page” setting

Alternative setups

It is recommended that you start with and use the [wpmem_profile] shortcode as described above.  However, for setups that need a little more control over things, there are alternatives.  The [wpmem_form password] shortcode also handles forgotten password reset for a logged out user. It is essentially just the password portion of the [wpmem_profile] shortcode.  You can potentially use the user profile page setting in the options to point to a page with [wpmem_form password] if you only want to provide a password reset.

Note that if you use [wpmem_form password] the page must not be blocked.

If you have an alternate forgot password dialog (such as the WP default, or WooCommerce), you should still set the User Profile page setting in the main options so the link is displayed.  Then you can use the wpmem_forgot_link filter to change the URL the link points to.

Note that if you do not have the “user profile page” setting set in the plugin’s main options, then the forgot password link will not display in the login form, and the return URL in the password reset email will be incomplete.

See also: Domain not included in the password reset link

Basic Use

To implement the list, create the page you want the list to display on and add the following shortcode:

[wpmem_ul]

The User List allows for multiple instances in a site, but can generally only be used once on a page.  If you are only implementing a single list on a single page, it is recommended that you simply use the shortcode and rely on the admin panel to implement your settings.

Additional Custom Attributes

If you are implementing additional lists and you need to override the list settings from the admin, you can utilize the attributes below.

• role – determine the role of users to list (such as subscriber, author, etc). To display “all” roles, pass the role attribute as empty (role=””).  The default is “subscriber”.
• exclude – a list of User IDs (numeric) to exclude from the list display.
• number – the number of users that will be displayed per page.  The default is 10.
• search – determines whether or not to display the search form.  The default is true.  Setting to false turns it off.
• search_by – determines which fields that are included in the search by dropdown.  Values must be passed as “Field Name|meta key” pairs separated by commas (i.e. “First Name|first_name,Last Name|last_name”).
• nav – determines whether or not to display the nav links. The default is true.  Setting to false turns it off.
• fields – an array of the fields you would like displayed for each user. The default is username (user_login) and “member since”.
• avatar – size of the user avatar. The default is 45px.  A negative number can be passed for no avatar.
• h2 – what field to display as the h2 heading for each user in the list. The default is first_last.  Possible arguments are first_last, last_first, display_name, user_login, username.  First name / last name combinations assume use of the WP and WP-Members native first_name and last_name fields.
• order_by – what field to order the list by.  The default is username.  The possibilities here are currently limited to ordering the list by a field that is part of the wp_users table (user_login, user_email, user_nicename, display_name). To order by a meta field, set this to meta_value and also specify the meta_key parameter.
• show_labels – true/false boolean to include the field title as part of the display. For example, first_name: Sam. The default is false. (“show_titles” is deprecated in version 2.0. Use “show_titles” for User List 1.x, “show_labels” for User List version 2.x.)
• meta_key – this allows you to set up a list of users with a specific meta key.
• meta_value – if you use the meta_key parameter to filter the displayed list, this must be included to determine the meta_key value to display. (“meta_val” is deprecated in version 2.0. Use “meta_val” for User List 1.x, “meta_value” for User List version 2.x.)

Additional Examples setting custom shortcode parameters

Display 5 users per page, no search form:

[wpmem_ul number=5 search=false]

Display  default 10 users per page, no navigation links:

[wpmem_ul nav=false]

This shortcode can also be nested with the wp-members status shortcode, such as:

The members list can only be viewed by members. If you are a member, login to view the list.