Changeset 37893

Timestamp:

06/28/2016 09:17:30 PM (8 years ago)

Author:

jeremyfelt

Message:

Multisite: Introduce get_network().

Given a network ID or network object, get_network() retrieves network data in the same vein as get_site() or get_post(). This will allow for clean retrieval of networks from a primed cache when WP_Network_Query is implemented.

Props flixos90.
See #32504.

File:

• trunk/src/wp-includes/ms-blogs.php (modified) (1 diff)

trunk/src/wp-includes/ms-blogs.php

@@ -1073 +1073 @@
 
 /**
+ * Retrieves network data given a network ID or network object.
+ *
+ * Network data will be cached and returned after being passed through a filter.
+ * If the provided network is empty, the current network global will be used.
+ *
+ * @since 4.6.0
+ *
+ * @global WP_Network $current_site
+ *
+ * @param WP_Network|int|null $network Network to retrieve.
+ * @return WP_Network|null The network object or null if not found.
+ */
+function get_network( &$network = null ) {
+    global $current_site;
+    if ( empty( $network ) && isset( $current_site ) ) {
+        $network = $current_site;
+    }
+
+    if ( $network instanceof WP_Network ) {
+        $_network = $network;
+    } elseif ( is_object( $network ) ) {
+        $_network = new WP_Network( $network );
+    } else {
+        $_network = WP_Network::get_instance( $network );
+    }
+
+    if ( ! $_network ) {
+        return null;
+    }
+
+    /**
+     * Fires after a network is retrieved.
+     *
+     * @since 4.6.0
+     *
+     * @param WP_Network $_network Network data.
+     */
+    $_network = apply_filters( 'get_network', $_network );
+
+    return $_network;
+}
+
+/**
  * Handler for updating the blog date when a post is published or an already published post is changed.
  *