• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

RocketGeek

Home of WP-Members, The Original WordPress Membership Plugin

  • WordPress Plugins
    • WP-Members
      • FAQs
      • Quick Start
      • Documentation
      • Extensions
    • Advanced Options
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Download Protect
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Invite Codes
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • MailChimp Integration
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • PayPal Subscriptions
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Salesforce Web-to-Lead
    • Security
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Text Editor
      • Purchase the Plugin
      • Get the Pro Bundle
    • User List
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • User Tracking
      • Documentation
      • Purchase the Plugin
      • Get the Pro Bundle
    • Memberships for WooCommerce
    • WordPass
  • Blog
    • Basics
    • Tips and Tricks
    • Filters
    • Actions
    • Code Snippets
    • Shortcodes
    • Design
    • Release Announcements
  • Store
    • Cart
    • Checkout
  • Contact
  • Log In
  • Show Search
Hide Search
Home » Plugins » WP-Members » Documentation » Filter Hooks » wpmem_pre_register_data

wpmem_pre_register_data

Description

Gets user registration data before data is validated, but before the 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 the plugin’s default 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 which comes after the user is inserted.

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

Not sure what to do with this code?

You're not a "coder" and don't know what to do? Don't worry! Code Snippets are the basic building blocks of WordPress customization, and once you know the basics, they are simple to use.

Here are some free articles to get you started:

  • Using Code Snippets from the Site
  • Using a code snippets plugin
  • The functions.php File
  • Create a plugin file for custom functions
  • Create a child theme
  • Do not modify plugin files!

For "hands on" help, consider a plugin support subscription or the Pro Bundle.

  • Getting Started
  • Recommended WordPress® Settings
  • Plugin Settings
    • Options
    • Fields
    • Dialogs
    • Emails
    • New Feature Settings
  • Managing Content
    • Restricting Posts
    • Restricting Pages
    • Show Excerpts
    • Custom Post Types
  • Managing Users
    • Import Users
    • Export Users
    • Edit Users
    • Search Users
  • Login
  • Registration
    • Choosing Fields
    • Create a Registration Page
    • Moderating Registration
    • Using CAPTCHA
    • Removing Registration Options
  • User Profile
  • Memberships
    • Membership Properties
    • Membership Levels
  • Menus
    • Individual Menu Items
    • Logged In Menus
    • Login/Logout Menu Link
  • Customizing Emails
    • Email Address
    • Email Content
    • Email Format
    • Email Shortcodes
    • Email Troubleshooting
  • Customizing Forms
    • Create a Custom Stylesheet
    • Using the WordPress Customizer
    • Login Form HTML
    • Registration Form HTML
    • Widget Login Form HTML
  • Translation and Localization
    • Maintain a custom translation file
    • Filter untranslated strings
    • Multi-language Considerations
  • Shortcodes
    • Pages and Forms
    • Login Status
    • User Fields
    • Memberships
    • Email
    • Other Shortcodes
  • WP-CLI Commands
  • API Functions
  • Filter Hooks
  • Action Hooks
  • FAQs
    • Email troubleshooting
    • Passwords are not being included in Emails
    • The plugin isn’t blocking my content
    • Are files protected?
    • How can I prevent registration spam?
    • How to add a shortcode
    • How to apply login redirects
    • Why can’t users log in?
    • Why does reCAPTCHA v3 fail?
    • Troubleshooting Really Simple Captcha
    • Why do I get a 403 error?
    • How do I use code snippets?
    • My changes aren’t showing up
    • How to hide the “Admin Bar”
    • How to add a forgot password link
    • Password reset doesn’t show any fields
    • Domain not included in the password reset link
    • There was an error processing the form
    • Hidden vs. Restricted
  • Demo Videos
  • How to Request Support
  • Copy Settings for Support
  • Hosting Recommendations

Ready to get started?

Join Today!

© 2025 · butlerblog.com · RocketGeek is built using WordPress, WP-Members, and the Genesis Framework

  • butlerblog.com
  • WP-Members Support Subscription
  • Terms of Service
  • Privacy Policy
  • Refund Policy