diff --git a/wp-includes/ms-deprecated.php b/wp-includes/ms-deprecated.php index 19224d78d7..f45896ed4f 100644 --- a/wp-includes/ms-deprecated.php +++ b/wp-includes/ms-deprecated.php @@ -438,3 +438,76 @@ function get_admin_users_for_domain( $sitedomain = '', $path = '' ) { return false; } + +/** + * Return an array of sites for a network or networks. + * + * @since 3.7.0 + * @deprecated 4.6.0 + * @see get_sites() + * + * @global wpdb $wpdb WordPress database abstraction object. + * + * @param array $args { + * Array of default arguments. Optional. + * + * @type int|array $network_id A network ID or array of network IDs. Set to null to retrieve sites + * from all networks. Defaults to current network ID. + * @type int $public Retrieve public or non-public sites. Default null, for any. + * @type int $archived Retrieve archived or non-archived sites. Default null, for any. + * @type int $mature Retrieve mature or non-mature sites. Default null, for any. + * @type int $spam Retrieve spam or non-spam sites. Default null, for any. + * @type int $deleted Retrieve deleted or non-deleted sites. Default null, for any. + * @type int $limit Number of sites to limit the query to. Default 100. + * @type int $offset Exclude the first x sites. Used in combination with the $limit parameter. Default 0. + * } + * @return array An empty array if the install is considered "large" via wp_is_large_network(). Otherwise, + * an associative array of site data arrays, each containing the site (network) ID, blog ID, + * site domain and path, dates registered and modified, and the language ID. Also, boolean + * values for whether the site is public, archived, mature, spam, and/or deleted. + */ +function wp_get_sites( $args = array() ) { + global $wpdb; + + _deprecated_function( __FUNCTION__, '4.6', 'get_sites()' ); + + if ( wp_is_large_network() ) + return array(); + + $defaults = array( + 'network_id' => $wpdb->siteid, + '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; + } + + // Make sure count is disabled. + $args['count'] = false; + + $_sites = get_sites( $args ); + + $results = array(); + + foreach ( $_sites as $_site ) { + $results[] = (array) get_site( $_site ); + } + + return $results; +} diff --git a/wp-includes/ms-functions.php b/wp-includes/ms-functions.php index b907cb73d9..814b14397c 100644 --- a/wp-includes/ms-functions.php +++ b/wp-includes/ms-functions.php @@ -2424,76 +2424,6 @@ function wp_is_large_network( $using = 'sites' ) { return apply_filters( 'wp_is_large_network', $count > 10000, 'sites', $count ); } - -/** - * Return an array of sites for a network or networks. - * - * @since 3.7.0 - * - * @global wpdb $wpdb WordPress database abstraction object. - * - * @param array $args { - * Array of default arguments. Optional. - * - * @type int|array $network_id A network ID or array of network IDs. Set to null to retrieve sites - * from all networks. Defaults to current network ID. - * @type int $public Retrieve public or non-public sites. Default null, for any. - * @type int $archived Retrieve archived or non-archived sites. Default null, for any. - * @type int $mature Retrieve mature or non-mature sites. Default null, for any. - * @type int $spam Retrieve spam or non-spam sites. Default null, for any. - * @type int $deleted Retrieve deleted or non-deleted sites. Default null, for any. - * @type int $limit Number of sites to limit the query to. Default 100. - * @type int $offset Exclude the first x sites. Used in combination with the $limit parameter. Default 0. - * } - * @return array An empty array if the install is considered "large" via wp_is_large_network(). Otherwise, - * an associative array of site data arrays, each containing the site (network) ID, blog ID, - * site domain and path, dates registered and modified, and the language ID. Also, boolean - * values for whether the site is public, archived, mature, spam, and/or deleted. - */ -function wp_get_sites( $args = array() ) { - global $wpdb; - - if ( wp_is_large_network() ) - return array(); - - $defaults = array( - 'network_id' => $wpdb->siteid, - '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; - } - - // Make sure count is disabled. - $args['count'] = false; - - $_sites = get_sites( $args ); - - $results = array(); - - foreach ( $_sites as $_site ) { - $results[] = (array) get_site( $_site ); - } - - return $results; -} - /** * Retrieves a list of reserved site on a sub-directory Multisite install. * diff --git a/wp-includes/version.php b/wp-includes/version.php index 8660452384..813890450b 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '4.6-alpha-37652'; +$wp_version = '4.6-alpha-37653'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.