Rock: Project Elevate - Part 1

classes/controllers/FrmFormsController.php

@@ -1504,6 +1504,7 @@ private static function get_settings_tabs( $values ) {
 					'upgrade'    => __( 'Form Permissions', 'formidable' ),
 					'message'    => __( 'Allow editing, protect forms and files, limit entries, and save drafts. Upgrade to get form and entry permissions.', 'formidable' ),
 					'screenshot' => 'permissions.png',
+					'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-permissions', 'form-permissions-settings' ),
 				),
 			),
 			'scheduling'  => array(
@@ -1514,6 +1515,7 @@ private static function get_settings_tabs( $values ) {
 					'medium'     => 'scheduling',
 					'upgrade'    => __( 'Form scheduling settings', 'formidable' ),
 					'screenshot' => 'scheduling.png',
+					'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-scheduling', 'form-scheduling-settings' ),
 				),
 			),
 			'buttons'     => array(
@@ -1538,6 +1540,7 @@ private static function get_settings_tabs( $values ) {
 						'upgrade'    => __( 'Conversational Forms', 'formidable' ),
 						'message'    => __( 'Ask one question at a time for automated conversations.', 'formidable' ),
 						'screenshot' => 'chat.png',
+						'learn-more' => FrmAppHelper::get_doc_url( 'conversational-forms', 'conversational-forms-settings', false ),
 					)
 				),
 			),
@@ -1551,6 +1554,7 @@ private static function get_settings_tabs( $values ) {
 						'upgrade'    => __( 'Form abandonment settings', 'formidable' ),
 						'message'    => __( 'Unlock the power of data capture to boost lead generation and master the art of form optimization.', 'formidable' ),
 						'screenshot' => 'abandonment.png',
+						'learn-more' => FrmAppHelper::get_doc_url( 'features/form-abandonment-wordpress-plugin', 'form-abandonment-settings', false ),
 					)
 				),
 			),

classes/controllers/FrmSettingsController.php

@@ -123,6 +123,7 @@ private static function get_settings_tabs() {
 					'medium'     => 'white-label',
 					'upgrade'    => __( 'White labeling options', 'formidable' ),
 					'screenshot' => 'white-label.png',
+					'learn-more' => FrmAppHelper::get_doc_url( 'features/white-label-form-builder-wordpress', 'white-labeling-global-settings', false ),
 				),
 			),
 			'inbox'         => array(
@@ -133,6 +134,7 @@ private static function get_settings_tabs() {
 					'medium'     => 'inbox-settings',
 					'upgrade'    => __( 'Inbox settings', 'formidable' ),
 					'screenshot' => 'inbox.png',
+					'learn-more' => FrmAppHelper::get_doc_url( 'global-settings-overview/#kb-inbox', 'inbox-global-settings' ),
 				),
 			),
 		);

classes/helpers/FrmAppHelper.php

@@ -3451,7 +3451,7 @@ public static function json_to_array( $json_vars ) {
 	 * @param string $l1
 	 * @param mixed  $val
 	 * @param array  $vars
-	 * 
+	 *
 	 * @return void
 	 */
 	public static function add_value_to_array( $name, $l1, $val, &$vars ) {
@@ -4534,6 +4534,7 @@ public static function get_landing_page_upgrade_data_params( $medium = 'landing'
 			'upgrade'    => __( 'Form Landing Pages', 'formidable' ),
 			'message'    => __( 'Easily manage a landing page for your form. Upgrade to get form landing pages.', 'formidable' ),
 			'screenshot' => 'landing.png',
+			'learn-more' => self::get_doc_url( 'landing-page-forms', 'form-landing-page-settings', false ),
 		);
 		return self::get_upgrade_data_params( 'landing', $params );
 	}
@@ -4951,6 +4952,26 @@ public static function is_valid_utf8( $string ) {
 		return false;
 	}
 
+	/**
+	 * Get a documentation URL with UTM parameters and affiliate tracking.
+	 *
+	 * @since x.x
+	 *
+	 * @param string $path           The relative path to append to the base URL.
+	 * @param string $campaign       The campaign to use for UTM parameters.
+	 * @param bool   $add_kb_base    Whether to prepend 'knowledgebase/' to the path. Default true.
+	 *
+	 * @return string The processed URL with UTM parameters and affiliate tracking.
+	 */
+	public static function get_doc_url( $path, $campaign, $add_kb_base = true ) {
+		$path = trim( $path, '/' );
+		if ( $add_kb_base ) {
+			$path = 'knowledgebase/' . $path;
+		}
+
+		return self::maybe_add_missing_utm( 'https://formidableforms.com/' . $path, array( 'campaign' => $campaign ) );
+	}
+
 	/**
 	 * @since 5.0.16
 	 * @deprecated x.x

classes/helpers/FrmFieldsHelper.php

@@ -2412,7 +2412,21 @@ public static function show_add_field_buttons( $args ) {
 			$li_params['data-upsell-image'] = $field_type['upsell_image'];
 		}
 
-		if ( $upgrade_message ) {
+		if ( ! empty( $field_type['learn-more'] ) ) {
+			$li_params['data-learn-more'] = FrmAppHelper::get_doc_url(
+				$field_type['learn-more'],
+				'form-builder-add-fields',
+				false !== strpos( $field_type['learn-more'], '/' )
+			);
+		}
+
+		if ( isset( $upgrading['url'] ) ) {
+			$li_params['data-message'] = sprintf(
+				// translators: %s: Field name
+				esc_html__( 'You already have access to %s fields, you\'ll just need to activate to start using them.', 'formidable' ),
+				$field_name
+			);
+		} elseif ( $upgrade_message ) {
 			$li_params['data-message'] = $upgrade_message;
 		}
 		?>