wp_is_large_network() – Function | Developer.WordPress.org

Determines whether or not we have a large network.

Description

The default criteria for a large network is either more than 10,000 users or more than 10,000 sites.
Plugins can alter this criteria using the ‘wp_is_large_network’ filter.

Parameters

$usingstringoptional: 'sites' or 'users'. Default is 'sites'.
Default:'sites'
$network_idint|nulloptional: ID of the network. Default is the current network.
Default:null

Return

bool True if the network meets the criteria for large. False otherwise.

Source

function wp_is_large_network( $using = 'sites', $network_id = null ) {
	$network_id = (int) $network_id;
	if ( ! $network_id ) {
		$network_id = get_current_network_id();
	}

	if ( 'users' === $using ) {
		$count = get_user_count( $network_id );

		$is_large_network = wp_is_large_user_count( $network_id );

		/**
		 * Filters whether the network is considered large.
		 *
		 * @since 3.3.0
		 * @since 4.8.0 The `$network_id` parameter has been added.
		 *
		 * @param bool   $is_large_network Whether the network has more than 10000 users or sites.
		 * @param string $component        The component to count. Accepts 'users', or 'sites'.
		 * @param int    $count            The count of items for the component.
		 * @param int    $network_id       The ID of the network being checked.
		 */
		return apply_filters( 'wp_is_large_network', $is_large_network, 'users', $count, $network_id );
	}

	$count = get_blog_count( $network_id );

	/** This filter is documented in wp-includes/ms-functions.php */
	return apply_filters( 'wp_is_large_network', $count > 10000, 'sites', $count, $network_id );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘wp_is_large_network’, bool $is_large_network, string $component, int $count, int $network_id ): Filters whether the network is considered large.

Uses	Description
wp_is_large_user_count()`wp-includes/user.php`	Determines whether the site has a large number of users.
get_current_network_id()`wp-includes/load.php`	Retrieves the current network ID.
get_user_count()`wp-includes/user.php`	Returns the number of active users in your installation.
get_blog_count()`wp-includes/ms-functions.php`	Gets the number of active sites on the installation.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
WP_MS_Users_List_Table::prepare_items()`wp-admin/includes/class-wp-ms-users-list-table.php`
WP_MS_Sites_List_Table::prepare_items()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Prepares the list of sites for display.
wp_ajax_autocomplete_user()`wp-admin/includes/ajax-actions.php`	Handles user autocomplete via AJAX.
WP_User_Query::prepare_query()`wp-includes/class-wp-user-query.php`	Prepares the query variables.
wp_get_sites()`wp-includes/ms-deprecated.php`	Return an array of sites for a network or networks.
wp_maybe_update_network_site_counts()`wp-includes/ms-functions.php`	Updates the count of sites for the current network.
wp_maybe_update_network_user_counts()`wp-includes/ms-functions.php`	Updates the network-wide users count.

Show 2 more Show less

Changelog

Version	Description
4.8.0	The `$network_id` parameter has been added.
3.3.0	Introduced.

User Contributed Notes

Skip to note 3 content

Rami Yushuvaev 7 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
Whether the network has more than 5,000 users/sites instead of 10,000:
```
function custom_large_network( $is_large_network, $component, $count, $network_id ) {
    return ( $count > 5000);
}
add_filter( 'wp_is_large_network', 'custom_large_network', 10, 4 );
```
Source: https://generatewp.com/snippet/9XaNVan/
Log in to add feedback
Skip to note 4 content

Rami Yushuvaev 7 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
Whether the network has more than 5,000 users/sites instead of 10,000:
```
function custom_large_network( $is_large_network, $component, $count, $network_id ) {
	return 5;
}
add_filter( 'wp_is_large_network', 'custom_large_network', 10, 4 );
```
Source: https://generatewp.com/snippet/9XaNVan/
Log in to add feedback

wp_is_large_network( string $using = ‘sites’, int|null $network_id = null ): bool

In this article