wppaste
WordPress

apply_filters( 'insert_custom_user_meta', array $custom_meta, WP_User $user, bool $update, array $userdata )

Since
5.9.0
Filters a user's custom meta values and keys immediately after the user is created or updated and before any user meta is inserted or updated.

Description

For non-custom meta fields, see the 'insert_user_meta' filter.

Parameters

$custom_metaarray
Array of custom user meta values keyed by meta key.
$userWP_User
User object.
$updatebool
Whether the user is being updated rather than created.
$userdataarray
The raw array of data passed to wp_insert_user().

Fired at · 1

  • wp-includes/user.php:2637wp_insert_user()

Source

	 *	 * @param array   $custom_meta Array of custom user meta values keyed by meta key.	 * @param WP_User $user        User object.	 * @param bool    $update      Whether the user is being updated rather than created.	 * @param array   $userdata    The raw array of data passed to wp_insert_user().	 */	$custom_meta = apply_filters( 'insert_custom_user_meta', $custom_meta, $user, $update, $userdata ); 	$meta = array_merge( $meta, $custom_meta ); 	if ( $update ) {		// Update user meta.		foreach ( $meta as $key => $value ) {

History

Introduced in 5.9.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.