概述

deactivated_plugins_notice() 函数用于在插件因与当前 WordPress 版本不兼容而在更新过程中被强制停用时，在管理后台显示警告通知。它检查用户权限和停用插件列表，生成并输出相应的通知消息。

关键要点

• 函数在非 plugins.php 页面且当前用户具有 activate_plugins 权限时触发。
• 从 wp_force_deactivated_plugins 选项获取停用插件信息，支持单站点和多站点环境。
• 根据插件版本信息生成详细的通知消息，包括插件名称、停用版本、当前 WordPress 版本和兼容版本。
• 使用 wp_admin_notice() 输出警告类型的通知，并清空相关选项以避免重复显示。

代码示例

function deactivated_plugins_notice() {
    if ( 'plugins.php' === $GLOBALS['pagenow'] ) {
        return;
    }

    if ( ! current_user_can( 'activate_plugins' ) ) {
        return;
    }

    $blog_deactivated_plugins = get_option( 'wp_force_deactivated_plugins' );
    $site_deactivated_plugins = array();

    if ( false === $blog_deactivated_plugins ) {
        update_option( 'wp_force_deactivated_plugins', array(), false );
    }

    if ( is_multisite() ) {
        $site_deactivated_plugins = get_site_option( 'wp_force_deactivated_plugins' );
        if ( false === $site_deactivated_plugins ) {
            update_site_option( 'wp_force_deactivated_plugins', array() );
        }
    }

    if ( empty( $blog_deactivated_plugins ) && empty( $site_deactivated_plugins ) ) {
        return;
    }

    $deactivated_plugins = array_merge( $blog_deactivated_plugins, $site_deactivated_plugins );

    foreach ( $deactivated_plugins as $plugin ) {
        if ( ! empty( $plugin['version_compatible'] ) && ! empty( $plugin['version_deactivated'] ) ) {
            $explanation = sprintf(
                __( '%1$s %2$s was deactivated due to incompatibility with WordPress %3$s, please upgrade to %1$s %4$s or later.' ),
                $plugin['plugin_name'],
                $plugin['version_deactivated'],
                $GLOBALS['wp_version'],
                $plugin['version_compatible']
            );
        } else {
            $explanation = sprintf(
                __( '%1$s %2$s was deactivated due to incompatibility with WordPress %3$s.' ),
                $plugin['plugin_name'],
                ! empty( $plugin['version_deactivated'] ) ? $plugin['version_deactivated'] : '',
                $GLOBALS['wp_version']
            );
        }

        $message = sprintf(
            '%s%s%s',
            sprintf(
                __( '%s plugin deactivated during WordPress upgrade.' ),
                $plugin['plugin_name']
            ),
            $explanation,
            esc_url( admin_url( 'plugins.php?plugin_status=inactive' ) ),
            __( 'Go to the Plugins screen' )
        );
        wp_admin_notice( $message, array( 'type' => 'warning' ) );
    }

    update_option( 'wp_force_deactivated_plugins', array(), false );
    if ( is_multisite() ) {
        update_site_option( 'wp_force_deactivated_plugins', array() );
    }
}

注意事项

• 函数仅在 WordPress 5.8.0 及以上版本可用。
• 通知消息包含指向插件管理页面的链接，引导用户处理停用插件。
• 在多站点环境中，会同时处理站点和网络级别的停用插件选项。