populate_network_meta( int $network_id, array $meta = array() )

Parameters

$network_idint

Network ID to populate meta for.

$metaarrayoptional

Custom meta $key => $value pairs to use. Default empty array.Default: array()

Hooks fired · 1

One hook fires while populate_network_meta() runs, in this order:

1. 1
   apply_filters( populate_network_meta )filterline 1360 (+129 into the body)

   Filters meta for a network on creation.

Uses · 16

• get_user_by()Retrieves user info by a given field.
• wp_get_current_user()Retrieves the current user object.
• get_option()Retrieves an option value based on an option name.
• wp_get_theme()Gets a WP_Theme object for a theme.
• clean_network_cache()Removes a network from the object cache.
• wp_cache_delete()Removes the cache contents matching key and group.
• is_multisite()Determines whether Multisite is enabled.
• get_users()Retrieves list of users matching criteria.
• get_site_option()Retrieve an option value for the current network based on name of option.
• __()Retrieves the translation of $text.
• get_allowed_mime_types()Retrieves the list of allowed mime types and file extensions.
• get_locale()Retrieves the current locale.

Used by · 1

• populate_network()Populate network settings.

Source

View on Trac ↗View on GitHub ↗

1231function populate_network_meta( $network_id, array $meta = array() ) {1232	global $wpdb, $wp_db_version;1233 1234	$network_id = (int) $network_id;1235 1236	$email             = ! empty( $meta['admin_email'] ) ? $meta['admin_email'] : '';1237	$subdomain_install = isset( $meta['subdomain_install'] ) ? (int) $meta['subdomain_install'] : 0;1238 1239	// If a user with the provided email does not exist, default to the current user as the new network admin.1240	$site_user = ! empty( $email ) ? get_user_by( 'email', $email ) : false;1241	if ( false === $site_user ) {1242		$site_user = wp_get_current_user();1243	}1244 1245	if ( empty( $email ) ) {1246		$email = $site_user->user_email;1247	}1248 1249	$template       = get_option( 'template' );1250	$stylesheet     = get_option( 'stylesheet' );1251	$allowed_themes = array( $stylesheet => true );1252 1253	if ( $template !== $stylesheet ) {1254		$allowed_themes[ $template ] = true;1255	}1256 1257	if ( WP_DEFAULT_THEME !== $stylesheet && WP_DEFAULT_THEME !== $template ) {1258		$allowed_themes[ WP_DEFAULT_THEME ] = true;1259	}1260 1261	// If WP_DEFAULT_THEME doesn't exist, also include the latest core default theme.1262	if ( ! wp_get_theme( WP_DEFAULT_THEME )->exists() ) {1263		$core_default = WP_Theme::get_core_default_theme();1264		if ( $core_default ) {1265			$allowed_themes[ $core_default->get_stylesheet() ] = true;1266		}1267	}1268 1269	if ( function_exists( 'clean_network_cache' ) ) {1270		clean_network_cache( $network_id );1271	} else {1272		wp_cache_delete( $network_id, 'networks' );1273	}1274 1275	if ( ! is_multisite() ) {1276		$site_admins = array( $site_user->user_login );1277		$users       = get_users(1278			array(1279				'fields' => array( 'user_login' ),1280				'role'   => 'administrator',1281			)1282		);1283		if ( $users ) {1284			foreach ( $users as $user ) {1285				$site_admins[] = $user->user_login;1286			}1287 1288			$site_admins = array_unique( $site_admins );1289		}1290	} else {1291		$site_admins = get_site_option( 'site_admins' );1292	}1293 1294	/* translators: Do not translate USERNAME, SITE_NAME, BLOG_URL, PASSWORD: those are placeholders. */1295	$welcome_email = __(1296		'Howdy USERNAME,1297 1298Your new SITE_NAME site has been successfully set up at:1299BLOG_URL1300 1301You can log in to the administrator account with the following information:1302 1303Username: USERNAME1304Password: PASSWORD1305Log in here: BLOG_URLwp-login.php1306 1307We hope you enjoy your new site. Thanks!1308 1309--The Team @ SITE_NAME'1310	);

History

Introduced in 5.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-admin/includes/schema.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.