Mass Users Password Reset

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].

Introduction

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

Compatible with:

Requirements

  1. WordPress 4.4 or higher
  2. 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.

    • Delete via admin panel

      Go to plugins, search for ‘Mass Users Password Reset’ then deactivate and delete it.

    • Delete via FTP

      Go to wp-content/plugins directory. Search for ‘Mass Users Password Reset’ folder and delete it.

Downloading & Installation

Upload via WordPress Admin Panel

  1. Log into WordPress and Plugins page
  2. Select the .zip file you downloaded and click Install
  3. Enter your FTP information if required and install the plugin
  4. Activate the plugin

Upload via FTP

  1. Unzip the .zip file you downloaded.
  2. Upload the “Mass Users Password Reset Pro” plugin folder to your wp-content/plugins directory.
  3. Navigate to your Admin Panel: Plugins.
  4. Under “Mass Users Password Reset Pro”, click Activate.

How to use the plugin?

Once you have installed the plugin, you have to visit Users >> Mass Users Password Reset Pro to use it.

Reset password:

You can reset all users’ password by selecting the ‘Reset All User Password’ button from the screenshot above.


Custom filters:

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


Customized email template:

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.

  1. 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.

  2. 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.


Reset single user password in user page:

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:

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.


User list pagination:

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.


Password reset through WP CLI

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:

  1. wp mupr reset --all
  2. wp mupr reset --role="name"
  3. wp mupr reset --user_id="1 2 3 4 5"
  4. wp mupr reset --role="name" --meta_key="key" --meta_value="value" meta_compare="!= | > | >= | < | <= | LIKE | NOT LIKE | IN | NOT IN | EXISTS | NOT EXISTS"
  5. wp mupr reset --meta_key="key" --meta_value="value" meta_compare="!= | > | >= | < | <= | LIKE | NOT LIKE | IN | NOT IN | EXISTS | NOT EXISTS"
  6. wp mupr update option --reset_link="enabled|disable"
  7. wp mupr update option --test_mode="enabled|disabled" -- test_mode_email="[email protected]"

WordPress Multisite


Exclude Valid Reset Link Users

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.


Reset link expiration time

You can set reset link expiration time


Hooks and Filters

  1. 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' );
    
  2. 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' );
    
  3. 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 );
    
  4. 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' );
    
  5. 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' );
    
  6. 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.

Add ons

Schedule Password Reset MUPR Add On

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 MUPR 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

  1. Maintain the password reset log reset by MUPR plugin
  2. Accurate user password reset log
  3. Available for MUPR and MUPR Pro

Features Comparison

Features
Free
Premium
  • Role based grouping
  • Email notification with new password
  • Multisite support
  • WP CLI support
  • Test Mode
  • Multiple methods to update password
  • Multilingual Translation
  • Custom filter based actions
  • Custom email template
  • Option to send password reset link
  • WooCommerce compatible
  • BuddyPress compatible
  • Dokan – multivendor marketplace compatible
  • Exclude valid reset link user
  • Support
    Forums
    Email & Phone