do_action( ‘edit_user_profile’, WP_User $profile_user )

User Contributed Notes

1. Skip to note 3 content

   1994rstefan 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   This action can be used to add a form to the backend user editing screen and save some additional user meta data.

   For example to add a field for the users birthday:

   function userMetaBirthdayForm(WP_User $user) {
   ?>
   <h2>Birthday</h2>
   	<table class="form-table">
   		<tr>
   			<th><label for="user_birthday">Birthday</label></th>
   			<td>
   				<input
   					type="date"
   					value="<?php echo esc_attr(get_user_meta($user->ID, 'birthday', true)); ?>"
   					name="user_birthday"
   					id="user_birthday"
   				>
   				<span class="description">Some description to the input</span>
   			</td>
   		</tr>
   	</table>
   <?php
   }
   add_action('show_user_profile', 'userMetaBirthdayForm'); // editing your own profile
   add_action('edit_user_profile', 'userMetaBirthdayForm'); // editing another user
   add_action('user_new_form', 'userMetaBirthdayForm'); // creating a new user
   
   function userMetaBirthdaySave($userId) {
   	if (!current_user_can('edit_user', $userId)) {
   		return;
   	}
   
   	update_user_meta($userId, 'birthday', $_REQUEST['user_birthday']);
   }
   add_action('personal_options_update', 'userMetaBirthdaySave');
   add_action('edit_user_profile_update', 'userMetaBirthdaySave');
   add_action('user_register', 'userMetaBirthdaySave');

   • This example is wrong. You can’t pass this callback to user_new_form because that hook doesn’t pass an User object, just a string type. The very least this callback would have to conditionally use user object, not expect it to be there in all cases. Above code will throw a uncaught type error when adding a new user. Also see https://developer.wordpress.org/reference/hooks/user_new_form/

     Beda 2 years ago
   • It’s incorrect also because you should not pass the $userId of the profile you are visiting to current_user_can, because you want to check the current user editing the profile. In $userId, you have the ID of the user whose profile is being viewed.

     Jorgu5 2 months ago
2. Skip to note 4 content

   Steven Lin 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Example migrated from Codex:

   /**
    * Show custom user profile fields
    * 
    * @param  object $profileuser A WP_User object
    * @return void
    */
   function custom_user_profile_fields( $profileuser ) {
   ?>
   	<table class="form-table">
   		<tr>
   			<th>
   				<label for="user_location"><?php esc_html_e( 'Location' ); ?></label>
   			</th>
   			<td>
   				<input type="text" name="user_location" id="user_location" value="<?php echo esc_attr( get_the_author_meta( 'user_location', $profileuser->ID ) ); ?>" class="regular-text" />
   				<br><span class="description"><?php esc_html_e( 'Your location.', 'text-domain' ); ?></span>
   			</td>
   		</tr>
   	</table>
   <?php
   }
   add_action( 'show_user_profile', 'custom_user_profile_fields', 10, 1 );
   add_action( 'edit_user_profile', 'custom_user_profile_fields', 10, 1 );