Changeset 60954

Timestamp:

10/17/2025 03:03:09 PM (12 months ago)

Author:

johnjamesjacoby

Message:

Networks and Sites: introduce 3 new actions inside the populate_network() function.

• before_populate_network
• after_populate_network
• after_upgrade_to_multisite

These hooks are strategically located to allow the execution of custom code before & after a new multisite network is created, as well as after the first time a single-site installation is upgraded to multisite.

This change also includes a set of unit tests via a new Tests_Multisite_PopulateNetworkHooks class, to confirm that these hooks are executing when and as intended.

Props jeremyfelt, johnjamesjacoby, Mista-Flo, spacedmonkey, sukhendu2002, rmccue, rollybueno.

Fixes #27289.

Location:

trunk

Files:

• src/wp-admin/includes/schema.php (modified) (3 diffs)
• tests/phpunit/tests/multisite/populateNetworkHooks.php (added)

trunk/src/wp-admin/includes/schema.php

@@ -1005 +1005 @@
         $network_id = (int) $network_id;
 
+        /**
+         * Fires before a network is populated.
+         *
+         * @since 6.9.0
+         *
+         * @param int    $network_id        ID of network to populate.
+         * @param string $domain            The domain name for the network.
+         * @param string $email             Email address for the network administrator.
+         * @param string $site_name         The name of the network.
+         * @param string $path              The path to append to the network's domain name.
+         * @param bool   $subdomain_install Whether the network is a subdomain installation or a subdirectory installation.
+         */
+        do_action( 'before_populate_network', $network_id, $domain, $email, $site_name, $path, $subdomain_install );
+
         $errors = new WP_Error();
         if ( '' === $domain ) {
@@ -1124 +1138 @@
                 flush_rewrite_rules();
 
+                /**
+                 * Fires after a network is created when converting a single site to multisite.
+                 *
+                 * @since 6.9.0
+                 *
+                 * @param int    $network_id        ID of network created.
+                 * @param string $domain            The domain name for the network.
+                 * @param string $email             Email address for the network administrator.
+                 * @param string $site_name         The name of the network.
+                 * @param string $path              The path to append to the network's domain name.
+                 * @param bool   $subdomain_install Whether the network is a subdomain installation or a subdirectory installation.
+                 */
+                do_action( 'after_upgrade_to_multisite', $network_id, $domain, $email, $site_name, $path, $subdomain_install );
+
                 if ( ! $subdomain_install ) {
                         return true;
@@ -1169 +1197 @@
                 }
         }
+
+        /**
+         * Fires after a network is fully populated.
+         *
+         * @since 6.9.0
+         *
+         * @param int    $network_id        ID of network created.
+         * @param string $domain            The domain name for the network.
+         * @param string $email             Email address for the network administrator.
+         * @param string $site_name         The name of the network.
+         * @param string $path              The path to append to the network's domain name.
+         * @param bool   $subdomain_install Whether the network is a subdomain installation or a subdirectory installation.
+         */
+        do_action( 'after_populate_network', $network_id, $domain, $email, $site_name, $path, $subdomain_install );
 
         return true;