This is the help document for the Mass User Password Reset Pro plugin. We recommend going through this plugin manual before installing and using the plugin.
If you have gone through the manual and still have any questions, feel free to contact us at [email protected].
Mass Users Password Reset is a WordPress Plugin that lets you resets the password of all users. It can group the users according to their role and resets the password of that group. It sends a notification email to users about their new randomly generated password. The pro version comes with the multiple methods to reset the password and customized email templates with the new password information. It supports multiple languages and compatible with the WooCommerce, BuddyPress and Dokan - Multivendor Marketplace. It has the best user interface in the latest version thatsupport some advanced features like custom field filter, test mode and WP CLI support too.
View the comparison between MUPR and WordPress password reset
If If you are using the free version of the Mass User Password Reset Plugin, the first thing you need to do is deactivate and delete it from the WordPress set up.
Go to plugins, search for ‘Mass Users Password Reset’ then deactivate and delete it.
Go to wp-content/plugins directory. Search for ‘Mass Users Password Reset’ folder and delete it.
Once you have installed the plugin, you have to visit Users >> Mass Users Password Reset Pro to use it.
You can reset all users’ password by selecting the ‘Reset All User Password’ button from the screenshot above.
You can set the custom filters for user selection by clicking on the ‘Filter’ icon. Custom field filters will display different user meta keys. You can reset the password of a specific group of users based on selected custom field and selected value.
Note: User filtration can be done either based on roles or based on custom filters
You can customize the reset password email template by inserting the user details to the email. You can do that by using the placeholders on the right side. These placeholders can be used in the message body only. There will be 2 options for resetting the password.
Admin will reset the password of all users and mail containing changed password will be received to them. The length of a randomly generated password is 8 characters by default. You can customize that by applying filter 'mupr_password_length'.
For Example: Write this code in function file:
add_filter(‘mupr_password_length’,’my_theme_function’);
function my_theme_function(){
return 6;
}
Note: Make sure that send password reset link is disabled in email settings.
User can set the new password. The system will send them the reset password link and the user will be able to generate their new password following that link.
{RESET_PASSWORD_URL} link takes you to default WordPress reset password page while the link in {WOO_RESET_PASSWORD_URL} will take you to WooCommerce reset password page.
Note: Make sure that send password reset link is enabled in email setting.
You can reset the password of a single user from users page as well. You can do that by clicking on the reset password link below the specific user name. The message containing the respective user’s name will be displayed on success.
Test mode now lets you send the password reset link to specific email id only. If you have kept the test mode enabled, it won’t bother all users by sending the reset email password link and send the new password link to that email only.
You can select the number of users to display per page from the config settings. You can also select what details about the users will be displayed on the user listing page.
We have added some initial WP-CLI support for resetting the user’s password. You can use role, user id and custom fields also while resetting the password through command line.
Following is the list of the WP CLI commands you can use:
This filter will display only when the setting is set as the user will receive the password reset link not the password. You can also change the expire time of the password reset link, by default it is 1 days.
You can set reset link expiration time
If you want to disable email notification for the reset password email then add the below code to the function file.
/**
* Disable password reset email
*
* Callback function: __return_false OR __return_true
*/
add_filter( 'mupr_send_email', '__return_false' );
If you want to change the password length then you can change using the below filter. Just change the number from 10 to your choice. We prefer to keep at least 6.
/**
* Set auto generate password length.
*
* @param int $length Password length.
* @return int
*/
function callback_function_password_length( $length ) {
return 10;
}
add_filter( 'mupr_password_length', 'callback_function_password_length' );
If you wish to keep a fix password before you reset the password then you need to add the below code to the function file. Change the string to what ever the password you wish to keep.
/**
* Set custom password instead of auto generate password.
*
* @param string $password Auto generate password.
* @param object $userinfo User info.
* @return string Password
*/
function callback_function_set_user_password( $password, $userinfo ) {
return $password;
}
add_filter( 'mupr_set_user_password', 'callback_function_set_user_password', 10, 2 );
If you want to do somthing after user's password reset then you can use the below action.You will get the user information from the parameter.
/**
* Execute something after password reset
*
* @param object $userinfo User info.
*/
function callback_function_after_reset( $userinfo ) {
// Code here
}
add_action( 'mupr_after_reset', 'callback_function_after_reset' );
If you want to change the plugins page from users sub page to other position or with new menu item, you can use the below filter:
/**
* Filter MUPR admin menu.
*
* @param array $menu MUPR menu item.
* @return array Menu item
*/
function theme_prefix_mupr_menu_config( $menu ) {
$menu = array(
'parent' => 'users.php', // Parent menu path If you want to create new menu then set `false`.
'menu_title' => __( 'MUPR Pro', 'textdomain' ),
'capability' => 'manage_options',
'position' => 999, // NOTE: It will working only if 'parent' is set to false
);
return $menu;
}
add_filter( 'mupr_menu_config', 'theme_prefix_mupr_menu_config' );
If you want to add extra email to receive the same email sent to the user when password is reset:
/**
* Filter user notification email recipient.
*
* @param string $to Email Recipient.
* @return array Menu item
*/
function theme_prefix_mupr_email_recipient( $to ) {
// Code here
return $to;
}
add_filter( 'mupr_email_recipient', 'theme_prefix_mupr_email_recipient' );
Do you have any questions? Email us at [email protected] for personal assistance.
Schedule Password Reset Add-on lets you schedule the password reset on daily, weekly or monthly basis and automatically send the password update emails. It works with both Mass User Password Reset (Free) and Mass User Password Reset Pro plugin. You can also utilize all the default filters and features along with this add on features. If you are using a free version of the Mass User Password Reset plugin, there is something more for you. It removes the limit of 100 users for the Mass User Password Reset plugin. You can use the plugin for unlimited users with this module.
If you are looking to test the schedule password reset you can also check that with 5 minutes or 10 minutes. Just add the below line in to wp-config.php and test mode with 5 or 10 minutes will be available for you.
define( 'SPR_DEV_MODE', true );
Check out the amazing features of Schedule Password Reset Add On.
Password reset log for Mass User Password Reset gives you the complete log of password reset history of each user in your system. You can also check who has reset the password for user. This add-on is compatible for both Mass User Password Reset and Mass user Password Reset Pro.
Key Features