You appear to be a bot. Output may be restricted

Description

Creates a single user.

Usage

$WP_REST_Response|WP_Error = WP_REST_Users_Controller::create_item( $request );

Parameters

$request

( WP_REST_Request ) required – Full details about the request.

Returns

WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.

Source

File name: wordpress/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php
Lines:

  public function create_item( $request ) {
    if ( ! empty( $request['id'] ) ) {
      return new WP_Error(
        'rest_user_exists',
        __( 'Cannot create existing user.' ),
        array( 'status' => 400 )
      );
    }

    $schema = $this->WP_REST_Users_Controller::get_item_schema();

    if ( ! empty( $request['roles'] ) && ! empty( $schema['properties']['roles'] ) ) {
      $check_permission = $this->WP_REST_Users_Controller::check_role_update( $request['id'], $request['roles'] );

      if ( is_wp_error( $check_permission ) ) {
        return $check_permission;
      }
    }

    $user = $this->WP_REST_Users_Controller::prepare_item_for_database( $request );

    if ( is_multisite() ) {
      $ret = wpmu_validate_user_signup( $user->user_login, $user->user_email );

      if ( is_wp_error( $ret['errors'] ) && $ret['errors']->has_errors() ) {
        $error = new WP_Error(
          'rest_invalid_param',
          __( 'Invalid user parameter(s).' ),
          array( 'status' => 400 )
        );

        foreach ( $ret['errors']->errors as $code => $messages ) {
          foreach ( $messages as $message ) {
            $error->add( $code, $message );
          }

          $error_data = $error->get_error_data( $code );

          if ( $error_data ) {
            $error->add_data( $error_data, $code );
          }
        }
        return $error;
      }
    }

    if ( is_multisite() ) {
      $user_id = wpmu_create_user( $user->user_login, $user->user_pass, $user->user_email );

      if ( ! $user_id ) {
        return new WP_Error(
          'rest_user_create',
          __( 'Error creating new user.' ),
          array( 'status' => 500 )
        );
      }

      $user->ID = $user_id;
      $user_id  = wp_update_user( wp_slash( (array) $user ) );

      if ( is_wp_error( $user_id ) ) {
        return $user_id;
      }

      $result = add_user_to_blog( get_site()->id, $user_id, '' );
      if ( is_wp_error( $result ) ) {
        return $result;
      }
    } else {
      $user_id = wp_insert_user( wp_slash( (array) $user ) );

      if ( is_wp_error( $user_id ) ) {
        return $user_id;
      }
    }

    $user = get_user_by( 'id', $user_id );

    
/**
 * Fires immediately after a user is created or updated via the REST API.
 *
 * @since 4.7.0
 *
 * @param WP_User         $user     Inserted or updated user object.
 * @param WP_REST_Request $request  Request object.
 * @param bool            $creating True when creating a user, false when updating.
 */
    do_action( 'rest_insert_user', $user, $request, true );

    if ( ! empty( $request['roles'] ) && ! empty( $schema['properties']['roles'] ) ) {
      array_map( array( $user, 'add_role' ), $request['roles'] );
    }

    if ( ! empty( $schema['properties']['meta'] ) && isset( $request['meta'] ) ) {
      $meta_update = $this->meta->update_value( $request['meta'], $user_id );

      if ( is_wp_error( $meta_update ) ) {
        return $meta_update;
      }
    }
 

 View on GitHub View on Trac