BP_Signup
Class used to handle Signups.
Description
Source
File: bp-members/classes/class-bp-signup.php
class BP_Signup { /** * ID of the signup which the object relates to. * * @since BuddyPress 2.0.0 * @var integer */ public $id; /** * The URL to the full size of the avatar for the user. * * @since BuddyPress 2.0.0 * @var string */ public $avatar; /** * The username for the user. * * @since BuddyPress 2.0.0 * @var string */ public $user_login; /** * The email for the user. * * @since BuddyPress 2.0.0 * @var string */ public $user_email; /** * The full name of the user. * * @since BuddyPress 2.0.0 * @var string */ public $user_name; /** * Metadata associated with the signup. * * @since BuddyPress 2.0.0 * @var array */ public $meta; /** * The registered date for the user. * * @since BuddyPress 2.0.0 * @var string */ public $registered; /** * The activation key for the user. * * @since BuddyPress 2.0.0 * @var string */ public $activation_key; /** Public Methods *******************************************************/ /** * Class constructor. * * @since BuddyPress 2.0.0 * * @param integer $signup_id The ID for the signup being queried. */ public function __construct( $signup_id = 0 ) { if ( !empty( $signup_id ) ) { $this->id = $signup_id; $this->populate(); } } /** * Populate the instantiated class with data based on the signup_id provided. * * @since BuddyPress 2.0.0 */ public function populate() { global $wpdb; $signups_table = buddypress()->members->table_name_signups; $signup = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$signups_table} WHERE signup_id = %d AND active = 0", $this->id ) ); $this->avatar = get_avatar( $signup->user_email, 32 ); $this->user_login = $signup->user_login; $this->user_email = $signup->user_email; $this->meta = maybe_unserialize( $signup->meta ); $this->user_name = ! empty( $this->meta['field_1'] ) ? wp_unslash( $this->meta['field_1'] ) : ''; $this->registered = $signup->registered; $this->activation_key = $signup->activation_key; } /** Static Methods *******************************************************/ /** * Fetch signups based on parameters. * * @since BuddyPress 2.0.0 * * @param array $args { * The argument to retrieve desired signups. * @type int $offset Offset amount. Default 0. * @type int $number How many to fetch. Default 1. * @type bool|string $usersearch Whether or not to search for a username. Default false. * @type string $orderby Order By parameter. Default 'signup_id'. * @type string $order Order direction. Default 'DESC'. * @type bool $include Whether or not to include more specific query params. * @type string $activation_key Activation key to search for. * @type string $user_login Specific user login to return. * @type string $fields Which fields to return. Specify 'ids' to fetch a list of signups IDs. * Default: 'all' (return BP_Signup objects). * } * @return array { * @type array $signups Located signups. (IDs only if `fields` is set to `ids`.) * @type int $total Total number of signups matching params. * } */ public static function get( $args = array() ) { global $wpdb; $r = bp_parse_args( $args, array( 'offset' => 0, 'number' => 1, 'usersearch' => false, 'orderby' => 'signup_id', 'order' => 'DESC', 'include' => false, 'activation_key' => '', 'user_login' => '', 'fields' => 'all', ), 'bp_core_signups_get_args' ); // @todo whitelist sanitization if ( $r['orderby'] !== 'signup_id' ) { $r['orderby'] = 'user_' . $r['orderby']; } $r['orderby'] = sanitize_title( $r['orderby'] ); $sql = array(); $signups_table = buddypress()->members->table_name_signups; $sql['select'] = "SELECT * FROM {$signups_table}"; $sql['where'] = array(); $sql['where'][] = "active = 0"; if ( empty( $r['include'] ) ) { // Search terms. if ( ! empty( $r['usersearch'] ) ) { $search_terms_like = '%' . bp_esc_like( $r['usersearch'] ) . '%'; $sql['where'][] = $wpdb->prepare( "( user_login LIKE %s OR user_email LIKE %s OR meta LIKE %s )", $search_terms_like, $search_terms_like, $search_terms_like ); } // Activation key. if ( ! empty( $r['activation_key'] ) ) { $sql['where'][] = $wpdb->prepare( "activation_key = %s", $r['activation_key'] ); } // User login. if ( ! empty( $r['user_login'] ) ) { $sql['where'][] = $wpdb->prepare( "user_login = %s", $r['user_login'] ); } $sql['orderby'] = "ORDER BY {$r['orderby']}"; $sql['order'] = bp_esc_sql_order( $r['order'] ); $sql['limit'] = $wpdb->prepare( "LIMIT %d, %d", $r['offset'], $r['number'] ); } else { $in = implode( ',', wp_parse_id_list( $r['include'] ) ); $sql['in'] = "AND signup_id IN ({$in})"; } // Implode WHERE clauses. $sql['where'] = 'WHERE ' . implode( ' AND ', $sql['where'] ); /** * Filters the Signups paged query. * * @since BuddyPress 2.0.0 * * @param string $value SQL statement. * @param array $sql Array of SQL statement parts. * @param array $args Array of original arguments for get() method. * @param array $r Array of parsed arguments for get() method. */ $paged_signups = $wpdb->get_results( apply_filters( 'bp_members_signups_paged_query', join( ' ', $sql ), $sql, $args, $r ) ); if ( empty( $paged_signups ) ) { return array( 'signups' => false, 'total' => false ); } // We only want the IDs. if ( 'ids' === $r['fields'] ) { $paged_signups = wp_list_pluck( $paged_signups, 'signup_id' ); } else { // Used to calculate a diff between now & last // time an activation link has been resent. $now = current_time( 'timestamp', true ); foreach ( (array) $paged_signups as $key => $signup ) { $signup->id = intval( $signup->signup_id ); $signup->meta = ! empty( $signup->meta ) ? maybe_unserialize( $signup->meta ) : false; $signup->user_name = ''; if ( ! empty( $signup->meta['field_1'] ) ) { $signup->user_name = wp_unslash( $signup->meta['field_1'] ); } // Sent date defaults to date of registration. if ( ! empty( $signup->meta['sent_date'] ) ) { $signup->date_sent = $signup->meta['sent_date']; } else { $signup->date_sent = $signup->registered; } $sent_at = mysql2date('U', $signup->date_sent ); $diff = $now - $sent_at; /** * Add a boolean in case the last time an activation link * has been sent happened less than a day ago. */ if ( $diff < 1 * DAY_IN_SECONDS ) { $signup->recently_sent = true; } if ( ! empty( $signup->meta['count_sent'] ) ) { $signup->count_sent = absint( $signup->meta['count_sent'] ); } else { $signup->count_sent = 1; } $paged_signups[ $key ] = $signup; } } unset( $sql['limit'] ); $sql['select'] = preg_replace( "/SELECT.*?FROM/", "SELECT COUNT(*) FROM", $sql['select'] ); /** * Filters the Signups count query. * * @since BuddyPress 2.0.0 * * @param string $value SQL statement. * @param array $sql Array of SQL statement parts. * @param array $args Array of original arguments for get() method. * @param array $r Array of parsed arguments for get() method. */ $total_signups = $wpdb->get_var( apply_filters( 'bp_members_signups_count_query', join( ' ', $sql ), $sql, $args, $r ) ); return array( 'signups' => $paged_signups, 'total' => $total_signups ); } /** * Add a signup. * * @since BuddyPress 2.0.0 * * @param array $args { * Array of arguments for signup addition. * @type string $domain New user's domain. * @type string $path New user's path. * @type string $title New user's title. * @type string $user_login New user's user_login. * @type string $user_email New user's email address. * @type int|string $registered Time the user registered. * @type string $activation_key New user's activation key. * @type string $meta New user's user meta. * } * @return int|bool ID of newly created signup on success, false on failure. */ public static function add( $args = array() ) { global $wpdb; $r = bp_parse_args( $args, array( 'domain' => '', 'path' => '', 'title' => '', 'user_login' => '', 'user_email' => '', 'registered' => current_time( 'mysql', true ), 'activation_key' => '', 'meta' => '', ), 'bp_core_signups_add_args' ); $r['meta'] = maybe_serialize( $r['meta'] ); $inserted = $wpdb->insert( buddypress()->members->table_name_signups, $r, array( '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s' ) ); if ( $inserted ) { $retval = $wpdb->insert_id; } else { $retval = false; } /** * Filters the result of a signup addition. * * @since BuddyPress 2.0.0 * * @param int|bool $retval Newly added user ID on success, false on failure. */ return apply_filters( 'bp_core_signups_add', $retval ); } /** * Create a WP user at signup. * * Since BP 2.0, non-multisite configurations have stored signups in * the same way as Multisite configs traditionally have: in the * wp_signups table. However, because some plugins may be looking * directly in the wp_users table for non-activated signups, we * mirror signups there by creating "phantom" users, mimicking WP's * default behavior. * * @since BuddyPress 2.0.0 * * @param string $user_login User login string. * @param string $user_password User password. * @param string $user_email User email address. * @param array $usermeta Metadata associated with the signup. * @return int User id. */ public static function add_backcompat( $user_login = '', $user_password = '', $user_email = '', $usermeta = array() ) { global $wpdb; $user_id = wp_insert_user( array( 'user_login' => $user_login, 'user_pass' => $user_password, 'display_name' => sanitize_title( $user_login ), 'user_email' => $user_email ) ); if ( is_wp_error( $user_id ) || empty( $user_id ) ) { return $user_id; } // Update the user status to '2', ie "not activated" // (0 = active, 1 = spam, 2 = not active). $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->users} SET user_status = 2 WHERE ID = %d", $user_id ) ); // WordPress creates these options automatically on // wp_insert_user(), but we delete them so that inactive // signups don't appear in various user counts. delete_user_option( $user_id, 'capabilities' ); delete_user_option( $user_id, 'user_level' ); // Set any profile data. if ( bp_is_active( 'xprofile' ) ) { if ( ! empty( $usermeta['profile_field_ids'] ) ) { $profile_field_ids = explode( ',', $usermeta['profile_field_ids'] ); foreach ( (array) $profile_field_ids as $field_id ) { if ( empty( $usermeta["field_{$field_id}"] ) ) { continue; } $current_field = $usermeta["field_{$field_id}"]; xprofile_set_field_data( $field_id, $user_id, $current_field ); /* * Save the visibility level. * * Use the field's default visibility if not present, and 'public' if a * default visibility is not defined. */ $key = "field_{$field_id}_visibility"; if ( isset( $usermeta[ $key ] ) ) { $visibility_level = $usermeta[ $key ]; } else { $vfield = xprofile_get_field( $field_id ); $visibility_level = isset( $vfield->default_visibility ) ? $vfield->default_visibility : 'public'; } xprofile_set_field_visibility_level( $field_id, $user_id, $visibility_level ); } } } /** * Filters the user ID for the backcompat functionality. * * @since BuddyPress 2.0.0 * * @param int $user_id User ID being registered. */ return apply_filters( 'bp_core_signups_add_backcompat', $user_id ); } /** * Check a user status (from wp_users) on a non-multisite config. * * @since BuddyPress 2.0.0 * * @param int $user_id ID of the user being checked. * @return int|bool The status if found, otherwise false. */ public static function check_user_status( $user_id = 0 ) { global $wpdb; if ( empty( $user_id ) ) { return false; } $user_status = $wpdb->get_var( $wpdb->prepare( "SELECT user_status FROM {$wpdb->users} WHERE ID = %d", $user_id ) ); /** * Filters the user status of a provided user ID. * * @since BuddyPress 2.0.0 * * @param int $value User status of the provided user ID. */ return apply_filters( 'bp_core_signups_check_user_status', intval( $user_status ) ); } /** * Activate a signup. * * @since BuddyPress 2.0.0 * * @param string $key Activation key. * @return bool True on success, false on failure. */ public static function validate( $key = '' ) { global $wpdb; if ( empty( $key ) ) { return; } $activated = $wpdb->update( // Signups table. buddypress()->members->table_name_signups, array( 'active' => 1, 'activated' => current_time( 'mysql', true ), ), array( 'activation_key' => $key, ), // Data sanitization format. array( '%d', '%s', ), // WHERE sanitization format. array( '%s', ) ); /** * Filters the status of the activated user. * * @since BuddyPress 2.0.0 * * @param bool $activated Whether or not the activation was successful. */ return apply_filters( 'bp_core_signups_validate', $activated ); } /** * How many inactive signups do we have? * * @since BuddyPress 2.0.0 * * @return int The number of signups. */ public static function count_signups() { global $wpdb; $signups_table = buddypress()->members->table_name_signups; $count_signups = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) AS total FROM {$signups_table} WHERE active = %d", 0 ) ); /** * Filters the total inactive signups. * * @since BuddyPress 2.0.0 * * @param int $count_signups How many total signups there are. */ return apply_filters( 'bp_core_signups_count', (int) $count_signups ); } /** * Update the meta for a signup. * * This is the way we use to "trace" the last date an activation * email was sent and how many times activation was sent. * * @since BuddyPress 2.0.0 * * @param array $args { * Array of arguments for the signup update. * @type int $signup_id User signup ID. * @type array $meta Meta to update. * } * @return int The signup id. */ public static function update( $args = array() ) { global $wpdb; $r = bp_parse_args( $args, array( 'signup_id' => 0, 'meta' => array(), ), 'bp_core_signups_update_args' ); if ( empty( $r['signup_id'] ) || empty( $r['meta'] ) ) { return false; } $wpdb->update( // Signups table. buddypress()->members->table_name_signups, // Data to update. array( 'meta' => serialize( $r['meta'] ), ), // WHERE. array( 'signup_id' => $r['signup_id'], ), // Data sanitization format. array( '%s', ), // WHERE sanitization format. array( '%d', ) ); /** * Filters the signup ID which received a meta update. * * @since BuddyPress 2.0.0 * * @param int $value The signup ID. */ return apply_filters( 'bp_core_signups_update', $r['signup_id'] ); } /** * Resend an activation email. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Single ID or list of IDs to resend. * @return array */ public static function resend( $signup_ids = array() ) { if ( empty( $signup_ids ) || ! is_array( $signup_ids ) ) { return false; } $to_resend = self::get( array( 'include' => $signup_ids, ) ); if ( ! $signups = $to_resend['signups'] ) { return false; } $result = array(); /** * Fires before activation emails are resent. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of IDs to resend activation emails to. */ do_action( 'bp_core_signup_before_resend', $signup_ids ); foreach ( $signups as $signup ) { $meta = $signup->meta; $meta['sent_date'] = current_time( 'mysql', true ); $meta['count_sent'] = $signup->count_sent + 1; // Send activation email. if ( is_multisite() ) { wpmu_signup_user_notification( $signup->user_login, $signup->user_email, $signup->activation_key, serialize( $meta ) ); } else { // Check user status before sending email. $user_id = email_exists( $signup->user_email ); if ( ! empty( $user_id ) && 2 != self::check_user_status( $user_id ) ) { // Status is not 2, so user's account has been activated. $result['errors'][ $signup->signup_id ] = array( $signup->user_login, esc_html__( 'the sign-up has already been activated.', 'buddyboss' ) ); // Repair signups table. self::validate( $signup->activation_key ); continue; // Send the validation email. } else { bp_core_signup_send_validation_email( false, $signup->user_email, $signup->activation_key, $signup->user_login ); } } // Update metas. $result['resent'][] = self::update( array( 'signup_id' => $signup->signup_id, 'meta' => $meta, ) ); } /** * Fires after activation emails are resent. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of IDs to resend activation emails to. * @param array $result Updated metadata related to activation emails. */ do_action( 'bp_core_signup_after_resend', $signup_ids, $result ); /** * Filters the result of the metadata for signup activation email resends. * * @since BuddyPress 2.0.0 * * @param array $result Updated metadata related to activation emails. */ return apply_filters( 'bp_core_signup_resend', $result ); } /** * Activate a pending account. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Single ID or list of IDs to activate. * @return array */ public static function activate( $signup_ids = array() ) { if ( empty( $signup_ids ) || ! is_array( $signup_ids ) ) { return false; } $to_activate = self::get( array( 'include' => $signup_ids, ) ); if ( ! $signups = $to_activate['signups'] ) { return false; } $result = array(); /** * Fires before activation of user accounts. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of IDs to activate. */ do_action( 'bp_core_signup_before_activate', $signup_ids ); foreach ( $signups as $signup ) { $user = bp_core_activate_signup( $signup->activation_key ); if ( ! empty( $user->errors ) ) { $user_id = username_exists( $signup->user_login ); if ( 2 !== self::check_user_status( $user_id ) ) { $user_id = false; } if ( empty( $user_id ) ) { // Status is not 2, so user's account has been activated. $result['errors'][ $signup->signup_id ] = array( $signup->user_login, esc_html__( 'the sign-up has already been activated.', 'buddyboss' ) ); // Repair signups table. self::validate( $signup->activation_key ); // We have a user id, account is not active, let's delete it. } else { $result['errors'][ $signup->signup_id ] = array( $signup->user_login, $user->get_error_message() ); } } else { $result['activated'][] = $user; } } /** * Fires after activation of user accounts. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of IDs activated activate. * @param array $result Array of data for activated accounts. */ do_action( 'bp_core_signup_after_activate', $signup_ids, $result ); /** * Filters the result of the metadata after user activation. * * @since BuddyPress 2.0.0 * * @param array $result Updated metadata related to user activation. */ return apply_filters( 'bp_core_signup_activate', $result ); } /** * Delete a pending account. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Single ID or list of IDs to delete. * @return array */ public static function delete( $signup_ids = array() ) { global $wpdb; if ( empty( $signup_ids ) || ! is_array( $signup_ids ) ) { return false; } $to_delete = self::get( array( 'include' => $signup_ids, ) ); if ( ! $signups = $to_delete['signups'] ) { return false; } $result = array(); /** * Fires before deletion of pending accounts. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of pending IDs to delete. */ do_action( 'bp_core_signup_before_delete', $signup_ids ); foreach ( $signups as $signup ) { $user_id = username_exists( $signup->user_login ); if ( ! empty( $user_id ) && $signup->activation_key === bp_get_user_meta( $user_id, 'activation_key', true ) ) { if ( 2 != self::check_user_status( $user_id ) ) { // Status is not 2, so user's account has been activated. $result['errors'][ $signup->signup_id ] = array( $signup->user_login, esc_html__( 'the sign-up has already been activated.', 'buddyboss' ) ); // Repair signups table. self::validate( $signup->activation_key ); // We have a user id, account is not active, let's delete it. } else { bp_core_delete_account( $user_id ); } } if ( empty( $result['errors'][ $signup->signup_id ] ) ) { $wpdb->delete( // Signups table. buddypress()->members->table_name_signups, // Where. array( 'signup_id' => $signup->signup_id, ), // WHERE sanitization format. array( '%d', ) ); $result['deleted'][] = $signup->signup_id; } } /** * Fires after deletion of pending accounts. * * @since BuddyPress 2.0.0 * * @param array $signup_ids Array of pending IDs to delete. * @param array $result Array of data for deleted accounts. */ do_action( 'bp_core_signup_after_delete', $signup_ids, $result ); /** * Filters the result of the metadata for deleted pending accounts. * * @since BuddyPress 2.0.0 * * @param array $result Updated metadata related to deleted pending accounts. */ return apply_filters( 'bp_core_signup_delete', $result ); } }
Changelog
Version | Description |
---|---|
BuddyPress 2.0.0 | Introduced. |
Methods
- __construct — Class constructor.
- activate — Activate a pending account.
- add — Add a signup.
- add_backcompat — Create a WP user at signup.
- check_user_status — Check a user status (from wp_users) on a non-multisite config.
- count_signups — How many inactive signups do we have?
- delete — Delete a pending account.
- get — Fetch signups based on parameters.
- populate — Populate the instantiated class with data based on the signup_id provided.
- resend — Resend an activation email.
- update — Update the meta for a signup.
- validate — Activate a signup.
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.