Ticket #25645: 25645.diff

src/wp-includes/ms-functions.php

@@ -2068 +2068 @@
 /**
  * Return an array of sites for a network.
  *
+ * For each site, an array is returned containing the blog ID, site ID, domain, path, date registered and modified,
+ * and the language ID. Also boolean values for whether the site is public, archived, mature, spam, or deleted.
+ *
  * @see wp_is_large_network() Returns an empty array if the install is considered large.
  *
  * @since 3.7.0
  *
  * @param array $args {
- *     Array of arguments. Optional.
+ *     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.
+ *     @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 array of site data
+ * @return array An array of site data including the blog_id, site_id, domain, path, and more.
  */
 function wp_get_sites( $args = array() ) {
         global $wpdb;