Changeset 37893 for trunk/src/wp-includes/ms-blogs.php

Timestamp:

06/28/2016 09:17:30 PM (10 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.
  *