# add_existing_user_to_blog()

URL: https://chugunov.pro/api-wordpress/functions/add_existing_user_to_blog/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: MU (3.0.0).

## Сигнатура

```php
add_existing_user_to_blog( array|false $details = false ): true|WP_Error|void
```

## Описание

Добавляет пользователя в блог на основе данных из maybe_add_existing_user_to_blog() .

## Параметры

- `$details` `array|false` — необязательный, по умолчанию `false`. Данные пользователя. Должны содержать как минимум значения для перечисленных ниже ключей.
  
  user_id intID пользователя, добавляемого в текущий блог.
  
  role stringРоль, назначаемая пользователю.

## Возвращаемое значение

`true|WP_Error|void` — WP_Error

## Исходный код

Файл: `wp-includes/ms-functions.php:2275`

```php
function add_existing_user_to_blog( $details = false ) {
	if ( is_array( $details ) ) {
		$blog_id = get_current_blog_id();
		$result  = add_user_to_blog( $blog_id, $details['user_id'], $details['role'] );

		/**
		 * Fires immediately after an existing user is added to a site.
		 *
		 * @since MU (3.0.0)
		 *
		 * @param int           $user_id User ID.
		 * @param true|WP_Error $result  True on success or a WP_Error object if the user doesn't exist
		 *                               or could not be added.
		 */
		do_action( 'added_existing_user', $details['user_id'], $result );

		return $result;
	}
}
```

## История изменений

- MU (3.0.0) — Introduced.

## Связанные

Использует: [`add_user_to_blog`](https://chugunov.pro/api-wordpress/functions/add_user_to_blog/), [`get_current_blog_id`](https://chugunov.pro/api-wordpress/functions/get_current_blog_id/), [`do_action`](https://chugunov.pro/api-wordpress/functions/do_action/).
Используется в: [`maybe_add_existing_user_to_blog`](https://chugunov.pro/api-wordpress/functions/maybe_add_existing_user_to_blog/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/add_existing_user_to_blog/