PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 6.7.2
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v6.7.2
6.35 6.34 6.33.1 6.33 6.32.1 6.32 6.31 6.25 6.25.1 6.26 6.26.1 6.27 6.28 6.29 6.3 6.3.1 6.3.2 6.30 6.4 6.4.1 6.4.2 6.5 6.5.1 6.5.2 6.5.3 All 141 releases
← All changes | classes/helpers/FrmFormsHelper.php +313 -674 6.28 → 6.7.2 View file →
@@ -5,43 +5,21 @@
5 5
6 6 class FrmFormsHelper {
7 7
8 8 /**
9 - * Store and re-use field type data for the insert_opt_html function (to avoid multiple calls to FrmField::all_field_selection).
10 - *
11 - * @since 6.10
12 - *
13 - * @var array|null
14 - */
15 - private static $field_type_data_for_insert_opt_html;
16 -
17 - /**
18 9 * @since 2.2.10
19 - *
20 - * @return string
21 10 */
22 11 public static function form_error_class() {
23 12 return apply_filters( 'frm_form_error_class', 'frm_error_style' );
24 13 }
25 14
26 - /**
27 - * @param string $key
28 - * @param false|object $form
29 - *
30 - * @return string
31 - */
32 15 public static function get_direct_link( $key, $form = false ) {
33 16 $target_url = esc_url( admin_url( 'admin-ajax.php?action=frm_forms_preview&form=' . $key ) );
34 - return apply_filters( 'frm_direct_link', $target_url, $key, $form );
17 + $target_url = apply_filters( 'frm_direct_link', $target_url, $key, $form );
18 +
19 + return $target_url;
35 20 }
36 21
37 - /**
38 - * @param string $field_name
39 - * @param int|string $field_value
40 - * @param array $args
41 - *
42 - * @return void
43 - */
44 22 public static function forms_dropdown( $field_name, $field_value = '', $args = array() ) {
45 23 $defaults = array(
46 24 'blank' => true,
47 25 'field_id' => false,
@@ -56,9 +34,8 @@
56 34 $args['field_id'] = $field_name;
57 35 }
58 36
59 37 $query = array();
60 -
61 38 if ( $args['exclude'] ) {
62 39 $query['id !'] = $args['exclude'];
63 40 }
64 41
@@ -67,47 +44,41 @@
67 44 $add_html = array();
68 45 self::add_html_attr( $args['onchange'], 'onchange', $add_html );
69 46 self::add_html_attr( $args['class'], 'class', $add_html );
70 47
71 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
72 48 ?>
73 49 <select name="<?php echo esc_attr( $field_name ); ?>"
74 50 id="<?php echo esc_attr( $args['field_id'] ); ?>"
75 51 <?php echo wp_strip_all_tags( implode( ' ', $add_html ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>>
76 52 <?php if ( $args['blank'] ) { ?>
77 - <option value=""><?php echo $args['blank'] == 1 ? ' ' : '- ' . esc_attr( $args['blank'] ) . ' -'; // phpcs:ignore Universal.Operators.StrictComparisons ?></option>
53 + <option value=""><?php echo ( $args['blank'] == 1 ) ? ' ' : '- ' . esc_attr( $args['blank'] ) . ' -'; ?></option>
78 54 <?php } ?>
79 55 <?php foreach ( $forms as $form ) { ?>
80 56 <option value="<?php echo esc_attr( $form->id ); ?>" <?php selected( $field_value, $form->id ); ?>>
81 - <?php echo esc_html( '' === $form->name ? self::get_no_title_text() : FrmAppHelper::truncate( $form->name, 50 ) . ( $form->parent_form_id ? __( ' (child)', 'formidable' ) : '' ) ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong ?>
57 + <?php echo esc_html( '' === $form->name ? __( '(no title)', 'formidable' ) : FrmAppHelper::truncate( $form->name, 50 ) . ( $form->parent_form_id ? __( ' (child)', 'formidable' ) : '' ) ); ?>
82 58 </option>
83 59 <?php } ?>
84 60 </select>
85 61 <?php
86 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
87 62 }
88 63
89 64 /**
90 - * @since 2.0.6
91 - *
92 65 * @param string $class
93 66 * @param string $param
94 67 * @param array $add_html
95 68 *
96 - * @return void
69 + * @since 2.0.6
97 70 */
98 71 public static function add_html_attr( $class, $param, &$add_html ) {
99 - if ( $class ) {
100 - $add_html[ $param ] = sanitize_title( $param ) . '="' . esc_attr( sanitize_text_field( $class ) ) . '"';
72 + if ( ! empty( $class ) ) {
73 + $add_html[ $param ] = sanitize_title( $param ) . '="' . esc_attr( trim( sanitize_text_field( $class ) ) ) . '"';
101 74 }
102 75 }
103 76
104 77 /**
105 - * @param false|object|string $selected - The label for the placeholder, or the form object.
106 - *
107 - * @return void
78 + * @param string|object|false $selected - The label for the placeholder, or the form object.
108 79 */
109 - public static function form_switcher( $selected = false ) { // phpcs:ignore SlevomatCodingStandard.Complexity.Cognitive.ComplexityTooHigh, Generic.Metrics.CyclomaticComplexity.MaxExceeded, SlevomatCodingStandard.Files.LineLength.LineTooLong
80 + public static function form_switcher( $selected = false ) {
110 81 $where = apply_filters( 'frm_forms_dropdown', array(), '' );
111 82 $forms = FrmForm::get_published_forms( $where );
112 83
113 84 $args = array(
@@ -113,9 +84,8 @@
113 84 $args = array(
114 85 'id' => 0,
115 86 'form' => 0,
116 87 );
117 -
118 88 if ( isset( $_GET['id'] ) && ! isset( $_GET['form'] ) ) {
119 89 unset( $args['form'] );
120 90 } elseif ( isset( $_GET['form'] ) && ! isset( $_GET['id'] ) ) {
121 91 unset( $args['id'] );
@@ -121,13 +91,12 @@
121 91 unset( $args['id'] );
122 92 }
123 93
124 94 $frm_action = FrmAppHelper::simple_get( 'frm_action', 'sanitize_title' );
125 -
126 - if ( FrmAppHelper::is_admin_page( 'formidable-entries' ) && in_array( $frm_action, array( 'edit', 'show', 'destroy', 'destroy_all' ), true ) ) {
95 + if ( FrmAppHelper::is_admin_page( 'formidable-entries' ) && in_array( $frm_action, array( 'edit', 'show', 'destroy', 'destroy_all' ) ) ) {
127 96 $args['frm_action'] = 'list';
128 97 $args['form'] = 0;
129 - } elseif ( FrmAppHelper::is_admin_page( 'formidable' ) && in_array( $frm_action, array( 'new', 'duplicate' ), true ) ) {
98 + } elseif ( FrmAppHelper::is_admin_page( 'formidable' ) && in_array( $frm_action, array( 'new', 'duplicate' ) ) ) {
130 99 $args['frm_action'] = 'edit';
131 100 } elseif ( FrmAppHelper::is_style_editor_page() ) {
132 101 // Avoid passing style into form switcher on style page.
133 102 unset( $args['id'] );
@@ -133,31 +102,27 @@
133 102 unset( $args['id'] );
134 103 $query_args = array(
135 104 'page' => 'formidable-styles',
136 105 );
137 -
138 106 if ( $frm_action ) {
139 107 $query_args['frm_action'] = $frm_action;
140 108 }
141 -
142 109 $base = add_query_arg( $query_args, admin_url( 'admin.php' ) );
143 110 } elseif ( isset( $_GET['post'] ) ) {
144 111 $args['form'] = 0;
145 112 $base = admin_url( 'edit.php?post_type=frm_display' );
146 - }//end if
113 + }
147 114
148 115 $form_id = 0;
149 -
150 116 if ( is_object( $selected ) ) {
151 117 $form_id = $selected->id;
152 118 $selected = $selected->name;
153 119 }
154 120
155 - $name = $selected === false ? __( 'Switch Form', 'formidable' ) : $selected;
156 - $name = '' === $name || is_null( $name ) ? self::get_no_title_text() : strip_tags( $name );
121 + $name = ( $selected === false ) ? __( 'Switch Form', 'formidable' ) : $selected;
122 + $name = '' === $name ? __( '(no title)', 'formidable' ) : strip_tags( $name );
157 123 $truncated_name = FrmAppHelper::truncate( $name, 25 );
158 124
159 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
160 125 if ( count( $forms ) < 2 ) {
161 126 ?>
162 127 <div id="frm_bs_dropdown">
163 128 <h1>
@@ -187,10 +152,8 @@
187 152 array(
188 153 'input_id' => 'dropform',
189 154 'placeholder' => __( 'Search Forms', 'formidable' ),
190 155 'tosearch' => 'frm-dropdown-form',
191 - // Specify a value to avoid the $_REQUEST['s'] default value.
192 - 'value' => '',
193 156 )
194 157 );
195 158 ?>
196 159 </li>
@@ -204,15 +167,14 @@
204 167
205 168 if ( isset( $args['id'] ) ) {
206 169 $args['id'] = $form->id;
207 170 }
208 -
209 171 if ( isset( $args['form'] ) ) {
210 172 $args['form'] = $form->id;
211 173 }
212 174
213 175 $url = isset( $base ) ? add_query_arg( $args, $base ) : add_query_arg( $args );
214 - $form_name = ! empty( $form->name ) ? $form->name : self::get_no_title_text();
176 + $form_name = empty( $form->name ) ? __( '(no title)', 'formidable' ) : $form->name;
215 177 ?>
216 178 <li class="frm-dropdown-form">
217 179 <a href="<?php echo esc_url( $url ); ?>" tabindex="-1" class="frm-justify-between">
218 180 <?php echo esc_html( $form_name ); ?>
@@ -234,43 +196,49 @@
234 196 ?>
235 197 </ul>
236 198 </div>
237 199 <?php
238 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
239 200 }
240 201
241 202 /**
242 - * @param string $col
243 - * @param string $sort_col
244 - * @param string $sort_dir
203 + * @since 3.05
204 + * @deprecated 4.0
245 205 *
246 - * @return void
206 + * @param array $values The form array.
247 207 */
208 + public static function builder_submit_button( $values ) {
209 + FrmDeprecated::builder_submit_button( $values );
210 + }
211 +
248 212 public static function get_sortable_classes( $col, $sort_col, $sort_dir ) {
249 - echo $sort_col == $col ? 'sorted' : 'sortable'; // phpcs:ignore Universal.Operators.StrictComparisons
250 - echo $sort_col == $col && $sort_dir === 'desc' ? ' asc' : ' desc'; // phpcs:ignore Universal.Operators.StrictComparisons
213 + echo ( $sort_col == $col ) ? 'sorted' : 'sortable';
214 + echo ( $sort_col == $col && $sort_dir === 'desc' ) ? ' asc' : ' desc';
251 215 }
252 216
253 217 /**
254 218 * @since 3.0
255 - *
256 - * @param array|string $field_type
257 - *
258 - * @return string
259 219 */
260 220 public static function get_field_link_name( $field_type ) {
261 - return is_array( $field_type ) ? $field_type['name'] : $field_type;
221 + if ( is_array( $field_type ) ) {
222 + $field_label = $field_type['name'];
223 + } else {
224 + $field_label = $field_type;
225 + }
226 +
227 + return $field_label;
262 228 }
263 229
264 230 /**
265 231 * @since 3.0
266 - *
267 - * @param array|string $field_type
268 - *
269 - * @return string
270 232 */
271 233 public static function get_field_link_icon( $field_type ) {
272 - return is_array( $field_type ) && isset( $field_type['icon'] ) ? $field_type['icon'] : 'frmfont frm_pencil_icon';
234 + if ( is_array( $field_type ) && isset( $field_type['icon'] ) ) {
235 + $icon = $field_type['icon'];
236 + } else {
237 + $icon = 'frm_icon_font frm_pencil_icon';
238 + }
239 +
240 + return $icon;
273 241 }
274 242
275 243 /**
276 244 * Get the invalid form error message
@@ -282,15 +250,14 @@
282 250 * @return string
283 251 */
284 252 public static function get_invalid_error_message( $args ) {
285 253 $settings_args = $args;
286 -
287 254 if ( isset( $args['form'] ) ) {
288 255 $settings_args['current_form'] = $args['form']->id;
289 256 }
290 257
291 258 $frm_settings = FrmAppHelper::get_settings( $settings_args );
292 - $invalid_msg = do_shortcode( $frm_settings->invalid_msg );
259 + $invalid_msg = do_shortcode( $frm_settings->invalid_msg );
293 260 return apply_filters( 'frm_invalid_error_message', $invalid_msg, $args );
294 261 }
295 262
296 263 /**
@@ -301,48 +268,24 @@
301 268 * @type stdClass $form
302 269 * @type int $entry_id
303 270 * @type string $class
304 271 * }
305 - *
306 272 * @return string
307 273 */
308 274 public static function get_success_message( $atts ) {
309 275 $message = apply_filters( 'frm_content', $atts['message'], $atts['form'], $atts['entry_id'] );
310 -
311 - // Only autop if the message includes line breaks.
312 - $autop = str_contains( $message, "\n" );
313 -
314 - /**
315 - * Filters whether to autop the success message.
316 - * This is false by default if the message does not include line breaks.
317 - *
318 - * @since 6.23
319 - *
320 - * @param bool $autop
321 - * @param string $message
322 - * @param object $form
323 - */
324 - $autop = (bool) apply_filters( 'frm_wpautop_success_message', $autop, $message, $atts['form'] );
325 -
326 - if ( $autop ) {
327 - $message = FrmAppHelper::use_wpautop( $message );
328 - }
329 -
330 - $message = do_shortcode( $message );
331 - return '<div class="' . esc_attr( $atts['class'] ) . '" role="status">' . $message . '</div>';
276 + $message = do_shortcode( FrmAppHelper::use_wpautop( $message ) );
277 + $message = '<div class="' . esc_attr( $atts['class'] ) . '" role="status">' . $message . '</div>';
278 + return $message;
332 279 }
333 280
334 281 /**
335 282 * Used when a form is created
336 - *
337 - * @param array $values
338 - *
339 - * @return array
340 283 */
341 284 public static function setup_new_vars( $values = array() ) {
342 285 global $wpdb;
343 286
344 - if ( $values ) {
287 + if ( ! empty( $values ) ) {
345 288 $post_values = $values;
346 289 } else {
347 290 $values = array();
348 291 $post_values = ! empty( $_POST ) ? $_POST : array(); // phpcs:ignore WordPress.Security.NonceVerification.Missing
@@ -351,9 +294,8 @@
351 294 $defaults = array(
352 295 'name' => '',
353 296 'description' => '',
354 297 );
355 -
356 298 foreach ( $defaults as $var => $default ) {
357 299 if ( ! isset( $values[ $var ] ) ) {
358 300 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
359 301 }
@@ -368,9 +310,8 @@
368 310 'is_template' => 0,
369 311 'status' => 'published',
370 312 'parent_form_id' => 0,
371 313 );
372 -
373 314 foreach ( $defaults as $var => $default ) {
374 315 if ( ! isset( $values[ $var ] ) ) {
375 316 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
376 317 }
@@ -377,9 +318,9 @@
377 318 }
378 319 unset( $defaults );
379 320
380 321 if ( ! isset( $values['form_key'] ) ) {
381 - $values['form_key'] = $post_values && isset( $post_values['form_key'] ) ? $post_values['form_key'] : FrmAppHelper::get_unique_key( '', $wpdb->prefix . 'frm_forms', 'form_key' ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
322 + $values['form_key'] = ( $post_values && isset( $post_values['form_key'] ) ) ? $post_values['form_key'] : FrmAppHelper::get_unique_key( '', $wpdb->prefix . 'frm_forms', 'form_key' );
382 323 }
383 324
384 325 $values = self::fill_default_opts( $values, false, $post_values );
385 326 $values['custom_style'] = FrmAppHelper::custom_style_value( $post_values );
@@ -388,22 +329,16 @@
388 329 }
389 330
390 331 /**
391 332 * Used when editing a form
392 - *
393 - * @param array $values
394 - * @param object $record
395 - * @param array $post_values
396 - *
397 - * @return array
398 333 */
399 334 public static function setup_edit_vars( $values, $record, $post_values = array() ) {
400 - if ( ! $post_values ) {
335 + if ( empty( $post_values ) ) {
401 336 $post_values = wp_unslash( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
402 337 }
403 338
404 - $values['form_key'] = $post_values['form_key'] ?? $record->form_key;
405 - $values['is_template'] = $post_values['is_template'] ?? $record->is_template;
339 + $values['form_key'] = isset( $post_values['form_key'] ) ? $post_values['form_key'] : $record->form_key;
340 + $values['is_template'] = isset( $post_values['is_template'] ) ? $post_values['is_template'] : $record->is_template;
406 341 $values['status'] = $record->status;
407 342
408 343 $values = self::fill_default_opts( $values, $record, $post_values );
409 344
@@ -409,31 +344,23 @@
409 344
410 345 return apply_filters( 'frm_setup_edit_form_vars', $values );
411 346 }
412 347
413 - /**
414 - * @param array $values
415 - * @param false|object $record
416 - * @param array|false $post_values
417 - *
418 - * @return array
419 - */
420 - public static function fill_default_opts( $values, $record, $post_values ) { // phpcs:ignore SlevomatCodingStandard.Complexity.Cognitive.ComplexityTooHigh
348 + public static function fill_default_opts( $values, $record, $post_values ) {
421 349
422 350 $defaults = self::get_default_opts();
423 -
424 351 foreach ( $defaults as $var => $default ) {
425 352 if ( is_array( $default ) ) {
426 353 if ( ! isset( $values[ $var ] ) ) {
427 - $values[ $var ] = $record && isset( $record->options[ $var ] ) ? $record->options[ $var ] : array();
354 + $values[ $var ] = ( $record && isset( $record->options[ $var ] ) ) ? $record->options[ $var ] : array();
428 355 }
429 356
430 357 foreach ( $default as $k => $v ) {
431 - $values[ $var ][ $k ] = $post_values && isset( $post_values[ $var ][ $k ] ) ? $post_values[ $var ][ $k ] : ( $record && isset( $record->options[ $var ] ) && isset( $record->options[ $var ][ $k ] ) ? $record->options[ $var ][ $k ] : $v ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
358 + $values[ $var ][ $k ] = ( $post_values && isset( $post_values[ $var ][ $k ] ) ) ? $post_values[ $var ][ $k ] : ( ( $record && isset( $record->options[ $var ] ) && isset( $record->options[ $var ][ $k ] ) ) ? $record->options[ $var ][ $k ] : $v );
432 359
433 360 if ( is_array( $v ) ) {
434 361 foreach ( $v as $k1 => $v1 ) {
435 - $values[ $var ][ $k ][ $k1 ] = $post_values && isset( $post_values[ $var ][ $k ][ $k1 ] ) ? $post_values[ $var ][ $k ][ $k1 ] : ( $record && isset( $record->options[ $var ] ) && isset( $record->options[ $var ][ $k ] ) && isset( $record->options[ $var ][ $k ][ $k1 ] ) ? $record->options[ $var ][ $k ][ $k1 ] : $v1 ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
362 + $values[ $var ][ $k ][ $k1 ] = ( $post_values && isset( $post_values[ $var ][ $k ][ $k1 ] ) ) ? $post_values[ $var ][ $k ][ $k1 ] : ( ( $record && isset( $record->options[ $var ] ) && isset( $record->options[ $var ][ $k ] ) && isset( $record->options[ $var ][ $k ][ $k1 ] ) ) ? $record->options[ $var ][ $k ][ $k1 ] : $v1 );
436 363 unset( $k1, $v1 );
437 364 }
438 365 }
439 366
@@ -439,9 +366,9 @@
439 366
440 367 unset( $k, $v );
441 368 }
442 369 } else {
443 - $values[ $var ] = $post_values && isset( $post_values['options'][ $var ] ) ? $post_values['options'][ $var ] : ( $record && isset( $record->options[ $var ] ) ? $record->options[ $var ] : $default ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
370 + $values[ $var ] = ( $post_values && isset( $post_values['options'][ $var ] ) ) ? $post_values['options'][ $var ] : ( ( $record && isset( $record->options[ $var ] ) ) ? $record->options[ $var ] : $default );
444 371 }
445 372
446 373 unset( $var, $default );
447 374 }//end foreach
@@ -460,9 +387,9 @@
460 387 'success_action' => 'message',
461 388 'success_msg' => $frm_settings->success_msg,
462 389 'show_form' => 0,
463 390 'akismet' => '',
464 - 'stopforumspam' => 0,
391 + 'honeypot' => 'basic',
465 392 'antispam' => 0,
466 393 'no_save' => 0,
467 394 'ajax_load' => 0,
468 395 'js_validate' => 0,
@@ -477,20 +404,17 @@
477 404 );
478 405 }
479 406
480 407 /**
481 - * @since 2.0.6
482 - *
483 408 * @param array $options
484 409 * @param array $values
485 410 *
486 - * @return void
411 + * @since 2.0.6
487 412 */
488 413 public static function fill_form_options( &$options, $values ) {
489 414 $defaults = self::get_default_opts();
490 -
491 415 foreach ( $defaults as $var => $default ) {
492 - $options[ $var ] = $values['options'][ $var ] ?? $default;
416 + $options[ $var ] = isset( $values['options'][ $var ] ) ? $values['options'][ $var ] : $default;
493 417 unset( $var, $default );
494 418 }
495 419 }
496 420
@@ -495,10 +419,8 @@
495 419 }
496 420
497 421 /**
498 422 * @param string $loc
499 - *
500 - * @return string
501 423 */
502 424 public static function get_default_html( $loc ) {
503 425 if ( $loc === 'submit' ) {
504 426 $draft_link = self::get_draft_link();
@@ -523,13 +445,12 @@
523 445
524 446 return $default_html;
525 447 }
526 448
527 - /**
528 - * @return string
529 - */
530 449 public static function get_draft_link() {
531 - return '[if save_draft]<button class="frm_save_draft" [draft_hook]>[draft_label]</button>[/if save_draft]';
450 + $link = '[if save_draft]<a href="#" tabindex="0" class="frm_save_draft" [draft_hook]>[draft_label]</a>[/if save_draft]';
451 +
452 + return $link;
532 453 }
533 454
534 455 /**
535 456 * Gets start over button shortcode.
@@ -541,21 +462,11 @@
541 462 public static function get_start_over_shortcode() {
542 463 return '[if start_over]<a href="#" tabindex="0" class="frm_start_over" [start_over_hook]>[start_over_label]</a>[/if start_over]';
543 464 }
544 465
545 - /**
546 - * @param string $html
547 - * @param object $form
548 - * @param string $submit
549 - * @param object|null $form_action
550 - * @param array $values
551 - *
552 - * @return void
553 - */
554 466 public static function get_custom_submit( $html, $form, $submit, $form_action, $values ) {
555 467 $button = self::replace_shortcodes( $html, $form, $submit, $form_action, $values );
556 -
557 - if ( ! str_contains( $button, '[button_action]' ) ) {
468 + if ( ! strpos( $button, '[button_action]' ) ) {
558 469 echo FrmAppHelper::maybe_kses( $button ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
559 470 return;
560 471 }
561 472
@@ -562,21 +473,18 @@
562 473 /**
563 474 * @since 5.0.06
564 475 */
565 476 $button = apply_filters( 'frm_submit_button_html', $button, compact( 'form' ) );
566 -
567 477 if ( FrmAppHelper::should_never_allow_unfiltered_html() ) {
568 478 $button = FrmAppHelper::kses_submit_button( $button );
569 479 }
570 -
571 480 $button_parts = explode( '[button_action]', $button );
572 - $classes = apply_filters( 'frm_submit_button_class', array(), $form );
573 481
574 - if ( $classes ) {
482 + $classes = apply_filters( 'frm_submit_button_class', array(), $form );
483 + if ( ! empty( $classes ) ) {
575 484 $classes = implode( ' ', $classes );
576 - $button_class = 'frm_button_submit';
577 -
578 - if ( preg_match( '/\bclass="[^"]*?\b' . preg_quote( $button_class, '/' ) . '\b[^"]*?"/', $button_parts[0] ) ) {
485 + $button_class = ' class="frm_button_submit';
486 + if ( strpos( $button_parts[0], $button_class ) !== false ) {
579 487 $button_parts[0] = str_replace( $button_class, $button_class . ' ' . esc_attr( $classes ), $button_parts[0] );
580 488 } else {
581 489 $button_parts[0] .= ' class="' . esc_attr( $classes ) . '"';
582 490 }
@@ -588,56 +496,54 @@
588 496 }
589 497
590 498 /**
591 499 * @since 4.0
592 - *
593 - * @return array
594 500 */
595 501 public static function html_shortcodes() {
596 502 $codes = array(
597 - 'id' => array(
503 + 'id' => array(
598 504 'label' => __( 'Field ID', 'formidable' ),
599 505 'class' => 'show_field_custom_html',
600 506 ),
601 - 'key' => array(
507 + 'key' => array(
602 508 'label' => __( 'Field Key', 'formidable' ),
603 509 'class' => 'show_field_custom_html',
604 510 ),
605 - 'field_name' => array(
511 + 'field_name' => array(
606 512 'label' => __( 'Field Name', 'formidable' ),
607 513 'class' => 'show_field_custom_html',
608 514 ),
609 - 'description' => array(
515 + 'description' => array(
610 516 'label' => __( 'Field Description', 'formidable' ),
611 517 'class' => 'show_field_custom_html',
612 518 ),
613 - 'label_position' => array(
519 + 'label_position' => array(
614 520 'label' => __( 'Label Position', 'formidable' ),
615 521 'class' => 'show_field_custom_html',
616 522 ),
617 - 'required_label' => array(
523 + 'required_label' => array(
618 524 'label' => __( 'Required Label', 'formidable' ),
619 525 'class' => 'show_field_custom_html',
620 526 ),
621 - 'input' => array(
527 + 'input' => array(
622 528 'label' => __( 'Input Field', 'formidable' ),
623 529 'class' => 'show_field_custom_html',
624 530 ),
625 - 'input opt=1' => array(
531 + 'input opt=1' => array(
626 532 'label' => __( 'Single Option', 'formidable' ),
627 533 'title' => __( 'Show a single radio or checkbox option by replacing 1 with the order of the option', 'formidable' ),
628 534 'class' => 'show_field_custom_html',
629 535 ),
630 - 'input label=0' => array(
536 + 'input label=0' => array(
631 537 'label' => __( 'Hide Option Label', 'formidable' ),
632 538 'class' => 'show_field_custom_html',
633 539 ),
634 - 'required_class' => array(
540 + 'required_class' => array(
635 541 'label' => __( 'Required Class', 'formidable' ),
636 542 'title' => __( 'Add class name if field is required', 'formidable' ),
637 543 'class' => 'show_field_custom_html',
638 544 ),
639 - 'error_class' => array(
545 + 'error_class' => array(
640 546 'label' => __( 'Error Class', 'formidable' ),
641 547 'title' => __( 'Add class name if field has an error on form submit', 'formidable' ),
642 548 'class' => 'show_field_custom_html',
643 549 ),
@@ -658,13 +564,13 @@
658 564 'label' => __( 'Delete Entry Link', 'formidable' ),
659 565 'class' => 'show_before_html show_after_html',
660 566 ),
661 567
662 - 'button_label' => array(
568 + 'button_label' => array(
663 569 'label' => __( 'Button Label', 'formidable' ),
664 570 'class' => 'show_submit_html',
665 571 ),
666 - 'button_action' => array(
572 + 'button_action' => array(
667 573 'label' => __( 'Button Hook', 'formidable' ),
668 574 'class' => 'show_submit_html',
669 575 ),
670 576 );
@@ -676,17 +582,14 @@
676 582 }
677 583
678 584 /**
679 585 * @since 4.0
680 - *
681 586 * @param array $args
682 - *
683 - * @return void
684 587 */
685 588 public static function insert_opt_html( $args ) {
686 - $class = $args['class'] ?? '';
687 - $fields = self::get_field_type_data_for_insert_opt_html();
688 - $field = $fields[ $args['type'] ] ?? array();
589 + $class = isset( $args['class'] ) ? $args['class'] : '';
590 + $fields = FrmField::all_field_selection();
591 + $field = isset( $fields[ $args['type'] ] ) ? $fields[ $args['type'] ] : array();
689 592
690 593 self::prepare_field_type( $field );
691 594
692 595 if ( ! isset( $field['icon'] ) ) {
@@ -693,9 +596,8 @@
693 596 $field['icon'] = 'frmfont frm_pencil_icon';
694 597 }
695 598
696 599 $possible_email_field = FrmFieldFactory::field_has_property( $args['type'], 'holds_email_values' );
697 -
698 600 if ( $possible_email_field ) {
699 601 $class .= ' show_frm_not_email_to';
700 602 }
701 603
@@ -701,60 +603,31 @@
701 603
702 604 if ( 'url' === $args['type'] ) {
703 605 $class .= ' frm_insert_url';
704 606 }
705 -
706 - $truncated_name = FrmAppHelper::truncate( $args['name'], 60 );
707 -
708 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
709 607 ?>
710 608 <li class="<?php echo esc_attr( $class ); ?>">
711 - <a href="javascript:void(0)" class="frmids frm_insert_code" data-code="<?php echo esc_attr( $args['id'] ); ?>">
712 - <?php
713 - if ( isset( $field['icon'] ) ) {
714 - FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) );
715 - }
716 -
717 - echo esc_html( $truncated_name );
718 - ?>
719 - <span>[<?php echo esc_attr( $args['id_label'] ?? $args['id'] ); ?>]</span>
609 + <a href="javascript:void(0)" class="frmids frm_insert_code"
610 + data-code="<?php echo esc_attr( $args['id'] ); ?>">
611 + <?php FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) ); ?>
612 + <?php echo esc_attr( FrmAppHelper::truncate( $args['name'], 60 ) ); ?>
613 + <span>[<?php echo esc_attr( isset( $args['id_label'] ) ? $args['id_label'] : $args['id'] ); ?>]</span>
720 614 </a>
721 - <a href="javascript:void(0)" class="frmkeys frm_insert_code frm_hidden" data-code="<?php echo esc_attr( $args['key'] ); ?>">
722 - <?php
723 - if ( isset( $field['icon'] ) ) {
724 - FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) );
725 - }
726 -
727 - echo esc_html( $truncated_name );
728 - ?>
729 - <span>[<?php echo esc_attr( FrmAppHelper::truncate( $args['key_label'] ?? $args['key'], 7 ) ); ?>]</span>
615 + <a href="javascript:void(0)" class="frmkeys frm_insert_code frm_hidden"
616 + data-code="<?php echo esc_attr( $args['key'] ); ?>">
617 + <?php if ( isset( $field['icon'] ) ) { ?>
618 + <?php FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) ); ?>
619 + <?php } ?>
620 + <?php echo esc_attr( FrmAppHelper::truncate( $args['name'], 60 ) ); ?>
621 + <span>[<?php echo esc_attr( FrmAppHelper::truncate( isset( $args['key_label'] ) ? $args['key_label'] : $args['key'], 7 ) ); ?>]</span>
730 622 </a>
731 623 </li>
732 624 <?php
733 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
734 625 }
735 626
736 627 /**
737 - * Store and re-use field selection data for use when outputting shortcodes options in shortcode pop up.
738 - * This significantly improves performance by avoiding repeat calls to FrmField::all_field_selection.
739 - *
740 - * @since 6.10
741 - *
742 - * @return array
743 - */
744 - private static function get_field_type_data_for_insert_opt_html() {
745 - if ( ! isset( self::$field_type_data_for_insert_opt_html ) ) {
746 - self::$field_type_data_for_insert_opt_html = FrmField::all_field_selection();
747 - }
748 - return self::$field_type_data_for_insert_opt_html;
749 - }
750 -
751 - /**
752 628 * @since 4.0
753 - *
754 629 * @param array $args
755 - *
756 - * @return void
757 630 */
758 631 public static function insert_code_html( $args ) {
759 632 $defaults = array(
760 633 'class' => '',
@@ -765,9 +638,8 @@
765 638
766 639 $args = array_merge( $defaults, $args );
767 640 $has_tooltip = ! empty( $args['title'] );
768 641
769 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
770 642 ?>
771 643 <li class="<?php echo esc_attr( $args['class'] ); ?>">
772 644 <a href="javascript:void(0)" class="frm_insert_code <?php echo $has_tooltip ? 'frm_help' : ''; ?>"
773 645 <?php echo $has_tooltip ? 'title="' . esc_attr( $args['title'] ) . '"' : ''; ?>
@@ -778,9 +650,8 @@
778 650 </span>
779 651 </a>
780 652 </li>
781 653 <?php
782 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
783 654 }
784 655
785 656 /**
786 657 * Some field types in add-ons may have been added with only
@@ -786,18 +657,14 @@
786 657 * Some field types in add-ons may have been added with only
787 658 * a field type and name.
788 659 *
789 660 * @since 4.0
790 - *
791 - * @param array|string $field
792 - *
793 - * @return void
794 661 */
795 662 public static function prepare_field_type( &$field ) {
796 663 if ( ! is_array( $field ) ) {
797 664 $field = array(
798 665 'name' => $field,
799 - 'icon' => 'frmfont frm_pencil_icon',
666 + 'icon' => 'frm_icon_font frm_pencil_icon',
800 667 );
801 668 }
802 669 }
803 670
@@ -805,16 +672,14 @@
805 672 * Automatically add end section fields if they don't exist (2.0 migration)
806 673 *
807 674 * @since 2.0
808 675 *
809 - * @param object $form
810 - * @param array $fields
811 - * @param bool $reset_fields
812 - *
813 - * @return void
676 + * @param object $form
677 + * @param array $fields
678 + * @param boolean $reset_fields
814 679 */
815 680 public static function auto_add_end_section_fields( $form, $fields, &$reset_fields ) {
816 - if ( ! $fields ) {
681 + if ( empty( $fields ) ) {
817 682 return;
818 683 }
819 684
820 685 $end_section_values = apply_filters( 'frm_before_field_created', FrmFieldsHelper::setup_new_vars( 'end_divider', $form->id ) );
@@ -821,12 +686,11 @@
821 686 $open = false;
822 687 $prev_order = false;
823 688 $add_order = 0;
824 689 $last_field = false;
825 -
826 690 foreach ( $fields as $field ) {
827 691 if ( $prev_order === $field->field_order ) {
828 - ++$add_order;
692 + $add_order ++;
829 693 }
830 694
831 695 if ( $add_order ) {
832 696 $reset_fields = true;
@@ -866,17 +730,8 @@
866 730
867 731 /**
868 732 * Create end section field if it doesn't exist. This is for migration from < 2.0
869 733 * Fix any ordering that may be messed up
870 - *
871 - * @param bool $open
872 - * @param bool $reset_fields
873 - * @param int $add_order
874 - * @param array $end_section_values
875 - * @param object $field
876 - * @param string $move
877 - *
878 - * @return void
879 734 */
880 735 public static function maybe_create_end_section( &$open, &$reset_fields, &$add_order, $end_section_values, $field, $move = 'no' ) {
881 736 if ( ! $open ) {
882 737 return;
@@ -885,27 +740,18 @@
885 740 $end_section_values['field_order'] = $field->field_order + 1;
886 741
887 742 FrmField::create( $end_section_values );
888 743
889 - if ( $move === 'move' ) {
890 - // Bump the order of current field unless we're at the end of the form
744 + if ( $move == 'move' ) {
745 + // bump the order of current field unless we're at the end of the form
891 746 FrmField::update( $field->id, array( 'field_order' => $field->field_order + 2 ) );
892 747 }
893 748
894 - $add_order += 2;
749 + $add_order += 2;
895 750 $open = false;
896 751 $reset_fields = true;
897 752 }
898 753
899 - /**
900 - * @param string $html
901 - * @param object $form
902 - * @param bool $title
903 - * @param bool $description
904 - * @param array $values
905 - *
906 - * @return string
907 - */
908 754 public static function replace_shortcodes( $html, $form, $title = false, $description = false, $values = array() ) {
909 755 $codes = array(
910 756 'form_name' => $title,
911 757 'form_description' => $description,
@@ -910,9 +756,8 @@
910 756 'form_name' => $title,
911 757 'form_description' => $description,
912 758 'entry_key' => true,
913 759 );
914 -
915 760 foreach ( $codes as $code => $show ) {
916 761 if ( $code === 'form_name' ) {
917 762 $replace_with = $form->name;
918 763 } elseif ( $code === 'form_description' ) {
@@ -922,9 +767,9 @@
922 767 } else {
923 768 $replace_with = '';
924 769 }
925 770
926 - FrmShortcodeHelper::remove_inline_conditions( FrmAppHelper::is_true( $show ) && $replace_with != '', $code, $replace_with, $html ); // phpcs:ignore Universal.Operators.StrictComparisons, SlevomatCodingStandard.Files.LineLength.LineTooLong
771 + FrmShortcodeHelper::remove_inline_conditions( ( FrmAppHelper::is_true( $show ) && $replace_with != '' ), $code, $replace_with, $html );
927 772 }
928 773
929 774 // Replace [form_key].
930 775 $html = str_replace( '[form_key]', $form->form_key, $html );
@@ -931,9 +776,9 @@
931 776
932 777 // Replace [frmurl].
933 778 $html = str_replace( '[frmurl]', FrmFieldsHelper::dynamic_default_values( 'frmurl' ), $html );
934 779
935 - if ( str_contains( $html, '[button_label]' ) ) {
780 + if ( strpos( $html, '[button_label]' ) ) {
936 781 add_filter( 'frm_submit_button', 'FrmFormsHelper::submit_button_label', 1 );
937 782 $submit_label = apply_filters( 'frm_submit_button', $title, $form );
938 783 $submit_label = esc_attr( do_shortcode( $submit_label ) );
939 784 $html = str_replace( '[button_label]', $submit_label, $html );
@@ -940,32 +785,27 @@
940 785 }
941 786
942 787 $html = apply_filters( 'frm_form_replace_shortcodes', $html, $form, $values );
943 788
944 - if ( str_contains( $html, '[if back_button]' ) ) {
789 + if ( strpos( $html, '[if back_button]' ) ) {
945 790 $html = preg_replace( '/(\[if\s+back_button\])(.*?)(\[\/if\s+back_button\])/mis', '', $html );
946 791 }
947 792
948 - if ( str_contains( $html, '[if save_draft]' ) ) {
793 + if ( strpos( $html, '[if save_draft]' ) ) {
949 794 $html = preg_replace( '/(\[if\s+save_draft\])(.*?)(\[\/if\s+save_draft\])/mis', '', $html );
950 795 }
951 796
952 - if ( str_contains( $html, '[if start_over]' ) ) {
797 + if ( strpos( $html, '[if start_over]' ) ) {
953 798 $html = preg_replace( '/(\[if\s+start_over\])(.*?)(\[\/if\s+start_over\])/mis', '', $html );
954 799 }
955 800
956 801 if ( apply_filters( 'frm_do_html_shortcodes', true ) ) {
957 - return do_shortcode( $html );
802 + $html = do_shortcode( $html );
958 803 }
959 804
960 805 return $html;
961 806 }
962 807
963 - /**
964 - * @param string $submit
965 - *
966 - * @return string
967 - */
968 808 public static function submit_button_label( $submit ) {
969 809 if ( ! $submit ) {
970 810 $frm_settings = FrmAppHelper::get_settings();
971 811 $submit = $frm_settings->submit_value;
@@ -978,32 +818,28 @@
978 818 * If the Formidable styling isn't being loaded,
979 819 * use inline styling to hide the element
980 820 *
981 821 * @since 2.03.05
982 - *
983 - * @return void
984 822 */
985 823 public static function maybe_hide_inline() {
986 824 $frm_settings = FrmAppHelper::get_settings();
987 -
988 - if ( $frm_settings->load_style === 'none' ) {
825 + if ( $frm_settings->load_style == 'none' ) {
989 826 echo ' style="display:none;"';
990 - } elseif ( $frm_settings->load_style === 'dynamic' ) {
827 + } elseif ( $frm_settings->load_style == 'dynamic' ) {
991 828 FrmStylesController::enqueue_style();
992 829 }
993 830 }
994 831
995 - /**
996 - * @param array|bool|int|object|string $form
997 - *
998 - * @return string|null
999 - */
1000 832 public static function get_form_style_class( $form = false ) {
1001 833 $style = self::get_form_style( $form );
1002 834 $class = ' with_frm_style';
1003 835
1004 - if ( ! $style ) {
1005 - return FrmAppHelper::is_admin_page( 'formidable-entries' ) ? $class : null;
836 + if ( empty( $style ) ) {
837 + if ( FrmAppHelper::is_admin_page( 'formidable-entries' ) ) {
838 + return $class;
839 + } else {
840 + return;
841 + }
1006 842 }
1007 843
1008 844 // If submit button needs to be inline or centered.
1009 845 if ( is_object( $form ) ) {
@@ -1024,9 +860,11 @@
1024 860 } elseif ( 'center' === $submit_align ) {
1025 861 $class .= ' frm_center_submit';
1026 862 }
1027 863
1028 - return apply_filters( 'frm_add_form_style_class', $class, $style, compact( 'form' ) );
864 + $class = apply_filters( 'frm_add_form_style_class', $class, $style, compact( 'form' ) );
865 +
866 + return $class;
1029 867 }
1030 868
1031 869 /**
1032 870 * In order for frm_inline_submit to inline the submit button the form must also have the frm_inline_form that adds the grid-column style rules required for it to work.
@@ -1033,17 +871,16 @@
1033 871 *
1034 872 * @since 5.0.12
1035 873 *
1036 874 * @param array $form
1037 - *
1038 875 * @return bool
1039 876 */
1040 877 private static function form_should_be_inline_and_missing_class( $form ) {
1041 - if ( isset( $form['form_class'] ) && str_contains( ' ' . $form['form_class'] . ' ', ' frm_inline_form ' ) ) {
1042 - // Not missing class, avoid adding it twice.
878 + if ( isset( $form['form_class'] ) && false !== strpos( ' ' . $form['form_class'] . ' ', ' frm_inline_form ' ) ) {
879 + // not missing class, avoid adding it twice.
1043 880 return false;
1044 881 }
1045 - return ! empty( $form['submit_html'] ) && str_contains( $form['submit_html'], 'frm_inline_submit' );
882 + return ! empty( $form['submit_html'] ) && false !== strpos( $form['submit_html'], 'frm_inline_submit' );
1046 883 }
1047 884
1048 885 /**
1049 886 * Returns appropriate class if form has top labels
@@ -1068,9 +905,8 @@
1068 905 return false;
1069 906 }
1070 907
1071 908 $fields = $form['fields'];
1072 -
1073 909 if ( count( $fields ) <= 0 ) {
1074 910 return false;
1075 911 }
1076 912
@@ -1075,13 +911,11 @@
1075 911 }
1076 912
1077 913 // Start from the fields closest to the submit button.
1078 914 $fields = array_reverse( $fields );
1079 -
1080 915 foreach ( $fields as $field ) {
1081 - $type = $field['original_type'] ?? $field['type'];
916 + $type = isset( $field['original_type'] ) ? $field['original_type'] : $field['type'];
1082 917 $has_input = FrmFieldFactory::field_has_property( $type, 'has_input' );
1083 -
1084 918 if ( $has_input ) {
1085 919 return self::field_has_top_label( $field, $form );
1086 920 }
1087 921 }
@@ -1092,31 +926,29 @@
1092 926 /**
1093 927 * Check if a field's label position is set to "top"
1094 928 *
1095 929 * @param array $field
1096 - * @param bool|object|string $form
930 + * @param object|string|bool $form
1097 931 *
1098 932 * @return bool
1099 933 */
1100 934 private static function field_has_top_label( $field, $form ) {
1101 935 $label_position = FrmFieldsHelper::label_position( $field['label'], $field, $form );
1102 - return in_array( $label_position, array( 'top', 'inside', 'hidden' ), true );
936 +
937 + return in_array( $label_position, array( 'top', 'inside', 'hidden' ) );
1103 938 }
1104 939
1105 940 /**
1106 - * @param array|bool|int|object|string $form
941 + * @param object|string|boolean $form
1107 942 *
1108 - * @return int|string
943 + * @return string
1109 944 */
1110 945 public static function get_form_style( $form ) {
1111 946 $style = 1;
1112 -
1113 - if ( ! $form || 'default' === $form ) {
947 + if ( empty( $form ) || 'default' === $form ) {
1114 948 return $style;
1115 - }
1116 -
1117 - if ( is_object( $form ) && $form->parent_form_id ) {
1118 - // Get the parent form if this is a child
949 + } elseif ( is_object( $form ) && $form->parent_form_id ) {
950 + // get the parent form if this is a child
1119 951 $form = $form->parent_form_id;
1120 952 } elseif ( is_array( $form ) && ! empty( $form['parent_form_id'] ) ) {
1121 953 $form = $form['parent_form_id'];
1122 954 } elseif ( is_array( $form ) && isset( $form['custom_style'] ) ) {
@@ -1122,28 +954,28 @@
1122 954 } elseif ( is_array( $form ) && isset( $form['custom_style'] ) ) {
1123 955 $style = $form['custom_style'];
1124 956 }
1125 957
1126 - if ( $form && ( is_string( $form ) || is_int( $form ) ) ) {
958 + if ( $form && is_string( $form ) ) {
1127 959 $form = FrmForm::getOne( $form );
1128 960 }
1129 961
1130 - return $form && is_object( $form ) && isset( $form->options['custom_style'] ) ? $form->options['custom_style'] : $style;
962 + $style = ( $form && is_object( $form ) && isset( $form->options['custom_style'] ) ) ? $form->options['custom_style'] : $style;
963 +
964 + return $style;
1131 965 }
1132 966
1133 967 /**
1134 968 * Display the validation error messages when an entry is submitted
1135 969 *
1136 - * @since 2.0.6
1137 - *
1138 970 * @param array $args Includes img, errors.
1139 971 *
1140 - * @return void
972 + * @since 2.0.6
1141 973 */
1142 974 public static function show_errors( $args ) {
1143 975 $invalid_msg = self::get_invalid_error_message( $args );
1144 976
1145 - if ( ! $invalid_msg ) {
977 + if ( empty( $invalid_msg ) ) {
1146 978 $show_img = false;
1147 979 } else {
1148 980 echo wp_kses_post( $invalid_msg );
1149 981 $show_img = true;
@@ -1162,22 +994,19 @@
1162 994 * Display the error message in the front-end along with the image if set
1163 995 * The image was removed from the styling settings, but it may still be set with a hook
1164 996 * If the message in the global settings is empty, show every validation message in the error box
1165 997 *
1166 - * @since 2.0.6
1167 - *
1168 998 * @param array $args Includes img, errors, and show_img.
1169 999 *
1170 - * @return void
1000 + * @since 2.0.6
1171 1001 */
1172 1002 public static function show_error( $args ) {
1173 - // Remove any blank messages
1003 + // remove any blank messages
1174 1004 $args['errors'] = array_filter( (array) $args['errors'] );
1175 1005
1176 1006 $line_break_first = $args['show_img'];
1177 -
1178 1007 foreach ( $args['errors'] as $error_key => $error ) {
1179 - if ( $line_break_first && ! is_numeric( $error_key ) && ( $error_key === 'cptch_number' || str_starts_with( $error_key, 'field' ) ) ) {
1008 + if ( $line_break_first && ! is_numeric( $error_key ) && ( $error_key == 'cptch_number' || strpos( $error_key, 'field' ) === 0 ) ) {
1180 1009 continue;
1181 1010 }
1182 1011
1183 1012 $id = str_replace( 'field', 'field_', $error_key );
@@ -1183,9 +1012,9 @@
1183 1012 $id = str_replace( 'field', 'field_', $error_key );
1184 1013 echo '<div id="' . esc_attr( $id ) . '_error">';
1185 1014
1186 1015 if ( $args['show_img'] && ! empty( $args['img'] ) ) {
1187 - echo '<img src="' . esc_url( $args['img'] ) . '" alt="" />';
1016 + echo '<img src="' . esc_attr( $args['img'] ) . '" alt="" />';
1188 1017 } else {
1189 1018 $args['show_img'] = true;
1190 1019 }
1191 1020
@@ -1194,38 +1023,34 @@
1194 1023 echo '</div>';
1195 1024 }
1196 1025 }
1197 1026
1198 - /**
1199 - * @param int|string $id
1200 - *
1201 - * @return void
1202 - */
1203 1027 public static function maybe_get_scroll_js( $id ) {
1204 1028 $offset = apply_filters( 'frm_scroll_offset', 4, array( 'form_id' => $id ) );
1205 -
1206 - // phpcs:ignore Universal.Operators.StrictComparisons
1207 1029 if ( $offset != - 1 ) {
1208 1030 self::get_scroll_js( $id );
1209 1031 }
1210 1032 }
1211 1033
1034 + public static function get_scroll_js( $form_id ) {
1035 + echo '<script type="text/javascript">document.addEventListener(\'DOMContentLoaded\',function(){frmFrontForm.scrollMsg(' . (int) $form_id . ');})</script>';
1036 + }
1037 +
1212 1038 /**
1213 - * @param int|string $form_id
1214 - *
1215 - * @return void
1039 + * @since 3.0
1216 1040 */
1217 - public static function get_scroll_js( $form_id ) {
1218 - echo '<script type="text/javascript">document.addEventListener(\'DOMContentLoaded\',function(){frmFrontForm.scrollMsg(' . (int) $form_id . ');})</script>';
1041 + public static function actions_dropdown( $atts ) {
1042 + if ( FrmAppHelper::is_admin_page( 'formidable' ) ) {
1043 + $status = $atts['status'];
1044 + $form_id = isset( $atts['id'] ) ? $atts['id'] : FrmAppHelper::get_param( 'id', 0, 'get', 'absint' );
1045 + $trash_link = self::delete_trash_info( $form_id, $status );
1046 + $links = self::get_action_links( $form_id, $status );
1047 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/actions-dropdown.php' );
1048 + }
1219 1049 }
1220 1050
1221 1051 /**
1222 1052 * @since 3.0
1223 - *
1224 - * @param int|object|string $form_id
1225 - * @param mixed $form
1226 - *
1227 - * @return array
1228 1053 */
1229 1054 public static function get_action_links( $form_id, $form ) {
1230 1055 if ( ! is_object( $form ) ) {
1231 1056 $form = FrmForm::getOne( $form_id );
@@ -1232,10 +1057,9 @@
1232 1057 }
1233 1058
1234 1059 $actions = array();
1235 1060 $trash_links = self::delete_trash_links( $form_id );
1236 -
1237 - if ( 'trash' === $form->status ) {
1061 + if ( 'trash' == $form->status ) {
1238 1062 $actions['restore'] = $trash_links['restore'];
1239 1063
1240 1064 if ( current_user_can( 'frm_delete_forms' ) ) {
1241 1065 $actions['trash'] = $trash_links['delete'];
@@ -1241,20 +1065,19 @@
1241 1065 $actions['trash'] = $trash_links['delete'];
1242 1066 }
1243 1067 } elseif ( current_user_can( 'frm_edit_forms' ) ) {
1244 1068 $duplicate_link = '?page=formidable&frm_action=duplicate&id=' . $form_id;
1245 -
1246 1069 if ( $form->is_template ) {
1247 1070 $actions['frm_duplicate'] = array(
1248 1071 'url' => wp_nonce_url( $duplicate_link ),
1249 1072 'label' => __( 'Create Form from Template', 'formidable' ),
1250 - 'icon' => 'frmfont frm_clone_icon',
1073 + 'icon' => 'frm_icon_font frm_clone_icon',
1251 1074 );
1252 1075 } else {
1253 1076 $actions['duplicate'] = array(
1254 1077 'url' => wp_nonce_url( $duplicate_link ),
1255 1078 'label' => __( 'Duplicate Form', 'formidable' ),
1256 - 'icon' => 'frmfont frm_clone_icon',
1079 + 'icon' => 'frm_icon_font frm_clone_icon',
1257 1080 );
1258 1081 }
1259 1082
1260 1083 $actions['trash'] = self::delete_trash_info( $form_id, $form->status );
@@ -1262,13 +1085,8 @@
1262 1085
1263 1086 return $actions;
1264 1087 }
1265 1088
1266 - /**
1267 - * @param int|object|string $data
1268 - *
1269 - * @return string
1270 - */
1271 1089 public static function edit_form_link( $data ) {
1272 1090 $form_id = self::get_form_id_from_data( $data );
1273 1091
1274 1092 if ( ! $form_id ) {
@@ -1275,122 +1093,94 @@
1275 1093 return '';
1276 1094 }
1277 1095
1278 1096 $label = self::edit_form_link_label( $data );
1279 - return '<a href="' . esc_url( FrmForm::get_edit_link( $form_id ) ) . '">' . esc_html( $label ) . '</a>';
1097 + $link = '<a href="' . esc_url( FrmForm::get_edit_link( $form_id ) ) . '">' . esc_html( $label ) . '</a>';
1098 + return $link;
1280 1099 }
1281 1100
1282 - /**
1283 - * Returns a text used when no title is set.
1284 - *
1285 - * @since 6.16.1
1286 - *
1287 - * @return string
1288 - */
1289 - public static function get_no_title_text() {
1290 - return __( '(no title)', 'formidable' );
1291 - }
1292 -
1293 - /**
1294 - * @param int|object|string $data
1295 - *
1296 - * @return string
1297 - */
1298 1101 public static function edit_form_link_label( $data ) {
1299 1102 $name = self::get_form_name_from_data( $data );
1300 -
1301 1103 if ( ! $name ) {
1302 - return self::get_no_title_text();
1104 + return __( '(no title)', 'formidable' );
1303 1105 }
1304 -
1305 1106 return FrmAppHelper::truncate( $name, 40 );
1306 1107 }
1307 1108
1308 1109 /**
1309 - * @param int|object|string $data
1310 - *
1311 - * @return int|string
1110 + * @param mixed $data
1111 + * @return int
1312 1112 */
1313 1113 private static function get_form_id_from_data( $data ) {
1314 - return is_object( $data ) ? $data->id : $data;
1114 + if ( is_object( $data ) ) {
1115 + $form_id = $data->id;
1116 + } else {
1117 + $form_id = $data;
1118 + }
1119 + return $form_id;
1315 1120 }
1316 1121
1317 1122 /**
1318 1123 * @param mixed $data
1319 - *
1320 1124 * @return string
1321 1125 */
1322 1126 private static function get_form_name_from_data( $data ) {
1323 1127 if ( is_object( $data ) ) {
1324 - return $data->name;
1128 + $form_name = $data->name;
1129 + } else {
1130 + $form_id = $data;
1131 + $form_name = FrmForm::getName( $form_id );
1325 1132 }
1326 -
1327 - $form_id = $data;
1328 - return FrmForm::getName( $form_id );
1133 + return $form_name;
1329 1134 }
1330 1135
1331 - /**
1332 - * @param int $id
1333 - * @param string $status
1334 - * @param string $length
1335 - *
1336 - * @return string
1337 - */
1338 1136 public static function delete_trash_link( $id, $status, $length = 'label' ) {
1339 1137 $link_details = self::delete_trash_info( $id, $status );
1138 +
1340 1139 return self::format_link_html( $link_details, $length );
1341 1140 }
1342 1141
1343 1142 /**
1344 1143 * @since 3.0
1345 - *
1346 - * @param array $link_details
1347 - * @param string $length
1348 - *
1349 - * @return string
1350 1144 */
1351 1145 public static function format_link_html( $link_details, $length = 'label' ) {
1352 1146 $link = '';
1147 + if ( ! empty( $link_details ) ) {
1148 + $link = '<a href="' . esc_url( $link_details['url'] ) . '" class="frm-trash-link"';
1149 + if ( isset( $link_details['data'] ) ) {
1150 + foreach ( $link_details['data'] as $data => $value ) {
1151 + $link .= ' data-' . esc_attr( $data ) . '="' . esc_attr( $value ) . '"';
1152 + }
1153 + } elseif ( isset( $link_details['confirm'] ) ) {
1154 + $link .= ' onclick="return confirm(\'' . esc_attr( $link_details['confirm'] ) . '\')"';
1155 + }
1353 1156
1354 - if ( ! $link_details ) {
1355 - return $link;
1356 - }
1357 -
1358 - $link = '<a href="' . esc_url( $link_details['url'] ) . '" class="frm-trash-link"';
1359 -
1360 - if ( isset( $link_details['data'] ) ) {
1361 - foreach ( $link_details['data'] as $data => $value ) {
1362 - $link .= ' data-' . esc_attr( $data ) . '="' . esc_attr( $value ) . '"';
1157 + $label = ( isset( $link_details[ $length ] ) ? $link_details[ $length ] : $link_details['label'] );
1158 + if ( $length == 'icon' && isset( $link_details[ $length ] ) ) {
1159 + $label = '<span class="' . $label . '" title="' . esc_attr( $link_details['label'] ) . '" aria-hidden="true"></span>';
1160 + $link .= ' aria-label="' . esc_attr( $link_details['label'] ) . '"';
1363 1161 }
1364 - } elseif ( isset( $link_details['confirm'] ) ) {
1365 - $link .= ' onclick="return confirm(\'' . esc_attr( $link_details['confirm'] ) . '\')"';
1366 - }
1367 1162
1368 - $label = $link_details[ $length ] ?? $link_details['label'];
1369 -
1370 - if ( $length === 'icon' && isset( $link_details[ $length ] ) ) {
1371 - $label = '<span class="' . $label . '" title="' . esc_attr( $link_details['label'] ) . '" aria-hidden="true"></span>';
1372 - $link .= ' aria-label="' . esc_attr( $link_details['label'] ) . '"';
1163 + $link .= '>' . $label . '</a>';
1373 1164 }
1374 1165
1375 - return $link . ( '>' . $label . '</a>' );
1166 + return $link;
1376 1167 }
1377 1168
1378 1169 /**
1379 1170 * @since 3.0
1380 - *
1381 - * @param int $id
1382 - * @param string $status
1383 - *
1384 - * @return array
1385 1171 */
1386 1172 public static function delete_trash_info( $id, $status ) {
1387 1173 $labels = self::delete_trash_links( $id );
1388 1174
1389 - if ( 'trash' === $status ) {
1175 + if ( 'trash' == $status ) {
1390 1176 $info = $labels['restore'];
1391 1177 } elseif ( current_user_can( 'frm_delete_forms' ) ) {
1392 - $info = EMPTY_TRASH_DAYS ? $labels['trash'] : $labels['delete'];
1178 + if ( EMPTY_TRASH_DAYS ) {
1179 + $info = $labels['trash'];
1180 + } else {
1181 + $info = $labels['delete'];
1182 + }
1393 1183 } else {
1394 1184 $info = array();
1395 1185 }
1396 1186
@@ -1398,12 +1188,8 @@
1398 1188 }
1399 1189
1400 1190 /**
1401 1191 * @since 3.0
1402 - *
1403 - * @param int $id
1404 - *
1405 - * @return array
1406 1192 */
1407 1193 public static function delete_trash_links( $id ) {
1408 1194 $current_page = FrmAppHelper::get_simple_request( array( 'param' => 'form_type' ) );
1409 1195 $base_url = '?page=formidable&form_type=' . $current_page . '&id=' . $id;
@@ -1417,9 +1203,9 @@
1417 1203 'trash' => array(
1418 1204 'label' => __( 'Move Form to Trash', 'formidable' ),
1419 1205 'short' => __( 'Trash', 'formidable' ),
1420 1206 'url' => wp_nonce_url( $base_url . '&frm_action=trash', 'trash_form_' . absint( $id ) ),
1421 - 'icon' => 'frmfont frm_delete_icon',
1207 + 'icon' => 'frm_icon_font frm_delete_icon',
1422 1208 'data' => array(
1423 1209 'frmverify' => __( 'Do you want to move this form to the trash?', 'formidable' ),
1424 1210 'frmverify-btn' => 'frm-button-red',
1425 1211 ),
@@ -1428,9 +1214,9 @@
1428 1214 'label' => __( 'Delete Permanently', 'formidable' ),
1429 1215 'short' => __( 'Delete', 'formidable' ),
1430 1216 'url' => wp_nonce_url( $base_url . '&frm_action=destroy', 'destroy_form_' . absint( $id ) ),
1431 1217 'confirm' => __( 'Are you sure you want to delete this form and all its entries?', 'formidable' ),
1432 - 'icon' => 'frmfont frm_delete_icon',
1218 + 'icon' => 'frm_icon_font frm_delete_icon',
1433 1219 'data' => array(
1434 1220 'frmverify' => __( 'This will permanently delete the form and all its entries. This is irreversible. Are you sure you want to continue?', 'formidable' ),
1435 1221 'frmverify-btn' => 'frm-button-red',
1436 1222 ),
@@ -1439,38 +1225,36 @@
1439 1225 }
1440 1226
1441 1227 /**
1442 1228 * @since 3.0
1443 - *
1444 - * @return array
1445 1229 */
1446 1230 public static function css_classes() {
1447 1231 $classes = array(
1448 - 'frm_total' => array(
1232 + 'frm_total' => array(
1449 1233 'label' => __( 'Total', 'formidable' ),
1450 1234 'title' => __( 'Add this to a read-only field to display the text in bold without a border or background.', 'formidable' ),
1451 1235 ),
1452 - 'frm_total_big' => array(
1236 + 'frm_total_big' => array(
1453 1237 'label' => __( 'Big Total', 'formidable' ),
1454 1238 'title' => __( 'Add this to a read-only field to display the text in large, bold text without a border or background.', 'formidable' ),
1455 1239 ),
1456 - 'frm_scroll_box' => array(
1240 + 'frm_scroll_box' => array(
1457 1241 'label' => __( 'Scroll Box', 'formidable' ),
1458 - 'title' => __( 'If you have many checkbox or radio button options, you may add this class to allow your user to easily scroll through the options. Or add a scrolling area around content in an HTML field.', 'formidable' ), // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
1242 + 'title' => __( 'If you have many checkbox or radio button options, you may add this class to allow your user to easily scroll through the options. Or add a scrolling area around content in an HTML field.', 'formidable' ),
1459 1243 ),
1460 - 'frm_first' => array(
1244 + 'frm_first' => array(
1461 1245 'label' => __( 'First', 'formidable' ),
1462 1246 'title' => __( 'Add this to the first field in each row along with a width. ie frm_first frm4', 'formidable' ),
1463 1247 ),
1464 - 'frm_alignright' => __( 'Right', 'formidable' ),
1465 - 'frm_grid_first' => __( 'First Grid Row', 'formidable' ),
1466 - 'frm_grid' => __( 'Even Grid Row', 'formidable' ),
1467 - 'frm_grid_odd' => __( 'Odd Grid Row', 'formidable' ),
1248 + 'frm_alignright' => __( 'Right', 'formidable' ),
1249 + 'frm_grid_first' => __( 'First Grid Row', 'formidable' ),
1250 + 'frm_grid' => __( 'Even Grid Row', 'formidable' ),
1251 + 'frm_grid_odd' => __( 'Odd Grid Row', 'formidable' ),
1468 1252 'frm_color_block' => array(
1469 1253 'label' => __( 'Color Block', 'formidable' ),
1470 1254 'title' => __( 'Add a background color to the field or section.', 'formidable' ),
1471 1255 ),
1472 - 'frm_capitalize' => array(
1256 + 'frm_capitalize' => array(
1473 1257 'label' => __( 'Capitalize', 'formidable' ),
1474 1258 'title' => __( 'Automatically capitalize the first letter in each word.', 'formidable' ),
1475 1259 ),
1476 1260 );
@@ -1477,11 +1261,8 @@
1477 1261
1478 1262 return apply_filters( 'frm_layout_classes', $classes );
1479 1263 }
1480 1264
1481 - /**
1482 - * @return array
1483 - */
1484 1265 public static function grid_classes() {
1485 1266 return array(
1486 1267 'frm_half' => '1/2',
1487 1268 'frm_third' => '1/3',
@@ -1495,18 +1276,12 @@
1495 1276 }
1496 1277
1497 1278 /**
1498 1279 * @since 3.0
1499 - *
1500 - * @param mixed $style
1501 - * @param string $class
1502 - *
1503 - * @return string
1504 1280 */
1505 1281 public static function style_class_label( $style, $class ) {
1506 1282 $label = '';
1507 -
1508 - if ( ! $style ) {
1283 + if ( empty( $style ) ) {
1509 1284 $label = $class;
1510 1285 } elseif ( ! is_array( $style ) ) {
1511 1286 $label = $style;
1512 1287 } elseif ( isset( $style['label'] ) ) {
@@ -1515,13 +1290,8 @@
1515 1290
1516 1291 return $label;
1517 1292 }
1518 1293
1519 - /**
1520 - * @param string $status
1521 - *
1522 - * @return string
1523 - */
1524 1294 public static function status_nice_name( $status ) {
1525 1295 $nice_names = array(
1526 1296 'draft' => __( 'Draft', 'formidable' ),
1527 1297 'trash' => __( 'Trash', 'formidable' ),
@@ -1527,13 +1297,15 @@
1527 1297 'trash' => __( 'Trash', 'formidable' ),
1528 1298 'publish' => __( 'Published', 'formidable' ),
1529 1299 );
1530 1300
1531 - if ( ! array_key_exists( $status, $nice_names ) ) {
1301 + if ( ! in_array( $status, array_keys( $nice_names ) ) ) {
1532 1302 $status = 'publish';
1533 1303 }
1534 1304
1535 - return $nice_names[ $status ];
1305 + $name = $nice_names[ $status ];
1306 +
1307 + return $name;
1536 1308 }
1537 1309
1538 1310 /**
1539 1311 * Renders a template icon based on the given categories.
@@ -1540,11 +1312,10 @@
1540 1312 *
1541 1313 * @param array $categories The categories to render the icon for.
1542 1314 * @param array $atts {
1543 1315 * Optional. An array of attributes for rendering.
1544 - *
1545 1316 * @type string $html 'span' or 'div'. Default 'span'.
1546 - * @type bool $bg Whether to add a background color or not. Default false.
1317 + * @type boolean $bg Whether to add a background color or not. Default false.
1547 1318 * }
1548 1319 *
1549 1320 * @return void
1550 1321 */
@@ -1550,76 +1321,84 @@
1550 1321 */
1551 1322 public static function template_icon( $categories, $atts = array() ) {
1552 1323 // Define defaults.
1553 1324 $defaults = array(
1554 - 'bg' => true,
1325 + 'bg' => true,
1555 1326 );
1556 - $atts = array_merge( $defaults, $atts );
1327 + $atts = array_merge( $defaults, $atts );
1557 1328
1558 1329 // Filter out ignored categories.
1559 - $ignore = self::get_license_types();
1330 + $ignore = self::ignore_template_categories();
1560 1331 $categories = array_diff( $categories, $ignore );
1561 1332
1562 1333 // Define icons mapping.
1563 1334 $icons = array(
1564 - 'WooCommerce' => array( 'woocommerce', 'var(--purple)' ),
1565 - 'Post' => array( 'wordpress', 'rgb(0,160,210)' ),
1566 - 'User Registration' => array( 'register', 'var(--pink)' ),
1335 + 'WooCommerce' => array( 'woocommerce', 'var(--purple)' ),
1336 + 'Post' => array( 'wordpress', 'rgb(0,160,210)' ),
1337 + 'User Registration' => array( 'register', 'var(--pink)' ),
1567 1338 'Registration and Signup' => array( 'register', 'var(--pink)' ),
1568 - 'PayPal' => array( 'paypal' ),
1569 - 'Stripe' => array( 'credit_card', 'var(--green)' ),
1570 - 'Twilio' => array( 'sms' ),
1571 - 'Payment' => array( 'credit_card' ),
1572 - 'Order Form' => array( 'product' ),
1573 - 'Finance' => array( 'total' ),
1574 - 'Health and Wellness' => array( 'heart', 'var(--pink)' ),
1575 - 'Event Planning' => array( 'calendar', 'var(--orange)' ),
1576 - 'Real Estate' => array( 'house' ),
1577 - 'Nonprofit' => array( 'heart_solid' ),
1578 - 'Calculator' => array( 'calculator', 'var(--purple)' ),
1579 - 'Quiz' => array( 'percent' ),
1580 - 'Registrations' => array( 'address_card' ),
1581 - 'Customer Service' => array( 'users_solid' ),
1582 - 'Education' => array( 'pencil' ),
1583 - 'Marketing' => array( 'eye' ),
1584 - 'Feedback' => array( 'smile' ),
1585 - 'Business Operations' => array( 'case' ),
1586 - 'Contact Form' => array( 'email' ),
1587 - 'Conversational Forms' => array( 'chat_forms' ),
1588 - 'Survey' => array( 'chat_forms', 'var(--orange)' ),
1589 - 'Application' => array( 'align_right' ),
1590 - 'Signature' => array( 'signature' ),
1591 - '' => array( 'align_right' ),
1339 + 'PayPal' => array( 'paypal' ),
1340 + 'Stripe' => array( 'credit_card', 'var(--green)' ),
1341 + 'Twilio' => array( 'sms' ),
1342 + 'Payment' => array( 'credit_card' ),
1343 + 'Order Form' => array( 'product' ),
1344 + 'Finance' => array( 'total' ),
1345 + 'Health and Wellness' => array( 'heart', 'var(--pink)' ),
1346 + 'Event Planning' => array( 'calendar', 'var(--orange)' ),
1347 + 'Real Estate' => array( 'house' ),
1348 + 'Nonprofit' => array( 'heart_solid' ),
1349 + 'Calculator' => array( 'calculator', 'var(--purple)' ),
1350 + 'Quiz' => array( 'percent' ),
1351 + 'Registrations' => array( 'address_card' ),
1352 + 'Customer Service' => array( 'users_solid' ),
1353 + 'Education' => array( 'pencil' ),
1354 + 'Marketing' => array( 'eye' ),
1355 + 'Feedback' => array( 'smile' ),
1356 + 'Business Operations' => array( 'case' ),
1357 + 'Contact Form' => array( 'email' ),
1358 + 'Conversational Forms' => array( 'chat_forms' ),
1359 + 'Survey' => array( 'chat_forms', 'var(--orange)' ),
1360 + 'Application' => array( 'align_right' ),
1361 + 'Signature' => array( 'signature' ),
1362 + '' => array( 'align_right' ),
1592 1363 );
1593 1364
1594 1365 // Determine the icon to be used.
1595 1366 $icon = $icons[''];
1596 -
1597 1367 if ( count( $categories ) === 1 ) {
1598 1368 $category = reset( $categories );
1599 - $icon = $icons[ $category ] ?? $icon;
1600 - } elseif ( $categories ) {
1369 + $icon = isset( $icons[ $category ] ) ? $icons[ $category ] : $icon;
1370 + } elseif ( ! empty( $categories ) ) {
1601 1371 $icons = array_intersect_key( $icons, array_flip( $categories ) );
1602 - $icon = reset( $icons );
1372 + $icon = reset( $icons );
1603 1373 }
1604 1374
1605 1375 // Prepare variables for output.
1606 1376 $icon_name = $icon[0];
1607 - $bg_color = $icon[1] ?? '';
1377 + $bg_color = isset( $icon[1] ) ? $icon[1] : '';
1608 1378
1609 1379 // Render the icon.
1610 1380 echo '<span class="frm-category-icon frm-icon-wrapper"';
1611 -
1612 1381 if ( $bg_color && $atts['bg'] ) {
1613 1382 echo ' style="background-color:' . esc_attr( $bg_color ) . '"';
1614 1383 }
1615 -
1616 1384 echo '>';
1617 - FrmAppHelper::icon_by_class( 'frmfont frm_' . $icon_name . '_icon' );
1385 + FrmAppHelper::icon_by_class( 'frmfont frm_' . $icon_name . '_icon' );
1618 1386 echo '</span>';
1619 1387 }
1620 1388
1621 1389 /**
1390 + * Retrieves the list of template categories to ignore.
1391 + *
1392 + * @since 4.03.01
1393 + *
1394 + * @return string[] Array of categories to ignore.
1395 + */
1396 + public static function ignore_template_categories() {
1397 + return array( 'Business', 'Elite', 'Personal', 'Creator', 'Basic', 'free' );
1398 + }
1399 +
1400 + /**
1622 1401 * Get template install link.
1623 1402 *
1624 1403 * @since 4.02
1625 1404 *
@@ -1624,9 +1403,8 @@
1624 1403 * @since 4.02
1625 1404 *
1626 1405 * @param array $template Template details.
1627 1406 * @param array $args Additional arguments.
1628 - *
1629 1407 * @return array The link attributes.
1630 1408 */
1631 1409 public static function get_template_install_link( $template, $args ) {
1632 1410 $defaults = array(
@@ -1642,8 +1420,13 @@
1642 1420 'class' => 'frm-install-template',
1643 1421 'href' => 'rel',
1644 1422 'atts' => '',
1645 1423 );
1424 + } elseif ( self::plan_is_allowed( $args ) ) {
1425 + $link = array(
1426 + 'url' => FrmAppHelper::admin_upgrade_link( 'addons', 'account/downloads/' ) . '&utm_content=' . $template['slug'],
1427 + 'label' => __( 'Renew', 'formidable' ),
1428 + );
1646 1429 } else {
1647 1430 $link = array(
1648 1431 'url' => $args['pricing'],
1649 1432 'label' => __( 'Upgrade', 'formidable' ),
@@ -1658,9 +1441,8 @@
1658 1441 *
1659 1442 * @since 4.02.02
1660 1443 *
1661 1444 * @param array $args
1662 - *
1663 1445 * @return bool
1664 1446 */
1665 1447 public static function plan_is_allowed( $args ) {
1666 1448 if ( empty( $args['license_type'] ) ) {
@@ -1679,9 +1461,8 @@
1679 1461 foreach ( $plans as $plan ) {
1680 1462 if ( $included || $plan === $license_type ) {
1681 1463 break;
1682 1464 }
1683 -
1684 1465 $included = $plan === $plan_required;
1685 1466 }
1686 1467
1687 1468 return $included;
@@ -1691,29 +1472,22 @@
1691 1472 * If a template or add-on cannot be installed, show a message
1692 1473 * about which plan is required.
1693 1474 *
1694 1475 * @since 4.0
1695 - *
1696 - * @param string $requires
1697 - * @param string $link
1698 - *
1699 - * @return void
1700 1476 */
1701 1477 public static function show_plan_required( $requires, $link ) {
1702 - if ( ! $requires ) {
1478 + if ( empty( $requires ) ) {
1703 1479 return;
1704 1480 }
1705 1481
1706 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
1707 1482 ?>
1708 1483 <p class="frm_plan_required">
1709 - <?php esc_html_e( 'Plan required:', 'formidable' ); ?>
1484 + <?php esc_html_e( 'License plan required:', 'formidable' ); ?>
1710 1485 <a href="<?php echo esc_url( $link ); ?>" target="_blank" rel="noopener">
1711 1486 <?php echo esc_html( $requires ); ?>
1712 1487 </a>
1713 1488 </p>
1714 1489 <?php
1715 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
1716 1490 }
1717 1491
1718 1492 /**
1719 1493 * @since 4.0
@@ -1718,10 +1492,9 @@
1718 1492 /**
1719 1493 * @since 4.0
1720 1494 *
1721 1495 * @param array $item
1722 - *
1723 - * @return false|string
1496 + * @return string|false
1724 1497 */
1725 1498 public static function get_plan_required( &$item ) {
1726 1499 if ( ! isset( $item['categories'] ) || ! is_array( $item['categories'] ) || ! empty( $item['url'] ) ) {
1727 1500 return false;
@@ -1726,14 +1499,20 @@
1726 1499 if ( ! isset( $item['categories'] ) || ! is_array( $item['categories'] ) || ! empty( $item['url'] ) ) {
1727 1500 return false;
1728 1501 }
1729 1502
1730 - $plans = self::get_license_types();
1503 + $plans = array( 'free', 'Basic', 'Personal', 'Plus', 'Creator', 'Business', 'Elite' );
1731 1504
1732 1505 foreach ( $item['categories'] as $k => $category ) {
1733 1506 if ( in_array( $category, $plans, true ) ) {
1734 1507 unset( $item['categories'][ $k ] );
1735 - return self::convert_legacy_package_names( $category );
1508 +
1509 + if ( in_array( $category, array( 'Creator', 'Personal' ), true ) ) {
1510 + // Show the current package name.
1511 + $category = 'Plus';
1512 + }
1513 +
1514 + return $category;
1736 1515 }
1737 1516 }
1738 1517
1739 1518 return false;
@@ -1739,53 +1518,8 @@
1739 1518 return false;
1740 1519 }
1741 1520
1742 1521 /**
1743 - * Converts legacy package names to the current standard package name.
1744 - *
1745 - * @since 6.15
1746 - *
1747 - * @param string $package_name
1748 - *
1749 - * @return string The updated package name.
1750 - */
1751 - public static function convert_legacy_package_names( $package_name ) {
1752 - if ( in_array( $package_name, array( 'Creator', 'Personal' ), true ) ) {
1753 - return 'Plus';
1754 - }
1755 -
1756 - return $package_name;
1757 - }
1758 -
1759 - /**
1760 - * Get the license types.
1761 - *
1762 - * @since 6.15
1763 - *
1764 - * @param array $args
1765 - *
1766 - * @return array
1767 - */
1768 - public static function get_license_types( $args = array() ) {
1769 - $defaults = array(
1770 - 'include_all' => true,
1771 - 'case_lower' => false,
1772 - );
1773 - $args = wp_parse_args( $args, $defaults );
1774 - $license_types = array( 'Basic', 'Plus', 'Business', 'Elite' );
1775 -
1776 - if ( $args['include_all'] ) {
1777 - $license_types = array_merge( array( 'free', 'Personal', 'Creator' ), $license_types );
1778 - }
1779 -
1780 - if ( $args['case_lower'] ) {
1781 - return array_map( 'strtolower', $license_types );
1782 - }
1783 -
1784 - return $license_types;
1785 - }
1786 -
1787 - /**
1788 1522 * Checks for warnings to be displayed after form settings are saved.
1789 1523 *
1790 1524 * @since 4.04
1791 1525 *
@@ -1793,9 +1527,10 @@
1793 1527 *
1794 1528 * @return array An array of warnings or an empty array.
1795 1529 */
1796 1530 public static function check_for_warnings( $values ) {
1797 - $warnings = array();
1531 + $warnings = array();
1532 +
1798 1533 $redirect_warning = self::check_redirect_url_for_unsafe_params( $values );
1799 1534
1800 1535 if ( $redirect_warning ) {
1801 1536 $warnings[] = $redirect_warning;
@@ -1820,9 +1555,9 @@
1820 1555
1821 1556 $options = $values['options'];
1822 1557 FrmAppHelper::sanitize_with_html( $options );
1823 1558
1824 - if ( ! isset( $options['success_action'] ) || $options['success_action'] !== 'redirect' || ! isset( $options['success_url'] ) ) {
1559 + if ( ( ! isset( $options['success_action'] ) ) || $options['success_action'] !== 'redirect' || ! isset( $options['success_url'] ) ) {
1825 1560 return false;
1826 1561 }
1827 1562
1828 1563 $unsafe_params_in_redirect = self::get_unsafe_params( $options['success_url'] );
@@ -1840,13 +1575,11 @@
1840 1575 * @return array An array of params whose names are reserved words or an empty array.
1841 1576 */
1842 1577 private static function get_unsafe_params( $url ) {
1843 1578 $redirect_components = parse_url( $url );
1844 -
1845 1579 if ( empty( $redirect_components['query'] ) ) {
1846 1580 return array();
1847 1581 }
1848 -
1849 1582 parse_str( $redirect_components['query'], $redirect_params );
1850 1583 $redirect_param_names = array_keys( $redirect_params );
1851 1584 $reserved_words = self::reserved_words();
1852 1585 $unsafe_params_in_redirect = array_intersect( $redirect_param_names, $reserved_words );
@@ -1863,27 +1596,26 @@
1863 1596 *
1864 1597 * @return bool|string A string with an unsafe param message or false.
1865 1598 */
1866 1599 private static function create_unsafe_param_warning( $unsafe_params_in_redirect ) {
1867 - $count = count( $unsafe_params_in_redirect );
1600 + $count = count( $unsafe_params_in_redirect );
1601 + $caution = esc_html__( 'Is this intentional?', 'formidable' );
1602 + $reserved_words_intro = esc_html__( 'See the list of reserved words in WordPress.', 'formidable' );
1603 + $reserved_words_link = '<a href="https://codex.wordpress.org/WordPress_Query_Vars" target="_blank"> ' . $reserved_words_intro . '</a>';
1868 1604
1869 1605 if ( $count === 0 ) {
1870 1606 return false;
1871 1607 }
1872 1608
1873 - $caution = esc_html__( 'Is this intentional?', 'formidable' );
1874 - $reserved_words_intro = esc_html__( 'See the list of reserved words in WordPress.', 'formidable' );
1875 - $reserved_words_link = '<a href="https://codex.wordpress.org/WordPress_Query_Vars" target="_blank"> ' . $reserved_words_intro . '</a>';
1876 -
1877 - if ( $count === 1 ) {
1609 + if ( $count == 1 ) {
1878 1610 /* translators: %s: the name of a single parameter in the redirect URL */
1879 - return sprintf( esc_html__( 'The redirect URL is using the parameter "%s", which is reserved by WordPress. ', 'formidable' ), $unsafe_params_in_redirect[0] ) . $caution . $reserved_words_link; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
1611 + return sprintf( esc_html__( 'The redirect URL is using the parameter "%s", which is reserved by WordPress. ', 'formidable' ), $unsafe_params_in_redirect[0] ) . $caution . $reserved_words_link;
1880 1612 }
1881 1613
1882 1614 $unsafe_params_string = implode( '", "', $unsafe_params_in_redirect );
1883 1615
1884 1616 /* translators: %s: the names of two or more parameters in the redirect URL, separated by commas */
1885 - return sprintf( esc_html__( 'The redirect URL is using the parameters "%s", which are reserved by WordPress. ', 'formidable' ), $unsafe_params_string ) . $caution . $reserved_words_link; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
1617 + return sprintf( esc_html__( 'The redirect URL is using the parameters "%s", which are reserved by WordPress. ', 'formidable' ), $unsafe_params_string ) . $caution . $reserved_words_link;
1886 1618 }
1887 1619
1888 1620 /**
1889 1621 * Returns an array of common reserved words in WordPress.
@@ -1949,19 +1681,17 @@
1949 1681 * @since 5.0.16
1950 1682 *
1951 1683 * @param string $url
1952 1684 * @param int $form_id
1953 - *
1954 1685 * @return string
1955 1686 */
1956 1687 public static function maybe_add_sanitize_url_attr( $url, $form_id ) {
1957 - if ( ! str_contains( $url, '[' ) ) {
1688 + if ( false === strpos( $url, '[' ) ) {
1958 1689 // Do nothing if no shortcodes are detected.
1959 1690 return $url;
1960 1691 }
1961 1692
1962 1693 $parsed = wp_parse_url( $url );
1963 -
1964 1694 if ( empty( $parsed['query'] ) ) {
1965 1695 // Do nothing if no query can be detected in the url string.
1966 1696 return $url;
1967 1697 }
@@ -1967,10 +1697,10 @@
1967 1697 }
1968 1698
1969 1699 $original_query = $parsed['query'];
1970 1700 $query = $parsed['query'];
1971 - $shortcodes = FrmFieldsHelper::get_shortcodes( $query, $form_id );
1972 1701
1702 + $shortcodes = FrmFieldsHelper::get_shortcodes( $query, $form_id );
1973 1703 if ( empty( $shortcodes[0] ) ) {
1974 1704 // No shortcodes found, do nothing.
1975 1705 return $url;
1976 1706 }
@@ -1982,21 +1712,20 @@
1982 1712 // Skip if shortcodes.
1983 1713 continue;
1984 1714 }
1985 1715
1986 - if ( str_contains( $options, 'sanitize_url=' ) || str_contains( $options, 'sanitize=' ) ) {
1716 + if ( false !== strpos( $options, 'sanitize_url=' ) || false !== strpos( $options, 'sanitize=' ) ) {
1987 1717 // A sanitize option is already set so leave it alone.
1988 1718 continue;
1989 1719 }
1990 1720
1991 1721 $new_shortcode = '[' . $shortcodes[2][ $key ];
1992 -
1993 1722 if ( $options ) {
1994 1723 $new_shortcode .= ' ' . $options;
1995 1724 }
1725 + $new_shortcode .= ' sanitize_url=1]';
1996 1726
1997 - $new_shortcode .= ' sanitize_url=1]';
1998 - $query = str_replace( $shortcode, $new_shortcode, $query );
1727 + $query = str_replace( $shortcode, $new_shortcode, $query );
1999 1728 }//end foreach
2000 1729
2001 1730 if ( $query === $original_query ) {
2002 1731 return $url;
@@ -2005,8 +1734,20 @@
2005 1734 return str_replace( $original_query, $query, $url );
2006 1735 }
2007 1736
2008 1737 /**
1738 + * Check if Pro isn't up to date yet.
1739 + * If Pro is active but using a version earlier than v6.2 fallback to Pro for AJAX submit (so things don't all happen twice).
1740 + *
1741 + * @since 6.2
1742 + *
1743 + * @return bool
1744 + */
1745 + public static function should_use_pro_for_ajax_submit() {
1746 + return is_callable( 'FrmProForm::is_ajax_on' ) && ! is_callable( 'FrmProFormsHelper::lite_supports_ajax_submit' );
1747 + }
1748 +
1749 + /**
2009 1750 * Outputs the appropriate button text in the publish box.
2010 1751 *
2011 1752 * @return void
2012 1753 */
@@ -2021,127 +1762,25 @@
2021 1762 }
2022 1763 }
2023 1764
2024 1765 /**
2025 - * Strip characters similar to the WordPress sanitize_html_class function, but allow for [ and ].
2026 - * This allows shortcodes inside of the layout classes setting.
2027 - *
2028 - * @since 6.16
2029 - *
2030 - * @param string $classname
2031 - *
2032 - * @return string
1766 + * @since 4.02
1767 + * @deprecated 6.7
2033 1768 */
2034 - public static function sanitize_layout_class( $classname ) {
2035 - // Strip out any percent-encoded characters.
2036 - $sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $classname );
2037 -
2038 - // Limit to A-Z, a-z, 0-9, '_', '-', '[', ']'.
2039 - return preg_replace( '/[^A-Za-z0-9_\-\[\]]/', '', $sanitized );
1769 + public static function template_install_html( $link, $class = '' ) {
1770 + _deprecated_function( __METHOD__, '6.7' );
2040 1771 }
2041 1772
2042 1773 /**
2043 - * Returns true if the preview should be blocked.
1774 + * Check an array of templates, determine how many the logged in user can use
2044 1775 *
2045 - * @since 6.20
1776 + * @deprecated 6.7
2046 1777 *
2047 - * @param string $form_key
2048 - *
2049 - * @return bool
1778 + * @param array $templates
1779 + * @param array $args
1780 + * @return int
2050 1781 */
2051 - public static function should_block_preview( $form_key ) {
2052 - $should_block = in_array( $form_key, array( 'contact-form', 'contact-us' ), true ) && ! current_user_can( 'frm_view_forms' );
2053 - /**
2054 - * Filters whether the form preview should be blocked.
2055 - *
2056 - * @since 6.20
2057 - *
2058 - * @param bool $should_block
2059 - * @param string $form_key
2060 - */
2061 - return (bool) apply_filters( 'frm_block_preview', $should_block, $form_key );
2062 - }
2063 -
2064 - /**
2065 - * Checks if the form is loaded by API.
2066 - *
2067 - * @since 6.21
2068 - *
2069 - * @return bool
2070 - */
2071 - public static function form_is_loaded_by_api() {
2072 - global $frm_vars;
2073 -
2074 - if ( ! empty( $frm_vars['inplace_edit'] ) ) {
2075 - return true;
2076 - }
2077 -
2078 - return self::is_formidable_api_form() || self::is_gutenberg_editor() || self::is_elementor_ajax() || self::is_visual_views_preview();
2079 - }
2080 -
2081 - /**
2082 - * @since 6.21
2083 - *
2084 - * @return bool
2085 - */
2086 - private static function is_visual_views_preview() {
2087 - return 'frm_views_process_box_preview' === FrmAppHelper::get_post_param( 'action' );
2088 - }
2089 -
2090 - /**
2091 - * @since 6.21
2092 - *
2093 - * @return bool
2094 - */
2095 - private static function is_elementor_ajax() {
2096 - return 'elementor_ajax' === FrmAppHelper::get_post_param( 'action' );
2097 - }
2098 -
2099 - /**
2100 - * @since 6.21
2101 - *
2102 - * @return bool
2103 - */
2104 - private static function is_gutenberg_editor() {
2105 - $url = FrmAppHelper::get_server_value( 'REQUEST_URI' );
2106 -
2107 - if ( str_contains( $url, '/wp-json/wp/v2/block-renderer/formidable/simple-form' ) ) {
2108 - return true;
2109 - }
2110 -
2111 - if ( str_contains( urldecode( $url ), 'rest_route=/wp/v2/block-renderer/formidable/' ) ) {
2112 - return true;
2113 - }
2114 -
2115 - global $pagenow;
2116 - return 'post.php' === $pagenow;
2117 - }
2118 -
2119 - /**
2120 - * @since 6.21
2121 - *
2122 - * @return bool
2123 - */
2124 - private static function is_formidable_api_form() {
2125 - if ( ! class_exists( 'FrmAPIAppController' ) ) {
2126 - return false;
2127 - }
2128 -
2129 - $url = FrmAppHelper::get_server_value( 'REQUEST_URI' );
2130 -
2131 - if ( str_contains( $url, '/wp-json/frm/v2/forms/' ) ) {
2132 - // Prevent the honeypot from appearing for an API loaded form.
2133 - // This is to prevent conflicts where the script is not working.
2134 - return true;
2135 - }
2136 -
2137 - if ( is_callable( 'FrmProFormState::get_from_request' ) ) {
2138 - $api = FrmProFormState::get_from_request( 'a', 0 );
2139 -
2140 - if ( $api ) {
2141 - return true;
2142 - }
2143 - }
2144 -
2145 - return false;
1782 + public static function available_count( $templates, $args ) {
1783 + _deprecated_function( __METHOD__, '6.7' );
1784 + return 0;
2146 1785 }
2147 1786 }