wpmu_create_user

Definition:
function wpmu_create_user( $user_name, $password, $email) {}

Create a user.
This function runs when a user self-registers as well as when a Super Admin creates a new user. Hook to ‘wpmu_new_user’ for events that should affect all new users, but only on Multisite (otherwise use ‘user_register’).

Parameters

  • string $user_name: The new user’s login name.
  • string $password: The new user’s password.
  • string $email: The new user’s email address.

Return values

returns:Returns false on failure, or int $user_id on success

Defined actions

  • wpmu_new_user
    do_action( 'wpmu_new_user', $user_id );

Source code

function wpmu_create_user( $user_name, $password, $email) {

	$user_name = preg_replace( '/\s+/', '', sanitize_user( $user_name, true ) );



	$user_id = wp_create_user( $user_name, $password, $email );

	if ( is_wp_error($user_id) )

		return false;



	// Newly created users have no roles or caps until they are added to a blog.

	delete_user_option( $user_id, 'capabilities' );

	delete_user_option( $user_id, 'user_level' );



	do_action( 'wpmu_new_user', $user_id );



	return $user_id;

}

3379

wpmu_create_blog

Definition:
function wpmu_create_blog($domain, $path, $title, $user_id, $meta = '', $site_id = 1) {}

Create a site.
This function runs when a user self-registers a new site as well as when a Super Admin creates a new site. Hook to ‘wpmu_new_blog’ for events that should affect all new sites.

Parameters

  • string $domain: The new site’s domain.
  • string $path: The new site’s path.
  • string $title: The new site’s title.
  • int $user_id: The user ID of the new site’s admin.
  • array $meta: Optional. Used to set initial site options.
  • int $site_id: Optional. Only relevant on multi-network installs.

Return values

returns:Returns WP_Error object on failure, int $blog_id on success

Defined actions

  • wpmu_new_blog
    do_action( 'wpmu_new_blog', $blog_id, $user_id, $domain, $path, $site_id, $meta );

Source code

function wpmu_create_blog($domain, $path, $title, $user_id, $meta = '', $site_id = 1) {

	$domain = preg_replace( '/\s+/', '', sanitize_user( $domain, true ) );



	if ( is_subdomain_install() )

		$domain = str_replace( '@', '', $domain );



	$title = strip_tags( $title );

	$user_id = (int) $user_id;



	if ( empty($path) )

		$path = '/';



	// Check if the domain has been used already. We should return an error message.

	if ( domain_exists($domain, $path, $site_id) )

		return new WP_Error('blog_taken', __('Site already exists.'));



	if ( !defined('WP_INSTALLING') )

		define( 'WP_INSTALLING', true );



	if ( ! $blog_id = insert_blog($domain, $path, $site_id) )

		return new WP_Error('insert_blog', __('Could not create site.'));



	switch_to_blog($blog_id);

	install_blog($blog_id, $title);

	wp_install_defaults($user_id);



	add_user_to_blog($blog_id, $user_id, 'administrator');



	if ( is_array($meta) ) foreach ($meta as $key => $value) {

		if ( $key == 'public' || $key == 'archived' || $key == 'mature' || $key == 'spam' || $key == 'deleted' || $key == 'lang_id' )

			update_blog_status( $blog_id, $key, $value );

		else

			update_option( $key, $value );

	}



	add_option( 'WPLANG', get_site_option( 'WPLANG' ) );

	update_option( 'blog_public', (int)$meta['public'] );



	if ( ! is_super_admin( $user_id ) && ! get_user_meta( $user_id, 'primary_blog', true ) )

		update_user_meta( $user_id, 'primary_blog', $blog_id );



	restore_current_blog();

	do_action( 'wpmu_new_blog', $blog_id, $user_id, $domain, $path, $site_id, $meta );



	return $blog_id;

}

3377

wpmu_checkAvailableSpace

Definition:
function wpmu_checkAvailableSpace() {}

Determines if the available space defined by the admin has been exceeded by the user.

Source code

function wpmu_checkAvailableSpace() {

	_deprecated_function(__FUNCTION__, '3.0', 'is_upload_space_available()' );



	if ( !is_upload_space_available() )

		wp_die( __('Sorry, you must delete files before you can upload any more.') );

}

3375

wpmu_admin_redirect_add_updated_param

Definition:
function wpmu_admin_redirect_add_updated_param( $url = '' ) {}

Adds an ‘updated=true’ argument to a URL.

Parameters

  • string $url

Source code

function wpmu_admin_redirect_add_updated_param( $url = '' ) {

	if ( strpos( $url, 'updated=true' ) === false ) {

		if ( strpos( $url, '?' ) === false )

			return $url . '?updated=true';

		else

			return $url . '&updated=true';

	}

	return $url;

}

3373

wpmu_admin_do_redirect

Definition:
function wpmu_admin_do_redirect( $url = '' ) {}

Redirect a user based on $_GET or $_POST arguments.
The function looks for redirect arguments in the following order: 1) $_GET[‘ref’] 2) $_POST[‘ref’] 3) $_SERVER[‘HTTP_REFERER’] 4) $_GET[‘redirect’] 5) $_POST[‘redirect’] 6) $url

Parameters

  • string $url

Source code

function wpmu_admin_do_redirect( $url = '' ) {

	$ref = '';

	if ( isset( $_GET['ref'] ) )

		$ref = $_GET['ref'];

	if ( isset( $_POST['ref'] ) )

		$ref = $_POST['ref'];



	if ( $ref ) {

		$ref = wpmu_admin_redirect_add_updated_param( $ref );

		wp_redirect( $ref );

		exit();

	}

	if ( empty( $_SERVER['HTTP_REFERER'] ) == false ) {

		wp_redirect( $_SERVER['HTTP_REFERER'] );

		exit();

	}



	$url = wpmu_admin_redirect_add_updated_param( $url );

	if ( isset( $_GET['redirect'] ) ) {

		if ( substr( $_GET['redirect'], 0, 2 ) == 's_' )

			$url .= '&action=blogs&s='. esc_html( substr( $_GET['redirect'], 2 ) );

	} elseif ( isset( $_POST['redirect'] ) ) {

		$url = wpmu_admin_redirect_add_updated_param( $_POST['redirect'] );

	}

	wp_redirect( $url );

	exit();

}

3371