user_register
Срабатывает сразу после того, как новый пользователь был зарегистрирован на сайте. После того, как данные пользователя были добавлены в базу данных.
Хук получает в качестве параметра ID пользователя.
На момент срабатывания этого хука, все метаданные уже добавлены в БД. Пароль уже зашифрован.
Этот хук можно использовать для добавления дополнительных метаданных переданных в форме регистрации нового пользователя.
Для добавления или обновления метаданных пользователя, также можно использовать хук insert_user_meta. См. пример ниже или код функции wp_insert_user()
Использование
add_action( 'user_register', 'wp_kama_user_register_action', 10, 2 );
/**
* Function for `user_register` action-hook.
*
* @param int $user_id User ID.
* @param array $userdata The raw array of data passed to wp_insert_user().
*
* @return void
*/
function wp_kama_user_register_action( $user_id, $userdata ){
// action...
}
- $user_id(число)
- ID зарегистрированного пользователя.
- $userdata(WP 5.8)
- Необработанный массив данных, переданный в функцию wp_insert_user().
Примеры
#1 Добавим дополнительные данные пользователя при регистрации
Этот пример показывает как добавить значение поля user_sex, которое передается в $_POST данных из формы регистрации.
Имейте ввиду, что проверка обновляемых данных не должна производиться в момент этого хука - уже слишком поздно, пользователь уже добавлен! Проверку данных нужно делать во время хука registration_errors, хук user_register не сработает если проверка не будет пройдена...
// предварительная проверка поля
add_filter( 'registration_errors', 'my_validate_user_data' );
function my_validate_user_data( $errors ){
if( empty($_POST['user_sex']) )
$errors->add('empty_user_sex', 'Пол обязательно должен быть указан!' );
elseif( ! in_array($_POST['user_sex'], array('male','female')) )
$errors->add('invalid_user_sex', 'Пол указан неверно!' );
return $errors;
}
// обновление метаданных пользователя
add_action( 'user_register', 'my_user_registration' );
function my_user_registration( $user_id ) {
// $_POST['user_sex'] проверена заранее...
update_user_meta( $user_id, 'user_sex', $_POST['user_sex']);
} #2 Обновление метаданных пользователя при регистрации
Это аналогичный первому пример с использованием хука insert_user_meta для добавления метаданных пользователя при регистрации. Этот вариант предпочтительнее, потому что удобнее...
Этот пример полностью заменяет хук user_register из предыдущего примера. Проверку на ошибки берем из пред. примера.
// $meta = apply_filters( 'insert_user_meta', $meta, $user, $update );
add_filter( 'insert_user_meta', 'my_user_registration_meta', 10, 3 );
function my_user_registration_meta( $meta, $user, $update ) {
// выходим если это не регистрация юзера
if( $update ) return $meta;
$meta['user_sex'] = $_POST['user_sex']; // $_POST['user_sex'] проверена заранее...
return $meta;
}
Список изменений
| С версии 1.5.0 | Введена. |
| С версии 5.8.0 | The $userdata parameter was added. |
Где вызывается хук
do_action( 'user_register', $user_id, $userdata );
Где используется хук в WordPress
add_action( 'user_register', array( 'WP_Internal_Pointers', 'dismiss_pointers_for_new_users' ) );
add_action( $action, 'wp_maybe_update_user_counts', 10, 0 );