wpmem_pre_register_data

Description

Action hook gets user registration data before data is validated, but before new user is inserted.

All of the _data hooks can be used in a similar manner. The differences are if the user data has been inserted or not. All of it has passed validation by the time it gets to the hook.

The wpmem_pre_register_data hook can be used to validate registration data by globalizing $wpmem_themsg to contain the error message.  If $wpmem_themsg contains a value, it will halt the registration process and return the error message to the user.

The related action hook for user profile update is wpmem_post_update_data.

Parameters

$fields
(array) (optional) The user’s submitted registration data.

Usage

add_action( 'wpmem_pre_register_data', 'my_reg_hook' );
 
function my_reg_hook( $fields ) {
  
    // The following can be used to output what is in 
    // the $fields array so you can see what's in it,
    // and then it quits:
    // echo "<pre>"; print_r( $fields ); echo "</pre>";
    // exit();
  
    // In a real, working use of this action, you can
    // do whatever you need to do with registration
    // data before it is inserted.  
    
    // The following is an example using it to perform
    // validation, you can stop registration and return
    // an error message to the user by globalizing 
    // $wpmem_themsg and giving it your error message:
     
    global $wpmem_themsg;
    
    if ( $fields['my_field'] != 'some_criteria' ) {
        $wpmem_themsg = 'your error message...';
    }
    
    return;
}

Changelog

Introduced in version 2.7.2

Source

wpmem_post_register_data is located in /includes/api/api-users.php

Related

• wpmem_register_data (filter)
• wpmem_pre_register_data (action)
• wpmem_post_register_data (action)
• wpmem_pre_update_data (action)
• wpmem_post_update_data (action)

Code Snippet Library [Subscriber Content]

• Customize form fields based on specific page or post criteria
• Request additional data fields on a specific page
• Add a Date of Birth Field with Dropdown Selections for Month, Day, and Year
• Only Allow Registration From Specified Email Domains
• Fighting registration spam with a honey pot
• Validate a registration with a PIN
• Simple registration invite code example
• Custom form field validation: numeric fields