← All changes | classes/controllers/FrmFormsController.php +544 -1252 6.26.1 → 6.0 View file →

		@@ -4,31 +4,10 @@
4	4	}
5	5
6	6	class FrmFormsController {
7	7
8		- /**
9		- * Track the form that opened the redirect URL in a new tab. This is used to check if we should show the default
10		- * message in the current tab.
11		- *
12		- * @since 6.2
13		- *
14		- * @var array Keys are form IDs and values are 1.
15		- */
16		- private static $redirected_in_new_tab = array();
17		-
18		- /**
19		- * The HTML for the Formdiable TinyMCE button (That triggers a popup to insert shortcodes)
20		- * is stored here and re-used as an optimization.
21		- *
22		- * @since 6.11
23		- *
24		- * @var string|null
25		- */
26		- private static $formidable_tinymce_button;
27		-
28	8	public static function menu() {
29	9	$menu_label = __( 'Forms', 'formidable' );
30		-
31	10	if ( ! FrmAppHelper::pro_is_installed() ) {
32	11	$menu_label .= ' (Lite)';
33	12	}
34	13	add_submenu_page( 'formidable', 'Formidable | ' . $menu_label, $menu_label, 'frm_view_forms', 'formidable', 'FrmFormsController::route' );
		@@ -65,12 +44,12 @@
65	44	*/
66	45	public static function logic_tip() {
67	46	$images_url = FrmAppHelper::plugin_url() . '/images/';
68	47	$data_message = __( 'Only show the fields you need and create branching forms. Upgrade to get conditional logic and question branching.', 'formidable' );
69		- $data_message .= ' <img src="' . esc_url( $images_url ) . '/survey-logic.png" srcset="' . esc_url( $images_url ) . 'survey-logic@2x.png 2x" alt="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '"/>';
	48	+ $data_message .= ' <img src="' . esc_attr( $images_url ) . '/survey-logic.png" srcset="' . esc_attr( $images_url ) . 'survey-logic@2x.png 2x" alt="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '"/>';
70	49	echo '<a href="javascript:void(0)" class="frm_noallow frm_show_upgrade frm_add_logic_link frm-collapsed frm-flex-justify" data-upgrade="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '" data-message="' . esc_attr( $data_message ) . '" data-medium="builder" data-content="logic">';
71	50	esc_html_e( 'Conditional Logic', 'formidable' );
72		- FrmAppHelper::icon_by_class( 'frmfont frm_arrowdown8_icon', array( 'aria-hidden' => 'true' ) );
	51	+ FrmAppHelper::icon_by_class( 'frmfont frm_arrowdown6_icon', array( 'aria-hidden' => 'true' ) );
73	52	echo '</a>';
74	53	}
75	54
76	55	/**
		@@ -77,12 +56,8 @@
77	56	* By default, Divi processes form shortcodes on the edit post page.
78	57	* Now that won't do.
79	58	*
80	59	* @since 3.01
81		- *
82		- * @param array $shortcodes List of shortcodes to process.
83		- *
84		- * @return array
85	60	*/
86	61	public static function prevent_divi_conflict( $shortcodes ) {
87	62	$shortcodes[] = 'formidable';
88	63
		@@ -97,14 +72,12 @@
97	72
98	73	$message = '';
99	74	$params = FrmForm::list_page_params();
100	75	$errors = self::process_bulk_form_actions( array() );
101		-
102	76	if ( isset( $errors['message'] ) ) {
103	77	$message = $errors['message'];
104	78	unset( $errors['message'] );
105	79	}
106		-
107	80	$errors = apply_filters( 'frm_admin_list_form_action', $errors );
108	81
109	82	self::display_forms_list( $params, $message, $errors );
110	83	}
		@@ -113,25 +86,15 @@
113	86	* Create the default email action
114	87	*
115	88	* @since 2.02.11
116	89	*
117		- * @param int|object $form
118		- *
119		- * @return void
	90	+ * @param object|int $form
120	91	*/
121	92	private static function create_default_email_action( $form ) {
122	93	FrmForm::maybe_get_form( $form );
123		-
124		- if ( ! is_object( $form ) ) {
125		- return;
126		- }
127		-
128	94	$create_email = apply_filters( 'frm_create_default_email_action', true, $form );
129	95
130	96	if ( $create_email ) {
131		- /**
132		- * @var FrmFormAction
133		- */
134	97	$action_control = FrmFormActionsController::get_form_actions( 'email' );
135	98	$action_control->create( $form->id );
136	99	}
137	100	}
		@@ -140,19 +103,13 @@
140	103	* Create the default On submit action
141	104	*
142	105	* @since 6.0.0
143	106	*
144		- * @param int|object $form Form object or ID.
145		- *
146		- * @return void
	107	+ * @param object|int $form Form object or ID.
147	108	*/
148	109	private static function create_default_on_submit_action( $form ) {
149	110	FrmForm::maybe_get_form( $form );
150	111
151		- if ( ! is_object( $form ) ) {
152		- return;
153		- }
154		-
155	112	/**
156	113	* Enable or disable the default On Submit action.
157	114	*
158	115	* @since 6.0.0
		@@ -162,70 +119,21 @@
162	119	*/
163	120	$create = apply_filters( 'frm_create_default_on_submit_action', true, $form );
164	121
165	122	if ( $create ) {
166		- /**
167		- * @var FrmFormAction
168		- */
169	123	$action_control = FrmFormActionsController::get_form_actions( FrmOnSubmitAction::$slug );
170	124	$action_control->create( $form->id );
171	125	}
172	126	}
173	127
174		- /**
175		- * Creates submit button field.
176		- *
177		- * @since 6.9
178		- *
179		- * @param int|object $form Form ID or object.
180		- *
181		- * @return void
182		- */
183		- private static function create_submit_button_field( $form ) {
184		- FrmForm::maybe_get_form( $form );
185		-
186		- if ( ! is_object( $form ) ) {
187		- return;
188		- }
189		-
190		- if ( FrmSubmitHelper::get_submit_field( $form->id ) ) {
191		- // Do not create submit button field if it exists.
192		- return;
193		- }
194		-
195		- FrmField::create(
196		- array(
197		- 'type' => FrmSubmitHelper::FIELD_TYPE,
198		- 'name' => __( 'Submit', 'formidable' ),
199		- 'field_order' => FrmSubmitHelper::DEFAULT_ORDER,
200		- 'form_id' => $form->id,
201		- 'field_options' => FrmFieldsHelper::get_default_field_options( FrmSubmitHelper::FIELD_TYPE ),
202		- 'description' => '',
203		- 'default_value' => '',
204		- 'options' => array(),
205		- )
206		- );
207		- }
208		-
209		- /**
210		- * @param array|false $values
211		- *
212		- * @return void
213		- */
214	128	public static function edit( $values = false ) {
215	129	FrmAppHelper::permission_check( 'frm_edit_forms' );
216	130
217	131	$id = isset( $values['id'] ) ? absint( $values['id'] ) : FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
218	132
219		- self::get_edit_vars( $id );
	133	+ return self::get_edit_vars( $id );
220	134	}
221	135
222		- /**
223		- * @param mixed $id
224		- * @param string $message
225		- *
226		- * @return void
227		- */
228	136	public static function settings( $id = false, $message = '' ) {
229	137	FrmAppHelper::permission_check( 'frm_edit_forms' );
230	138
231	139	if ( ! $id || ! is_numeric( $id ) ) {
		@@ -231,36 +139,23 @@
231	139	if ( ! $id || ! is_numeric( $id ) ) {
232	140	$id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
233	141	}
234	142
235		- FrmOnSubmitHelper::maybe_migrate_submit_settings_to_action( $id );
	143	+ self::maybe_migrate_submit_settings_to_action( $id );
236	144
237		- self::get_settings_vars( $id, array(), $message );
	145	+ return self::get_settings_vars( $id, array(), $message );
238	146	}
239	147
240	148	public static function update_settings() {
241	149	FrmAppHelper::permission_check( 'frm_edit_forms' );
242		- $process_form = FrmAppHelper::get_post_param( 'process_form', '', 'sanitize_text_field' );
243	150
244		- if ( ! wp_verify_nonce( $process_form, 'process_form_nonce' ) ) {
245		- $frm_settings = FrmAppHelper::get_settings();
246		- $error_args = array(
247		- 'title' => __( 'Verification failed', 'formidable' ),
248		- 'body' => $frm_settings->admin_permission,
249		- 'cancel_text' => __( 'Cancel', 'formidable' ),
250		- );
251		- FrmAppController::show_error_modal( $error_args );
252		- return;
253		- }
254		-
255	151	$id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
256	152
257		- $errors = FrmForm::validate( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
	153	+ $errors = FrmForm::validate( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
258	154	$warnings = FrmFormsHelper::check_for_warnings( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
259	155
260	156	if ( count( $errors ) > 0 ) {
261		- self::get_settings_vars( $id, $errors, compact( 'warnings' ) );
262		- return;
	157	+ return self::get_settings_vars( $id, $errors, compact( 'warnings' ) );
263	158	}
264	159
265	160	do_action( 'frm_before_update_form_settings', $id );
266	161
		@@ -268,9 +163,8 @@
268	163
269	164	FrmForm::update( $id, $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
270	165
271	166	$antispam_is_on = ! empty( $_POST['options']['antispam'] ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
272		-
273	167	if ( $antispam_is_on !== $antispam_was_on ) {
274	168	FrmAntiSpam::clear_caches();
275	169	}
276	170
		@@ -275,14 +169,13 @@
275	169	}
276	170
277	171	$message = __( 'Settings Successfully Updated', 'formidable' );
278	172
279		- self::get_settings_vars( $id, array(), compact( 'message', 'warnings' ) );
	173	+ return self::get_settings_vars( $id, array(), compact( 'message', 'warnings' ) );
280	174	}
281	175
282	176	/**
283	177	* @param int $form_id
284		- *
285	178	* @return bool
286	179	*/
287	180	private static function antispam_was_on( $form_id ) {
288	181	$form = FrmForm::getOne( $form_id );
		@@ -288,13 +181,8 @@
288	181	$form = FrmForm::getOne( $form_id );
289	182	return ! empty( $form->options['antispam'] );
290	183	}
291	184
292		- /**
293		- * @param array $values
294		- *
295		- * @return void
296		- */
297	185	public static function update( $values = array() ) {
298	186	if ( empty( $values ) ) {
299	187	$values = $_POST; // phpcs:ignore WordPress.Security.NonceVerification.Missing
300	188	}
		@@ -305,9 +193,8 @@
305	193	}
306	194
307	195	$errors = FrmForm::validate( $values );
308	196	$permission_error = FrmAppHelper::permission_nonce_error( 'frm_edit_forms', 'frm_save_form', 'frm_save_form_nonce' );
309		-
310	197	if ( $permission_error !== false ) {
311	198	$errors['form'] = $permission_error;
312	199	}
313	200
		@@ -313,93 +200,65 @@
313	200
314	201	$id = isset( $values['id'] ) ? absint( $values['id'] ) : FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
315	202
316	203	if ( count( $errors ) > 0 ) {
317		- self::get_edit_vars( $id, $errors );
318		- return;
319		- }
	204	+ return self::get_edit_vars( $id, $errors );
	205	+ } else {
	206	+ FrmForm::update( $id, $values );
	207	+ $message = __( 'Form was successfully updated.', 'formidable' );
320	208
321		- self::maybe_remove_draft_option_from_fields( $id );
	209	+ if ( self::is_too_long( $values ) ) {
	210	+ $message .= '<br/> ' . sprintf(
	211	+ /* translators: %1$s: Start link HTML, %2$s: end link HTML */
	212	+ __( 'However, your form is very long and may be %1$sreaching server limits%2$s.', 'formidable' ),
	213	+ '<a href="https://formidableforms.com/knowledgebase/i-have-a-long-form-why-did-the-options-at-the-end-of-the-form-stop-saving/?utm_source=WordPress&utm_medium=builder&utm_campaign=liteplugin" target="_blank" rel="noopener">',
	214	+ '</a>'
	215	+ );
	216	+ }
322	217
323		- FrmForm::update( $id, $values );
324		- $message = __( 'Form was successfully updated.', 'formidable' );
	218	+ if ( defined( 'DOING_AJAX' ) ) {
	219	+ wp_die( FrmAppHelper::kses( $message, array( 'a' ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	220	+ }
325	221
326		- if ( self::is_too_long( $values ) ) {
327		- $message .= '<br/> ' . sprintf(
328		- /* translators: %1$s: Start link HTML, %2$s: end link HTML */
329		- __( 'However, your form is very long and may be %1$sreaching server limits%2$s.', 'formidable' ),
330		- '<a href="' . esc_url( self::get_form_too_long_docs_url() ) . '" target="_blank" rel="noopener">',
331		- '</a>'
332		- );
	222	+ return self::get_edit_vars( $id, array(), $message );
333	223	}
334		-
335		- if ( defined( 'DOING_AJAX' ) ) {
336		- wp_die( FrmAppHelper::kses( $message, array( 'a' ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
337		- }
338		-
339		- self::get_edit_vars( $id, array(), $message );
340	224	}
341	225
342	226	/**
343		- * @since 6.25.1
	227	+ * Check if the value at the end of the form was included.
	228	+ * If it's missing, it means other values at the end of the form
	229	+ * were likely not saved either.
344	230	*
345		- * @return string
	231	+ * @since 3.06.01
346	232	*/
347		- private static function get_form_too_long_docs_url() {
348		- $utm = array(
349		- 'campaign' => 'builder',
350		- 'content' => 'form-too-long',
351		- );
352		- return FrmAppHelper::admin_upgrade_link( $utm, 'knowledgebase/i-have-a-long-form-why-did-the-options-at-the-end-of-the-form-stop-saving/' );
	233	+ private static function is_too_long( $values ) {
	234	+ return ( ! isset( $values['frm_end'] ) ) || empty( $values['frm_end'] );
353	235	}
354	236
355	237	/**
356		- * Remove the draft flag from any new fields from this current session.
	238	+ * Redirect to the url for creating from a template
	239	+ * Also delete the current form
357	240	*
358		- * @since 6.8
359		- *
360		- * @param int $form_id
361		- *
362		- * @return void
	241	+ * @since 2.0
	242	+ * @deprecated 3.06
363	243	*/
364		- private static function maybe_remove_draft_option_from_fields( $form_id ) {
365		- $draft_field_ids_csv = FrmAppHelper::get_post_param( 'draft_fields', '', 'sanitize_text_field' );
	244	+ public static function _create_from_template() {
	245	+ _deprecated_function( __FUNCTION__, '3.06' );
366	246
367		- if ( ! $draft_field_ids_csv ) {
368		- // If the draft_fields input is empty there are no new fields in the session.
369		- return;
370		- }
	247	+ FrmAppHelper::permission_check( 'frm_edit_forms' );
	248	+ check_ajax_referer( 'frm_ajax', 'nonce' );
371	249
372		- $draft_field_ids = array_filter( explode( ',', $draft_field_ids_csv ), 'is_numeric' );
	250	+ $current_form = FrmAppHelper::get_param( 'this_form', '', 'get', 'absint' );
	251	+ $template_id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
373	252
374		- if ( ! $draft_field_ids ) {
375		- // Exit early if the draft fields input is invalid. It should be a CSV of integer values.
376		- return;
	253	+ if ( $current_form ) {
	254	+ FrmForm::destroy( $current_form );
377	255	}
378	256
379		- $draft_field_rows = FrmFieldsHelper::get_draft_field_results( $form_id, $draft_field_ids );
380		-
381		- foreach ( $draft_field_rows as $row ) {
382		- $row->field_options['draft'] = 0;
383		- FrmField::update( $row->id, array( 'field_options' => $row->field_options ) );
384		- }
	257	+ echo esc_url_raw( admin_url( 'admin.php?page=formidable&frm_action=duplicate&id=' . absint( $template_id ) ) );
	258	+ wp_die();
385	259	}
386	260
387		- /**
388		- * Check if the value at the end of the form was included.
389		- * If it's missing, it means other values at the end of the form
390		- * were likely not saved either.
391		- *
392		- * @since 3.06.01
393		- *
394		- * @param array $values
395		- *
396		- * @return bool
397		- */
398		- private static function is_too_long( $values ) {
399		- return empty( $values['frm_end'] );
400		- }
401		-
402	261	public static function duplicate() {
403	262	FrmAppHelper::permission_check( 'frm_edit_forms' );
404	263	$nonce = FrmAppHelper::simple_get( '_wpnonce' );
405	264
		@@ -413,11 +272,10 @@
413	272	$url = admin_url( 'admin.php?page=formidable' );
414	273	$message = 'form_duplicate_error';
415	274
416	275	if ( $form ) {
417		- $new_template = FrmAppHelper::simple_get( 'new_template' ) ? '&new_template=true' : '';
418		- $url = admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . absint( $form ) . $new_template );
419		- $message = 'form_duplicated';
	276	+ $url = admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . absint( $form ) );
	277	+ $message = 'form_duplicated';
420	278	}
421	279
422	280	$url .= '&message=' . $message;
423	281
		@@ -425,45 +283,27 @@
425	283	exit();
426	284	}
427	285
428	286	/**
429		- * @return string|null
	287	+ * @return string
430	288	*/
431	289	public static function page_preview() {
432	290	$params = FrmForm::list_page_params();
433		-
434		- if ( ! $params['form'] || is_numeric( $params['form'] ) ) {
435		- return null;
	291	+ if ( ! $params['form'] ) {
	292	+ return;
436	293	}
437	294
438		- self::maybe_block_preview( $params['form'] );
439		-
440	295	$form = FrmForm::getOne( $params['form'] );
441		-
442		- if ( ! $form ) {
443		- return null;
	296	+ if ( $form ) {
	297	+ return self::show_form( $form->id, '', 'auto', 'auto' );
444	298	}
445		-
446		- return self::show_form( $form->id, '', 'auto', 'auto' );
447	299	}
448	300
449	301	/**
450	302	* @since 3.0
451		- *
452		- * @return void
453	303	*/
454	304	public static function show_page_preview() {
455		- $preview = self::page_preview();
456		-
457		- if ( is_null( $preview ) ) {
458		- wp_die(
459		- '<h1>' . esc_html__( 'Form key is invalid', 'formidable' ) . '</h1>',
460		- '<p>' . esc_html__( 'Form key is invalid', 'formidable' ) . '</p>',
461		- 404
462		- );
463		- }
464		-
465		- echo $preview; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	305	+ echo self::page_preview(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
466	306	}
467	307
468	308	/**
469	309	* @return void
		@@ -474,19 +314,9 @@
474	314
475	315	global $frm_vars;
476	316	$frm_vars['preview'] = true;
477	317
478		- // print_emoji_styles is deprecated.
479		- remove_action( 'wp_print_styles', 'print_emoji_styles' );
480		-
481		- if ( FrmTestModeController::should_add_test_mode_container() ) {
482		- do_action( 'frm_test_mode_init' );
483		- add_action( 'wp_enqueue_scripts', 'FrmTestModeController::register_and_enqueue_required_scripts' );
484		- add_filter( 'frm_filter_final_form', 'FrmTestModeController::maybe_add_test_mode_container', 99 );
485		- }
486		-
487	318	$include_theme = FrmAppHelper::get_param( 'theme', '', 'get', 'absint' );
488		-
489	319	if ( $include_theme ) {
490	320	self::set_preview_query();
491	321	self::load_theme_preview();
492	322	} else {
		@@ -509,9 +339,8 @@
509	339	'post_type' => 'page',
510	340	);
511	341
512	342	$page_for_posts = get_option( 'page_for_posts' );
513		-
514	343	if ( is_numeric( $page_for_posts ) ) {
515	344	// Avoid querying for the "Posts Page" or "Blog Page" so we don't display 10 forms.
516	345	$page_query['post__not_in'] = array( $page_for_posts );
517	346	}
		@@ -516,20 +345,13 @@
516	345	$page_query['post__not_in'] = array( $page_for_posts );
517	346	}
518	347
519	348	$random_page = get_posts( $page_query );
520		-
521	349	if ( ! $random_page ) {
522	350	return;
523	351	}
524	352
525	353	$random_page = reset( $random_page );
526		-
527		- if ( ! is_a( $random_page, 'WP_Post' ) ) {
528		- // The return type can also be int.
529		- return;
530		- }
531		-
532	354	query_posts(
533	355	array(
534	356	'post_type' => 'page',
535	357	'page_id' => $random_page->ID,
		@@ -545,10 +367,9 @@
545	367	* Set the WP $post global object. Used for in-theme preview when defining a page.
546	368	*
547	369	* @since 5.5.2
548	370	*
549		- * @param WP_Post $page The page object.
550		- *
	371	+ * @param WP_Post $post
551	372	* @return void
552	373	*/
553	374	private static function set_post_global( $page ) {
554	375	global $post;
		@@ -556,10 +377,8 @@
556	377	}
557	378
558	379	/**
559	380	* @since 3.0
560		- *
561		- * @return void
562	381	*/
563	382	private static function load_theme_preview() {
564	383	add_filter( 'wp_title', 'FrmFormsController::preview_title', 9999 );
565	384	add_filter( 'the_title', 'FrmFormsController::preview_page_title', 9999 );
		@@ -568,40 +387,20 @@
568	387	add_filter( 'is_active_sidebar', '__return_false' );
569	388	FrmStylesController::enqueue_css( 'enqueue', true );
570	389
571	390	if ( false === get_template_part( 'page' ) ) {
572		- if ( function_exists( 'wp_is_block_theme' ) && wp_is_block_theme() ) {
573		- add_filter( 'body_class', 'FrmFormsController::preview_block_theme_body_classnames' );
574		- }
575	391	self::fallback_when_page_template_part_is_not_supported_by_theme();
576	392	}
577	393	}
578	394
579	395	/**
580		- * Add padding to the body for block themes.
581		- *
582		- * @since 6.5.2
583		- *
584		- * @param array $classes The body classes list.
585		- *
586		- * @return array
587		- */
588		- public static function preview_block_theme_body_classnames( $classes ) {
589		- $classes[] = 'has-global-padding';
590		- return $classes;
591		- }
592		-
593		- /**
594	396	* Not every theme supports get_template_part( 'page' ).
595	397	* When this is not supported, false is returned, and we can handle a fallback.
596		- *
597		- * @return void
598	398	*/
599	399	private static function fallback_when_page_template_part_is_not_supported_by_theme() {
600	400	if ( have_posts() ) {
601	401	the_post();
602		- self::get_template( 'header' );
603		-
	402	+ get_header( '' );
604	403	// add some generic class names to the container to add some natural padding to the content.
605	404	// .entry-content catches the WordPress TwentyTwenty theme.
606	405	// .container catches Customizr content.
607	406	echo '<div class="container entry-content">';
		@@ -606,69 +405,16 @@
606	405	// .container catches Customizr content.
607	406	echo '<div class="container entry-content">';
608	407	the_content();
609	408	echo '</div>';
610		-
611		- // Prevent extra unexpected forms in the footer.
612		- // For some reason this happens in the Twenty Twenty Five theme.
613		- add_filter( 'frm_filter_final_form', '__return_empty_string' );
614		-
615		- self::get_template( 'footer' );
	409	+ get_footer();
616	410	}
617	411	}
618	412
619	413	/**
620		- * Calls core function to get a template part if it doesn't cause deprecation warnings. Otherwise skips the deprecation function call
621		- * and renders required html fragments calling required functions.
622		- *
623		- * @since 6.7.1
624		- *
625		- * @param string $template
626		- *
627		- * @return void
628		- */
629		- private static function get_template( $template ) {
630		- if ( self::should_try_getting_template( $template ) ) {
631		- call_user_func( 'get_' . $template );
632		- return;
633		- }
634		-
635		- if ( 'header' === $template ) {
636		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/preview/header.php';
637		- return;
638		- }
639		-
640		- if ( 'footer' === $template ) {
641		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/preview/footer.php';
642		- }
643		- }
644		-
645		- /**
646		- * Returns true if calling a template function doesn't trigger deprecation warnings.
647		- *
648		- * @since 6.7.1
649		- *
650		- * @param string $template
651		- *
652		- * @return bool
653		- */
654		- private static function should_try_getting_template( $template ) {
655		- $stylesheet_path = get_stylesheet_directory();
656		- $template_path = get_template_directory();
657		- $is_child_theme = $stylesheet_path !== $template_path;
658		- $template_name = $template . '.php';
659		-
660		- return file_exists( $stylesheet_path . '/' . $template_name ) || $is_child_theme && file_exists( $template_path . '/' . $template_name );
661		- }
662		-
663		- /**
664	414	* Set the page title for the theme preview page
665	415	*
666	416	* @since 3.0
667		- *
668		- * @param string $title
669		- *
670		- * @return string
671	417	*/
672	418	public static function preview_page_title( $title ) {
673	419	if ( in_the_loop() ) {
674	420	$title = self::preview_title( $title );
		@@ -677,15 +423,11 @@
677	423	return $title;
678	424	}
679	425
680	426	/**
681		- * Set the page title for the theme preview page.
	427	+ * Set the page title for the theme preview page
682	428	*
683	429	* @since 3.0
684		- *
685		- * @param string $title
686		- *
687		- * @return string
688	430	*/
689	431	public static function preview_title( $title ) {
690	432	return __( 'Form Preview', 'formidable' );
691	433	}
		@@ -690,21 +432,15 @@
690	432	return __( 'Form Preview', 'formidable' );
691	433	}
692	434
693	435	/**
694		- * Set the page content for the theme preview page.
	436	+ * Set the page content for the theme preview page
695	437	*
696	438	* @since 3.0
697		- *
698		- * @param string $content
699		- *
700		- * @return string
701	439	*/
702	440	public static function preview_content( $content ) {
703	441	if ( in_the_loop() ) {
704		- self::show_page_preview();
705		- // Clear the content for the page we're using.
706		- $content = '';
	442	+ $content = self::show_page_preview();
707	443	}
708	444
709	445	return $content;
710	446	}
		@@ -712,92 +448,23 @@
712	448	/**
713	449	* @since 3.0
714	450	*/
715	451	private static function load_direct_preview() {
	452	+ header( 'Content-Type: text/html; charset=' . get_option( 'blog_charset' ) );
	453	+
716	454	$key = FrmAppHelper::simple_get( 'form', 'sanitize_title' );
717		-
718	455	if ( $key == '' ) {
719	456	$key = FrmAppHelper::get_post_param( 'form', '', 'sanitize_title' );
720	457	}
721	458
722		- if ( ! $key ) {
723		- $error = __( 'Form key is missing', 'formidable' );
724		- wp_die(
725		- '<h1>' . esc_html( $error ) . '</h1>',
726		- '<p>' . esc_html( $error ) . '</p>',
727		- 404
728		- );
729		- }
730		-
731		- self::maybe_block_preview( $key );
732		-
733	459	$form = FrmForm::getAll( array( 'form_key' => $key ), '', 1 );
734		-
735		- if ( ! $form ) {
736		- $error = __( 'Form does not exist', 'formidable' );
737		- wp_die(
738		- '<h1>' . esc_html( $error ) . '</h1>',
739		- '<p>' . esc_html( $error ) . '</p>',
740		- 404
741		- );
	460	+ if ( empty( $form ) ) {
	461	+ $form = FrmForm::getAll( array(), '', 1 );
742	462	}
743	463
744		- header( 'Content-Type: text/html; charset=' . get_option( 'blog_charset' ) );
745		-
746		- self::fix_deprecated_null_param_warning();
747		-
748		- require FrmAppHelper::plugin_path() . '/classes/views/frm-entries/direct.php';
	464	+ require( FrmAppHelper::plugin_path() . '/classes/views/frm-entries/direct.php' );
749	465	}
750	466
751		- /**
752		- * Block the form preview for the contact form by default if the user cannot view forms.
753		- * This is to prevent the contact form being exploited.
754		- * Since this form is added by default and every site uses the same key, it is too easy
755		- * to guess this form.
756		- *
757		- * @since 6.20
758		- *
759		- * @param string $form_key Form key.
760		- *
761		- * @return void
762		- */
763		- public static function maybe_block_preview( $form_key ) {
764		- if ( FrmFormsHelper::should_block_preview( $form_key ) ) {
765		- $error = __( 'You do not have permission to view this form', 'formidable' );
766		- wp_die(
767		- '<h1>' . esc_html( $error ) . '</h1>',
768		- '<p>' . esc_html( $error ) . '</p>',
769		- 403
770		- );
771		- }
772		- }
773		-
774		- /**
775		- * Some themes have a null $src value.
776		- * This function adds a filter to ensure that $src is not null.
777		- * WP will call str_starts_with with the null value triggering a deprecated message otherwise.
778		- *
779		- * @since 6.10
780		- *
781		- * @return void
782		- */
783		- private static function fix_deprecated_null_param_warning() {
784		- add_filter(
785		- 'script_loader_src',
786		- /**
787		- * @param string|null $src
788		- *
789		- * @return string
790		- */
791		- function ( $src ) {
792		- if ( is_null( $src ) ) {
793		- $src = '';
794		- }
795		- return $src;
796		- }
797		- );
798		- }
799		-
800	467	public static function untrash() {
801	468	self::change_form_status( 'untrash' );
802	469	}
803	470
		@@ -802,9 +469,8 @@
802	469	}
803	470
804	471	/**
805	472	* @param array $ids
806		- *
807	473	* @return string
808	474	*/
809	475	public static function bulk_untrash( $ids ) {
810	476	FrmAppHelper::permission_check( 'frm_edit_forms' );
		@@ -861,15 +527,14 @@
861	527	FrmAppHelper::permission_check( $available_status[ $status ]['permission'] );
862	528
863	529	$params = FrmForm::list_page_params();
864	530
865		- // Check nonce url.
	531	+ //check nonce url
866	532	check_admin_referer( $status . '_form_' . $params['id'] );
867	533
868	534	$count = 0;
869		-
870	535	if ( FrmForm::set_status( $params['id'], $available_status[ $status ]['new_status'] ) ) {
871		- ++$count;
	536	+ $count ++;
872	537	}
873	538
874	539	$form_type = FrmAppHelper::get_simple_request(
875	540	array(
		@@ -881,9 +546,9 @@
881	546	/* translators: %1$s: Number of forms */
882	547	$available_status['untrash']['message'] = sprintf( _n( '%1$s form restored from the Trash.', '%1$s forms restored from the Trash.', $count, 'formidable' ), $count );
883	548
884	549	/* translators: %1$s: Number of forms, %2$s: Start link HTML, %3$s: End link HTML */
885		- $available_status['trash']['message'] = sprintf( _n( '%1$s form moved to the Trash. %2$sUndo%3$s', '%1$s forms moved to the Trash. %2$sUndo%3$s', $count, 'formidable' ), $count, '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=untrash&form_type=' . $form_type . '&id=' . $params['id'], 'untrash_form_' . $params['id'] ) ) . '">', '</a>' );
	550	+ $available_status['trash']['message'] = sprintf( _n( '%1$s form moved to the Trash. %2$sUndo%3$s', '%1$s forms moved to the Trash. %2$sUndo%3$s', $count, 'formidable' ), $count, '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=untrash&form_type=' . $form_type . '&id=' . $params['id'], 'untrash_form_' . $params['id'] ) ) . '">', '</a>' );
886	551
887	552	$message = $available_status[ $status ]['message'];
888	553
889	554	self::display_forms_list( $params, $message );
		@@ -888,28 +553,18 @@
888	553
889	554	self::display_forms_list( $params, $message );
890	555	}
891	556
892		- /**
893		- * @param array $ids
894		- *
895		- * @return string
896		- */
897	557	public static function bulk_trash( $ids ) {
898	558	FrmAppHelper::permission_check( 'frm_delete_forms' );
899	559
900	560	$count = 0;
901		-
902	561	foreach ( $ids as $id ) {
903	562	if ( FrmForm::trash( $id ) ) {
904		- ++$count;
	563	+ $count ++;
905	564	}
906	565	}
907	566
908		- if ( ! $count ) {
909		- return '';
910		- }
911		-
912	567	$current_page = FrmAppHelper::get_simple_request(
913	568	array(
914	569	'param' => 'form_type',
915	570	'type' => 'request',
		@@ -934,11 +589,10 @@
934	589	// Check nonce url.
935	590	check_admin_referer( 'destroy_form_' . $params['id'] );
936	591
937	592	$count = 0;
938		-
939	593	if ( FrmForm::destroy( $params['id'] ) ) {
940		- ++$count;
	594	+ $count ++;
941	595	}
942	596
943	597	/* translators: %1$s: Number of forms */
944	598	$message = sprintf( _n( '%1$s Form Permanently Deleted', '%1$s Forms Permanently Deleted', $count, 'formidable' ), $count );
		@@ -945,41 +599,28 @@
945	599
946	600	self::display_forms_list( $params, $message );
947	601	}
948	602
949		- /**
950		- * @param array $ids
951		- *
952		- * @return string
953		- */
954	603	public static function bulk_destroy( $ids ) {
955	604	FrmAppHelper::permission_check( 'frm_delete_forms' );
956	605
957	606	$count = 0;
958		-
959	607	foreach ( $ids as $id ) {
960	608	$d = FrmForm::destroy( $id );
961		-
962	609	if ( $d ) {
963		- ++$count;
	610	+ $count ++;
964	611	}
965	612	}
966	613
967		- if ( $count ) {
968		- /* translators: %1$s: Number of forms */
969		- return sprintf( _n( '%1$s form permanently deleted.', '%1$s forms permanently deleted.', $count, 'formidable' ), $count );
970		- }
	614	+ /* translators: %1$s: Number of forms */
	615	+ $message = sprintf( _n( '%1$s form permanently deleted.', '%1$s forms permanently deleted.', $count, 'formidable' ), $count );
971	616
972		- return '';
	617	+ return $message;
973	618	}
974	619
975		- /**
976		- * @since 6.7.1 Function went from private to public.
977		- */
978		- public static function delete_all() {
	620	+ private static function delete_all() {
979	621	// Check nonce url.
980	622	$permission_error = FrmAppHelper::permission_nonce_error( 'frm_delete_forms', '_wpnonce', 'bulk-toplevel_page_formidable' );
981		-
982	623	if ( $permission_error !== false ) {
983	624	self::display_forms_list( array(), '', array( $permission_error ) );
984	625
985	626	return;
		@@ -984,15 +625,14 @@
984	625
985	626	return;
986	627	}
987	628
988		- $count = FrmForm::scheduled_delete( time() );
989		- $url = remove_query_arg( array( 'delete_all' ) );
	629	+ $count = FrmForm::scheduled_delete( time() );
990	630
991		- $url .= '&message=forms_permanently_deleted&forms_deleted=' . $count;
	631	+ /* translators: %1$s: Number of forms */
	632	+ $message = sprintf( _n( '%1$s form permanently deleted.', '%1$s forms permanently deleted.', $count, 'formidable' ), $count );
992	633
993		- wp_safe_redirect( $url );
994		- die();
	634	+ self::display_forms_list( array(), $message );
995	635	}
996	636
997	637	/**
998	638	* Create a new form from the modal.
		@@ -1005,9 +645,9 @@
1005	645
1006	646	$new_values = self::get_modal_values();
1007	647	$new_values['form_key'] = $new_values['name'];
1008	648	$new_values['options'] = array(
1009		- 'antispam' => 1,
	649	+ 'antispam' => 1,
1010	650	'on_submit_migrated' => 1,
1011	651	);
1012	652
1013	653	/**
		@@ -1026,14 +666,13 @@
1026	666	* @param int $form_id
1027	667	*/
1028	668	do_action( 'frm_build_new_form', $form_id );
1029	669
1030		- self::create_submit_button_field( $form_id );
1031	670	self::create_default_on_submit_action( $form_id );
1032	671	self::create_default_email_action( $form_id );
1033	672
1034	673	$response = array(
1035		- 'redirect' => FrmForm::get_edit_link( $form_id ) . '&new_template=true',
	674	+ 'redirect' => FrmForm::get_edit_link( $form_id ),
1036	675	);
1037	676
1038	677	echo wp_json_encode( $response );
1039	678	wp_die();
		@@ -1039,15 +678,46 @@
1039	678	wp_die();
1040	679	}
1041	680
1042	681	/**
	682	+ * Create a custom template from a form
	683	+ *
	684	+ * @since 3.06
	685	+ */
	686	+ public static function build_template() {
	687	+ global $wpdb;
	688	+
	689	+ FrmAppHelper::permission_check( 'frm_edit_forms' );
	690	+ check_ajax_referer( 'frm_ajax', 'nonce' );
	691	+
	692	+ $form_id = FrmAppHelper::get_param( 'xml', '', 'post', 'absint' );
	693	+ $new_form_id = FrmForm::duplicate( $form_id, 1, true );
	694	+ if ( ! $new_form_id ) {
	695	+ $response = array(
	696	+ 'message' => __( 'There was an error creating a template.', 'formidable' ),
	697	+ );
	698	+ } else {
	699	+ $new_values = self::get_modal_values();
	700	+ $query_results = $wpdb->update( $wpdb->prefix . 'frm_forms', $new_values, array( 'id' => $new_form_id ) );
	701	+ if ( $query_results ) {
	702	+ FrmForm::clear_form_cache();
	703	+ }
	704	+
	705	+ $response = array(
	706	+ 'redirect' => admin_url( 'admin.php?page=formidable&frm_action=duplicate&id=' . $new_form_id ) . '&_wpnonce=' . wp_create_nonce(),
	707	+ );
	708	+ }
	709	+
	710	+ echo wp_json_encode( $response );
	711	+ wp_die();
	712	+ }
	713	+
	714	+ /**
1043	715	* Before creating a new form, get the name and description from the modal.
1044	716	*
1045	717	* @since 4.0
1046		- *
1047		- * @return array<string,string>
1048	718	*/
1049		- public static function get_modal_values() {
	719	+ private static function get_modal_values() {
1050	720	$name = FrmAppHelper::get_param( 'name', '', 'post', 'sanitize_text_field' );
1051	721	$desc = FrmAppHelper::get_param( 'desc', '', 'post', 'sanitize_textarea_field' );
1052	722
1053	723	return array(
		@@ -1060,24 +730,17 @@
1060	730	* Inserts Formidable button
1061	731	* Hook exists since 2.5.0
1062	732	*
1063	733	* @since 2.0.15
1064		- *
1065		- * @return void
1066	734	*/
1067	735	public static function insert_form_button() {
1068	736	if ( current_user_can( 'frm_view_forms' ) ) {
1069		- // Store the result in memory and re-use it when this function is called multiple times.
1070		- // This helps speed up the form builder when there are a lot of HTML fields, where this
1071		- // button is inserted once per HTML field.
1072		- // In a form with 66 HTML fields, this saves 0.5 seconds on page load time, tested locally.
1073		- if ( ! isset( self::$formidable_tinymce_button ) ) {
1074		- FrmAppHelper::load_admin_wide_js();
1075		- $menu_name = FrmAppHelper::get_menu_name();
1076		- $icon = apply_filters( 'frm_media_icon', FrmAppHelper::svg_logo() );
1077		- self::$formidable_tinymce_button = '<a href="#TB_inline?width=50&height=50&inlineId=frm_insert_form" class="thickbox button add_media frm_insert_form" title="' . esc_attr__( 'Add forms and content', 'formidable' ) . '">' . FrmAppHelper::kses( $icon, 'all' ) . ' ' . esc_html( $menu_name ) . '</a>';
1078		- }
1079		- echo self::$formidable_tinymce_button; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	737	+ FrmAppHelper::load_admin_wide_js();
	738	+ $menu_name = FrmAppHelper::get_menu_name();
	739	+ $icon = apply_filters( 'frm_media_icon', FrmAppHelper::svg_logo() );
	740	+ echo '<a href="#TB_inline?width=50&height=50&inlineId=frm_insert_form" class="thickbox button add_media frm_insert_form" title="' . esc_attr__( 'Add forms and content', 'formidable' ) . '">' .
	741	+ FrmAppHelper::kses( $icon, 'all' ) . // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	742	+ ' ' . esc_html( $menu_name ) . '</a>';
1080	743	}
1081	744	}
1082	745
1083	746	/**
		@@ -1121,9 +784,8 @@
1121	784	private static function should_insert_form_popup() {
1122	785	if ( FrmAppHelper::is_form_builder_page() ) {
1123	786	return true;
1124	787	}
1125		-
1126	788	$page = basename( FrmAppHelper::get_server_value( 'PHP_SELF' ) );
1127	789	return in_array( $page, array( 'post.php', 'page.php', 'page-new.php', 'post-new.php' ), true );
1128	790	}
1129	791
		@@ -1131,9 +793,8 @@
1131	793	FrmAppHelper::permission_check( 'frm_view_forms' );
1132	794	check_ajax_referer( 'frm_ajax', 'nonce' );
1133	795
1134	796	$shortcode = FrmAppHelper::get_post_param( 'shortcode', '', 'sanitize_text_field' );
1135		-
1136	797	if ( empty( $shortcode ) ) {
1137	798	wp_die();
1138	799	}
1139	800
		@@ -1159,9 +820,8 @@
1159	820	'label' => __( 'Minimize form HTML', 'formidable' ),
1160	821	),
1161	822	);
1162	823	}
1163		-
1164	824	$opts = apply_filters( 'frm_sc_popup_opts', $opts, $shortcode );
1165	825
1166	826	if ( isset( $opts['form_id'] ) && is_string( $opts['form_id'] ) ) {
1167	827	// allow other shortcodes to use the required form id option
		@@ -1168,9 +828,9 @@
1168	828	$form_id = $opts['form_id'];
1169	829	unset( $opts['form_id'] );
1170	830	}
1171	831
1172		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/shortcode_opts.php';
	832	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/shortcode_opts.php' );
1173	833
1174	834	echo '</div>';
1175	835
1176	836	wp_die();
		@@ -1181,9 +841,8 @@
1181	841	*
1182	842	* @param array $params
1183	843	* @param string $message
1184	844	* @param array $errors
1185		- *
1186	845	* @return void
1187	846	*/
1188	847	public static function display_forms_list( $params = array(), $message = '', $errors = array() ) {
1189	848	FrmAppHelper::permission_check( 'frm_view_forms' );
		@@ -1206,41 +865,29 @@
1206	865
1207	866	$wp_list_table->prepare_items();
1208	867
1209	868	$total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
1210		-
1211	869	if ( $pagenum > $total_pages && $total_pages > 0 ) {
1212	870	wp_redirect( esc_url_raw( add_query_arg( 'paged', $total_pages ) ) );
1213	871	die();
1214	872	}
1215	873
1216		- $inbox = new FrmInbox();
1217		- $error = $inbox->check_for_error();
1218		-
1219		- if ( $error ) {
1220		- $show_messages = array( $error['subject'] . '. ' . $error['message'] );
1221		- }
1222		-
1223	874	require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/list.php';
1224	875	}
1225	876
1226	877	/**
1227	878	* @param array<string,string> $columns
1228		- *
1229	879	* @return array<string,string>
1230	880	*/
1231	881	public static function get_columns( $columns ) {
1232		- $columns['cb'] = '<input type="checkbox" />';
1233		- $columns['name'] = esc_html__( 'Form Title', 'formidable' );
1234		- $columns['entries'] = esc_html__( 'Entries', 'formidable' );
1235		- $columns['id'] = 'ID';
1236		- $columns['form_key'] = esc_html__( 'Key', 'formidable' );
	882	+ $columns['cb'] = '<input type="checkbox" />';
	883	+ $columns['name'] = __( 'Form Title', 'formidable' );
	884	+ $columns['entries'] = __( 'Entries', 'formidable' );
	885	+ $columns['id'] = 'ID';
	886	+ $columns['form_key'] = __( 'Key', 'formidable' );
	887	+ $columns['shortcode'] = __( 'Actions', 'formidable' );
	888	+ $columns['created_at'] = __( 'Date', 'formidable' );
1237	889
1238		- if ( 'trash' !== FrmAppHelper::simple_get( 'form_type' ) ) {
1239		- $columns['shortcode'] = esc_html__( 'Actions', 'formidable' );
1240		- }
1241		- $columns['created_at'] = esc_html__( 'Date', 'formidable' );
1242		-
1243	890	add_screen_option(
1244	891	'per_page',
1245	892	array(
1246	893	'label' => __( 'Forms', 'formidable' ),
		@@ -1251,11 +898,8 @@
1251	898
1252	899	return $columns;
1253	900	}
1254	901
1255		- /**
1256		- * @return array<string,string>
1257		- */
1258	902	public static function get_sortable_columns() {
1259	903	return array(
1260	904	'id' => 'id',
1261	905	'name' => 'name',
		@@ -1266,9 +910,8 @@
1266	910	}
1267	911
1268	912	/**
1269	913	* @param mixed $hidden_columns
1270		- *
1271	914	* @return array
1272	915	*/
1273	916	public static function hidden_columns( $hidden_columns ) {
1274	917	if ( ! is_array( $hidden_columns ) ) {
		@@ -1289,17 +932,10 @@
1289	932
1290	933	return $hidden_columns;
1291	934	}
1292	935
1293		- /**
1294		- * @param mixed $save
1295		- * @param string $option
1296		- * @param int|string $value
1297		- *
1298		- * @return mixed
1299		- */
1300	936	public static function save_per_page( $save, $option, $value ) {
1301		- if ( $option === 'formidable_page_formidable_per_page' ) {
	937	+ if ( $option == 'formidable_page_formidable_per_page' ) {
1302	938	$save = (int) $value;
1303	939	}
1304	940
1305	941	return $save;
		@@ -1305,51 +941,146 @@
1305	941	return $save;
1306	942	}
1307	943
1308	944	/**
1309		- * @param int|string $id
1310		- * @param array $errors
1311		- * @param string $message
1312		- * @param bool $create_link
	945	+ * @return bool
	946	+ */
	947	+ public static function expired() {
	948	+ global $frm_expired;
	949	+ return $frm_expired;
	950	+ }
	951	+
	952	+ /**
	953	+ * Get data from api before rendering it so that we can flag the modal as expired
1313	954	*
1314	955	* @return void
1315	956	*/
1316		- private static function get_edit_vars( $id, $errors = array(), $message = '', $create_link = false ) {
1317		- global $frm_vars;
	957	+ public static function before_list_templates() {
	958	+ global $frm_templates;
	959	+ global $frm_expired;
	960	+ global $frm_license_type;
1318	961
1319		- $form = FrmForm::getOne( $id );
1320		- $error_args = array(
1321		- 'title' => __( 'You can\'t edit the form', 'formidable' ),
1322		- 'body' => __( 'You are trying to edit a form that does not exist', 'formidable' ),
1323		- 'cancel_url' => admin_url( 'admin.php?page=formidable' ),
1324		- 'continue_url' => add_query_arg(
1325		- array(
1326		- 'page' => 'formidable',
1327		- )
1328		- ),
	962	+ $api = new FrmFormTemplateApi();
	963	+ $frm_templates = $api->get_api_info();
	964	+ $expired = false;
	965	+ $license_type = '';
	966	+ if ( isset( $frm_templates['error'] ) ) {
	967	+ $error = $frm_templates['error']['message'];
	968	+ $error = str_replace( 'utm_medium=addons', 'utm_medium=form-templates', $error );
	969	+ $expired = 'expired' === $frm_templates['error']['code'];
	970	+ $license_type = isset( $frm_templates['error']['type'] ) ? $frm_templates['error']['type'] : '';
	971	+ unset( $frm_templates['error'] );
	972	+ }
	973	+
	974	+ $frm_expired = $expired;
	975	+ $frm_license_type = $license_type;
	976	+ }
	977	+
	978	+ /**
	979	+ * @return void
	980	+ */
	981	+ public static function list_templates() {
	982	+ global $frm_templates;
	983	+ global $frm_license_type;
	984	+
	985	+ $templates = $frm_templates;
	986	+ $custom_templates = array();
	987	+ $templates_by_category = array();
	988	+
	989	+ self::add_user_templates( $custom_templates );
	990	+
	991	+ foreach ( $templates as $template ) {
	992	+ if ( ! isset( $template['categories'] ) ) {
	993	+ continue;
	994	+ }
	995	+
	996	+ foreach ( $template['categories'] as $category ) {
	997	+ if ( ! isset( $templates_by_category[ $category ] ) ) {
	998	+ $templates_by_category[ $category ] = array();
	999	+ }
	1000	+
	1001	+ $templates_by_category[ $category ][] = $template;
	1002	+ }
	1003	+ }
	1004	+ unset( $template );
	1005	+
	1006	+ // Subcategories that are included elsewhere.
	1007	+ $redundant_cats = array( 'PayPal', 'Stripe', 'Twilio' );
	1008	+
	1009	+ $categories = array_keys( $templates_by_category );
	1010	+ $categories = array_diff( $categories, FrmFormsHelper::ignore_template_categories() );
	1011	+ $categories = array_diff( $categories, $redundant_cats );
	1012	+ sort( $categories );
	1013	+
	1014	+ array_walk(
	1015	+ $custom_templates,
	1016	+ function( &$template ) {
	1017	+ $template['custom'] = true;
	1018	+ }
1329	1019	);
1330	1020
1331		- if ( ! $form ) {
1332		- FrmAppController::show_error_modal( $error_args );
1333		- return;
	1021	+ $my_templates_translation = __( 'My Templates', 'formidable' );
	1022	+ $categories = array_merge( array( $my_templates_translation ), $categories );
	1023	+ $pricing = FrmAppHelper::admin_upgrade_link( 'form-templates' );
	1024	+ $license_type = $frm_license_type;
	1025	+ $args = compact( 'pricing', 'license_type' );
	1026	+ $where = apply_filters( 'frm_forms_dropdown', array(), '' );
	1027	+ $forms = FrmForm::get_published_forms( $where );
	1028	+ $view_path = FrmAppHelper::plugin_path() . '/classes/views/frm-forms/';
	1029	+
	1030	+ $templates_by_category[ $my_templates_translation ] = $custom_templates;
	1031	+
	1032	+ unset( $pricing, $license_type, $where );
	1033	+ wp_enqueue_script( 'accordion' ); // register accordion for template groups
	1034	+ require $view_path . 'list-templates.php';
	1035	+ }
	1036	+
	1037	+ /**
	1038	+ * @since 4.03.01
	1039	+ */
	1040	+ private static function get_template_categories( $templates ) {
	1041	+ $categories = array();
	1042	+ foreach ( $templates as $template ) {
	1043	+ if ( isset( $template['categories'] ) ) {
	1044	+ $categories = array_merge( $categories, $template['categories'] );
	1045	+ }
1334	1046	}
	1047	+ $exclude_cats = FrmFormsHelper::ignore_template_categories();
	1048	+ $categories = array_unique( $categories );
	1049	+ $categories = array_diff( $categories, $exclude_cats );
	1050	+ sort( $categories );
	1051	+ return $categories;
	1052	+ }
1335	1053
1336		- if ( 'trash' === $form->status ) {
1337		- $error_args['body'] = __( 'The form you\'re trying to edit is in trash. You must restore it first before you can make changes', 'formidable' );
1338		- $error_args['continue_url'] = add_query_arg(
1339		- array(
1340		- 'page' => 'formidable',
1341		- '_wpnonce' => wp_create_nonce( 'untrash_form_' . $id ),
1342		- 'form_type' => 'trash',
1343		- 'frm_action' => 'untrash',
1344		- 'id' => $id,
1345		- )
	1054	+ private static function add_user_templates( &$templates ) {
	1055	+ $user_templates = array(
	1056	+ 'is_template' => 1,
	1057	+ 'default_template' => 0,
	1058	+ );
	1059	+ $user_templates = FrmForm::getAll( $user_templates, 'name' );
	1060	+ foreach ( $user_templates as $template ) {
	1061	+ $template = array(
	1062	+ 'id' => $template->id,
	1063	+ 'name' => $template->name,
	1064	+ 'key' => $template->form_key,
	1065	+ 'description' => $template->description,
	1066	+ 'url' => wp_nonce_url( admin_url( 'admin.php?page=formidable&frm_action=duplicate&id=' . absint( $template->id ) ) ),
	1067	+ 'released' => $template->created_at,
	1068	+ 'installed' => 1,
1346	1069	);
1347		- $error_args['continue_text'] = __( 'Restore form', 'formidable' );
1348		- FrmAppController::show_error_modal( $error_args );
1349		- return;
	1070	+ array_unshift( $templates, $template );
	1071	+ unset( $template );
1350	1072	}
	1073	+ }
1351	1074
	1075	+ private static function get_edit_vars( $id, $errors = array(), $message = '', $create_link = false ) {
	1076	+ global $frm_vars;
	1077	+
	1078	+ $form = FrmForm::getOne( $id );
	1079	+ if ( ! $form ) {
	1080	+ wp_die( esc_html__( 'You are trying to edit a form that does not exist.', 'formidable' ) );
	1081	+ }
	1082	+
1352	1083	if ( $form->parent_form_id ) {
1353	1084	/* translators: %1$s: Start link HTML, %2$s: End link HTML */
1354	1085	wp_die( sprintf( esc_html__( 'You are trying to edit a child form. Please edit from %1$shere%2$s', 'formidable' ), '<a href="' . esc_url( FrmForm::get_edit_link( $form->parent_form_id ) ) . '">', '</a>' ) );
1355	1086	}
		@@ -1360,9 +1091,8 @@
1360	1091
1361	1092	// Automatically add end section fields if they don't exist (2.0 migration).
1362	1093	$reset_fields = false;
1363	1094	FrmFormsHelper::auto_add_end_section_fields( $form, $fields, $reset_fields );
1364		- FrmSubmitHelper::maybe_create_submit_field( $form, $fields, $reset_fields );
1365	1095
1366	1096	if ( $reset_fields ) {
1367	1097	$fields = FrmField::get_all_for_form( $form->id, '', 'exclude' );
1368	1098	}
		@@ -1382,9 +1112,8 @@
1382	1112	*/
1383	1113	$values['fields'] = apply_filters( 'frm_fields_in_form_builder', $fields, compact( 'form' ) );
1384	1114
1385	1115	$edit_message = __( 'Form was successfully updated.', 'formidable' );
1386		-
1387	1116	if ( $form->is_template && $message == $edit_message ) {
1388	1117	$message = __( 'Template was successfully updated.', 'formidable' );
1389	1118	}
1390	1119
		@@ -1389,23 +1118,19 @@
1389	1118	}
1390	1119
1391	1120	self::maybe_update_form_builder_message( $message );
1392	1121
1393		- $has_fields = ! empty( $values['fields'] ) && ! FrmSubmitHelper::only_contains_submit_field( $values['fields'] );
	1122	+ $all_templates = FrmForm::getAll( array( 'is_template' => 1 ), 'name' );
	1123	+ $has_fields = isset( $values['fields'] ) && ! empty( $values['fields'] );
1394	1124
1395	1125	if ( defined( 'DOING_AJAX' ) ) {
1396	1126	wp_die();
	1127	+ } else {
	1128	+ require( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/edit.php' );
1397	1129	}
1398		-
1399		- require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/edit.php';
1400	1130	}
1401	1131
1402		- /**
1403		- * @param array $fields
1404		- *
1405		- * @return array
1406		- */
1407		- public static function update_form_builder_fields( $fields ) {
	1132	+ public static function update_form_builder_fields( $fields, $form ) {
1408	1133	foreach ( $fields as $field ) {
1409	1134	$field->do_not_include_icons = true;
1410	1135	}
1411	1136	return $fields;
		@@ -1410,13 +1135,8 @@
1410	1135	}
1411	1136	return $fields;
1412	1137	}
1413	1138
1414		- /**
1415		- * @param string $message
1416		- *
1417		- * @return void
1418		- */
1419	1139	public static function maybe_update_form_builder_message( &$message ) {
1420	1140	if ( 'form_duplicated' === FrmAppHelper::simple_get( 'message' ) ) {
1421	1141	$message = __( 'Form was Successfully Copied', 'formidable' );
1422	1142	}
		@@ -1421,22 +1141,13 @@
1421	1141	$message = __( 'Form was Successfully Copied', 'formidable' );
1422	1142	}
1423	1143	}
1424	1144
1425		- /**
1426		- * @param int|string $id
1427		- * @param array $errors
1428		- * @param array|string $args
1429		- *
1430		- * @return void
1431		- */
1432	1145	public static function get_settings_vars( $id, $errors = array(), $args = array() ) {
1433	1146	FrmAppHelper::permission_check( 'frm_edit_forms' );
1434	1147
1435	1148	global $frm_vars;
1436	1149
1437		- self::maybe_print_media_templates();
1438		-
1439	1150	if ( ! is_array( $args ) ) {
1440	1151	// For reverse compatibility.
1441	1152	$args = array(
1442	1153	'message' => $args,
		@@ -1469,42 +1180,17 @@
1469	1180
1470	1181	$sections = self::get_settings_tabs( $values );
1471	1182	$current = FrmAppHelper::simple_get( 't', 'sanitize_title', 'advanced_settings' );
1472	1183
1473		- require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings.php';
	1184	+ require( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings.php' );
1474	1185	}
1475	1186
1476	1187	/**
1477		- * Print WordPress media templates email actions does not trigger a "Uncaught Error: Template not found: #tmpl-media-selection" error when the media button is clicked.
1478		- *
1479		- * @since 6.10
1480		- *
1481		- * @return void
1482		- */
1483		- private static function maybe_print_media_templates() {
1484		- if ( FrmAppHelper::pro_is_included() ) {
1485		- // This issue does not exist when Pro is active so exit early.
1486		- return;
1487		- }
1488		-
1489		- add_action(
1490		- 'wp_enqueue_editor',
1491		- function () {
1492		- wp_print_media_templates();
1493		- }
1494		- );
1495		- }
1496		-
1497		- /**
1498	1188	* @since 4.0
1499		- *
1500		- * @param array $atts
1501		- *
1502		- * @return void
1503	1189	*/
1504	1190	public static function form_publish_button( $atts ) {
1505	1191	$values = $atts['values'];
1506		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/_publish_box.php';
	1192	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/_publish_box.php' );
1507	1193	}
1508	1194
1509	1195	/**
1510	1196	* Get a list of all the settings tabs for the form settings page.
		@@ -1511,9 +1197,8 @@
1511	1197	*
1512	1198	* @since 4.0
1513	1199	*
1514	1200	* @param array $values
1515		- *
1516	1201	* @return array
1517	1202	*/
1518	1203	private static function get_settings_tabs( $values ) {
1519	1204	$sections = array(
		@@ -1519,9 +1204,9 @@
1519	1204	$sections = array(
1520	1205	'advanced' => array(
1521	1206	'name' => __( 'General', 'formidable' ),
1522	1207	'title' => __( 'General Form Settings', 'formidable' ),
1523		- 'function' => array( self::class, 'advanced_settings' ),
	1208	+ 'function' => array( __CLASS__, 'advanced_settings' ),
1524	1209	'icon' => 'frm_icon_font frm_settings_icon',
1525	1210	),
1526	1211	'email' => array(
1527	1212	'name' => __( 'Actions & Notifications', 'formidable' ),
		@@ -1530,9 +1215,9 @@
1530	1215	'icon' => 'frm_icon_font frm_mail_bulk_icon',
1531	1216	),
1532	1217	'permissions' => array(
1533	1218	'name' => __( 'Form Permissions', 'formidable' ),
1534		- 'icon' => 'frm_icon_font frm_lock_closed_icon',
	1219	+ 'icon' => 'frm_icon_font frm_lock_icon',
1535	1220	'html_class' => 'frm_show_upgrade_tab frm_noallow',
1536	1221	'data' => array(
1537	1222	'medium' => 'permissions',
1538	1223	'upgrade' => __( 'Form Permissions', 'formidable' ),
		@@ -1537,12 +1222,11 @@
1537	1222	'medium' => 'permissions',
1538	1223	'upgrade' => __( 'Form Permissions', 'formidable' ),
1539	1224	'message' => __( 'Allow editing, protect forms and files, limit entries, and save drafts. Upgrade to get form and entry permissions.', 'formidable' ),
1540	1225	'screenshot' => 'permissions.png',
1541		- 'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-permissions', 'form-permissions-settings' ),
1542	1226	),
1543	1227	),
1544		- 'scheduling' => array(
	1228	+ 'scheduling' => array(
1545	1229	'name' => __( 'Form Scheduling', 'formidable' ),
1546	1230	'icon' => 'frm_icon_font frm_calendar_icon',
1547	1231	'html_class' => 'frm_show_upgrade_tab frm_noallow',
1548	1232	'data' => array(
		@@ -1548,14 +1232,13 @@
1548	1232	'data' => array(
1549	1233	'medium' => 'scheduling',
1550	1234	'upgrade' => __( 'Form scheduling settings', 'formidable' ),
1551	1235	'screenshot' => 'scheduling.png',
1552		- 'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-scheduling', 'form-scheduling-settings' ),
1553	1236	),
1554	1237	),
1555	1238	'buttons' => array(
1556	1239	'name' => __( 'Buttons', 'formidable' ),
1557		- 'class' => self::class,
	1240	+ 'class' => __CLASS__,
1558	1241	'function' => 'buttons_settings',
1559	1242	'icon' => 'frm_icon_font frm_button_icon',
1560	1243	),
1561	1244	'landing' => array(
		@@ -1573,40 +1256,32 @@
1573	1256	array(
1574	1257	'upgrade' => __( 'Conversational Forms', 'formidable' ),
1575	1258	'message' => __( 'Ask one question at a time for automated conversations.', 'formidable' ),
1576	1259	'screenshot' => 'chat.png',
1577		- 'learn-more' => FrmAppHelper::get_doc_url( 'conversational-forms', 'conversational-forms-settings', false ),
1578	1260	)
1579	1261	),
1580	1262	),
1581		- 'abandonment' => array(
1582		- 'name' => __( 'Form Abandonment', 'formidable' ),
1583		- 'icon' => 'frm_icon_font frm_abandoned_icon',
1584		- 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1585		- 'data' => FrmAppHelper::get_upgrade_data_params(
1586		- 'abandonment',
1587		- array(
1588		- 'upgrade' => __( 'Form abandonment settings', 'formidable' ),
1589		- 'message' => __( 'Unlock the power of data capture to boost lead generation and master the art of form optimization.', 'formidable' ),
1590		- 'screenshot' => 'abandonment.png',
1591		- 'learn-more' => FrmAppHelper::get_doc_url( 'features/form-abandonment-wordpress-plugin', 'form-abandonment-settings', false ),
1592		- )
1593		- ),
1594		- ),
1595	1263	'html' => array(
1596	1264	'name' => __( 'Customize HTML', 'formidable' ),
1597		- 'class' => self::class,
	1265	+ 'class' => __CLASS__,
1598	1266	'function' => 'html_settings',
1599	1267	'icon' => 'frm_icon_font frm_code_icon',
1600	1268	),
1601	1269	);
1602	1270
1603		- if ( ! has_action( 'frm_add_form_style_tab_options' ) && ! has_action( 'frm_add_form_button_options' ) ) {
1604		- unset( $sections['buttons'] );
	1271	+ foreach ( array( 'landing', 'chat' ) as $feature ) {
	1272	+ if ( ! FrmAppHelper::show_new_feature( $feature ) ) {
	1273	+ unset( $sections[ $feature ] );
	1274	+ }
1605	1275	}
1606	1276
1607	1277	$sections = apply_filters( 'frm_add_form_settings_section', $sections, $values );
1608	1278
	1279	+ if ( FrmAppHelper::pro_is_installed() && ! FrmAppHelper::meets_min_pro_version( '4.0' ) ) {
	1280	+ // Prevent settings from showing in 2 spots.
	1281	+ unset( $sections['permissions'], $sections['scheduling'] );
	1282	+ }
	1283	+
1609	1284	foreach ( $sections as $key => $section ) {
1610	1285	$defaults = array(
1611	1286	'html_class' => '',
1612	1287	'name' => ucfirst( $key ),
		@@ -1628,9 +1303,9 @@
1628	1303	$section['id'] = $section['anchor'];
1629	1304	}
1630	1305
1631	1306	$sections[ $key ] = $section;
1632		- }//end foreach
	1307	+ }
1633	1308
1634	1309	return $sections;
1635	1310	}
1636	1311
		@@ -1637,10 +1312,8 @@
1637	1312	/**
1638	1313	* @since 4.0
1639	1314	*
1640	1315	* @param array $values
1641		- *
1642		- * @return void
1643	1316	*/
1644	1317	public static function advanced_settings( $values ) {
1645	1318	$first_h3 = 'frm_first_h3';
1646	1319
		@@ -1648,16 +1321,14 @@
1648	1321	}
1649	1322
1650	1323	/**
1651	1324	* @param array $values
1652		- *
1653		- * @return void
1654	1325	*/
1655		- public static function render_spam_settings( $values ) {
	1326	+ private static function render_spam_settings( $values ) {
1656	1327	if ( function_exists( 'akismet_http_post' ) ) {
1657	1328	include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/akismet.php';
1658	1329	}
1659		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/stopforumspam.php';
	1330	+ include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/honeypot.php';
1660	1331	include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/antispam.php';
1661	1332	}
1662	1333
1663	1334	/**
		@@ -1663,13 +1334,16 @@
1663	1334	/**
1664	1335	* @since 4.0
1665	1336	*
1666	1337	* @param array $values
1667		- *
1668		- * @return void
1669	1338	*/
1670	1339	public static function buttons_settings( $values ) {
1671		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-buttons.php';
	1340	+ $styles = apply_filters( 'frm_get_style_opts', array() );
	1341	+
	1342	+ $frm_settings = FrmAppHelper::get_settings();
	1343	+ $no_global_style = $frm_settings->load_style === 'none';
	1344	+
	1345	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-buttons.php' );
1672	1346	}
1673	1347
1674	1348	/**
1675	1349	* @since 4.0
		@@ -1674,13 +1348,11 @@
1674	1348	/**
1675	1349	* @since 4.0
1676	1350	*
1677	1351	* @param array $values
1678		- *
1679		- * @return void
1680	1352	*/
1681	1353	public static function html_settings( $values ) {
1682		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-html.php';
	1354	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-html.php' );
1683	1355	}
1684	1356
1685	1357	/**
1686	1358	* Replace old Submit Button href with new href to avoid errors in Chrome
		@@ -1686,11 +1358,9 @@
1686	1358	* Replace old Submit Button href with new href to avoid errors in Chrome
1687	1359	*
1688	1360	* @since 2.03.08
1689	1361	*
1690		- * @param array|bool $values
1691		- *
1692		- * @return void
	1362	+ * @param array|boolean $values
1693	1363	*/
1694	1364	private static function clean_submit_html( &$values ) {
1695	1365	if ( is_array( $values ) && isset( $values['submit_html'] ) ) {
1696	1366	$values['submit_html'] = str_replace( 'javascript:void(0)', '#', $values['submit_html'] );
		@@ -1711,14 +1381,8 @@
1711	1381
1712	1382	return $classes;
1713	1383	}
1714	1384
1715		- /**
1716		- * @param int|string $form_id
1717		- * @param string $class
1718		- *
1719		- * @return void
1720		- */
1721	1385	public static function mb_tags_box( $form_id, $class = '' ) {
1722	1386	$fields = FrmField::get_all_for_form( $form_id, '', 'include' );
1723	1387
1724	1388	/**
		@@ -1731,9 +1395,9 @@
1731	1395	*/
1732	1396	$fields = apply_filters( 'frm_fields_in_tags_box', $fields, compact( 'form_id' ) );
1733	1397	$linked_forms = array();
1734	1398	$col = 'one';
1735		- $settings_tab = FrmAppHelper::is_admin_page( 'formidable' );
	1399	+ $settings_tab = FrmAppHelper::is_admin_page( 'formidable' ) ? true : false;
1736	1400
1737	1401	$cond_shortcodes = apply_filters( 'frm_conditional_shortcodes', array() );
1738	1402	$entry_shortcodes = self::get_shortcode_helpers( $settings_tab );
1739	1403
		@@ -1738,17 +1402,13 @@
1738	1402	$entry_shortcodes = self::get_shortcode_helpers( $settings_tab );
1739	1403
1740	1404	$advanced_helpers = self::advanced_helpers( compact( 'fields', 'form_id' ) );
1741	1405
1742		- include FrmAppHelper::plugin_path() . '/classes/views/shared/mb_adv_info.php';
	1406	+ include( FrmAppHelper::plugin_path() . '/classes/views/shared/mb_adv_info.php' );
1743	1407	}
1744	1408
1745	1409	/**
1746	1410	* @since 3.04.01
1747		- *
1748		- * @param array $atts
1749		- *
1750		- * @return array
1751	1411	*/
1752	1412	private static function advanced_helpers( $atts ) {
1753	1413	$advanced_helpers = array(
1754	1414	'default' => array(
		@@ -1757,12 +1417,10 @@
1757	1417	),
1758	1418	);
1759	1419
1760	1420	$user_fields = self::user_shortcodes();
1761		-
1762		- if ( $user_fields ) {
	1421	+ if ( ! empty( $user_fields ) ) {
1763	1422	$user_helpers = array();
1764		-
1765	1423	foreach ( $user_fields as $uk => $uf ) {
1766	1424	$user_helpers[ '|user_id| show="' . $uk . '"' ] = $uf;
1767	1425	unset( $uk, $uf );
1768	1426	}
		@@ -1767,9 +1425,9 @@
1767	1425	unset( $uk, $uf );
1768	1426	}
1769	1427
1770	1428	$advanced_helpers['user_id'] = array(
1771		- 'codes' => $user_helpers,
	1429	+ 'codes' => $user_helpers,
1772	1430	);
1773	1431	}
1774	1432
1775	1433	/**
		@@ -1787,10 +1445,8 @@
1787	1445	* Get an array of the options to display in the advanced tab
1788	1446	* of the customization panel
1789	1447	*
1790	1448	* @since 2.0.6
1791		- *
1792		- * @return array
1793	1449	*/
1794	1450	private static function get_advanced_shortcodes() {
1795	1451	$adv_shortcodes = array(
1796	1452	'x sep=", "' => array(
		@@ -1816,10 +1472,8 @@
1816	1472	}
1817	1473
1818	1474	/**
1819	1475	* @since 3.04.01
1820		- *
1821		- * @return array
1822	1476	*/
1823	1477	private static function user_shortcodes() {
1824	1478	$options = array(
1825	1479	'ID' => __( 'User ID', 'formidable' ),
		@@ -1838,12 +1492,8 @@
1838	1492	/**
1839	1493	* Get an array of the helper shortcodes to display in the customization panel
1840	1494	*
1841	1495	* @since 2.0.6
1842		- *
1843		- * @param bool $settings_tab
1844		- *
1845		- * @return array
1846	1496	*/
1847	1497	private static function get_shortcode_helpers( $settings_tab ) {
1848	1498	$entry_shortcodes = array(
1849	1499	'id' => __( 'Entry ID', 'formidable' ),
		@@ -1854,25 +1504,26 @@
1854	1504	'updated-at' => __( 'Entry updated', 'formidable' ),
1855	1505	'' => '',
1856	1506	'siteurl' => __( 'Site URL', 'formidable' ),
1857	1507	'sitename' => __( 'Site Name', 'formidable' ),
1858		- 'form_name' => __( 'Form Name', 'formidable' ),
1859	1508	);
1860	1509
1861		- $entry_shortcodes = array_merge( FrmShortcodeHelper::get_contextual_shortcode_values(), $entry_shortcodes );
1862		-
1863	1510	if ( ! FrmAppHelper::pro_is_installed() ) {
1864	1511	unset( $entry_shortcodes['post_id'] );
1865	1512	}
1866	1513
	1514	+ if ( $settings_tab ) {
	1515	+ $entry_shortcodes['default-message'] = __( 'Default Msg', 'formidable' );
	1516	+ $entry_shortcodes['default-html'] = __( 'Default HTML', 'formidable' );
	1517	+ $entry_shortcodes['default-plain'] = __( 'Default Plain', 'formidable' );
	1518	+ $entry_shortcodes['form_name'] = __( 'Form Name', 'formidable' );
	1519	+ }
	1520	+
1867	1521	/**
1868	1522	* Use this hook to add or remove buttons in the helpers section
1869	1523	* in the customization panel
1870	1524	*
1871	1525	* @since 2.0.6
1872		- *
1873		- * @param array $entry_shortcodes
1874		- * @param bool $settings_tab
1875	1526	*/
1876	1527	$entry_shortcodes = apply_filters( 'frm_helper_shortcodes', $entry_shortcodes, $settings_tab );
1877	1528
1878	1529	return $entry_shortcodes;
		@@ -1878,13 +1529,9 @@
1878	1529	return $entry_shortcodes;
1879	1530	}
1880	1531
1881	1532	/**
1882		- * Insert the form class setting into the form.
1883		- *
1884		- * @param stdClass $form
1885		- *
1886		- * @return void
	1533	+ * Insert the form class setting into the form
1887	1534	*/
1888	1535	public static function form_classes( $form ) {
1889	1536	if ( isset( $form->options['form_class'] ) ) {
1890	1537	echo esc_attr( sanitize_text_field( $form->options['form_class'] ) );
		@@ -1893,12 +1540,8 @@
1893	1540	if ( ! empty( $form->options['js_validate'] ) ) {
1894	1541	echo ' frm_js_validate ';
1895	1542	self::add_js_validate_form_to_global_vars( $form );
1896	1543	}
1897		-
1898		- if ( FrmForm::is_ajax_on( $form ) ) {
1899		- echo ' frm_ajax_submit ';
1900		- }
1901	1544	}
1902	1545
1903	1546	/**
1904	1547	* @since 5.0.03
		@@ -1906,9 +1549,8 @@
1906	1549	* @param stdClass $form
1907	1550	*/
1908	1551	public static function add_js_validate_form_to_global_vars( $form ) {
1909	1552	global $frm_vars;
1910		-
1911	1553	if ( ! isset( $frm_vars['js_validate_forms'] ) ) {
1912	1554	$frm_vars['js_validate_forms'] = array();
1913	1555	}
1914	1556	$frm_vars['js_validate_forms'][ $form->id ] = $form;
		@@ -1919,11 +1561,11 @@
1919	1561	check_ajax_referer( 'frm_ajax', 'nonce' );
1920	1562
1921	1563	echo FrmEntriesController::show_entry_shortcode( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1922	1564	array(
1923		- 'form_id' => FrmAppHelper::get_post_param( 'form_id', '', 'absint' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	1565	+ 'form_id' => FrmAppHelper::get_post_param( 'form_id', '', 'absint' ),
1924	1566	'default_email' => true,
1925		- 'plain_text' => FrmAppHelper::get_post_param( 'plain_text', '', 'absint' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	1567	+ 'plain_text' => FrmAppHelper::get_post_param( 'plain_text', '', 'absint' ),
1926	1568	)
1927	1569	);
1928	1570	wp_die();
1929	1571	}
		@@ -1929,11 +1571,10 @@
1929	1571	}
1930	1572
1931	1573	/**
1932	1574	* @param string $content
1933		- * @param int|stdClass|string $form
1934		- * @param false|int|stdClass|string $entry
1935		- *
	1575	+ * @param stdClass|string|int $form
	1576	+ * @param stdClass|string|int|false $entry
1936	1577	* @return string
1937	1578	*/
1938	1579	public static function filter_content( $content, $form, $entry = false ) {
1939	1580	$content = self::replace_form_name_shortcodes( $content, $form );
		@@ -1938,9 +1579,8 @@
1938	1579	public static function filter_content( $content, $form, $entry = false ) {
1939	1580	$content = self::replace_form_name_shortcodes( $content, $form );
1940	1581
1941	1582	self::get_entry_by_param( $entry );
1942		-
1943	1583	if ( ! $entry ) {
1944	1584	return $content;
1945	1585	}
1946	1586
		@@ -1947,16 +1587,8 @@
1947	1587	if ( is_object( $form ) ) {
1948	1588	$form = $form->id;
1949	1589	}
1950	1590
1951		- /*
1952		- * Repeater actions adds `parent_entry` to `$entry` store the parent entry data. If `parent_entry` is not empty,
1953		- * use the parent form ID instead of repeater form ID to fix the parent form field shortcodes doesn't work.
1954		- */
1955		- if ( ! empty( $entry->parent_entry ) ) {
1956		- $form = $entry->parent_entry->form_id;
1957		- }
1958		-
1959	1591	$shortcodes = FrmFieldsHelper::get_shortcodes( $content, $form );
1960	1592	$content = apply_filters( 'frm_replace_content_shortcodes', $content, $entry, $shortcodes );
1961	1593
1962	1594	return $content;
		@@ -1966,18 +1598,13 @@
1966	1598	* Replace any [form_name] shortcodes in a string.
1967	1599	*
1968	1600	* @since 5.5
1969	1601	*
1970		- * @param array|string $string
1971		- * @param int|stdClass|string $form
1972		- *
1973		- * @return array|string
	1602	+ * @param string $string
	1603	+ * @param stdClass|string|int $form
	1604	+ * @return string
1974	1605	*/
1975	1606	public static function replace_form_name_shortcodes( $string, $form ) {
1976		- if ( ! is_string( $string ) ) {
1977		- return $string;
1978		- }
1979		-
1980	1607	if ( false === strpos( $string, '[form_name]' ) ) {
1981	1608	return $string;
1982	1609	}
1983	1610
		@@ -1989,10 +1616,9 @@
1989	1616	return str_replace( '[form_name]', $form_name, $string );
1990	1617	}
1991	1618
1992	1619	/**
1993		- * @param false|int|stdClass|string $entry
1994		- *
	1620	+ * @param stdClass|string|int|false $entry
1995	1621	* @return void
1996	1622	*/
1997	1623	private static function get_entry_by_param( &$entry ) {
1998	1624	if ( ! $entry || ! is_object( $entry ) ) {
		@@ -2003,24 +1629,12 @@
2003	1629	FrmEntry::maybe_get_entry( $entry );
2004	1630	}
2005	1631	}
2006	1632
2007		- /**
2008		- * @param string $content
2009		- * @param false|object $entry
2010		- * @param array $shortcodes
2011		- *
2012		- * @return string
2013		- */
2014	1633	public static function replace_content_shortcodes( $content, $entry, $shortcodes ) {
2015	1634	return FrmFieldsHelper::replace_content_shortcodes( $content, $entry, $shortcodes );
2016	1635	}
2017	1636
2018		- /**
2019		- * @param array $errors
2020		- *
2021		- * @return array
2022		- */
2023	1637	public static function process_bulk_form_actions( $errors ) {
2024	1638	if ( ! $_REQUEST ) {
2025	1639	return $errors;
2026	1640	}
		@@ -2025,9 +1639,8 @@
2025	1639	return $errors;
2026	1640	}
2027	1641
2028	1642	$bulkaction = FrmAppHelper::get_param( 'action', '', 'get', 'sanitize_text_field' );
2029		-
2030	1643	if ( $bulkaction == - 1 ) {
2031	1644	$bulkaction = FrmAppHelper::get_param( 'action2', '', 'get', 'sanitize_title' );
2032	1645	}
2033	1646
		@@ -2037,9 +1650,8 @@
2037	1650	$bulkaction = str_replace( 'bulk_', '', $bulkaction );
2038	1651	}
2039	1652
2040	1653	$ids = FrmAppHelper::get_param( 'item-action', '', 'get', 'sanitize_text_field' );
2041		-
2042	1654	if ( empty( $ids ) ) {
2043	1655	$errors[] = __( 'No forms were specified', 'formidable' );
2044	1656
2045	1657	return $errors;
		@@ -2045,9 +1657,8 @@
2045	1657	return $errors;
2046	1658	}
2047	1659
2048	1660	$permission_error = FrmAppHelper::permission_nonce_error( '', '_wpnonce', 'bulk-toplevel_page_formidable' );
2049		-
2050	1661	if ( $permission_error !== false ) {
2051	1662	$errors[] = $permission_error;
2052	1663
2053	1664	return $errors;
		@@ -2067,9 +1678,9 @@
2067	1678	case 'untrash':
2068	1679	$message = self::bulk_untrash( $ids );
2069	1680	}
2070	1681
2071		- if ( ! empty( $message ) ) {
	1682	+ if ( isset( $message ) && ! empty( $message ) ) {
2072	1683	$errors['message'] = $message;
2073	1684	}
2074	1685
2075	1686	return $errors;
		@@ -2074,23 +1685,8 @@
2074	1685
2075	1686	return $errors;
2076	1687	}
2077	1688
2078		- /**
2079		- * Includes html that shows a message when the device is too small to use Formidable Forms admin pages.
2080		- *
2081		- * @since 6.20
2082		- *
2083		- * @return void
2084		- */
2085		- public static function include_device_too_small_message() {
2086		- if ( ! FrmAppHelper::is_formidable_admin() ) {
2087		- return;
2088		- }
2089		-
2090		- include FrmAppHelper::plugin_path() . '/classes/views/shared/small-device-message.php';
2091		- }
2092		-
2093	1689	public static function route() {
2094	1690	$action = isset( $_REQUEST['frm_action'] ) ? 'frm_action' : 'action';
2095	1691	$vars = array();
2096	1692	FrmAppHelper::include_svg();
		@@ -2101,14 +1697,12 @@
2101	1697	// Javascript needs to be allowed in some field settings.
2102	1698	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
2103	1699	$json_vars = htmlspecialchars_decode( nl2br( str_replace( '&quot;', '"', wp_unslash( $_POST['frm_compact_fields'] ) ) ) );
2104	1700	$json_vars = json_decode( $json_vars, true );
2105		-
2106	1701	if ( empty( $json_vars ) ) {
2107	1702	// json decoding failed so we should return an error message.
2108	1703	$action = FrmAppHelper::get_param( $action, '', 'get', 'sanitize_title' );
2109		-
2110		- if ( 'edit' === $action ) {
	1704	+ if ( 'edit' == $action ) {
2111	1705	$action = 'update';
2112	1706	}
2113	1707
2114	1708	add_filter( 'frm_validate_form', 'FrmFormsController::json_error' );
		@@ -2120,19 +1714,20 @@
2120	1714	$_POST = array_merge( $_POST, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
2121	1715	}
2122	1716	} else {
2123	1717	$action = FrmAppHelper::get_param( $action, '', 'get', 'sanitize_title' );
2124		-
2125	1718	if ( isset( $_REQUEST['delete_all'] ) ) {
2126	1719	// Override the action for this page.
2127	1720	$action = 'delete_all';
2128	1721	}
2129		- }//end if
	1722	+ }
2130	1723
2131	1724	add_action( 'frm_load_form_hooks', 'FrmHooksController::trigger_load_form_hooks' );
2132	1725	FrmAppHelper::trigger_hook_load( 'form' );
2133	1726
2134	1727	switch ( $action ) {
	1728	+ case 'new':
	1729	+ return self::new_form( $vars );
2135	1730	case 'create':
2136	1731	case 'edit':
2137	1732	case 'update':
2138	1733	case 'trash':
		@@ -2137,26 +1732,23 @@
2137	1732	case 'update':
2138	1733	case 'trash':
2139	1734	case 'untrash':
2140	1735	case 'destroy':
	1736	+ case 'delete_all':
2141	1737	case 'settings':
2142	1738	case 'update_settings':
2143	1739	return self::$action( $vars );
2144	1740	case 'lite-reports':
2145		- self::no_reports( $vars );
2146		- return;
	1741	+ return self::no_reports( $vars );
2147	1742	case 'views':
2148		- self::no_views( $vars );
2149		- return;
	1743	+ return self::no_views( $vars );
2150	1744	default:
2151	1745	do_action( 'frm_form_action_' . $action );
2152		-
2153	1746	if ( apply_filters( 'frm_form_stop_action_' . $action, false ) ) {
2154	1747	return;
2155	1748	}
2156	1749
2157	1750	$action = FrmAppHelper::get_param( 'action', '', 'get', 'sanitize_text_field' );
2158		-
2159	1751	if ( $action == - 1 ) {
2160	1752	$action = FrmAppHelper::get_param( 'action2', '', 'get', 'sanitize_title' );
2161	1753	}
2162	1754
		@@ -2167,83 +1759,32 @@
2167	1759	return;
2168	1760	}
2169	1761
2170	1762	$message = FrmAppHelper::get_param( 'message' );
2171		-
2172	1763	if ( 'form_duplicate_error' === $message ) {
2173	1764	self::display_forms_list( array(), '', array( __( 'There was a problem duplicating the form', 'formidable' ) ) );
2174	1765	return;
2175	1766	}
2176	1767
2177		- if ( 'forms_permanently_deleted' === $message ) {
2178		- $count = FrmAppHelper::get_param( 'forms_deleted', 0, 'get', 'absint' );
2179		- /* translators: %1$s: Number of forms */
2180		- $message = sprintf( _n( '%1$s form permanently deleted.', '%1$s forms permanently deleted.', $count, 'formidable' ), $count );
2181		- self::display_forms_list( array(), $message, '' );
2182		- return;
2183		- }
2184		-
2185	1768	self::display_forms_list();
2186	1769
2187	1770	return;
2188		- }//end switch
	1771	+ }
2189	1772	}
2190	1773
2191		- /**
2192		- * Rename a form.
2193		- *
2194		- * Handles the AJAX request for renaming a form.
2195		- *
2196		- * @since 6.7
2197		- *
2198		- * @return void
2199		- */
2200		- public static function rename_form() {
2201		- // Check permission and nonce
2202		- FrmAppHelper::permission_check( 'frm_edit_forms' );
2203		- check_ajax_referer( 'frm_ajax', 'nonce' );
	1774	+ public static function json_error( $errors ) {
	1775	+ $errors['json'] = __( 'Abnormal HTML characters prevented your form from saving correctly', 'formidable' );
2204	1776
2205		- // Get posted data
2206		- $form_id = FrmAppHelper::get_post_param( 'form_id', '', 'absint' );
2207		- $name = FrmAppHelper::get_post_param( 'form_name', '', 'sanitize_text_field' );
2208		-
2209		- $form = FrmForm::getOne( $form_id );
2210		-
2211		- if ( ! $form ) {
2212		- wp_send_json_error( __( 'Form not found', 'formidable' ) );
2213		- }
2214		-
2215		- if ( $name === $form->name ) {
2216		- // Nothing to change so exit early.
2217		- wp_send_json_success();
2218		- }
2219		-
2220		- $to_update = array(
2221		- 'name' => $name,
2222		- );
2223		-
2224		- if ( '' !== $name ) {
2225		- // Only update form_key if name is not empty.
2226		- $form_key = FrmAppHelper::get_unique_key( sanitize_title( $name ), 'frm_forms', 'form_key' );
2227		- $to_update['form_key'] = $form_key;
2228		- } else {
2229		- $form_key = $form->form_key;
2230		- }
2231		-
2232		- FrmForm::update( $form_id, $to_update );
2233		-
2234		- wp_send_json_success( compact( 'form_key' ) );
	1777	+ return $errors;
2235	1778	}
2236	1779
2237	1780	/**
2238		- * @param array $errors
	1781	+ * Education for premium features.
2239	1782	*
2240		- * @return array
	1783	+ * @since 4.05
2241	1784	*/
2242		- public static function json_error( $errors ) {
2243		- $errors['json'] = __( 'Abnormal HTML characters prevented your form from saving correctly', 'formidable' );
2244		-
2245		- return $errors;
	1785	+ public static function add_form_style_tab_options() {
	1786	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/add_form_style_options.php' );
2246	1787	}
2247	1788
2248	1789	/**
2249	1790	* Add education about views.
		@@ -2248,12 +1789,8 @@
2248	1789	/**
2249	1790	* Add education about views.
2250	1791	*
2251	1792	* @since 4.07
2252		- *
2253		- * @param array $values
2254		- *
2255		- * @return void
2256	1793	*/
2257	1794	public static function no_views( $values = array() ) {
2258	1795	FrmAppHelper::include_svg();
2259	1796	$id = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
		@@ -2265,12 +1802,8 @@
2265	1802	/**
2266	1803	* Add education about reports.
2267	1804	*
2268	1805	* @since 4.07
2269		- *
2270		- * @param array $values
2271		- *
2272		- * @return void
2273	1806	*/
2274	1807	public static function no_reports( $values = array() ) {
2275	1808	$id = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
2276	1809	$form = $id ? FrmForm::getOne( $id ) : false;
		@@ -2277,11 +1810,9 @@
2277	1810
2278	1811	include FrmAppHelper::plugin_path() . '/classes/views/shared/reports-info.php';
2279	1812	}
2280	1813
2281		- /**
2282		- * FRONT-END FORMS.
2283		- */
	1814	+ /* FRONT-END FORMS */
2284	1815	public static function admin_bar_css() {
2285	1816	if ( is_admin() || ! current_user_can( 'frm_edit_forms' ) ) {
2286	1817	return;
2287	1818	}
		@@ -2296,9 +1827,8 @@
2296	1827	* @since 4.05.02
2297	1828	*/
2298	1829	private static function move_menu_to_footer() {
2299	1830	$settings = FrmAppHelper::get_settings();
2300		-
2301	1831	if ( empty( $settings->admin_bar ) ) {
2302	1832	remove_action( 'wp_body_open', 'wp_admin_bar_render', 0 );
2303	1833	}
2304	1834	}
		@@ -2304,15 +1834,13 @@
2304	1834	}
2305	1835
2306	1836	public static function admin_bar_configure() {
2307	1837	global $frm_vars;
2308		-
2309	1838	if ( empty( $frm_vars['forms_loaded'] ) ) {
2310	1839	return;
2311	1840	}
2312	1841
2313	1842	$actions = array();
2314		-
2315	1843	foreach ( $frm_vars['forms_loaded'] as $form ) {
2316	1844	if ( is_object( $form ) ) {
2317	1845	$actions[ $form->id ] = $form->name;
2318	1846	}
		@@ -2346,12 +1874,8 @@
2346	1874	}
2347	1875
2348	1876	/**
2349	1877	* @since 2.05.07
2350		- *
2351		- * @param array $actions
2352		- *
2353		- * @return void
2354	1878	*/
2355	1879	private static function add_forms_to_admin_bar( $actions ) {
2356	1880	global $wp_admin_bar;
2357	1881
		@@ -2362,9 +1886,9 @@
2362	1886	$wp_admin_bar->add_node(
2363	1887	array(
2364	1888	'parent' => 'frm-forms',
2365	1889	'id' => 'edit_form_' . $form_id,
2366		- 'title' => empty( $name ) ? FrmFormsHelper::get_no_title_text() : $name,
	1890	+ 'title' => empty( $name ) ? __( '(no title)', 'formidable' ) : $name,
2367	1891	'href' => FrmForm::get_edit_link( $form_id ),
2368	1892	)
2369	1893	);
2370	1894	}
		@@ -2373,16 +1897,14 @@
2373	1897	/**
2374	1898	* The formidable shortcode
2375	1899	*
2376	1900	* @param array $atts The params from the shortcode.
2377		- *
2378	1901	* @return string
2379	1902	*/
2380	1903	public static function get_form_shortcode( $atts ) {
2381	1904	global $frm_vars;
2382		-
2383		- if ( ! empty( $frm_vars['skip_shortcode'] ) ) {
2384		- $sc = '[formidable';
	1905	+ if ( isset( $frm_vars['skip_shortcode'] ) && $frm_vars['skip_shortcode'] ) {
	1906	+ $sc = '[formidable';
2385	1907	$sc .= FrmAppHelper::array_to_html_params( $atts );
2386	1908	return $sc . ']';
2387	1909	}
2388	1910
		@@ -2407,12 +1929,11 @@
2407	1929
2408	1930	/**
2409	1931	* @since 5.2.01
2410	1932	*
2411		- * @param false|int|string $id
2412		- * @param false|string $key
2413		- *
2414		- * @return false|stdClass
	1933	+ * @param string|int|false $id
	1934	+ * @param string|false $key
	1935	+ * @return stdClass|false
2415	1936	*/
2416	1937	private static function maybe_get_form_by_id_or_key( $id, $key ) {
2417	1938	if ( ! $id ) {
2418	1939	$id = $key;
		@@ -2420,14 +1941,13 @@
2420	1941	return self::maybe_get_form_to_show( $id );
2421	1942	}
2422	1943
2423	1944	/**
2424		- * @param false|int|string $id
2425		- * @param false|string $key
2426		- * @param bool|int|string $title may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
2427		- * @param bool|int|string $description may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
	1945	+ * @param string|int|false $id
	1946	+ * @param string|false $key
	1947	+ * @param string|int|bool $title may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
	1948	+ * @param string|int|bool $description may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
2428	1949	* @param array $atts
2429		- *
2430	1950	* @return string
2431	1951	*/
2432	1952	public static function show_form( $id = '', $key = '', $title = false, $description = false, $atts = array() ) {
2433	1953	$form = self::maybe_get_form_by_id_or_key( $id, $key );
		@@ -2474,19 +1994,16 @@
2474	1994	return $form;
2475	1995	}
2476	1996
2477	1997	/**
2478		- * @param false|int|string $id
2479		- *
2480		- * @return false|stdClass
	1998	+ * @param string|int|false $id
	1999	+ * @return stdClass|false
2481	2000	*/
2482	2001	private static function maybe_get_form_to_show( $id ) {
2483	2002	$form = false;
2484	2003
2485		- if ( ! empty( $id ) ) {
2486		- // Form id or key is set.
	2004	+ if ( ! empty( $id ) ) { // form id or key is set
2487	2005	$form = FrmForm::getOne( $id );
2488		-
2489	2006	if ( ! $form || $form->parent_form_id || $form->status === 'trash' ) {
2490	2007	$form = false;
2491	2008	}
2492	2009	}
		@@ -2493,25 +2010,12 @@
2493	2010
2494	2011	return $form;
2495	2012	}
2496	2013
2497		- /**
2498		- * @param object $form
2499		- *
2500		- * @return bool
2501		- */
2502	2014	private static function is_viewable_draft_form( $form ) {
2503	2015	return $form->status === 'draft' && current_user_can( 'frm_edit_forms' ) && ! FrmAppHelper::is_preview_page();
2504	2016	}
2505	2017
2506		- /**
2507		- * @param object $form
2508		- * @param bool $title
2509		- * @param bool $description
2510		- * @param array $atts
2511		- *
2512		- * @return string
2513		- */
2514	2018	public static function get_form( $form, $title, $description, $atts = array() ) {
2515	2019	ob_start();
2516	2020
2517	2021	do_action( 'frm_before_get_form', $atts );
		@@ -2526,25 +2030,12 @@
2526	2030
2527	2031	return $contents;
2528	2032	}
2529	2033
2530		- /**
2531		- * @param array $params
2532		- *
2533		- * @return void
2534		- */
2535	2034	public static function enqueue_scripts( $params ) {
2536	2035	do_action( 'frm_enqueue_form_scripts', $params );
2537	2036	}
2538	2037
2539		- /**
2540		- * @param object $form
2541		- * @param bool $title
2542		- * @param bool $description
2543		- * @param array $atts
2544		- *
2545		- * @return void
2546		- */
2547	2038	public static function get_form_contents( $form, $title, $description, $atts ) {
2548	2039	$params = FrmForm::get_params( $form );
2549	2040	$errors = self::get_saved_errors( $form, $params );
2550	2041	$fields = FrmFieldsHelper::get_form_fields( $form->id, $errors );
		@@ -2554,13 +2045,9 @@
2554	2045	$pass_args['action'] = $params['action'];
2555	2046	$handle_process_here = $params['action'] === 'create' && $params['posted_form_id'] == $form->id && $_POST; // phpcs:ignore WordPress.Security.NonceVerification.Missing
2556	2047
2557	2048	if ( ! $handle_process_here ) {
2558		- FrmFormState::set_initial_value( 'title', $title );
2559		- FrmFormState::set_initial_value( 'description', $description );
2560		-
2561	2049	do_action( 'frm_display_form_action', $params, $fields, $form, $title, $description );
2562		-
2563	2050	if ( apply_filters( 'frm_continue_to_new', true, $form->id, $params['action'] ) ) {
2564	2051	self::show_form_after_submit( $pass_args );
2565	2052	}
2566	2053	} elseif ( ! empty( $errors ) ) {
		@@ -2570,11 +2057,12 @@
2570	2057
2571	2058	do_action( 'frm_validate_form_creation', $params, $fields, $form, $title, $description );
2572	2059
2573	2060	if ( apply_filters( 'frm_continue_to_create', true, $form->id ) ) {
2574		- $entry_id = self::just_created_entry( $form->id );
2575		- $pass_args['entry_id'] = $entry_id;
2576		- $pass_args['reset'] = true;
	2061	+ $entry_id = self::just_created_entry( $form->id );
	2062	+ $pass_args['entry_id'] = $entry_id;
	2063	+ $pass_args['reset'] = true;
	2064	+ $pass_args['conf_method'] = self::get_confirmation_method( compact( 'form', 'entry_id' ) );
2577	2065
2578	2066	self::run_on_submit_actions( $pass_args );
2579	2067
2580	2068	do_action(
		@@ -2584,9 +2072,9 @@
2584	2072	'form' => $form,
2585	2073	)
2586	2074	);
2587	2075	}
2588		- }//end if
	2076	+ }
2589	2077	}
2590	2078
2591	2079	/**
2592	2080	* If the form was processed earlier (init), get the generated errors
		@@ -2591,13 +2079,8 @@
2591	2079	/**
2592	2080	* If the form was processed earlier (init), get the generated errors
2593	2081	*
2594	2082	* @since 2.05
2595		- *
2596		- * @param object $form
2597		- * @param array $params
2598		- *
2599		- * @return array
2600	2083	*/
2601	2084	private static function get_saved_errors( $form, $params ) {
2602	2085	global $frm_vars;
2603	2086
		@@ -2619,17 +2102,13 @@
2619	2102	}
2620	2103
2621	2104	/**
2622	2105	* @since 2.2.7
2623		- *
2624		- * @param int|string $form_id
2625		- *
2626		- * @return int
2627	2106	*/
2628	2107	public static function just_created_entry( $form_id ) {
2629	2108	global $frm_vars;
2630	2109
2631		- return isset( $frm_vars['created_entries'] ) && isset( $frm_vars['created_entries'][ $form_id ] ) && isset( $frm_vars['created_entries'][ $form_id ]['entry_id'] ) ? $frm_vars['created_entries'][ $form_id ]['entry_id'] : 0;
	2110	+ return ( isset( $frm_vars['created_entries'] ) && isset( $frm_vars['created_entries'][ $form_id ] ) && isset( $frm_vars['created_entries'][ $form_id ]['entry_id'] ) ) ? $frm_vars['created_entries'][ $form_id ]['entry_id'] : 0;
2632	2111	}
2633	2112
2634	2113	/**
2635	2114	* Gets confirmation method.
		@@ -2642,27 +2121,23 @@
2642	2121	*
2643	2122	* @type object $form Form object.
2644	2123	* @type int $entry_id Entry ID.
2645	2124	* }
2646		- *
2647		- * @return array|string
	2125	+ * @return string|array
2648	2126	*/
2649	2127	private static function get_confirmation_method( $atts ) {
2650		- $action = FrmOnSubmitHelper::current_event( $atts );
2651		- $opt = 'update' === $action ? 'edit_action' : 'success_action';
2652		- $method = ! empty( $atts['form']->options[ $opt ] ) ? $atts['form']->options[ $opt ] : 'message';
2653		-
2654		- if ( ! empty( $atts['entry_id'] ) ) {
2655		- $met_actions = self::get_met_on_submit_actions( $atts, $action );
2656		-
	2128	+ if ( ! empty( $atts['entry_id'] ) ) { // Check against entry has already submitted error.
	2129	+ $met_actions = self::get_met_on_submit_actions( $atts );
2657	2130	if ( $met_actions ) {
2658		- $method = $met_actions;
	2131	+ return $met_actions;
2659	2132	}
2660	2133	}
2661	2134
2662		- $method = apply_filters( 'frm_success_filter', $method, $atts['form'], $action );
	2135	+ $opt = 'success_action';
	2136	+ $method = ( isset( $atts['form']->options[ $opt ] ) && ! empty( $atts['form']->options[ $opt ] ) ) ? $atts['form']->options[ $opt ] : 'message';
	2137	+ $method = apply_filters( 'frm_success_filter', $method, $atts['form'], 'create' );
2663	2138
2664		- if ( $method !== 'message' && ( ! $atts['entry_id'] || ! is_numeric( $atts['entry_id'] ) ) ) {
	2139	+ if ( $method != 'message' && ( ! $atts['entry_id'] || ! is_numeric( $atts['entry_id'] ) ) ) {
2665	2140	$method = 'message';
2666	2141	}
2667	2142
2668	2143	return $method;
		@@ -2667,15 +2142,8 @@
2667	2142
2668	2143	return $method;
2669	2144	}
2670	2145
2671		- /**
2672		- * @param object $form
2673		- * @param array $params
2674		- * @param array $args
2675		- *
2676		- * @return void
2677		- */
2678	2146	public static function maybe_trigger_redirect( $form, $params, $args ) {
2679	2147	if ( ! isset( $params['id'] ) ) {
2680	2148	global $frm_vars;
2681	2149	$params['id'] = $frm_vars['created_entries'][ $form->id ]['entry_id'];
		@@ -2684,30 +2152,14 @@
2684	2152	$conf_method = self::get_confirmation_method(
2685	2153	array(
2686	2154	'form' => $form,
2687	2155	'entry_id' => $params['id'],
2688		- 'action' => FrmOnSubmitHelper::current_event( $params ),
2689	2156	)
2690	2157	);
2691	2158
2692		- self::maybe_trigger_redirect_with_action( $conf_method, $form, $params, $args );
2693		- }
2694		-
2695		- /**
2696		- * Maybe trigger redirect with the new Confirmation action.
2697		- *
2698		- * @since 6.1.1
2699		- *
2700		- * @param array|string $conf_method Array of confirmation actions or the action type string.
2701		- * @param object $form Form object.
2702		- * @param array $params See {@see FrmFormsController::maybe_trigger_redirect()}.
2703		- * @param array $args See {@see FrmFormsController::maybe_trigger_redirect()}.
2704		- */
2705		- public static function maybe_trigger_redirect_with_action( $conf_method, $form, $params, $args ) {
2706	2159	if ( is_array( $conf_method ) && 1 === count( $conf_method ) ) {
2707		- if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $conf_method[0] ) && empty( $conf_method[0]->post_content['redirect_delay'] ) ) {
2708		- $event = FrmOnSubmitHelper::current_event( $params );
2709		- FrmOnSubmitHelper::populate_on_submit_data( $form->options, $conf_method[0], $event );
	2160	+ if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $conf_method[0] ) ) {
	2161	+ FrmOnSubmitHelper::populate_on_submit_data( $form->options, $conf_method[0] );
2710	2162	$conf_method = 'redirect';
2711	2163	}
2712	2164	}
2713	2165
		@@ -2715,15 +2167,8 @@
2715	2167	self::trigger_redirect( $form, $params, $args );
2716	2168	}
2717	2169	}
2718	2170
2719		- /**
2720		- * @param object $form
2721		- * @param array $params
2722		- * @param array $args
2723		- *
2724		- * @return void
2725		- */
2726	2171	public static function trigger_redirect( $form, $params, $args ) {
2727	2172	$success_args = array(
2728	2173	'action' => $params['action'],
2729	2174	'conf_method' => 'redirect',
		@@ -2761,9 +2206,9 @@
2761	2206	unset( $extra_args['form'] );
2762	2207
2763	2208	do_action( 'frm_success_action', $args['conf_method'], $args['form'], $args['form']->options, $args['entry_id'], $extra_args );
2764	2209
2765		- $opt = ! isset( $args['action'] ) || $args['action'] === 'create' ? 'success' : 'edit';
	2210	+ $opt = ( ! isset( $args['action'] ) || $args['action'] === 'create' ) ? 'success' : 'edit';
2766	2211
2767	2212	$args['success_opt'] = $opt;
2768	2213	$args['ajax'] = ! empty( $frm_vars['ajax'] );
2769	2214
		@@ -2782,24 +2227,14 @@
2782	2227	* @since 6.0
2783	2228	*
2784	2229	* @param array $args See {@see FrmFormsController::run_success_action()}.
2785	2230	* @param string $event Form event. Default is `create`.
2786		- *
2787	2231	* @return array Array of actions that meet the conditional logics.
2788	2232	*/
2789	2233	public static function get_met_on_submit_actions( $args, $event = 'create' ) {
2790		- if ( ! FrmOnSubmitHelper::form_has_migrated( $args['form'] ) ) {
2791		- return array();
2792		- }
2793		-
2794		- // If a redirect action has already opened the URL in a new tab, we show the default message in the current tab.
2795		- if ( ! empty( self::$redirected_in_new_tab[ $args['form']->id ] ) ) {
2796		- return array( FrmOnSubmitHelper::get_fallback_action_after_open_in_new_tab( $event ) );
2797		- }
2798		-
2799		- $entry = FrmEntry::getOne( $args['entry_id'], true );
2800		- $actions = FrmOnSubmitHelper::get_actions( $args['form']->id );
2801		- $met_actions = array();
	2234	+ $entry = FrmEntry::getOne( $args['entry_id'], true );
	2235	+ $actions = FrmOnSubmitHelper::get_actions( $args['form']->id );
	2236	+ $met_actions = array();
2802	2237	$has_redirect = false;
2803	2238
2804	2239	foreach ( $actions as $action ) {
2805	2240	if ( ! in_array( $event, $action->post_content['event'], true ) ) {
		@@ -2809,28 +2244,19 @@
2809	2244	if ( FrmFormAction::action_conditions_met( $action, $entry ) ) {
2810	2245	continue;
2811	2246	}
2812	2247
2813		- $action_type = FrmOnSubmitHelper::get_action_type( $action );
2814		-
2815		- if ( 'redirect' === $action_type ) {
2816		- if ( $has_redirect ) {
2817		- // Do not process because we run the first redirect action only.
	2248	+ if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $action ) ) {
	2249	+ if ( $has_redirect ) { // Do not process because we run the first redirect action only.
2818	2250	continue;
2819	2251	}
2820		- }
2821	2252
2822		- if ( ! self::is_valid_on_submit_action( $action, $args, $event ) ) {
2823		- continue;
2824		- }
2825		-
2826		- if ( 'redirect' === $action_type ) {
2827	2253	$has_redirect = true;
2828	2254	}
2829	2255
2830	2256	$met_actions[] = $action;
2831	2257	unset( $action );
2832		- }//end foreach
	2258	+ }
2833	2259
2834	2260	$args['event'] = $event;
2835	2261
2836	2262	/**
		@@ -2840,59 +2266,12 @@
2840	2266	*
2841	2267	* @param array $met_actions Actions that meet the conditional logics.
2842	2268	* @param array $args See {@see FrmFormsController::run_success_action()}. `$args['event']` is also added.
2843	2269	*/
2844		- $met_actions = apply_filters( 'frm_get_met_on_submit_actions', $met_actions, $args );
2845		-
2846		- if ( empty( $met_actions ) ) {
2847		- $met_actions = array( FrmOnSubmitHelper::get_fallback_action( $event ) );
2848		- }
2849		-
2850		- return $met_actions;
	2270	+ return apply_filters( 'frm_get_met_on_submit_actions', $met_actions, $args );
2851	2271	}
2852	2272
2853	2273	/**
2854		- * Checks if a Confirmation action has the valid data.
2855		- *
2856		- * @since 6.1.2
2857		- *
2858		- * @param object $action Form action object.
2859		- * @param array $args See {@see FrmFormsController::run_success_action()}.
2860		- * @param string $event Form event. Default is `create`.
2861		- *
2862		- * @return bool
2863		- */
2864		- private static function is_valid_on_submit_action( $action, $args, $event = 'create' ) {
2865		- $action_type = FrmOnSubmitHelper::get_action_type( $action );
2866		-
2867		- if ( 'redirect' === $action_type ) {
2868		- // Run through frm_redirect_url filter. This is used for the valid action check.
2869		- $action->post_content['success_url'] = apply_filters(
2870		- 'frm_redirect_url',
2871		- $action->post_content['success_url'],
2872		- $args['form'],
2873		- $args + array( 'action' => $event )
2874		- );
2875		-
2876		- return ! empty( $action->post_content['success_url'] );
2877		- }
2878		-
2879		- if ( 'page' === $action_type ) {
2880		- if ( empty( $action->post_content['success_page_id'] ) ) {
2881		- return false;
2882		- }
2883		-
2884		- $page = get_post( $action->post_content['success_page_id'] );
2885		-
2886		- if ( ! $page || 'trash' === $page->post_status ) {
2887		- return false;
2888		- }
2889		- }
2890		-
2891		- return true;
2892		- }
2893		-
2894		- /**
2895	2274	* Runs On Submit actions.
2896	2275	*
2897	2276	* @since 6.0
2898	2277	*
		@@ -2897,17 +2276,9 @@
2897	2276	* @since 6.0
2898	2277	*
2899	2278	* @param array $args See inside {@see FrmFormsController::get_form_contents()} method.
2900	2279	*/
2901		- public static function run_on_submit_actions( $args ) {
2902		- $args['conf_method'] = self::get_confirmation_method(
2903		- array(
2904		- 'form' => $args['form'],
2905		- 'entry_id' => $args['entry_id'],
2906		- 'action' => FrmOnSubmitHelper::current_event( $args ),
2907		- )
2908		- );
2909		-
	2280	+ private static function run_on_submit_actions( $args ) {
2910	2281	if ( ! is_array( $args['conf_method'] ) ) {
2911	2282	self::run_success_action( $args );
2912	2283	return;
2913	2284	}
		@@ -2934,9 +2305,8 @@
2934	2305	* @param array $args See {@see FrmFormsController::run_success_action()}.
2935	2306	*/
2936	2307	public static function run_multi_on_submit_actions( $args ) {
2937	2308	$redirect_action = null;
2938		-
2939	2309	foreach ( $args['conf_method'] as $action ) {
2940	2310	if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $action ) ) {
2941	2311	// We catch the redirect action to run it last.
2942	2312	$redirect_action = $action;
		@@ -2974,9 +2344,8 @@
2974	2344	* @since 6.0
2975	2345	*
2976	2346	* @param array $args See {@see FrmFormsController::run_success_action()}.
2977	2347	* @param object $action On Submit action object.
2978		- *
2979	2348	* @return array
2980	2349	*/
2981	2350	private static function get_run_success_action_args( $args, $action ) {
2982	2351	$new_args = $args;
		@@ -3000,17 +2369,12 @@
3000	2369	}
3001	2370
3002	2371	/**
3003	2372	* @since 3.0
3004		- *
3005		- * @param array $args
3006		- *
3007		- * @return void
3008	2373	*/
3009	2374	private static function load_page_after_submit( $args ) {
3010	2375	global $post;
3011	2376	$opt = $args['success_opt'];
3012		-
3013	2377	if ( ! $post || $args['form']->options[ $opt . '_page_id' ] != $post->ID ) {
3014	2378	$page = get_post( $args['form']->options[ $opt . '_page_id' ] );
3015	2379	$old_post = $post;
3016	2380	$post = $page;
		@@ -3029,14 +2393,13 @@
3029	2393	add_filter( 'the_content', 'FrmFormsController::preview_content', 9999 );
3030	2394	}
3031	2395
3032	2396	$post = $old_post;
3033		- }//end if
	2397	+ }
3034	2398	}
3035	2399
3036	2400	/**
3037	2401	* @since 3.0
3038		- *
3039	2402	* @param array $args See {@see FrmFormsController::run_success_action()}.
3040	2403	*/
3041	2404	private static function redirect_after_submit( $args ) {
3042	2405	add_filter( 'frm_use_wpautop', '__return_false' );
		@@ -3053,25 +2416,16 @@
3053	2416	$success_url = apply_filters( 'frm_redirect_url', $success_url, $args['form'], $args );
3054	2417
3055	2418	$doing_ajax = FrmAppHelper::doing_ajax();
3056	2419
3057		- if ( ! empty( $args['ajax'] ) && $doing_ajax && empty( $args['force_delay_redirect'] ) ) {
3058		- // Is AJAX submit and there is just one Redirect action runs.
3059		- echo json_encode( self::get_ajax_redirect_response_data( $args + compact( 'success_url' ) ) );
	2420	+ if ( ! empty( $args['ajax'] ) && $doing_ajax && empty( $args['force_delay_redirect'] ) ) { // Is AJAX submit and there is just one Redirect action runs.
	2421	+ echo json_encode( array( 'redirect' => $success_url ) );
3060	2422	wp_die();
3061	2423	}
3062	2424
3063		- if ( ! headers_sent() && empty( $args['force_delay_redirect'] ) && empty( $args['form']->options['redirect_delay'] ) ) {
3064		- // Not AJAX submit, no headers sent, and there is just one Redirect action runs.
3065		- if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3066		- self::print_open_in_new_tab_js_with_fallback_handler( $success_url, $args );
3067		- self::$redirected_in_new_tab[ $args['form']->id ] = 1;
3068		- return;
3069		- }
3070		-
	2425	+ if ( ! headers_sent() && empty( $args['force_delay_redirect'] ) ) { // Not AJAX submit, no headers sent, and there is just one Redirect action runs.
3071	2426	wp_redirect( esc_url_raw( $success_url ) );
3072		- // Do not use wp_die or redirect fails.
3073		- die();
	2427	+ die(); // do not use wp_die or redirect fails
3074	2428	}
3075	2429
3076	2430	// Redirect with a delay.
3077	2431	self::redirect_after_submit_using_js( $args + compact( 'success_url', 'doing_ajax' ) );
		@@ -3077,83 +2431,8 @@
3077	2431	self::redirect_after_submit_using_js( $args + compact( 'success_url', 'doing_ajax' ) );
3078	2432	}
3079	2433
3080	2434	/**
3081		- * Prints open in new tab js with fallback handler.
3082		- *
3083		- * @since 6.3.1
3084		- *
3085		- * @param string $success_url Success URL.
3086		- * @param array $args See {@see FrmFormsController::redirect_after_submit()}.
3087		- */
3088		- private static function print_open_in_new_tab_js_with_fallback_handler( $success_url, $args ) {
3089		- echo '<script>var newTab = window.open("' . esc_url_raw( $success_url ) . '", "_blank");';
3090		- echo 'if ( ! newTab ) {';
3091		-
3092		- $data = array(
3093		- 'formId' => intval( $args['form']->id ),
3094		- 'message' => self::get_redirect_fallback_message( $success_url, $args ),
3095		- );
3096		- // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
3097		- echo 'frmShowNewTabFallback = ' . FrmAppHelper::maybe_json_encode( $data ) . ';';
3098		- echo '}</script>';
3099		- }
3100		-
3101		- /**
3102		- * Gets response data for redirect action when AJAX submitting.
3103		- *
3104		- * @since 6.3.1
3105		- *
3106		- * @param array $args See {@see FrmFormsController::run_success_action()}.
3107		- *
3108		- * @return array
3109		- */
3110		- private static function get_ajax_redirect_response_data( $args ) {
3111		- $response_data = array(
3112		- 'redirect' => $args['success_url'],
3113		- 'content' => '',
3114		- );
3115		- $unset_content = true;
3116		-
3117		- if ( ! empty( $args['form']->options['redirect_delay'] ) ) {
3118		- $response_data['delay'] = $args['form']->options['redirect_delay_time'];
3119		- $response_data['content'] .= self::get_redirect_message( $args['success_url'], $args['form']->options['redirect_delay_msg'], $args );
3120		- $unset_content = false;
3121		- }
3122		-
3123		- if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3124		- $response_data['openInNewTab'] = 1;
3125		-
3126		- // Only show open in new tab text if there is no delay.
3127		- if ( empty( $response_data['content'] ) ) {
3128		- $args['message'] = FrmOnSubmitHelper::get_default_new_tab_msg();
3129		-
3130		- $args['form']->options['success_msg'] = $args['message'];
3131		- $args['form']->options['edit_msg'] = $args['message'];
3132		-
3133		- if ( ! isset( $args['fields'] ) ) {
3134		- $args['fields'] = FrmField::get_all_for_form( $args['form']->id );
3135		- }
3136		-
3137		- $args['message'] = self::prepare_submit_message( $args['form'], $args['entry_id'], $args );
3138		-
3139		- ob_start();
3140		- self::show_lone_success_message( $args );
3141		- $response_data['content'] .= ob_get_clean();
3142		- $unset_content = false;
3143		- }//end if
3144		-
3145		- $response_data['fallbackMsg'] = self::get_redirect_fallback_message( $args['success_url'], $args );
3146		- }//end if
3147		-
3148		- if ( $unset_content && '' === $response_data['content'] ) {
3149		- unset( $response_data['content'] );
3150		- }
3151		-
3152		- return $response_data;
3153		- }
3154		-
3155		- /**
3156	2435	* Redirects after submitting using JS. This is used when showing message before redirecting.
3157	2436	*
3158	2437	* @since 6.0
3159	2438	*
		@@ -3159,11 +2438,10 @@
3159	2438	*
3160	2439	* @param array $args See {@see FrmFormsController::run_success_action()}.
3161	2440	*/
3162	2441	private static function redirect_after_submit_using_js( $args ) {
3163		- $success_msg = $args['form']->options['redirect_delay_msg'];
	2442	+ $success_msg = FrmOnSubmitHelper::get_default_redirect_msg();
3164	2443	$redirect_msg = self::get_redirect_message( $args['success_url'], $success_msg, $args );
3165		- $success_url = esc_url_raw( $args['success_url'] );
3166	2444
3167	2445	/**
3168	2446	* Filters the delay time before redirecting when On Submit Redirect action is delayed.
3169	2447	*
		@@ -3168,29 +2446,20 @@
3168	2446	* Filters the delay time before redirecting when On Submit Redirect action is delayed.
3169	2447	*
3170	2448	* @since 6.0
3171	2449	*
3172		- * @param int $delay_time Delay time in milliseconds.
	2450	+ * @param int $delay_time Delay time in miliseconds.
3173	2451	*/
3174		- $delay_time = apply_filters( 'frm_redirect_delay_time', 1000 * $args['form']->options['redirect_delay_time'] );
	2452	+ $delay_time = apply_filters( 'frm_redirect_delay_time', 8000 );
3175	2453
3176		- if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3177		- $redirect_js = 'window.open("' . $success_url . '", "_blank")';
3178		- } else {
3179		- $redirect_js = 'window.location="' . $success_url . '";';
3180		- }
3181		-
3182	2454	add_filter( 'frm_use_wpautop', '__return_true' );
3183	2455
3184	2456	echo FrmAppHelper::maybe_kses( $redirect_msg ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
3185	2457	echo '<script>';
3186		-
3187		- if ( empty( $args['doing_ajax'] ) ) {
3188		- // Not AJAX submit, delay JS until window.load.
	2458	+ if ( empty( $args['doing_ajax'] ) ) { // Not AJAX submit, delay JS until window.load.
3189	2459	echo 'window.onload=function(){';
3190	2460	}
3191		- echo 'setTimeout(function(){' . $redirect_js . '}, ' . intval( $delay_time ) . ');'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
3192		-
	2461	+ echo 'setTimeout(function(){window.location="' . esc_url_raw( $args['success_url'] ) . '";}, ' . intval( $delay_time ) . ');';
3193	2462	if ( empty( $args['doing_ajax'] ) ) {
3194	2463	echo '};';
3195	2464	}
3196	2465	echo '</script>';
		@@ -3200,15 +2469,14 @@
3200	2469	* @since 3.0
3201	2470	*
3202	2471	* @param string $success_url
3203	2472	* @param string $success_msg
3204		- * @param array $args
	2473	+ * @param array $args
3205	2474	*/
3206	2475	private static function get_redirect_message( $success_url, $success_msg, $args ) {
3207		- $success_msg = apply_filters( 'frm_content', $success_msg, $args['form'], $args['entry_id'] );
3208		- $success_msg = do_shortcode( FrmAppHelper::use_wpautop( $success_msg ) );
3209	2476	$redirect_msg = '<div class="' . esc_attr( FrmFormsHelper::get_form_style_class( $args['form'] ) ) . '"><div class="frm-redirect-msg" role="status">' . $success_msg . '<br/>' .
3210		- self::get_redirect_fallback_message( $success_url, $args ) .
	2477	+ /* translators: %1$s: Start link HTML, %2$s: End link HTML */
	2478	+ sprintf( __( '%1$sClick here%2$s if you are not automatically redirected.', 'formidable' ), '<a href="' . esc_url( $success_url ) . '">', '</a>' ) .
3211	2479	'</div></div>';
3212	2480
3213	2481	$redirect_args = array(
3214	2482	'entry_id' => $args['entry_id'],
		@@ -3219,59 +2487,19 @@
3219	2487	return apply_filters( 'frm_redirect_msg', $redirect_msg, $redirect_args );
3220	2488	}
3221	2489
3222	2490	/**
3223		- * Gets fallback message when redirecting failed.
3224		- *
3225		- * @since 6.3.1
3226		- *
3227		- * @param string $success_url Redirect URL.
3228		- * @param array $args Contains `form` object.
3229		- *
3230		- * @return string
3231		- */
3232		- private static function get_redirect_fallback_message( $success_url, $args ) {
3233		- $target = '';
3234		-
3235		- if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3236		- $target = ' target="_blank"';
3237		- }
3238		-
3239		- return sprintf(
3240		- /* translators: %1$s: Start link HTML, %2$s: End link HTML */
3241		- __( '%1$sClick here%2$s if you are not automatically redirected.', 'formidable' ),
3242		- '<a href="' . esc_url( $success_url ) . '"' . $target . '>',
3243		- '</a>'
3244		- );
3245		- }
3246		-
3247		- /**
3248	2491	* Prepare to show the success message and empty form after submit
3249	2492	*
3250	2493	* @since 2.05
3251		- *
3252		- * @param array $atts
3253		- *
3254		- * @return void
3255	2494	*/
3256	2495	public static function show_message_after_save( $atts ) {
3257		- $atts['message'] = self::prepare_submit_message( $atts['form'], $atts['entry_id'], $atts );
	2496	+ $atts['message'] = self::prepare_submit_message( $atts['form'], $atts['entry_id'] );
3258	2497
3259	2498	if ( ! isset( $atts['form']->options['show_form'] ) || $atts['form']->options['show_form'] ) {
3260		- if ( isset( $atts['action'] ) && 'update' === $atts['action'] && is_callable( array( 'FrmProEntriesController', 'show_front_end_form_with_entry' ) ) ) {
3261		- $entry = FrmEntry::getOne( $atts['entry_id'] );
3262		-
3263		- if ( $entry ) {
3264		- // This is copied from the Pro plugin.
3265		- $atts['conf_message'] = FrmProEntriesController::confirmation( 'message', $atts['form'], $atts['form']->options, $entry->id, $atts );
3266		- $atts['show_form'] = FrmProEntriesController::is_form_displayed_after_edit( $atts['form'] );
3267		- FrmProEntriesController::show_front_end_form_with_entry( $entry, $atts );
3268		- }
3269		- } else {
3270		- self::show_form_after_submit( $atts );
3271		- }
	2499	+ self::show_form_after_submit( $atts );
3272	2500	} else {
3273		- self::show_lone_success_message( $atts );
	2501	+ self::show_lone_success_messsage( $atts );
3274	2502	}
3275	2503	}
3276	2504
3277	2505	/**
		@@ -3277,12 +2505,8 @@
3277	2505	/**
3278	2506	* Show an empty form
3279	2507	*
3280	2508	* @since 2.05
3281		- *
3282		- * @param array $args
3283		- *
3284		- * @return void
3285	2509	*/
3286	2510	private static function show_form_after_submit( $args ) {
3287	2511	self::fill_atts_for_form_display( $args );
3288	2512
		@@ -3303,9 +2527,9 @@
3303	2527
3304	2528	$include_form_tag = apply_filters( 'frm_include_form_tag', true, $form );
3305	2529
3306	2530	$frm_settings = FrmAppHelper::get_settings();
3307		- $submit = $form->options['submit_value'] ?? $frm_settings->submit_value;
	2531	+ $submit = isset( $form->options['submit_value'] ) ? $form->options['submit_value'] : $frm_settings->submit_value;
3308	2532
3309	2533	global $frm_vars;
3310	2534	self::maybe_load_css( $form, $values['custom_style'], $frm_vars['load_css'] );
3311	2535
		@@ -3314,19 +2538,13 @@
3314	2538	include FrmAppHelper::plugin_path() . '/classes/views/frm-entries/new.php';
3315	2539	}
3316	2540
3317	2541	/**
3318		- * Gets message placement.
	2542	+ * @return string - 'before', 'after', or 'submit'
3319	2543	*
3320	2544	* @since 4.05.02
3321		- * @since 6.26 This method changed from `private` to `public`.
3322		- *
3323		- * @param object $form Form object.
3324		- * @param string $message The message.
3325		- *
3326		- * @return string Accepts 'before', 'after', or 'submit'.
3327	2545	*/
3328		- public static function message_placement( $form, $message ) {
	2546	+ private static function message_placement( $form, $message ) {
3329	2547	$place = 'before';
3330	2548
3331	2549	if ( $message && isset( $form->options['form_class'] ) ) {
3332	2550	if ( strpos( $form->options['form_class'], 'frm_below_success' ) !== false ) {
		@@ -3336,14 +2554,11 @@
3336	2554	}
3337	2555	}
3338	2556
3339	2557	/**
3340		- * Filter the message placement.
	2558	+ * @return string - 'before' or 'after'
3341	2559	*
3342	2560	* @since 4.05.02
3343		- *
3344		- * @param string $place Accepts 'before', 'after', or 'submit'.
3345		- * @param array $args Args.
3346	2561	*/
3347	2562	return apply_filters( 'frm_message_placement', $place, compact( 'form', 'message' ) );
3348	2563	}
3349	2564
		@@ -3350,22 +2565,10 @@
3350	2565	/**
3351	2566	* Get all the values needed on the new.php entry page
3352	2567	*
3353	2568	* @since 2.05
3354		- *
3355		- * @param array $args
3356		- *
3357		- * @return void
3358	2569	*/
3359	2570	private static function fill_atts_for_form_display( &$args ) {
3360		- if ( ! isset( $args['title'] ) && isset( $args['show_title'] ) ) {
3361		- $args['title'] = $args['show_title'];
3362		- }
3363		-
3364		- if ( ! isset( $args['description'] ) && isset( $args['show_description'] ) ) {
3365		- $args['description'] = $args['show_description'];
3366		- }
3367		-
3368	2571	$defaults = array(
3369	2572	'errors' => array(),
3370	2573	'message' => '',
3371	2574	'fields' => array(),
		@@ -3380,14 +2583,10 @@
3380	2583	/**
3381	2584	* Show the success message without the form
3382	2585	*
3383	2586	* @since 2.05
3384		- *
3385		- * @param array $atts
3386		- *
3387		- * @return void
3388	2587	*/
3389		- private static function show_lone_success_message( $atts ) {
	2588	+ private static function show_lone_success_messsage( $atts ) {
3390	2589	global $frm_vars;
3391	2590	$values = FrmEntriesHelper::setup_new_vars( $atts['fields'], $atts['form'], true );
3392	2591	self::maybe_load_css( $atts['form'], $values['custom_style'], $frm_vars['load_css'] );
3393	2592
		@@ -3396,9 +2595,9 @@
3396	2595	$errors = array();
3397	2596	$form = $atts['form'];
3398	2597	$message = $atts['message'];
3399	2598
3400		- include FrmAppHelper::plugin_path() . '/classes/views/frm-entries/errors.php';
	2599	+ include( FrmAppHelper::plugin_path() . '/classes/views/frm-entries/errors.php' );
3401	2600	}
3402	2601
3403	2602	/**
3404	2603	* Prepare the success message before it's shown
		@@ -3403,22 +2602,14 @@
3403	2602	/**
3404	2603	* Prepare the success message before it's shown
3405	2604	*
3406	2605	* @since 2.05
3407		- * @since 6.0.x Added the third parameter.
3408		- *
3409		- * @param object $form Form object.
3410		- * @param int $entry_id Entry ID.
3411		- * @param array $args See {@see FrmFormsController::run_success_action()}.
3412		- *
3413		- * @return string
3414	2606	*/
3415		- private static function prepare_submit_message( $form, $entry_id, $args = array() ) {
	2607	+ private static function prepare_submit_message( $form, $entry_id ) {
3416	2608	$frm_settings = FrmAppHelper::get_settings( array( 'current_form' => $form->id ) );
3417		- $opt = $args['success_opt'] ?? 'success';
3418	2609
3419	2610	if ( $entry_id && is_numeric( $entry_id ) ) {
3420		- $message = $form->options[ $opt . '_msg' ] ?? $frm_settings->success_msg;
	2611	+ $message = isset( $form->options['success_msg'] ) ? $form->options['success_msg'] : $frm_settings->success_msg;
3421	2612	$class = 'frm_message';
3422	2613	} else {
3423	2614	$message = $frm_settings->failed_msg;
3424	2615	$class = FrmFormsHelper::form_error_class();
		@@ -3459,15 +2650,8 @@
3459	2650	public static function has_combo_js_file() {
3460	2651	return is_readable( FrmAppHelper::plugin_path() . '/js/frm.min.js' );
3461	2652	}
3462	2653
3463		- /**
3464		- * @param object $form
3465		- * @param int|string $this_load
3466		- * @param bool $global_load
3467		- *
3468		- * @return void
3469		- */
3470	2654	public static function maybe_load_css( $form, $this_load, $global_load ) {
3471	2655	$load_css = FrmForm::is_form_loaded( $form, $this_load, $global_load );
3472	2656
3473	2657	if ( ! $load_css ) {
		@@ -3497,9 +2681,8 @@
3497	2681	return;
3498	2682	}
3499	2683
3500	2684	global $wp_styles;
3501		-
3502	2685	if ( is_array( $wp_styles->queue ) && in_array( 'formidable', $wp_styles->queue, true ) ) {
3503	2686	wp_print_styles( 'formidable' );
3504	2687	}
3505	2688	}
		@@ -3514,16 +2697,10 @@
3514	2697	private static function should_load_late() {
3515	2698	return ! function_exists( 'aioseo' );
3516	2699	}
3517	2700
3518		- /**
3519		- * @param string $tag
3520		- * @param string $handle
3521		- *
3522		- * @return string
3523		- */
3524	2701	public static function defer_script_loading( $tag, $handle ) {
3525		- if ( 'captcha-api' === $handle && ! strpos( $tag, 'defer' ) ) {
	2702	+ if ( 'captcha-api' == $handle && ! strpos( $tag, 'defer' ) ) {
3526	2703	$tag = str_replace( ' src', ' defer="defer" async="async" src', $tag );
3527	2704	}
3528	2705
3529	2706	return $tag;
		@@ -3528,33 +2705,21 @@
3528	2705
3529	2706	return $tag;
3530	2707	}
3531	2708
3532		- /**
3533		- * @param string $location
3534		- *
3535		- * @return void
3536		- */
3537	2709	public static function footer_js( $location = 'footer' ) {
3538	2710	global $frm_vars;
3539	2711
3540	2712	FrmStylesController::enqueue_css();
3541	2713
3542		- if ( ! FrmAppHelper::is_admin() && $location !== 'header' && ! empty( $frm_vars['forms_loaded'] ) ) {
	2714	+ if ( ! FrmAppHelper::is_admin() && $location != 'header' && ! empty( $frm_vars['forms_loaded'] ) ) {
3543	2715	// load formidable js
3544	2716	wp_enqueue_script( 'formidable' );
3545		-
3546		- FrmHoneypot::maybe_print_honeypot_js();
3547	2717	}
3548	2718	}
3549	2719
3550	2720	/**
3551	2721	* @since 2.0.8
3552		- *
3553		- * @param array $atts
3554		- * @param string $content
3555		- *
3556		- * @return void
3557	2722	*/
3558	2723	private static function maybe_minimize_form( $atts, &$content ) {
3559	2724	// check if minimizing is turned on
3560	2725	if ( self::is_minification_on( $atts ) ) {
		@@ -3563,15 +2728,12 @@
3563	2728	}
3564	2729
3565	2730	/**
3566	2731	* @since 2.0.8
3567		- *
3568		- * @param array $atts
3569		- *
3570		- * @return bool
	2732	+ * @return boolean
3571	2733	*/
3572	2734	private static function is_minification_on( $atts ) {
3573		- return ! empty( $atts['minimize'] );
	2735	+ return isset( $atts['minimize'] ) && ! empty( $atts['minimize'] );
3574	2736	}
3575	2737
3576	2738	/**
3577	2739	* @since 5.0.16
		@@ -3579,9 +2741,8 @@
3579	2741	* @return void
3580	2742	*/
3581	2743	public static function landing_page_preview_option() {
3582	2744	$dir = apply_filters( 'frm_landing_page_preview_option', false );
3583		-
3584	2745	if ( false === $dir || ! file_exists( $dir . 'landing-page-preview-option.php' ) ) {
3585	2746	$dir = self::get_form_views_path();
3586	2747	}
3587	2748	include $dir . 'landing-page-preview-option.php';
		@@ -3600,9 +2761,9 @@
3600	2761	* Create a page with an embedded formidable Gutenberg block.
3601	2762	*
3602	2763	* @since 5.2
3603	2764	*
3604		- * @return void
	2765	+ * @return never
3605	2766	*/
3606	2767	public static function create_page_with_shortcode() {
3607	2768	if ( ! current_user_can( 'publish_posts' ) ) {
3608	2769	die( 0 );
		@@ -3610,15 +2771,13 @@
3610	2771
3611	2772	check_ajax_referer( 'frm_ajax', 'nonce' );
3612	2773
3613	2774	$type = FrmAppHelper::get_post_param( 'type', '', 'sanitize_text_field' );
3614		-
3615	2775	if ( ! $type || ! in_array( $type, array( 'form', 'view' ), true ) ) {
3616	2776	die( 0 );
3617	2777	}
3618	2778
3619	2779	$object_id = FrmAppHelper::get_post_param( 'object_id', '', 'absint' );
3620		-
3621	2780	if ( ! $object_id ) {
3622	2781	die( 0 );
3623	2782	}
3624	2783
		@@ -3630,15 +2789,13 @@
3630	2789	$postarr['post_content'] = apply_filters( 'frm_create_page_with_' . $type . '_shortcode_content', '', $object_id );
3631	2790	}
3632	2791
3633	2792	$name = FrmAppHelper::get_post_param( 'name', '', 'sanitize_text_field' );
3634		-
3635	2793	if ( $name ) {
3636	2794	$postarr['post_title'] = $name;
3637	2795	}
3638	2796
3639	2797	$success = wp_insert_post( $postarr );
3640		-
3641	2798	if ( ! is_numeric( $success ) || ! $success ) {
3642	2799	die( 0 );
3643	2800	}
3644	2801
		@@ -3651,10 +2808,10 @@
3651	2808
3652	2809	/**
3653	2810	* @since 5.3
3654	2811	*
3655		- * @param int $form_id
3656		- *
	2812	+ * @param string $content
	2813	+ * @param int $form_id
3657	2814	* @return string
3658	2815	*/
3659	2816	private static function get_page_shortcode_content_for_form( $form_id ) {
3660	2817	$shortcode = '[formidable id="' . $form_id . '"]';
		@@ -3665,9 +2822,9 @@
3665	2822
3666	2823	/**
3667	2824	* Get page dropdown for AJAX request for embedding form in an existing page.
3668	2825	*
3669		- * @return void
	2826	+ * @return never
3670	2827	*/
3671	2828	public static function get_page_dropdown() {
3672	2829	if ( ! current_user_can( 'publish_posts' ) ) {
3673	2830	die( 0 );
		@@ -3675,9 +2832,9 @@
3675	2832
3676	2833	check_ajax_referer( 'frm_ajax', 'nonce' );
3677	2834
3678	2835	$html = FrmAppHelper::clip(
3679		- function () {
	2836	+ function() {
3680	2837	FrmAppHelper::maybe_autocomplete_pages_options(
3681	2838	array(
3682	2839	'field_name' => 'frm_page_dropdown',
3683	2840	'page_id' => '',
		@@ -3695,14 +2852,114 @@
3695	2852	);
3696	2853	}
3697	2854
3698	2855	/**
3699		- * @deprecated 4.0
	2856	+ * Maybe migrate submit settings from the form options to On Submit action.
	2857	+ * This is added after On Submit action is released. This might migrate the frontend editing submit settings too.
3700	2858	*
3701		- * @param array $values
	2859	+ * @since 6.0
3702	2860	*
3703		- * @return void
	2861	+ * @param int $form_id Form ID.
3704	2862	*/
	2863	+ private static function maybe_migrate_submit_settings_to_action( $form_id ) {
	2864	+ $form = FrmDb::get_row( 'frm_forms', array( 'id' => $form_id ), 'options,editable' );
	2865	+ if ( ! $form ) {
	2866	+ return;
	2867	+ }
	2868	+
	2869	+ FrmAppHelper::unserialize_or_decode( $form->options );
	2870	+
	2871	+ $flag_key = 'on_submit_migrated';
	2872	+ if ( ! empty( $form->options[ $flag_key ] ) ) {
	2873	+ return;
	2874	+ }
	2875	+
	2876	+ $form->id = $form_id;
	2877	+
	2878	+ // Create On Submit action.
	2879	+ $base_action = array();
	2880	+
	2881	+ $base_action['post_type'] = FrmFormActionsController::$action_post_type;
	2882	+ $base_action['post_excerpt'] = FrmOnSubmitAction::$slug;
	2883	+ $base_action['post_title'] = FrmOnSubmitAction::get_name();
	2884	+ $base_action['menu_order'] = $form_id;
	2885	+ $base_action['post_status'] = 'publish';
	2886	+ $base_action['post_content'] = array(
	2887	+ 'event' => array( 'create' ),
	2888	+ );
	2889	+
	2890	+ $action_data = self::get_on_submit_action_data_from_form_options( $form->options );
	2891	+
	2892	+ // If frontend editing is enabled, migrate its settings too.
	2893	+ if ( method_exists( 'FrmProFormActionsController', 'change_on_submit_action_ops' ) && FrmAppHelper::pro_is_connected() && $form->editable ) {
	2894	+ $edit_data = self::get_on_submit_action_data_from_form_options( $form->options, 'update' );
	2895	+
	2896	+ if ( $action_data === $edit_data ) {
	2897	+ // Just create one action for both create and update if they are the same.
	2898	+ $base_action['post_content']['event'][] = 'update';
	2899	+ } else {
	2900	+ // Create a separate action for update.
	2901	+ $edit_action = $base_action;
	2902	+ $edit_action['post_content'] += $edit_data;
	2903	+ $edit_action['post_content']['event'] = array( 'update' );
	2904	+
	2905	+ $edit_action['post_content'] = FrmAppHelper::prepare_and_encode( $edit_action['post_content'] );
	2906	+ FrmDb::save_json_post( $edit_action );
	2907	+ }
	2908	+ }
	2909	+
	2910	+ $action = $base_action;
	2911	+ $action['post_content'] += $action_data;
	2912	+
	2913	+ $action['post_content'] = FrmAppHelper::prepare_and_encode( $action['post_content'] );
	2914	+ FrmDb::save_json_post( $action );
	2915	+
	2916	+ $form->options[ $flag_key ] = 1;
	2917	+ FrmForm::update( $form->id, array( 'options' => $form->options ) );
	2918	+ }
	2919	+
	2920	+ /**
	2921	+ * Gets On Submit action data from form options to be used for the migration.
	2922	+ *
	2923	+ * @since 6.0
	2924	+ *
	2925	+ * @param array $form_options Form options.
	2926	+ * @param string $event Action event. Accepts `create` or `update`. Default is `create`.
	2927	+ * @return array
	2928	+ */
	2929	+ private static function get_on_submit_action_data_from_form_options( $form_options, $event = 'create' ) {
	2930	+ $opt = 'update' === $event ? 'edit_' : 'success_';
	2931	+ $data = array(
	2932	+ 'success_action' => isset( $form_options[ $opt . 'action' ] ) ? $form_options[ $opt . 'action' ] : FrmOnSubmitHelper::get_default_action_type(),
	2933	+ );
	2934	+
	2935	+ switch ( $data['success_action'] ) {
	2936	+ case 'redirect':
	2937	+ $data['success_url'] = isset( $form_options[ $opt . 'url' ] ) ? $form_options[ $opt . 'url' ] : '';
	2938	+ break;
	2939	+
	2940	+ case 'page':
	2941	+ $data['success_page_id'] = isset( $form_options[ $opt . 'page_id' ] ) ? $form_options[ $opt . 'page_id' ] : '';
	2942	+ break;
	2943	+
	2944	+ default:
	2945	+ $data['success_msg'] = isset( $form_options[ $opt . 'msg' ] ) ? $form_options[ $opt . 'msg' ] : FrmOnSubmitHelper::get_default_msg();
	2946	+ $data['show_form'] = ! empty( $form_options['show_form'] );
	2947	+ }
	2948	+
	2949	+ return $data;
	2950	+ }
	2951	+
	2952	+ /**
	2953	+ * @deprecated 4.0
	2954	+ */
	2955	+ public static function new_form( $values = array() ) {
	2956	+ FrmDeprecated::new_form( $values );
	2957	+ }
	2958	+
	2959	+ /**
	2960	+ * @deprecated 4.0
	2961	+ */
3705	2962	public static function create( $values = array() ) {
3706	2963	_deprecated_function( __METHOD__, '4.0', 'FrmFormsController::update' );
3707	2964	self::update( $values );
3708	2965	}
		@@ -3707,16 +2964,51 @@
3707	2964	self::update( $values );
3708	2965	}
3709	2966
3710	2967	/**
3711		- * Education for premium features.
3712		- *
3713		- * @since 4.05
3714		- * @deprecated 6.16.3
3715		- *
3716		- * @return void
	2968	+ * @deprecated 1.07.05
	2969	+ * @codeCoverageIgnore
3717	2970	*/
3718		- public static function add_form_style_tab_options() {
3719		- _deprecated_function( __METHOD__, '6.16.3' );
3720		- include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/add_form_style_options.php';
	2971	+ public static function add_default_templates( $path, $default = true, $template = true ) {
	2972	+ FrmDeprecated::add_default_templates( $path, $default, $template );
	2973	+ }
	2974	+
	2975	+ /**
	2976	+ * @deprecated 3.0
	2977	+ * @codeCoverageIgnore
	2978	+ */
	2979	+ public static function bulk_create_template( $ids ) {
	2980	+ return FrmDeprecated::bulk_create_template( $ids );
	2981	+ }
	2982	+
	2983	+ /**
	2984	+ * @deprecated 2.03
	2985	+ * @codeCoverageIgnore
	2986	+ */
	2987	+ public static function register_pro_scripts() {
	2988	+ FrmDeprecated::register_pro_scripts();
	2989	+ }
	2990	+
	2991	+ /**
	2992	+ * @deprecated 3.0
	2993	+ * @codeCoverageIgnore
	2994	+ */
	2995	+ public static function edit_key() {
	2996	+ FrmDeprecated::edit_key();
	2997	+ }
	2998	+
	2999	+ /**
	3000	+ * @deprecated 3.0
	3001	+ * @codeCoverageIgnore
	3002	+ */
	3003	+ public static function edit_description() {
	3004	+ FrmDeprecated::edit_description();
	3005	+ }
	3006	+
	3007	+ /**
	3008	+ * @deprecated 4.08
	3009	+ * @since 3.06
	3010	+ */
	3011	+ public static function add_new() {
	3012	+ _deprecated_function( __FUNCTION__, '4.08' );
3721	3013	}
3722	3014	}