network_upgrade_needed_transient = 'acf_network_upgrade_needed_' . ACF_UPGRADE_VERSION; add_action( 'admin_menu', array( $this, 'admin_menu' ), 20 ); if ( is_multisite() ) { add_action( 'network_admin_menu', array( $this, 'network_admin_menu' ), 20 ); } } /** * admin_menu * * Setus up logic if DB Upgrade is needed on a single site. * * @date 24/8/18 * @since 5.7.4 * * @param void * @return void */ function admin_menu() { // check if upgrade is avaialble if ( acf_has_upgrade() ) { // add notice add_action( 'admin_notices', array( $this, 'admin_notices' ) ); // add page $page = add_submenu_page( 'index.php', __( 'Upgrade Database', 'acf' ), __( 'Upgrade Database', 'acf' ), acf_get_setting( 'capability' ), 'acf-upgrade', array( $this, 'admin_html' ) ); // actions add_action( 'load-' . $page, array( $this, 'admin_load' ) ); } } /** * Displays a “Database Upgrade Required” network admin notice and adds * the “Upgrade Database” submenu under the “Dashboard” network admin * menu item if an ACF upgrade needs to run on any network site. * * @date 24/8/18 * @since 5.7.4 * @since 6.0.0 Reduce memory usage, cache network upgrade checks. * * @return void */ function network_admin_menu() { $network_upgrade_needed = get_site_transient( $this->network_upgrade_needed_transient ); // No transient value exists, so run the upgrade check. if ( $network_upgrade_needed === false ) { $network_upgrade_needed = $this->check_for_network_upgrades(); } if ( $network_upgrade_needed === 'no' ) { return; } add_action( 'network_admin_notices', array( $this, 'network_admin_notices' ) ); $page = add_submenu_page( 'index.php', __( 'Upgrade Database', 'acf' ), __( 'Upgrade Database', 'acf' ), acf_get_setting( 'capability' ), 'acf-upgrade-network', array( $this, 'network_admin_html' ) ); add_action( "load-$page", array( $this, 'network_admin_load' ) ); } /** * Checks if an ACF database upgrade is required on any site in the * multisite network. * * Stores the result in `$this->network_upgrade_needed_transient`, * which is version-linked to ACF_UPGRADE_VERSION: the highest ACF * version that requires an upgrade function to run. Bumping * ACF_UPGRADE_VERSION will trigger new upgrade checks but incrementing * ACF_VERSION alone will not. * * @since 6.0.0 * @return string 'yes' if any site in the network requires an upgrade, * otherwise 'no'. String instead of boolean so that * `false` returned from a get_site_transient check can * denote that an upgrade check is needed. */ public function check_for_network_upgrades() { $network_upgrade_needed = 'no'; $sites = get_sites( array( 'number' => 0, 'fields' => 'ids', // Reduces PHP memory usage. ) ); if ( $sites ) { // Reduces memory usage (same pattern used in wp-includes/ms-site.php). remove_action( 'switch_blog', 'wp_switch_roles_and_user', 1 ); foreach ( $sites as $site_id ) { switch_to_blog( $site_id ); $site_needs_upgrade = acf_has_upgrade(); restore_current_blog(); // Restores global vars. if ( $site_needs_upgrade ) { $network_upgrade_needed = 'yes'; break; } } add_action( 'switch_blog', 'wp_switch_roles_and_user', 1, 2 ); } set_site_transient( $this->network_upgrade_needed_transient, $network_upgrade_needed, 3 * MONTH_IN_SECONDS ); return $network_upgrade_needed; } /** * admin_load * * Runs during the loading of the admin page. * * @date 24/8/18 * @since 5.7.4 * * @param type $var Description. Default. * @return type Description. */ function admin_load() { // remove prompt remove_action( 'admin_notices', array( $this, 'admin_notices' ) ); // Enqueue core script. acf_enqueue_script( 'acf' ); } /** * network_admin_load * * Runs during the loading of the network admin page. * * @date 24/8/18 * @since 5.7.4 * * @param type $var Description. Default. * @return type Description. */ function network_admin_load() { // remove prompt remove_action( 'network_admin_notices', array( $this, 'network_admin_notices' ) ); // Enqueue core script. acf_enqueue_script( 'acf' ); } /** * admin_notices * * Displays the DB Upgrade prompt. * * @date 23/8/18 * @since 5.7.3 * * @param void * @return void */ function admin_notices() { // vars $view = array( 'button_text' => __( 'Upgrade Database', 'acf' ), 'button_url' => admin_url( 'index.php?page=acf-upgrade' ), 'confirm' => true, ); // view acf_get_view( 'html-notice-upgrade', $view ); } /** * network_admin_notices * * Displays the DB Upgrade prompt on a multi site. * * @date 23/8/18 * @since 5.7.3 * * @param void * @return void */ function network_admin_notices() { // vars $view = array( 'button_text' => __( 'Review sites & upgrade', 'acf' ), 'button_url' => network_admin_url( 'index.php?page=acf-upgrade-network' ), 'confirm' => false, ); // view acf_get_view( 'html-notice-upgrade', $view ); } /** * admin_html * * Displays the HTML for the admin page. * * @date 24/8/18 * @since 5.7.4 * * @param void * @return void */ function admin_html() { acf_get_view( 'html-admin-page-upgrade' ); } /** * network_admin_html * * Displays the HTML for the network upgrade admin page. * * @date 24/8/18 * @since 5.7.4 * * @param void * @return void */ function network_admin_html() { acf_get_view( 'html-admin-page-upgrade-network' ); } } // instantiate acf_new_instance( 'ACF_Admin_Upgrade' ); endif; // class_exists check