Search Results for: short code

Description

Filter hook to add attachments to emails sent through the WP-Members email function.

Parameters

$attachment
(string/array)(required) The path to an attachment.

$tag
(string)(optional) The email being sent (newreg|newmod|appmod|repass|admin).

Usage

// Example adding an attachement as a string:
add_filter( 'wpmem_email_attachments', function( $attachments, $tag ) {
    
    if ( 'newreg' == $tag ) {
        $upload_dir = wp_upload_dir();
        $attachments = trailingslashit( $upload_dir['basedir'] ) . 'path/to/file/filename.pdf';
    }
    
    return $attachments;
}, 10, 2 );


// Example adding an attachment as an array:
add_filter( 'wpmem_email_attachments', function( $attachments, $tag ) {
    
    if ( 'newreg' == $tag ) {
        $upload_dir = wp_upload_dir();
        $attachments[] = trailingslashit( $upload_dir['basedir'] ) . 'path/to/file/filename.pdf';
    }
    
    return $attachments;
}, 10, 2 );

Changelog

• Introduced in 3.4.0

Source

wpmem_email_attachments is located in includes/class-wp-members-email.php

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