Rock: Welcome Tour

.eslintignore

@@ -12,6 +12,7 @@ js/formidable_admin.js
 js/bootstrap-multiselect.js
 js/formidable-settings-components.js
 js/frm_testing_mode.js
+js/welcome-tour.js
 
 # Config files
 *.config.js

classes/controllers/FrmAppController.php

@@ -855,10 +855,19 @@ private static function should_show_floating_links() {
 			return false;
 		}
 
-		return FrmAppHelper::is_formidable_admin() &&
+		$should_show = FrmAppHelper::is_formidable_admin() &&
 			! FrmAppHelper::is_style_editor_page() &&
 			! FrmAppHelper::is_admin_page( 'formidable-views-editor' ) &&
 			! FrmAppHelper::simple_get( 'frm_action', 'sanitize_title' );
+
+		/**
+		 * Filters whether the floating links should be displayed.
+		 *
+		 * @since x.x
+		 *
+		 * @param bool $should_show Whether the floating links should be shown.
+		 */
+		return apply_filters( 'frm_should_show_floating_links', $should_show );
 	}
 
 	/**

classes/controllers/FrmHooksController.php

@@ -209,6 +209,8 @@ public static function load_admin_hooks() {
 
 		add_action( 'frm_email_styles_extra_settings', 'FrmEmailStylesController::show_upsell_settings' );
 
+		add_action( 'admin_init', 'FrmWelcomeTourController::admin_init' );
+
 		FrmDashboardController::load_admin_hooks();
 		FrmTransLiteHooksController::load_admin_hooks();
 		FrmStrpLiteHooksController::load_admin_hooks();
@@ -310,13 +312,15 @@ public static function load_ajax_hooks() {
 
 		// Reviews.
 		add_action( 'wp_ajax_frm_dismiss_review', 'FrmAppController::dismiss_review' );
-
 		add_action( 'wp_ajax_frm_small_screen_proceed', 'FrmAppController::small_screen_proceed' );
-
 		add_action( 'wp_ajax_frm_sale_banner_dismiss', 'FrmSalesApi::dismiss_banner' );
 
 		add_action( 'wp_ajax_frm_email_style_preview', 'FrmEmailStylesController::ajax_preview' );
 		add_action( 'wp_ajax_frm_send_test_email', 'FrmEmailStylesController::ajax_send_test_email' );
+
+		// Welcome Tour.
+		add_action( 'wp_ajax_frm_mark_checklist_step_as_completed', 'FrmWelcomeTourController::ajax_mark_checklist_step_as_completed' );
+		add_action( 'wp_ajax_frm_dismiss_welcome_tour', 'FrmWelcomeTourController::ajax_dismiss_welcome_tour' );
 	}
 
 	/**

classes/controllers/FrmStylesController.php

@@ -497,6 +497,8 @@ private static function save_form_style() {
 			return;
 		}
 
+		$previous_style_id = $form->options['custom_style'];
+
 		// If the default style is selected, use the "Always use default" legacy option instead of the default style.
 		// There's also a check here for conversational forms.
 		// Without the check it isn't possible to select "Default" because "Always use default" will convert to "Lines" dynamically.
@@ -508,11 +510,25 @@ private static function save_form_style() {
 		// We want to save a string for consistency. FrmStylesHelper::get_form_count_for_style expects the custom style ID is a string.
 		$form->options['custom_style'] = (string) $style_id;
 
+		if ( $previous_style_id === $form->options['custom_style'] ) {
+			// Exit early before updating DB if nothing actually changed.
+			self::$message = __( 'Successfully updated style.', 'formidable' );
+			return;
+		}
+
 		global $wpdb;
 		$wpdb->update( $wpdb->prefix . 'frm_forms', array( 'options' => maybe_serialize( $form->options ) ), array( 'id' => $form->id ) );
 
 		FrmForm::clear_form_cache();
 
+		/**
+		 * @since x.x
+		 *
+		 * @param int $form_id
+		 * @param int $style_id
+		 */
+		do_action( 'frm_after_changed_form_style', absint( $form_id ), absint( $style_id ) );
+
 		self::$message = __( 'Successfully updated style.', 'formidable' );
 	}
 
@@ -683,6 +699,13 @@ public static function save_style() {
 			$post_id = reset( $id );
 		}
 
+		/**
+		 * @since x.x
+		 *
+		 * @param int $post_id
+		 */
+		do_action( 'frm_after_saved_style', absint( $post_id ) );
+
 		self::$message = __( 'Your styling settings have been saved.', 'formidable' );
 	}
 

classes/controllers/FrmUsageController.php

@@ -93,7 +93,7 @@ public static function send_snapshot() {
 	 * @since 6.16.1
 	 */
 	public static function load_scripts() {
-		if ( self::is_forms_list_page() || FrmAppHelper::is_admin_page( 'formidable-form-templates' ) ) {
+		if ( self::is_forms_list_page() || FrmAppHelper::is_admin_page( 'formidable-form-templates' ) || FrmAppHelper::is_admin_page() ) {
 			wp_enqueue_script( 'frm-usage-tracking', FrmAppHelper::plugin_url() . '/js/admin/usage-tracking.js', array( 'formidable_dom' ), FrmAppHelper::$plug_version, true );
 		}
 	}