✨ What's New v4 page

assets/src/scss/admin-dashboard/index.scss

@@ -1,6 +1,7 @@
 @import '../../../../v2-library/src/scss/reusables.scss';
 @import './tutor-admin.scss';
 @import './whats-new.scss';
+@import './whats-new-v4.scss';
 @import './v2/admin-v2-markup.scss';
 @import './segments/withdraw.scss';
 @import './segments/registration-notice.scss';
@@ -10,4 +11,4 @@
 @import '../modules/certificate-list.scss';
 @import '../modules/quiz-icons.scss';
 @import './segments//legal-consents.scss';
-@import './segments/consent-logs.scss';
+@import './segments/consent-logs.scss';

classes/WhatsNew.php

@@ -24,6 +24,9 @@ class WhatsNew {
 	 */
 	public function __construct() {
 		add_filter( 'tutor_admin_menu', array( $this, 'add_whats_new_menu_item' ) );
+		add_action( 'upgrader_process_complete', array( $this, 'set_whats_new_v4_redirect' ), 10, 2 );
+		add_action( 'admin_init', array( $this, 'maybe_redirect_to_whats_new_v4' ) );
+		add_action( 'admin_menu', array( $this, 'register_whats_new_in_v4_hidden_page' ), 99 );
 	}
 
 	/**
@@ -69,6 +72,88 @@ public function whats_new_page() {
 		include tutor()->path . 'views/pages/whats-new.php';
 	}
 
+	/**
+	 * What's new in v4 page.
+	 *
+	 * @since 4.0.0
+	 *
+	 * @return void
+	 */
+	public function whats_new_in_v4_page() {
+		wp_enqueue_style( 'tutor-core-styles', tutor()->url . 'assets/css/tutor-core.min.css', array(), TUTOR_VERSION );
+		include tutor()->path . 'views/pages/whats-new-in-v4.php';
+	}
+
+	/**
+	 * Register the What's New in v4 page as a hidden submenu (no sidebar link).
+	 *
+	 * @since 4.0.0
+	 *
+	 * @return void
+	 */
+	public function register_whats_new_in_v4_hidden_page() {
+		add_submenu_page(
+			'tutor',                              // parent slug.
+			__( "What's New in v4", 'tutor' ),    // page title.
+			'',                                   // empty menu title = hidden from sidebar.
+			'manage_options',
+			'tutor-whats-new-in-v4',
+			array( $this, 'whats_new_in_v4_page' )
+		);
+	}
+
+	/**
+
+	 * Set a transient flag after plugin upgrade to trigger a one-time redirect.
+	 *
+	 * @since 4.0.0
+	 *
+	 * @param mixed $upgrader_object Upgrader instance.
+	 * @param array $options         Hook arguments.
+	 *
+	 * @return void
+	 */
+	public function set_whats_new_v4_redirect( $upgrader_object, $options ) {
+		if (
+			'update' === $options['action'] &&
+			'plugin' === $options['type'] &&
+			isset( $options['plugins'] ) &&
+			is_array( $options['plugins'] )
+		) {
+			foreach ( $options['plugins'] as $plugin ) {
+				if ( plugin_basename( TUTOR_FILE ) === $plugin ) {
+					set_transient( 'tutor_whats_new_v4_redirect', TUTOR_VERSION, 60 );
+					break;
+				}
+			}
+		}
+	}
+
+	/**
+	 * Redirect to the What's New v4 page once after a plugin update.
+	 *
+	 * @since 4.0.0
+	 *
+	 * @return void
+	 */
+	public function maybe_redirect_to_whats_new_v4() {
+		// Only redirect for admins, not during AJAX, not during activation bulk actions.
+		if (
+			! is_admin() ||
+			wp_doing_ajax() ||
+			! current_user_can( 'manage_options' ) ||
+			! get_transient( 'tutor_whats_new_v4_redirect' )
+		) {
+			return;
+		}
+
+		// Delete the transient immediately so only the first admin gets redirected once.
+		delete_transient( 'tutor_whats_new_v4_redirect' );
+
+		wp_safe_redirect( admin_url( 'admin.php?page=tutor-whats-new-in-v4' ) );
+		exit;
+	}
+
 	/**
 	 * Get tutor plugin version info
 	 *