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 +324 -734 6.32.1 → 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,29 +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 - foreach ( self::get_default_opts() as $var => $default ) {
350 + $defaults = self::get_default_opts();
351 + foreach ( $defaults as $var => $default ) {
423 352 if ( is_array( $default ) ) {
424 353 if ( ! isset( $values[ $var ] ) ) {
425 - $values[ $var ] = $record && isset( $record->options[ $var ] ) ? $record->options[ $var ] : array();
354 + $values[ $var ] = ( $record && isset( $record->options[ $var ] ) ) ? $record->options[ $var ] : array();
426 355 }
427 356
428 357 foreach ( $default as $k => $v ) {
429 - $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 );
430 359
431 360 if ( is_array( $v ) ) {
432 361 foreach ( $v as $k1 => $v1 ) {
433 - $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 );
434 363 unset( $k1, $v1 );
435 364 }
436 365 }
437 366
@@ -437,9 +366,9 @@
437 366
438 367 unset( $k, $v );
439 368 }
440 369 } else {
441 - $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 );
442 371 }
443 372
444 373 unset( $var, $default );
445 374 }//end foreach
@@ -458,9 +387,9 @@
458 387 'success_action' => 'message',
459 388 'success_msg' => $frm_settings->success_msg,
460 389 'show_form' => 0,
461 390 'akismet' => '',
462 - 'stopforumspam' => 0,
391 + 'honeypot' => 'basic',
463 392 'antispam' => 0,
464 393 'no_save' => 0,
465 394 'ajax_load' => 0,
466 395 'js_validate' => 0,
@@ -475,18 +404,17 @@
475 404 );
476 405 }
477 406
478 407 /**
479 - * @since 2.0.6
480 - *
481 408 * @param array $options
482 409 * @param array $values
483 410 *
484 - * @return void
411 + * @since 2.0.6
485 412 */
486 413 public static function fill_form_options( &$options, $values ) {
487 - foreach ( self::get_default_opts() as $var => $default ) {
488 - $options[ $var ] = $values['options'][ $var ] ?? $default;
414 + $defaults = self::get_default_opts();
415 + foreach ( $defaults as $var => $default ) {
416 + $options[ $var ] = isset( $values['options'][ $var ] ) ? $values['options'][ $var ] : $default;
489 417 unset( $var, $default );
490 418 }
491 419 }
492 420
@@ -491,10 +419,8 @@
491 419 }
492 420
493 421 /**
494 422 * @param string $loc
495 - *
496 - * @return string
497 423 */
498 424 public static function get_default_html( $loc ) {
499 425 if ( $loc === 'submit' ) {
500 426 $draft_link = self::get_draft_link();
@@ -519,13 +445,12 @@
519 445
520 446 return $default_html;
521 447 }
522 448
523 - /**
524 - * @return string
525 - */
526 449 public static function get_draft_link() {
527 - 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;
528 453 }
529 454
530 455 /**
531 456 * Gets start over button shortcode.
@@ -537,21 +462,11 @@
537 462 public static function get_start_over_shortcode() {
538 463 return '[if start_over]<a href="#" tabindex="0" class="frm_start_over" [start_over_hook]>[start_over_label]</a>[/if start_over]';
539 464 }
540 465
541 - /**
542 - * @param string $html
543 - * @param object $form
544 - * @param string $submit
545 - * @param object|null $form_action
546 - * @param array $values
547 - *
548 - * @return void
549 - */
550 466 public static function get_custom_submit( $html, $form, $submit, $form_action, $values ) {
551 467 $button = self::replace_shortcodes( $html, $form, $submit, $form_action, $values );
552 -
553 - if ( ! str_contains( $button, '[button_action]' ) ) {
468 + if ( ! strpos( $button, '[button_action]' ) ) {
554 469 echo FrmAppHelper::maybe_kses( $button ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
555 470 return;
556 471 }
557 472
@@ -558,21 +473,18 @@
558 473 /**
559 474 * @since 5.0.06
560 475 */
561 476 $button = apply_filters( 'frm_submit_button_html', $button, compact( 'form' ) );
562 -
563 477 if ( FrmAppHelper::should_never_allow_unfiltered_html() ) {
564 478 $button = FrmAppHelper::kses_submit_button( $button );
565 479 }
566 -
567 480 $button_parts = explode( '[button_action]', $button );
568 - $classes = apply_filters( 'frm_submit_button_class', array(), $form );
569 481
570 - if ( $classes ) {
482 + $classes = apply_filters( 'frm_submit_button_class', array(), $form );
483 + if ( ! empty( $classes ) ) {
571 484 $classes = implode( ' ', $classes );
572 - $button_class = 'frm_button_submit';
573 -
574 - 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 ) {
575 487 $button_parts[0] = str_replace( $button_class, $button_class . ' ' . esc_attr( $classes ), $button_parts[0] );
576 488 } else {
577 489 $button_parts[0] .= ' class="' . esc_attr( $classes ) . '"';
578 490 }
@@ -584,56 +496,54 @@
584 496 }
585 497
586 498 /**
587 499 * @since 4.0
588 - *
589 - * @return array
590 500 */
591 501 public static function html_shortcodes() {
592 502 $codes = array(
593 - 'id' => array(
503 + 'id' => array(
594 504 'label' => __( 'Field ID', 'formidable' ),
595 505 'class' => 'show_field_custom_html',
596 506 ),
597 - 'key' => array(
507 + 'key' => array(
598 508 'label' => __( 'Field Key', 'formidable' ),
599 509 'class' => 'show_field_custom_html',
600 510 ),
601 - 'field_name' => array(
511 + 'field_name' => array(
602 512 'label' => __( 'Field Name', 'formidable' ),
603 513 'class' => 'show_field_custom_html',
604 514 ),
605 - 'description' => array(
515 + 'description' => array(
606 516 'label' => __( 'Field Description', 'formidable' ),
607 517 'class' => 'show_field_custom_html',
608 518 ),
609 - 'label_position' => array(
519 + 'label_position' => array(
610 520 'label' => __( 'Label Position', 'formidable' ),
611 521 'class' => 'show_field_custom_html',
612 522 ),
613 - 'required_label' => array(
523 + 'required_label' => array(
614 524 'label' => __( 'Required Label', 'formidable' ),
615 525 'class' => 'show_field_custom_html',
616 526 ),
617 - 'input' => array(
527 + 'input' => array(
618 528 'label' => __( 'Input Field', 'formidable' ),
619 529 'class' => 'show_field_custom_html',
620 530 ),
621 - 'input opt=1' => array(
531 + 'input opt=1' => array(
622 532 'label' => __( 'Single Option', 'formidable' ),
623 533 'title' => __( 'Show a single radio or checkbox option by replacing 1 with the order of the option', 'formidable' ),
624 534 'class' => 'show_field_custom_html',
625 535 ),
626 - 'input label=0' => array(
536 + 'input label=0' => array(
627 537 'label' => __( 'Hide Option Label', 'formidable' ),
628 538 'class' => 'show_field_custom_html',
629 539 ),
630 - 'required_class' => array(
540 + 'required_class' => array(
631 541 'label' => __( 'Required Class', 'formidable' ),
632 542 'title' => __( 'Add class name if field is required', 'formidable' ),
633 543 'class' => 'show_field_custom_html',
634 544 ),
635 - 'error_class' => array(
545 + 'error_class' => array(
636 546 'label' => __( 'Error Class', 'formidable' ),
637 547 'title' => __( 'Add class name if field has an error on form submit', 'formidable' ),
638 548 'class' => 'show_field_custom_html',
639 549 ),
@@ -654,13 +564,13 @@
654 564 'label' => __( 'Delete Entry Link', 'formidable' ),
655 565 'class' => 'show_before_html show_after_html',
656 566 ),
657 567
658 - 'button_label' => array(
568 + 'button_label' => array(
659 569 'label' => __( 'Button Label', 'formidable' ),
660 570 'class' => 'show_submit_html',
661 571 ),
662 - 'button_action' => array(
572 + 'button_action' => array(
663 573 'label' => __( 'Button Hook', 'formidable' ),
664 574 'class' => 'show_submit_html',
665 575 ),
666 576 );
@@ -672,17 +582,14 @@
672 582 }
673 583
674 584 /**
675 585 * @since 4.0
676 - *
677 586 * @param array $args
678 - *
679 - * @return void
680 587 */
681 588 public static function insert_opt_html( $args ) {
682 - $class = $args['class'] ?? '';
683 - $fields = self::get_field_type_data_for_insert_opt_html();
684 - $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();
685 592
686 593 self::prepare_field_type( $field );
687 594
688 595 if ( ! isset( $field['icon'] ) ) {
@@ -689,9 +596,8 @@
689 596 $field['icon'] = 'frmfont frm_pencil_icon';
690 597 }
691 598
692 599 $possible_email_field = FrmFieldFactory::field_has_property( $args['type'], 'holds_email_values' );
693 -
694 600 if ( $possible_email_field ) {
695 601 $class .= ' show_frm_not_email_to';
696 602 }
697 603
@@ -697,60 +603,31 @@
697 603
698 604 if ( 'url' === $args['type'] ) {
699 605 $class .= ' frm_insert_url';
700 606 }
701 -
702 - $truncated_name = FrmAppHelper::truncate( $args['name'], 60 );
703 -
704 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
705 607 ?>
706 608 <li class="<?php echo esc_attr( $class ); ?>">
707 - <a href="javascript:void(0)" class="frmids frm_insert_code" data-code="<?php echo esc_attr( $args['id'] ); ?>">
708 - <?php
709 - if ( isset( $field['icon'] ) ) {
710 - FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) );
711 - }
712 -
713 - echo esc_html( $truncated_name );
714 - ?>
715 - <span>[<?php echo esc_html( $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>
716 614 </a>
717 - <a href="javascript:void(0)" class="frmkeys frm_insert_code frm_hidden" data-code="<?php echo esc_attr( $args['key'] ); ?>">
718 - <?php
719 - if ( isset( $field['icon'] ) ) {
720 - FrmAppHelper::icon_by_class( $field['icon'], array( 'aria-hidden' => 'true' ) );
721 - }
722 -
723 - echo esc_html( $truncated_name );
724 - ?>
725 - <span>[<?php echo esc_html( 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>
726 622 </a>
727 623 </li>
728 624 <?php
729 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
730 625 }
731 626
732 627 /**
733 - * Store and re-use field selection data for use when outputting shortcodes options in shortcode pop up.
734 - * This significantly improves performance by avoiding repeat calls to FrmField::all_field_selection.
735 - *
736 - * @since 6.10
737 - *
738 - * @return array
739 - */
740 - private static function get_field_type_data_for_insert_opt_html() {
741 - if ( ! isset( self::$field_type_data_for_insert_opt_html ) ) {
742 - self::$field_type_data_for_insert_opt_html = FrmField::all_field_selection();
743 - }
744 - return self::$field_type_data_for_insert_opt_html;
745 - }
746 -
747 - /**
748 628 * @since 4.0
749 - *
750 629 * @param array $args
751 - *
752 - * @return void
753 630 */
754 631 public static function insert_code_html( $args ) {
755 632 $defaults = array(
756 633 'class' => '',
@@ -761,22 +638,20 @@
761 638
762 639 $args = array_merge( $defaults, $args );
763 640 $has_tooltip = ! empty( $args['title'] );
764 641
765 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
766 642 ?>
767 643 <li class="<?php echo esc_attr( $args['class'] ); ?>">
768 644 <a href="javascript:void(0)" class="frm_insert_code <?php echo $has_tooltip ? 'frm_help' : ''; ?>"
769 645 <?php echo $has_tooltip ? 'title="' . esc_attr( $args['title'] ) . '"' : ''; ?>
770 646 data-code="<?php echo esc_attr( $args['code'] ); ?>">
771 - <?php echo esc_html( FrmAppHelper::truncate( $args['label'], 60 ) ); ?>
647 + <?php echo esc_attr( FrmAppHelper::truncate( $args['label'], 60 ) ); ?>
772 648 <span>
773 - [<?php echo esc_html( FrmAppHelper::truncate( $args['code'], 10 ) ); ?>]
649 + [<?php echo esc_attr( FrmAppHelper::truncate( $args['code'], 10 ) ); ?>]
774 650 </span>
775 651 </a>
776 652 </li>
777 653 <?php
778 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
779 654 }
780 655
781 656 /**
782 657 * Some field types in add-ons may have been added with only
@@ -782,18 +657,14 @@
782 657 * Some field types in add-ons may have been added with only
783 658 * a field type and name.
784 659 *
785 660 * @since 4.0
786 - *
787 - * @param array|string $field
788 - *
789 - * @return void
790 661 */
791 662 public static function prepare_field_type( &$field ) {
792 663 if ( ! is_array( $field ) ) {
793 664 $field = array(
794 665 'name' => $field,
795 - 'icon' => 'frmfont frm_pencil_icon',
666 + 'icon' => 'frm_icon_font frm_pencil_icon',
796 667 );
797 668 }
798 669 }
799 670
@@ -801,16 +672,14 @@
801 672 * Automatically add end section fields if they don't exist (2.0 migration)
802 673 *
803 674 * @since 2.0
804 675 *
805 - * @param object $form
806 - * @param array $fields
807 - * @param bool $reset_fields
808 - *
809 - * @return void
676 + * @param object $form
677 + * @param array $fields
678 + * @param boolean $reset_fields
810 679 */
811 680 public static function auto_add_end_section_fields( $form, $fields, &$reset_fields ) {
812 - if ( ! $fields ) {
681 + if ( empty( $fields ) ) {
813 682 return;
814 683 }
815 684
816 685 $end_section_values = apply_filters( 'frm_before_field_created', FrmFieldsHelper::setup_new_vars( 'end_divider', $form->id ) );
@@ -817,12 +686,11 @@
817 686 $open = false;
818 687 $prev_order = false;
819 688 $add_order = 0;
820 689 $last_field = false;
821 -
822 690 foreach ( $fields as $field ) {
823 691 if ( $prev_order === $field->field_order ) {
824 - ++$add_order;
692 + $add_order ++;
825 693 }
826 694
827 695 if ( $add_order ) {
828 696 $reset_fields = true;
@@ -862,17 +730,8 @@
862 730
863 731 /**
864 732 * Create end section field if it doesn't exist. This is for migration from < 2.0
865 733 * Fix any ordering that may be messed up
866 - *
867 - * @param bool $open
868 - * @param bool $reset_fields
869 - * @param int $add_order
870 - * @param array $end_section_values
871 - * @param object $field
872 - * @param string $move
873 - *
874 - * @return void
875 734 */
876 735 public static function maybe_create_end_section( &$open, &$reset_fields, &$add_order, $end_section_values, $field, $move = 'no' ) {
877 736 if ( ! $open ) {
878 737 return;
@@ -881,27 +740,18 @@
881 740 $end_section_values['field_order'] = $field->field_order + 1;
882 741
883 742 FrmField::create( $end_section_values );
884 743
885 - if ( $move === 'move' ) {
886 - // 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
887 746 FrmField::update( $field->id, array( 'field_order' => $field->field_order + 2 ) );
888 747 }
889 748
890 - $add_order += 2;
749 + $add_order += 2;
891 750 $open = false;
892 751 $reset_fields = true;
893 752 }
894 753
895 - /**
896 - * @param string $html
897 - * @param object $form
898 - * @param bool $title
899 - * @param bool $description
900 - * @param array $values
901 - *
902 - * @return string
903 - */
904 754 public static function replace_shortcodes( $html, $form, $title = false, $description = false, $values = array() ) {
905 755 $codes = array(
906 756 'form_name' => $title,
907 757 'form_description' => $description,
@@ -906,9 +756,8 @@
906 756 'form_name' => $title,
907 757 'form_description' => $description,
908 758 'entry_key' => true,
909 759 );
910 -
911 760 foreach ( $codes as $code => $show ) {
912 761 if ( $code === 'form_name' ) {
913 762 $replace_with = $form->name;
914 763 } elseif ( $code === 'form_description' ) {
@@ -918,9 +767,9 @@
918 767 } else {
919 768 $replace_with = '';
920 769 }
921 770
922 - 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 );
923 772 }
924 773
925 774 // Replace [form_key].
926 775 $html = str_replace( '[form_key]', $form->form_key, $html );
@@ -927,9 +776,9 @@
927 776
928 777 // Replace [frmurl].
929 778 $html = str_replace( '[frmurl]', FrmFieldsHelper::dynamic_default_values( 'frmurl' ), $html );
930 779
931 - if ( str_contains( $html, '[button_label]' ) ) {
780 + if ( strpos( $html, '[button_label]' ) ) {
932 781 add_filter( 'frm_submit_button', 'FrmFormsHelper::submit_button_label', 1 );
933 782 $submit_label = apply_filters( 'frm_submit_button', $title, $form );
934 783 $submit_label = esc_attr( do_shortcode( $submit_label ) );
935 784 $html = str_replace( '[button_label]', $submit_label, $html );
@@ -936,32 +785,27 @@
936 785 }
937 786
938 787 $html = apply_filters( 'frm_form_replace_shortcodes', $html, $form, $values );
939 788
940 - if ( str_contains( $html, '[if back_button]' ) ) {
789 + if ( strpos( $html, '[if back_button]' ) ) {
941 790 $html = preg_replace( '/(\[if\s+back_button\])(.*?)(\[\/if\s+back_button\])/mis', '', $html );
942 791 }
943 792
944 - if ( str_contains( $html, '[if save_draft]' ) ) {
793 + if ( strpos( $html, '[if save_draft]' ) ) {
945 794 $html = preg_replace( '/(\[if\s+save_draft\])(.*?)(\[\/if\s+save_draft\])/mis', '', $html );
946 795 }
947 796
948 - if ( str_contains( $html, '[if start_over]' ) ) {
797 + if ( strpos( $html, '[if start_over]' ) ) {
949 798 $html = preg_replace( '/(\[if\s+start_over\])(.*?)(\[\/if\s+start_over\])/mis', '', $html );
950 799 }
951 800
952 801 if ( apply_filters( 'frm_do_html_shortcodes', true ) ) {
953 - return do_shortcode( $html );
802 + $html = do_shortcode( $html );
954 803 }
955 804
956 805 return $html;
957 806 }
958 807
959 - /**
960 - * @param string $submit
961 - *
962 - * @return string
963 - */
964 808 public static function submit_button_label( $submit ) {
965 809 if ( ! $submit ) {
966 810 $frm_settings = FrmAppHelper::get_settings();
967 811 $submit = $frm_settings->submit_value;
@@ -974,32 +818,28 @@
974 818 * If the Formidable styling isn't being loaded,
975 819 * use inline styling to hide the element
976 820 *
977 821 * @since 2.03.05
978 - *
979 - * @return void
980 822 */
981 823 public static function maybe_hide_inline() {
982 824 $frm_settings = FrmAppHelper::get_settings();
983 -
984 - if ( $frm_settings->load_style === 'none' ) {
825 + if ( $frm_settings->load_style == 'none' ) {
985 826 echo ' style="display:none;"';
986 - } elseif ( $frm_settings->load_style === 'dynamic' ) {
827 + } elseif ( $frm_settings->load_style == 'dynamic' ) {
987 828 FrmStylesController::enqueue_style();
988 829 }
989 830 }
990 831
991 - /**
992 - * @param array|bool|int|object|string $form
993 - *
994 - * @return string|null
995 - */
996 832 public static function get_form_style_class( $form = false ) {
997 833 $style = self::get_form_style( $form );
998 834 $class = ' with_frm_style';
999 835
1000 - if ( ! $style ) {
1001 - 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 + }
1002 842 }
1003 843
1004 844 // If submit button needs to be inline or centered.
1005 845 if ( is_object( $form ) ) {
@@ -1020,9 +860,11 @@
1020 860 } elseif ( 'center' === $submit_align ) {
1021 861 $class .= ' frm_center_submit';
1022 862 }
1023 863
1024 - 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;
1025 867 }
1026 868
1027 869 /**
1028 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.
@@ -1029,17 +871,16 @@
1029 871 *
1030 872 * @since 5.0.12
1031 873 *
1032 874 * @param array $form
1033 - *
1034 875 * @return bool
1035 876 */
1036 877 private static function form_should_be_inline_and_missing_class( $form ) {
1037 - if ( isset( $form['form_class'] ) && str_contains( ' ' . $form['form_class'] . ' ', ' frm_inline_form ' ) ) {
1038 - // 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.
1039 880 return false;
1040 881 }
1041 - 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' );
1042 883 }
1043 884
1044 885 /**
1045 886 * Returns appropriate class if form has top labels
@@ -1064,9 +905,8 @@
1064 905 return false;
1065 906 }
1066 907
1067 908 $fields = $form['fields'];
1068 -
1069 909 if ( count( $fields ) <= 0 ) {
1070 910 return false;
1071 911 }
1072 912
@@ -1071,13 +911,11 @@
1071 911 }
1072 912
1073 913 // Start from the fields closest to the submit button.
1074 914 $fields = array_reverse( $fields );
1075 -
1076 915 foreach ( $fields as $field ) {
1077 - $type = $field['original_type'] ?? $field['type'];
916 + $type = isset( $field['original_type'] ) ? $field['original_type'] : $field['type'];
1078 917 $has_input = FrmFieldFactory::field_has_property( $type, 'has_input' );
1079 -
1080 918 if ( $has_input ) {
1081 919 return self::field_has_top_label( $field, $form );
1082 920 }
1083 921 }
@@ -1088,31 +926,29 @@
1088 926 /**
1089 927 * Check if a field's label position is set to "top"
1090 928 *
1091 929 * @param array $field
1092 - * @param bool|object|string $form
930 + * @param object|string|bool $form
1093 931 *
1094 932 * @return bool
1095 933 */
1096 934 private static function field_has_top_label( $field, $form ) {
1097 935 $label_position = FrmFieldsHelper::label_position( $field['label'], $field, $form );
1098 - return in_array( $label_position, array( 'top', 'inside', 'hidden' ), true );
936 +
937 + return in_array( $label_position, array( 'top', 'inside', 'hidden' ) );
1099 938 }
1100 939
1101 940 /**
1102 - * @param array|bool|int|object|string $form
941 + * @param object|string|boolean $form
1103 942 *
1104 - * @return int|string
943 + * @return string
1105 944 */
1106 945 public static function get_form_style( $form ) {
1107 946 $style = 1;
1108 -
1109 - if ( ! $form || 'default' === $form ) {
947 + if ( empty( $form ) || 'default' === $form ) {
1110 948 return $style;
1111 - }
1112 -
1113 - if ( is_object( $form ) && $form->parent_form_id ) {
1114 - // 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
1115 951 $form = $form->parent_form_id;
1116 952 } elseif ( is_array( $form ) && ! empty( $form['parent_form_id'] ) ) {
1117 953 $form = $form['parent_form_id'];
1118 954 } elseif ( is_array( $form ) && isset( $form['custom_style'] ) ) {
@@ -1118,32 +954,32 @@
1118 954 } elseif ( is_array( $form ) && isset( $form['custom_style'] ) ) {
1119 955 $style = $form['custom_style'];
1120 956 }
1121 957
1122 - if ( $form && ( is_string( $form ) || is_int( $form ) ) ) {
958 + if ( $form && is_string( $form ) ) {
1123 959 $form = FrmForm::getOne( $form );
1124 960 }
1125 961
1126 - 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;
1127 965 }
1128 966
1129 967 /**
1130 968 * Display the validation error messages when an entry is submitted
1131 969 *
1132 - * @since 2.0.6
1133 - *
1134 970 * @param array $args Includes img, errors.
1135 971 *
1136 - * @return void
972 + * @since 2.0.6
1137 973 */
1138 974 public static function show_errors( $args ) {
1139 975 $invalid_msg = self::get_invalid_error_message( $args );
1140 976
1141 - if ( $invalid_msg ) {
977 + if ( empty( $invalid_msg ) ) {
978 + $show_img = false;
979 + } else {
1142 980 echo wp_kses_post( $invalid_msg );
1143 981 $show_img = true;
1144 - } else {
1145 - $show_img = false;
1146 982 }
1147 983
1148 984 self::show_error(
1149 985 array(
@@ -1158,22 +994,19 @@
1158 994 * Display the error message in the front-end along with the image if set
1159 995 * The image was removed from the styling settings, but it may still be set with a hook
1160 996 * If the message in the global settings is empty, show every validation message in the error box
1161 997 *
1162 - * @since 2.0.6
1163 - *
1164 998 * @param array $args Includes img, errors, and show_img.
1165 999 *
1166 - * @return void
1000 + * @since 2.0.6
1167 1001 */
1168 1002 public static function show_error( $args ) {
1169 - // Remove any blank messages
1003 + // remove any blank messages
1170 1004 $args['errors'] = array_filter( (array) $args['errors'] );
1171 1005
1172 1006 $line_break_first = $args['show_img'];
1173 -
1174 1007 foreach ( $args['errors'] as $error_key => $error ) {
1175 - 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 ) ) {
1176 1009 continue;
1177 1010 }
1178 1011
1179 1012 $id = str_replace( 'field', 'field_', $error_key );
@@ -1179,9 +1012,9 @@
1179 1012 $id = str_replace( 'field', 'field_', $error_key );
1180 1013 echo '<div id="' . esc_attr( $id ) . '_error">';
1181 1014
1182 1015 if ( $args['show_img'] && ! empty( $args['img'] ) ) {
1183 - echo '<img src="' . esc_url( $args['img'] ) . '" alt="" />';
1016 + echo '<img src="' . esc_attr( $args['img'] ) . '" alt="" />';
1184 1017 } else {
1185 1018 $args['show_img'] = true;
1186 1019 }
1187 1020
@@ -1190,38 +1023,34 @@
1190 1023 echo '</div>';
1191 1024 }
1192 1025 }
1193 1026
1194 - /**
1195 - * @param int|string $id
1196 - *
1197 - * @return void
1198 - */
1199 1027 public static function maybe_get_scroll_js( $id ) {
1200 1028 $offset = apply_filters( 'frm_scroll_offset', 4, array( 'form_id' => $id ) );
1201 -
1202 - // phpcs:ignore Universal.Operators.StrictComparisons
1203 1029 if ( $offset != - 1 ) {
1204 1030 self::get_scroll_js( $id );
1205 1031 }
1206 1032 }
1207 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 +
1208 1038 /**
1209 - * @param int|string $form_id
1210 - *
1211 - * @return void
1039 + * @since 3.0
1212 1040 */
1213 - public static function get_scroll_js( $form_id ) {
1214 - 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 + }
1215 1049 }
1216 1050
1217 1051 /**
1218 1052 * @since 3.0
1219 - *
1220 - * @param int|object|string $form_id
1221 - * @param mixed $form
1222 - *
1223 - * @return array
1224 1053 */
1225 1054 public static function get_action_links( $form_id, $form ) {
1226 1055 if ( ! is_object( $form ) ) {
1227 1056 $form = FrmForm::getOne( $form_id );
@@ -1228,10 +1057,9 @@
1228 1057 }
1229 1058
1230 1059 $actions = array();
1231 1060 $trash_links = self::delete_trash_links( $form_id );
1232 -
1233 - if ( 'trash' === $form->status ) {
1061 + if ( 'trash' == $form->status ) {
1234 1062 $actions['restore'] = $trash_links['restore'];
1235 1063
1236 1064 if ( current_user_can( 'frm_delete_forms' ) ) {
1237 1065 $actions['trash'] = $trash_links['delete'];
@@ -1237,20 +1065,19 @@
1237 1065 $actions['trash'] = $trash_links['delete'];
1238 1066 }
1239 1067 } elseif ( current_user_can( 'frm_edit_forms' ) ) {
1240 1068 $duplicate_link = '?page=formidable&frm_action=duplicate&id=' . $form_id;
1241 -
1242 1069 if ( $form->is_template ) {
1243 1070 $actions['frm_duplicate'] = array(
1244 1071 'url' => wp_nonce_url( $duplicate_link ),
1245 1072 'label' => __( 'Create Form from Template', 'formidable' ),
1246 - 'icon' => 'frmfont frm_clone_icon',
1073 + 'icon' => 'frm_icon_font frm_clone_icon',
1247 1074 );
1248 1075 } else {
1249 1076 $actions['duplicate'] = array(
1250 1077 'url' => wp_nonce_url( $duplicate_link ),
1251 - 'label' => __( 'Duplicate', 'formidable' ),
1252 - 'icon' => 'frmfont frm_clone_icon',
1078 + 'label' => __( 'Duplicate Form', 'formidable' ),
1079 + 'icon' => 'frm_icon_font frm_clone_icon',
1253 1080 );
1254 1081 }
1255 1082
1256 1083 $actions['trash'] = self::delete_trash_info( $form_id, $form->status );
@@ -1258,13 +1085,8 @@
1258 1085
1259 1086 return $actions;
1260 1087 }
1261 1088
1262 - /**
1263 - * @param int|object|string $data
1264 - *
1265 - * @return string
1266 - */
1267 1089 public static function edit_form_link( $data ) {
1268 1090 $form_id = self::get_form_id_from_data( $data );
1269 1091
1270 1092 if ( ! $form_id ) {
@@ -1271,122 +1093,94 @@
1271 1093 return '';
1272 1094 }
1273 1095
1274 1096 $label = self::edit_form_link_label( $data );
1275 - 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;
1276 1099 }
1277 1100
1278 - /**
1279 - * Returns a text used when no title is set.
1280 - *
1281 - * @since 6.16.1
1282 - *
1283 - * @return string
1284 - */
1285 - public static function get_no_title_text() {
1286 - return __( '(no title)', 'formidable' );
1287 - }
1288 -
1289 - /**
1290 - * @param int|object|string $data
1291 - *
1292 - * @return string
1293 - */
1294 1101 public static function edit_form_link_label( $data ) {
1295 1102 $name = self::get_form_name_from_data( $data );
1296 -
1297 1103 if ( ! $name ) {
1298 - return self::get_no_title_text();
1104 + return __( '(no title)', 'formidable' );
1299 1105 }
1300 -
1301 1106 return FrmAppHelper::truncate( $name, 40 );
1302 1107 }
1303 1108
1304 1109 /**
1305 - * @param int|object|string $data
1306 - *
1307 - * @return int|string
1110 + * @param mixed $data
1111 + * @return int
1308 1112 */
1309 1113 private static function get_form_id_from_data( $data ) {
1310 - 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;
1311 1120 }
1312 1121
1313 1122 /**
1314 1123 * @param mixed $data
1315 - *
1316 1124 * @return string
1317 1125 */
1318 1126 private static function get_form_name_from_data( $data ) {
1319 1127 if ( is_object( $data ) ) {
1320 - return $data->name;
1128 + $form_name = $data->name;
1129 + } else {
1130 + $form_id = $data;
1131 + $form_name = FrmForm::getName( $form_id );
1321 1132 }
1322 -
1323 - $form_id = $data;
1324 - return FrmForm::getName( $form_id );
1133 + return $form_name;
1325 1134 }
1326 1135
1327 - /**
1328 - * @param int $id
1329 - * @param string $status
1330 - * @param string $length
1331 - *
1332 - * @return string
1333 - */
1334 1136 public static function delete_trash_link( $id, $status, $length = 'label' ) {
1335 1137 $link_details = self::delete_trash_info( $id, $status );
1138 +
1336 1139 return self::format_link_html( $link_details, $length );
1337 1140 }
1338 1141
1339 1142 /**
1340 1143 * @since 3.0
1341 - *
1342 - * @param array $link_details
1343 - * @param string $length
1344 - *
1345 - * @return string
1346 1144 */
1347 1145 public static function format_link_html( $link_details, $length = 'label' ) {
1348 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 + }
1349 1156
1350 - if ( ! $link_details ) {
1351 - return $link;
1352 - }
1353 -
1354 - $link = '<a href="' . esc_url( $link_details['url'] ) . '" class="frm-trash-link"';
1355 -
1356 - if ( isset( $link_details['data'] ) ) {
1357 - foreach ( $link_details['data'] as $data => $value ) {
1358 - $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'] ) . '"';
1359 1161 }
1360 - } elseif ( isset( $link_details['confirm'] ) ) {
1361 - $link .= ' onclick="return confirm(\'' . esc_attr( $link_details['confirm'] ) . '\')"';
1362 - }
1363 1162
1364 - $label = $link_details[ $length ] ?? $link_details['label'];
1365 -
1366 - if ( $length === 'icon' && isset( $link_details[ $length ] ) ) {
1367 - $label = '<span class="' . $label . '" title="' . esc_attr( $link_details['label'] ) . '" aria-hidden="true"></span>';
1368 - $link .= ' aria-label="' . esc_attr( $link_details['label'] ) . '"';
1163 + $link .= '>' . $label . '</a>';
1369 1164 }
1370 1165
1371 - return $link . ( '>' . $label . '</a>' );
1166 + return $link;
1372 1167 }
1373 1168
1374 1169 /**
1375 1170 * @since 3.0
1376 - *
1377 - * @param int $id
1378 - * @param string $status
1379 - *
1380 - * @return array
1381 1171 */
1382 1172 public static function delete_trash_info( $id, $status ) {
1383 1173 $labels = self::delete_trash_links( $id );
1384 1174
1385 - if ( 'trash' === $status ) {
1175 + if ( 'trash' == $status ) {
1386 1176 $info = $labels['restore'];
1387 1177 } elseif ( current_user_can( 'frm_delete_forms' ) ) {
1388 - $info = EMPTY_TRASH_DAYS ? $labels['trash'] : $labels['delete'];
1178 + if ( EMPTY_TRASH_DAYS ) {
1179 + $info = $labels['trash'];
1180 + } else {
1181 + $info = $labels['delete'];
1182 + }
1389 1183 } else {
1390 1184 $info = array();
1391 1185 }
1392 1186
@@ -1394,12 +1188,8 @@
1394 1188 }
1395 1189
1396 1190 /**
1397 1191 * @since 3.0
1398 - *
1399 - * @param int $id
1400 - *
1401 - * @return array
1402 1192 */
1403 1193 public static function delete_trash_links( $id ) {
1404 1194 $current_page = FrmAppHelper::get_simple_request( array( 'param' => 'form_type' ) );
1405 1195 $base_url = '?page=formidable&form_type=' . $current_page . '&id=' . $id;
@@ -1413,9 +1203,9 @@
1413 1203 'trash' => array(
1414 1204 'label' => __( 'Move Form to Trash', 'formidable' ),
1415 1205 'short' => __( 'Trash', 'formidable' ),
1416 1206 'url' => wp_nonce_url( $base_url . '&frm_action=trash', 'trash_form_' . absint( $id ) ),
1417 - 'icon' => 'frmfont frm_delete_icon',
1207 + 'icon' => 'frm_icon_font frm_delete_icon',
1418 1208 'data' => array(
1419 1209 'frmverify' => __( 'Do you want to move this form to the trash?', 'formidable' ),
1420 1210 'frmverify-btn' => 'frm-button-red',
1421 1211 ),
@@ -1424,9 +1214,9 @@
1424 1214 'label' => __( 'Delete Permanently', 'formidable' ),
1425 1215 'short' => __( 'Delete', 'formidable' ),
1426 1216 'url' => wp_nonce_url( $base_url . '&frm_action=destroy', 'destroy_form_' . absint( $id ) ),
1427 1217 'confirm' => __( 'Are you sure you want to delete this form and all its entries?', 'formidable' ),
1428 - 'icon' => 'frmfont frm_delete_icon',
1218 + 'icon' => 'frm_icon_font frm_delete_icon',
1429 1219 'data' => array(
1430 1220 'frmverify' => __( 'This will permanently delete the form and all its entries. This is irreversible. Are you sure you want to continue?', 'formidable' ),
1431 1221 'frmverify-btn' => 'frm-button-red',
1432 1222 ),
@@ -1435,38 +1225,36 @@
1435 1225 }
1436 1226
1437 1227 /**
1438 1228 * @since 3.0
1439 - *
1440 - * @return array
1441 1229 */
1442 1230 public static function css_classes() {
1443 1231 $classes = array(
1444 - 'frm_total' => array(
1232 + 'frm_total' => array(
1445 1233 'label' => __( 'Total', 'formidable' ),
1446 1234 'title' => __( 'Add this to a read-only field to display the text in bold without a border or background.', 'formidable' ),
1447 1235 ),
1448 - 'frm_total_big' => array(
1236 + 'frm_total_big' => array(
1449 1237 'label' => __( 'Big Total', 'formidable' ),
1450 1238 'title' => __( 'Add this to a read-only field to display the text in large, bold text without a border or background.', 'formidable' ),
1451 1239 ),
1452 - 'frm_scroll_box' => array(
1240 + 'frm_scroll_box' => array(
1453 1241 'label' => __( 'Scroll Box', 'formidable' ),
1454 - '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' ),
1455 1243 ),
1456 - 'frm_first' => array(
1244 + 'frm_first' => array(
1457 1245 'label' => __( 'First', 'formidable' ),
1458 1246 'title' => __( 'Add this to the first field in each row along with a width. ie frm_first frm4', 'formidable' ),
1459 1247 ),
1460 - 'frm_alignright' => __( 'Right', 'formidable' ),
1461 - 'frm_grid_first' => __( 'First Grid Row', 'formidable' ),
1462 - 'frm_grid' => __( 'Even Grid Row', 'formidable' ),
1463 - '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' ),
1464 1252 'frm_color_block' => array(
1465 1253 'label' => __( 'Color Block', 'formidable' ),
1466 1254 'title' => __( 'Add a background color to the field or section.', 'formidable' ),
1467 1255 ),
1468 - 'frm_capitalize' => array(
1256 + 'frm_capitalize' => array(
1469 1257 'label' => __( 'Capitalize', 'formidable' ),
1470 1258 'title' => __( 'Automatically capitalize the first letter in each word.', 'formidable' ),
1471 1259 ),
1472 1260 );
@@ -1473,11 +1261,8 @@
1473 1261
1474 1262 return apply_filters( 'frm_layout_classes', $classes );
1475 1263 }
1476 1264
1477 - /**
1478 - * @return array
1479 - */
1480 1265 public static function grid_classes() {
1481 1266 return array(
1482 1267 'frm_half' => '1/2',
1483 1268 'frm_third' => '1/3',
@@ -1491,18 +1276,12 @@
1491 1276 }
1492 1277
1493 1278 /**
1494 1279 * @since 3.0
1495 - *
1496 - * @param mixed $style
1497 - * @param string $class
1498 - *
1499 - * @return string
1500 1280 */
1501 1281 public static function style_class_label( $style, $class ) {
1502 1282 $label = '';
1503 -
1504 - if ( ! $style ) {
1283 + if ( empty( $style ) ) {
1505 1284 $label = $class;
1506 1285 } elseif ( ! is_array( $style ) ) {
1507 1286 $label = $style;
1508 1287 } elseif ( isset( $style['label'] ) ) {
@@ -1511,13 +1290,8 @@
1511 1290
1512 1291 return $label;
1513 1292 }
1514 1293
1515 - /**
1516 - * @param string $status
1517 - *
1518 - * @return string
1519 - */
1520 1294 public static function status_nice_name( $status ) {
1521 1295 $nice_names = array(
1522 1296 'draft' => __( 'Draft', 'formidable' ),
1523 1297 'trash' => __( 'Trash', 'formidable' ),
@@ -1523,13 +1297,15 @@
1523 1297 'trash' => __( 'Trash', 'formidable' ),
1524 1298 'publish' => __( 'Published', 'formidable' ),
1525 1299 );
1526 1300
1527 - if ( ! array_key_exists( $status, $nice_names ) ) {
1301 + if ( ! in_array( $status, array_keys( $nice_names ) ) ) {
1528 1302 $status = 'publish';
1529 1303 }
1530 1304
1531 - return $nice_names[ $status ];
1305 + $name = $nice_names[ $status ];
1306 +
1307 + return $name;
1532 1308 }
1533 1309
1534 1310 /**
1535 1311 * Renders a template icon based on the given categories.
@@ -1536,11 +1312,10 @@
1536 1312 *
1537 1313 * @param array $categories The categories to render the icon for.
1538 1314 * @param array $atts {
1539 1315 * Optional. An array of attributes for rendering.
1540 - *
1541 1316 * @type string $html 'span' or 'div'. Default 'span'.
1542 - * @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.
1543 1318 * }
1544 1319 *
1545 1320 * @return void
1546 1321 */
@@ -1546,76 +1321,84 @@
1546 1321 */
1547 1322 public static function template_icon( $categories, $atts = array() ) {
1548 1323 // Define defaults.
1549 1324 $defaults = array(
1550 - 'bg' => true,
1325 + 'bg' => true,
1551 1326 );
1552 - $atts = array_merge( $defaults, $atts );
1327 + $atts = array_merge( $defaults, $atts );
1553 1328
1554 1329 // Filter out ignored categories.
1555 - $ignore = self::get_license_types();
1330 + $ignore = self::ignore_template_categories();
1556 1331 $categories = array_diff( $categories, $ignore );
1557 1332
1558 1333 // Define icons mapping.
1559 1334 $icons = array(
1560 - 'WooCommerce' => array( 'woocommerce', 'var(--purple)' ),
1561 - 'Post' => array( 'wordpress', 'rgb(0,160,210)' ),
1562 - '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)' ),
1563 1338 'Registration and Signup' => array( 'register', 'var(--pink)' ),
1564 - 'PayPal' => array( 'paypal' ),
1565 - 'Stripe' => array( 'credit_card', 'var(--green)' ),
1566 - 'Twilio' => array( 'sms' ),
1567 - 'Payment' => array( 'credit_card' ),
1568 - 'Order Form' => array( 'product' ),
1569 - 'Finance' => array( 'total' ),
1570 - 'Health and Wellness' => array( 'heart', 'var(--pink)' ),
1571 - 'Event Planning' => array( 'calendar', 'var(--orange)' ),
1572 - 'Real Estate' => array( 'house' ),
1573 - 'Nonprofit' => array( 'heart_solid' ),
1574 - 'Calculator' => array( 'calculator', 'var(--purple)' ),
1575 - 'Quiz' => array( 'percent' ),
1576 - 'Registrations' => array( 'address_card' ),
1577 - 'Customer Service' => array( 'users_solid' ),
1578 - 'Education' => array( 'pencil' ),
1579 - 'Marketing' => array( 'eye' ),
1580 - 'Feedback' => array( 'smile' ),
1581 - 'Business Operations' => array( 'case' ),
1582 - 'Contact Form' => array( 'email' ),
1583 - 'Conversational Forms' => array( 'chat_forms' ),
1584 - 'Survey' => array( 'chat_forms', 'var(--orange)' ),
1585 - 'Application' => array( 'align_right' ),
1586 - 'Signature' => array( 'signature' ),
1587 - '' => 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' ),
1588 1363 );
1589 1364
1590 1365 // Determine the icon to be used.
1591 1366 $icon = $icons[''];
1592 -
1593 1367 if ( count( $categories ) === 1 ) {
1594 1368 $category = reset( $categories );
1595 - $icon = $icons[ $category ] ?? $icon;
1596 - } elseif ( $categories ) {
1369 + $icon = isset( $icons[ $category ] ) ? $icons[ $category ] : $icon;
1370 + } elseif ( ! empty( $categories ) ) {
1597 1371 $icons = array_intersect_key( $icons, array_flip( $categories ) );
1598 - $icon = reset( $icons );
1372 + $icon = reset( $icons );
1599 1373 }
1600 1374
1601 1375 // Prepare variables for output.
1602 1376 $icon_name = $icon[0];
1603 - $bg_color = $icon[1] ?? '';
1377 + $bg_color = isset( $icon[1] ) ? $icon[1] : '';
1604 1378
1605 1379 // Render the icon.
1606 1380 echo '<span class="frm-category-icon frm-icon-wrapper"';
1607 -
1608 1381 if ( $bg_color && $atts['bg'] ) {
1609 1382 echo ' style="background-color:' . esc_attr( $bg_color ) . '"';
1610 1383 }
1611 -
1612 1384 echo '>';
1613 - FrmAppHelper::icon_by_class( 'frmfont frm_' . $icon_name . '_icon' );
1385 + FrmAppHelper::icon_by_class( 'frmfont frm_' . $icon_name . '_icon' );
1614 1386 echo '</span>';
1615 1387 }
1616 1388
1617 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 + /**
1618 1401 * Get template install link.
1619 1402 *
1620 1403 * @since 4.02
1621 1404 *
@@ -1620,9 +1403,8 @@
1620 1403 * @since 4.02
1621 1404 *
1622 1405 * @param array $template Template details.
1623 1406 * @param array $args Additional arguments.
1624 - *
1625 1407 * @return array The link attributes.
1626 1408 */
1627 1409 public static function get_template_install_link( $template, $args ) {
1628 1410 $defaults = array(
@@ -1638,8 +1420,13 @@
1638 1420 'class' => 'frm-install-template',
1639 1421 'href' => 'rel',
1640 1422 'atts' => '',
1641 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 + );
1642 1429 } else {
1643 1430 $link = array(
1644 1431 'url' => $args['pricing'],
1645 1432 'label' => __( 'Upgrade', 'formidable' ),
@@ -1654,9 +1441,8 @@
1654 1441 *
1655 1442 * @since 4.02.02
1656 1443 *
1657 1444 * @param array $args
1658 - *
1659 1445 * @return bool
1660 1446 */
1661 1447 public static function plan_is_allowed( $args ) {
1662 1448 if ( empty( $args['license_type'] ) ) {
@@ -1675,9 +1461,8 @@
1675 1461 foreach ( $plans as $plan ) {
1676 1462 if ( $included || $plan === $license_type ) {
1677 1463 break;
1678 1464 }
1679 -
1680 1465 $included = $plan === $plan_required;
1681 1466 }
1682 1467
1683 1468 return $included;
@@ -1687,29 +1472,22 @@
1687 1472 * If a template or add-on cannot be installed, show a message
1688 1473 * about which plan is required.
1689 1474 *
1690 1475 * @since 4.0
1691 - *
1692 - * @param string $requires
1693 - * @param string $link
1694 - *
1695 - * @return void
1696 1476 */
1697 1477 public static function show_plan_required( $requires, $link ) {
1698 - if ( ! $requires ) {
1478 + if ( empty( $requires ) ) {
1699 1479 return;
1700 1480 }
1701 1481
1702 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
1703 1482 ?>
1704 1483 <p class="frm_plan_required">
1705 - <?php esc_html_e( 'Plan required:', 'formidable' ); ?>
1484 + <?php esc_html_e( 'License plan required:', 'formidable' ); ?>
1706 1485 <a href="<?php echo esc_url( $link ); ?>" target="_blank" rel="noopener">
1707 1486 <?php echo esc_html( $requires ); ?>
1708 1487 </a>
1709 1488 </p>
1710 1489 <?php
1711 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
1712 1490 }
1713 1491
1714 1492 /**
1715 1493 * @since 4.0
@@ -1714,10 +1492,9 @@
1714 1492 /**
1715 1493 * @since 4.0
1716 1494 *
1717 1495 * @param array $item
1718 - *
1719 - * @return false|string
1496 + * @return string|false
1720 1497 */
1721 1498 public static function get_plan_required( &$item ) {
1722 1499 if ( ! isset( $item['categories'] ) || ! is_array( $item['categories'] ) || ! empty( $item['url'] ) ) {
1723 1500 return false;
@@ -1722,14 +1499,20 @@
1722 1499 if ( ! isset( $item['categories'] ) || ! is_array( $item['categories'] ) || ! empty( $item['url'] ) ) {
1723 1500 return false;
1724 1501 }
1725 1502
1726 - $plans = self::get_license_types();
1503 + $plans = array( 'free', 'Basic', 'Personal', 'Plus', 'Creator', 'Business', 'Elite' );
1727 1504
1728 1505 foreach ( $item['categories'] as $k => $category ) {
1729 1506 if ( in_array( $category, $plans, true ) ) {
1730 1507 unset( $item['categories'][ $k ] );
1731 - 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;
1732 1515 }
1733 1516 }
1734 1517
1735 1518 return false;
@@ -1735,53 +1518,8 @@
1735 1518 return false;
1736 1519 }
1737 1520
1738 1521 /**
1739 - * Converts legacy package names to the current standard package name.
1740 - *
1741 - * @since 6.15
1742 - *
1743 - * @param string $package_name
1744 - *
1745 - * @return string The updated package name.
1746 - */
1747 - public static function convert_legacy_package_names( $package_name ) {
1748 - if ( in_array( $package_name, array( 'Creator', 'Personal' ), true ) ) {
1749 - return 'Plus';
1750 - }
1751 -
1752 - return $package_name;
1753 - }
1754 -
1755 - /**
1756 - * Get the license types.
1757 - *
1758 - * @since 6.15
1759 - *
1760 - * @param array $args
1761 - *
1762 - * @return array
1763 - */
1764 - public static function get_license_types( $args = array() ) {
1765 - $defaults = array(
1766 - 'include_all' => true,
1767 - 'case_lower' => false,
1768 - );
1769 - $args = wp_parse_args( $args, $defaults );
1770 - $license_types = array( 'Basic', 'Plus', 'Business', 'Elite' );
1771 -
1772 - if ( $args['include_all'] ) {
1773 - $license_types = array_merge( array( 'free', 'Personal', 'Creator' ), $license_types );
1774 - }
1775 -
1776 - if ( $args['case_lower'] ) {
1777 - return array_map( 'strtolower', $license_types );
1778 - }
1779 -
1780 - return $license_types;
1781 - }
1782 -
1783 - /**
1784 1522 * Checks for warnings to be displayed after form settings are saved.
1785 1523 *
1786 1524 * @since 4.04
1787 1525 *
@@ -1789,9 +1527,10 @@
1789 1527 *
1790 1528 * @return array An array of warnings or an empty array.
1791 1529 */
1792 1530 public static function check_for_warnings( $values ) {
1793 - $warnings = array();
1531 + $warnings = array();
1532 +
1794 1533 $redirect_warning = self::check_redirect_url_for_unsafe_params( $values );
1795 1534
1796 1535 if ( $redirect_warning ) {
1797 1536 $warnings[] = $redirect_warning;
@@ -1816,9 +1555,9 @@
1816 1555
1817 1556 $options = $values['options'];
1818 1557 FrmAppHelper::sanitize_with_html( $options );
1819 1558
1820 - 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'] ) ) {
1821 1560 return false;
1822 1561 }
1823 1562
1824 1563 $unsafe_params_in_redirect = self::get_unsafe_params( $options['success_url'] );
@@ -1836,16 +1575,15 @@
1836 1575 * @return array An array of params whose names are reserved words or an empty array.
1837 1576 */
1838 1577 private static function get_unsafe_params( $url ) {
1839 1578 $redirect_components = parse_url( $url );
1840 -
1841 1579 if ( empty( $redirect_components['query'] ) ) {
1842 1580 return array();
1843 1581 }
1844 -
1845 1582 parse_str( $redirect_components['query'], $redirect_params );
1846 1583 $redirect_param_names = array_keys( $redirect_params );
1847 - $unsafe_params_in_redirect = array_intersect( $redirect_param_names, self::reserved_words() );
1584 + $reserved_words = self::reserved_words();
1585 + $unsafe_params_in_redirect = array_intersect( $redirect_param_names, $reserved_words );
1848 1586
1849 1587 return array_values( $unsafe_params_in_redirect );
1850 1588 }
1851 1589
@@ -1858,27 +1596,26 @@
1858 1596 *
1859 1597 * @return bool|string A string with an unsafe param message or false.
1860 1598 */
1861 1599 private static function create_unsafe_param_warning( $unsafe_params_in_redirect ) {
1862 - $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>';
1863 1604
1864 1605 if ( $count === 0 ) {
1865 1606 return false;
1866 1607 }
1867 1608
1868 - $caution = esc_html__( 'Is this intentional?', 'formidable' );
1869 - $reserved_words_intro = esc_html__( 'See the list of reserved words in WordPress.', 'formidable' );
1870 - $reserved_words_link = '<a href="https://codex.wordpress.org/WordPress_Query_Vars" target="_blank"> ' . $reserved_words_intro . '</a>';
1871 -
1872 - if ( $count === 1 ) {
1609 + if ( $count == 1 ) {
1873 1610 /* translators: %s: the name of a single parameter in the redirect URL */
1874 - 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;
1875 1612 }
1876 1613
1877 1614 $unsafe_params_string = implode( '", "', $unsafe_params_in_redirect );
1878 1615
1879 1616 /* translators: %s: the names of two or more parameters in the redirect URL, separated by commas */
1880 - 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;
1881 1618 }
1882 1619
1883 1620 /**
1884 1621 * Returns an array of common reserved words in WordPress.
@@ -1944,19 +1681,17 @@
1944 1681 * @since 5.0.16
1945 1682 *
1946 1683 * @param string $url
1947 1684 * @param int $form_id
1948 - *
1949 1685 * @return string
1950 1686 */
1951 1687 public static function maybe_add_sanitize_url_attr( $url, $form_id ) {
1952 - if ( ! str_contains( $url, '[' ) ) {
1688 + if ( false === strpos( $url, '[' ) ) {
1953 1689 // Do nothing if no shortcodes are detected.
1954 1690 return $url;
1955 1691 }
1956 1692
1957 1693 $parsed = wp_parse_url( $url );
1958 -
1959 1694 if ( empty( $parsed['query'] ) ) {
1960 1695 // Do nothing if no query can be detected in the url string.
1961 1696 return $url;
1962 1697 }
@@ -1962,10 +1697,10 @@
1962 1697 }
1963 1698
1964 1699 $original_query = $parsed['query'];
1965 1700 $query = $parsed['query'];
1966 - $shortcodes = FrmFieldsHelper::get_shortcodes( $query, $form_id );
1967 1701
1702 + $shortcodes = FrmFieldsHelper::get_shortcodes( $query, $form_id );
1968 1703 if ( empty( $shortcodes[0] ) ) {
1969 1704 // No shortcodes found, do nothing.
1970 1705 return $url;
1971 1706 }
@@ -1977,21 +1712,20 @@
1977 1712 // Skip if shortcodes.
1978 1713 continue;
1979 1714 }
1980 1715
1981 - if ( str_contains( $options, 'sanitize_url=' ) || str_contains( $options, 'sanitize=' ) ) {
1716 + if ( false !== strpos( $options, 'sanitize_url=' ) || false !== strpos( $options, 'sanitize=' ) ) {
1982 1717 // A sanitize option is already set so leave it alone.
1983 1718 continue;
1984 1719 }
1985 1720
1986 1721 $new_shortcode = '[' . $shortcodes[2][ $key ];
1987 -
1988 1722 if ( $options ) {
1989 1723 $new_shortcode .= ' ' . $options;
1990 1724 }
1725 + $new_shortcode .= ' sanitize_url=1]';
1991 1726
1992 - $new_shortcode .= ' sanitize_url=1]';
1993 - $query = str_replace( $shortcode, $new_shortcode, $query );
1727 + $query = str_replace( $shortcode, $new_shortcode, $query );
1994 1728 }//end foreach
1995 1729
1996 1730 if ( $query === $original_query ) {
1997 1731 return $url;
@@ -2000,8 +1734,20 @@
2000 1734 return str_replace( $original_query, $query, $url );
2001 1735 }
2002 1736
2003 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 + /**
2004 1750 * Outputs the appropriate button text in the publish box.
2005 1751 *
2006 1752 * @return void
2007 1753 */
@@ -2016,181 +1762,25 @@
2016 1762 }
2017 1763 }
2018 1764
2019 1765 /**
2020 - * Strip characters similar to the WordPress sanitize_html_class function, but allow for [ and ].
2021 - * This allows shortcodes inside of the layout classes setting.
2022 - *
2023 - * @since 6.16
2024 - *
2025 - * @param string $classname
2026 - *
2027 - * @return string
1766 + * @since 4.02
1767 + * @deprecated 6.7
2028 1768 */
2029 - public static function sanitize_layout_class( $classname ) {
2030 - // Strip out any percent-encoded characters.
2031 - $sanitized = preg_replace( '|%[a-fA-F0-9][a-fA-F0-9]|', '', $classname );
2032 -
2033 - // Limit to A-Z, a-z, 0-9, '_', '-', '[', ']'.
2034 - return preg_replace( '/[^A-Za-z0-9_\-\[\]]/', '', $sanitized );
1769 + public static function template_install_html( $link, $class = '' ) {
1770 + _deprecated_function( __METHOD__, '6.7' );
2035 1771 }
2036 1772
2037 1773 /**
2038 - * Returns true if the preview should be blocked.
1774 + * Check an array of templates, determine how many the logged in user can use
2039 1775 *
2040 - * @since 6.20
1776 + * @deprecated 6.7
2041 1777 *
2042 - * @param string $form_key
2043 - *
2044 - * @return bool
1778 + * @param array $templates
1779 + * @param array $args
1780 + * @return int
2045 1781 */
2046 - public static function should_block_preview( $form_key ) {
2047 - $should_block = in_array( $form_key, array( 'contact-form', 'contact-us' ), true ) && ! current_user_can( 'frm_view_forms' );
2048 - /**
2049 - * Filters whether the form preview should be blocked.
2050 - *
2051 - * @since 6.20
2052 - *
2053 - * @param bool $should_block
2054 - * @param string $form_key
2055 - */
2056 - return (bool) apply_filters( 'frm_block_preview', $should_block, $form_key );
2057 - }
2058 -
2059 - /**
2060 - * Checks if the form is loaded by API.
2061 - *
2062 - * @since 6.21
2063 - *
2064 - * @return bool
2065 - */
2066 - public static function form_is_loaded_by_api() {
2067 - global $frm_vars;
2068 -
2069 - if ( ! empty( $frm_vars['inplace_edit'] ) ) {
2070 - return true;
2071 - }
2072 -
2073 - return self::is_formidable_api_form() || self::is_block_or_page_builder_preview();
2074 - }
2075 -
2076 - /**
2077 - * Checks if the form is rendered inside a block editor or page builder preview.
2078 - *
2079 - * @since 6.29
2080 - *
2081 - * @return bool
2082 - */
2083 - public static function is_block_or_page_builder_preview() {
2084 - return self::is_gutenberg_editor() || self::is_elementor_ajax() || self::is_visual_views_preview();
2085 - }
2086 -
2087 - /**
2088 - * @since 6.21
2089 - *
2090 - * @return bool
2091 - */
2092 - private static function is_visual_views_preview() {
2093 - return 'frm_views_process_box_preview' === FrmAppHelper::get_post_param( 'action' );
2094 - }
2095 -
2096 - /**
2097 - * @since 6.21
2098 - *
2099 - * @return bool
2100 - */
2101 - private static function is_elementor_ajax() {
2102 - return 'elementor_ajax' === FrmAppHelper::get_post_param( 'action' );
2103 - }
2104 -
2105 - /**
2106 - * @since 6.21
2107 - *
2108 - * @return bool
2109 - */
2110 - private static function is_gutenberg_editor() {
2111 - $url = FrmAppHelper::get_server_value( 'REQUEST_URI' );
2112 -
2113 - if ( str_contains( $url, '/wp-json/wp/v2/block-renderer/formidable/simple-form' ) ) {
2114 - return true;
2115 - }
2116 -
2117 - if ( str_contains( urldecode( $url ), 'rest_route=/wp/v2/block-renderer/formidable/' ) ) {
2118 - return true;
2119 - }
2120 -
2121 - global $pagenow;
2122 - return 'post.php' === $pagenow;
2123 - }
2124 -
2125 - /**
2126 - * @since 6.21
2127 - *
2128 - * @return bool
2129 - */
2130 - private static function is_formidable_api_form() {
2131 - if ( ! class_exists( 'FrmAPIAppController' ) ) {
2132 - return false;
2133 - }
2134 -
2135 - $url = FrmAppHelper::get_server_value( 'REQUEST_URI' );
2136 -
2137 - if ( str_contains( $url, '/wp-json/frm/v2/forms/' ) ) {
2138 - // Prevent the honeypot from appearing for an API loaded form.
2139 - // This is to prevent conflicts where the script is not working.
2140 - return true;
2141 - }
2142 -
2143 - if ( is_callable( 'FrmProFormState::get_from_request' ) ) {
2144 - $api = FrmProFormState::get_from_request( 'a', 0 );
2145 -
2146 - if ( $api ) {
2147 - return true;
2148 - }
2149 - }
2150 -
2151 - return false;
2152 - }
2153 -
2154 - /**
2155 - * @since 6.30
2156 - *
2157 - * @return void
2158 - */
2159 - public static function load_currency_js() {
2160 - global $frm_vars;
2161 -
2162 - if ( empty( $frm_vars['currency'] ) ) {
2163 - return;
2164 - }
2165 -
2166 - echo '<script>';
2167 - echo 'var frmcurrency=' . json_encode( $frm_vars['currency'] ) . ";\n";
2168 - echo 'if(typeof __FRMCURR == "undefined"){__FRMCURR=frmcurrency;}';
2169 - echo 'else{__FRMCURR=jQuery.extend(true,{},__FRMCURR,frmcurrency);}';
2170 - echo '</script>';
2171 - }
2172 -
2173 - /**
2174 - * Returns the form name or the no title text if the form name is empty.
2175 - *
2176 - * @since 6.30
2177 - *
2178 - * @param array|stdClass $form The form data.
2179 - * @param int $length The form name length to truncate to.
2180 - *
2181 - * @return string
2182 - */
2183 - public static function get_form_name( $form, $length = 0 ) {
2184 - $form_name = is_object( $form ) ? $form->name : $form['name'];
2185 -
2186 - if ( '' === $form_name || null === $form_name ) {
2187 - return self::get_no_title_text();
2188 - }
2189 -
2190 - if ( ! $length ) {
2191 - return $form_name;
2192 - }
2193 -
2194 - return FrmAppHelper::truncate( $form_name, $length );
1782 + public static function available_count( $templates, $args ) {
1783 + _deprecated_function( __METHOD__, '6.7' );
1784 + return 0;
2195 1785 }
2196 1786 }