This function has been deprecated. Use get_sites() instead.
wp_get_sites( array $args = array() )
Return an array of sites for a network or networks.
Description
See also
Parameters
- $args
-
(Optional) Array of default arguments. Optional.<br>
- 'network_id'
(int|int[]) A network ID or array of network IDs. Set to null to retrieve sites from all networks. Defaults to current network ID.<br> - 'public'
(int) Retrieve public or non-public sites. Default null, for any.<br> - 'archived'
(int) Retrieve archived or non-archived sites. Default null, for any.<br> - 'mature'
(int) Retrieve mature or non-mature sites. Default null, for any.<br> - 'spam'
(int) Retrieve spam or non-spam sites. Default null, for any.<br> - 'deleted'
(int) Retrieve deleted or non-deleted sites. Default null, for any.<br> - 'limit'
(int) Number of sites to limit the query to. Default 100.<br> - 'offset'
(int) Exclude the first x sites. Used in combination with the $limit parameter. Default 0.<br>
Default value: array()
- 'network_id'
Return
(array[]) An empty array if the installation is considered "large" via wp_is_large_network(). Otherwise, an associative array of WP_Site data as arrays.
Source
File: wp-includes/ms-deprecated.php
function wp_get_sites( $args = array() ) {
_deprecated_function( __FUNCTION__, 'WP-4.6.0', 'get_sites()' );
if ( wp_is_large_network() )
return array();
$defaults = array(
'network_id' => get_current_network_id(),
'public' => null,
'archived' => null,
'mature' => null,
'spam' => null,
'deleted' => null,
'limit' => 100,
'offset' => 0,
);
$args = wp_parse_args( $args, $defaults );
// Backwards compatibility
if( is_array( $args['network_id'] ) ){
$args['network__in'] = $args['network_id'];
$args['network_id'] = null;
}
if( is_numeric( $args['limit'] ) ){
$args['number'] = $args['limit'];
$args['limit'] = null;
} elseif ( ! $args['limit'] ) {
$args['number'] = 0;
$args['limit'] = null;
}
// Make sure count is disabled.
$args['count'] = false;
$_sites = get_sites( $args );
$results = array();
foreach ( $_sites as $_site ) {
$_site = get_site( $_site );
$results[] = $_site->to_array();
}
return $results;
}
Changelog
Version | Description |
---|---|
4.6.0 | Use get_sites() |
3.7.0 | Introduced. This function has been deprecated. Use get_sites() instead. |