Normalizes data for a site prior to inserting or updating in the database.

$data array Required

Associative array of site data passed to the respective function.
See wp_insert_site() for the possibly included data.

More Arguments from wp_insert_site( ... $data )

Data for the new site that should be inserted.

• domainstring
  Site domain. Default empty string.
• pathstring
  Site path. Default '/'.
• network_idint
  The site's network ID. Default is the current network ID.
• registeredstring
  When the site was registered, in SQL datetime format. Default is the current time.
• last_updatedstring
  When the site was last updated, in SQL datetime format. Default is the value of $registered.
• publicint
  Whether the site is public. Default 1.
• archivedint
  Whether the site is archived. Default 0.
• matureint
  Whether the site is mature. Default 0.
• spamint
  Whether the site is spam. Default 0.
• deletedint
  Whether the site is deleted. Default 0.
• lang_idint
  The site's language ID. Currently unused. Default 0.
• user_idint
  User ID for the site administrator. Passed to the wp_initialize_site hook.
• titlestring
  Site title. Default is 'Site %d' where %d is the site ID. Passed to the wp_initialize_site hook.
• optionsarray
  Custom option $key => $value pairs to use. Default empty array. Passed to the wp_initialize_site hook.
• metaarray
  Custom site metadata $key => $value pairs to use. Default empty array.
  Passed to the wp_initialize_site hook.

array Normalized site data.

File: wp-includes/ms-site.php. View all references

function wp_normalize_site_data( $data ) {
	// Sanitize domain if passed.
	if ( array_key_exists( 'domain', $data ) ) {
		$data['domain'] = trim( $data['domain'] );
		$data['domain'] = preg_replace( '/\s+/', '', sanitize_user( $data['domain'], true ) );
		if ( is_subdomain_install() ) {
			$data['domain'] = str_replace( '@', '', $data['domain'] );
		}
	}

	// Sanitize path if passed.
	if ( array_key_exists( 'path', $data ) ) {
		$data['path'] = trailingslashit( '/' . trim( $data['path'], '/' ) );
	}

	// Sanitize network ID if passed.
	if ( array_key_exists( 'network_id', $data ) ) {
		$data['network_id'] = (int) $data['network_id'];
	}

	// Sanitize status fields if passed.
	$status_fields = array( 'public', 'archived', 'mature', 'spam', 'deleted' );
	foreach ( $status_fields as $status_field ) {
		if ( array_key_exists( $status_field, $data ) ) {
			$data[ $status_field ] = (int) $data[ $status_field ];
		}
	}

	// Strip date fields if empty.
	$date_fields = array( 'registered', 'last_updated' );
	foreach ( $date_fields as $date_field ) {
		if ( ! array_key_exists( $date_field, $data ) ) {
			continue;
		}

		if ( empty( $data[ $date_field ] ) || '0000-00-00 00:00:00' === $data[ $date_field ] ) {
			unset( $data[ $date_field ] );
		}
	}

	return $data;
}