PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 5.4.3
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v5.4.3
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/FrmAppHelper.php +534 -1858 6.26 → 5.4.3 View file →
@@ -3,43 +3,27 @@
3 3 die( 'You are not allowed to call this page directly.' );
4 4 }
5 5
6 6 class FrmAppHelper {
7 + public static $db_version = 98; // Version of the database we are moving to.
8 + public static $pro_db_version = 37; //deprecated
9 + public static $font_version = 7;
7 10
8 11 /**
9 - * Version of the database we are moving to.
10 - *
11 - * @var int
12 + * @var bool $added_gmt_offset_filter
12 13 */
13 - public static $db_version = 104;
14 -
15 - /**
16 - * Used by the API add-on.
17 - *
18 - * @var float
19 - */
20 - public static $font_version = 7;
21 -
22 - /**
23 - * @var bool
24 - */
25 14 private static $added_gmt_offset_filter = false;
26 15
27 16 /**
28 17 * @since 2.0
29 - *
30 - * @var string
31 18 */
32 - public static $plug_version = '6.26';
19 + public static $plug_version = '5.4.3';
33 20
34 21 /**
35 - * @var bool
36 - */
37 - private static $included_svg = false;
38 -
39 - /**
40 22 * @since 1.07.02
41 23 *
24 + * @param none
25 + *
42 26 * @return string The version of this plugin
43 27 */
44 28 public static function plugin_version() {
45 29 return self::$plug_version;
@@ -44,33 +28,21 @@
44 28 public static function plugin_version() {
45 29 return self::$plug_version;
46 30 }
47 31
48 - /**
49 - * @return string
50 - */
51 32 public static function plugin_folder() {
52 33 return basename( self::plugin_path() );
53 34 }
54 35
55 - /**
56 - * @return string
57 - */
58 36 public static function plugin_path() {
59 - return dirname( __DIR__, 2 );
37 + return dirname( dirname( dirname( __FILE__ ) ) );
60 38 }
61 39
62 - /**
63 - * @return string
64 - */
65 40 public static function plugin_url() {
66 - // Previously FRM_URL constant.
41 + // Prevously FRM_URL constant.
67 42 return plugins_url( '', self::plugin_path() . '/formidable.php' );
68 43 }
69 44
70 - /**
71 - * @return string
72 - */
73 45 public static function relative_plugin_url() {
74 46 return str_replace( array( 'https:', 'http:' ), '', self::plugin_url() );
75 47 }
76 48
@@ -85,9 +57,8 @@
85 57 * Get the name of this site
86 58 * Used for [sitename] shortcode
87 59 *
88 60 * @since 2.0
89 - *
90 61 * @return string
91 62 */
92 63 public static function site_name() {
93 64 return get_option( 'blogname' );
@@ -92,16 +63,10 @@
92 63 public static function site_name() {
93 64 return get_option( 'blogname' );
94 65 }
95 66
96 - /**
97 - * @param string $url
98 - *
99 - * @return string
100 - */
101 67 public static function make_affiliate_url( $url ) {
102 68 $affiliate_id = self::get_affiliate();
103 -
104 69 if ( ! empty( $affiliate_id ) ) {
105 70 $url = str_replace( array( 'http://', 'https://' ), '', $url );
106 71 $url = 'http://www.shareasale.com/r.cfm?u=' . absint( $affiliate_id ) . '&b=841990&m=64739&afftrack=plugin&urllink=' . urlencode( $url );
107 72 }
@@ -108,11 +73,8 @@
108 73
109 74 return $url;
110 75 }
111 76
112 - /**
113 - * @return int
114 - */
115 77 public static function get_affiliate() {
116 78 return absint( apply_filters( 'frm_affiliate_id', 0 ) );
117 79 }
118 80
@@ -117,178 +79,64 @@
117 79 }
118 80
119 81 /**
120 82 * @since 3.04.02
121 - *
122 - * @param array|string $args If a string is passed, it is used for the utm_campaign attribute.
83 + * @param array|string $args
123 84 * @param string $page
124 85 */
125 86 public static function admin_upgrade_link( $args, $page = '' ) {
126 - if ( $page ) {
87 + if ( empty( $page ) ) {
88 + $page = 'https://formidableforms.com/lite-upgrade/';
89 + } else {
127 90 $page = str_replace( 'https://formidableforms.com/', '', $page );
128 91 $page = 'https://formidableforms.com/' . $page;
129 - } else {
130 - $page = 'https://formidableforms.com/lite-upgrade/';
131 92 }
132 93
94 + $anchor = '';
133 95 if ( is_array( $args ) ) {
134 - $args = self::adjust_legacy_utm_args( $args );
96 + $medium = $args['medium'];
97 + if ( isset( $args['content'] ) ) {
98 + $content = $args['content'];
99 + }
100 + if ( isset( $args['anchor'] ) ) {
101 + $anchor = '#' . $args['anchor'];
102 + }
135 103 } else {
136 - $args = array( 'campaign' => $args );
104 + $medium = $args;
137 105 }
138 106
139 107 $query_args = array(
140 - 'utm_source' => 'plugin',
141 - 'utm_medium' => self::get_utm_medium(),
108 + 'utm_source' => 'WordPress',
109 + 'utm_medium' => $medium,
110 + 'utm_campaign' => 'liteplugin',
142 111 );
143 - $query_args = self::maybe_add_utm_license( $query_args );
144 112
145 - if ( isset( $args['campaign'] ) ) {
146 - $query_args['utm_campaign'] = $args['campaign'];
113 + if ( isset( $content ) ) {
114 + $query_args['utm_content'] = $content;
147 115 }
148 116
149 - if ( isset( $args['content'] ) ) {
150 - $query_args['utm_content'] = $args['content'];
151 - }
152 -
153 - if ( isset( $args['param'] ) ) {
117 + if ( is_array( $args ) && isset( $args['param'] ) ) {
154 118 $query_args['f'] = $args['param'];
155 119 }
156 120
157 - if ( ! empty( $args['plan'] ) ) {
121 + if ( is_array( $args ) && ! empty( $args['plan'] ) ) {
158 122 $query_args['plan'] = $args['plan'];
159 123 }
160 124
161 - $link = add_query_arg( $query_args, $page );
162 -
163 - if ( isset( $args['anchor'] ) ) {
164 - $link .= '#' . $args['anchor'];
165 - }
166 -
125 + $link = add_query_arg( $query_args, $page ) . $anchor;
167 126 return self::make_affiliate_url( $link );
168 127 }
169 128
170 129 /**
171 - * If medium is "pro", add an additional utm_license param with their active license type.
172 - *
173 - * @since 6.25.1
174 - *
175 - * @param array $query_args
176 - * @param string $link
177 - *
178 - * @return array
179 - */
180 - private static function maybe_add_utm_license( $query_args, $link = '' ) {
181 - if ( isset( $query_args['utm_medium'] ) ) {
182 - $medium = $query_args['utm_medium'];
183 - } else {
184 - $medium = self::pull_medium_from_link( $link );
185 - }
186 -
187 - if ( 'pro' === $medium && is_callable( 'FrmProAddonsController::get_readable_license_type' ) ) {
188 - $query_args['utm_license'] = strtolower( FrmProAddonsController::get_readable_license_type() );
189 - }
190 -
191 - return $query_args;
192 - }
193 -
194 - /**
195 - * @since 6.26
196 - *
197 - * @param string $link
198 - *
199 - * @return string
200 - */
201 - private static function pull_medium_from_link( $link ) {
202 - if ( ! $link ) {
203 - return '';
204 - }
205 -
206 - $parsed = parse_url( $link );
207 -
208 - if ( ! is_array( $parsed ) || ! isset( $parsed['query'] ) ) {
209 - return '';
210 - }
211 -
212 - $query_args = wp_parse_args( $parsed['query'] );
213 -
214 - if ( empty( $query_args['utm_medium'] ) ) {
215 - return '';
216 - }
217 -
218 - return $query_args['utm_medium'];
219 - }
220 -
221 - /**
222 - * @since 6.25.1
223 - *
224 - * @return string
225 - */
226 - private static function get_utm_medium() {
227 - return self::pro_is_connected() ? 'pro' : 'lite';
228 - }
229 -
230 - /**
231 - * Change campaign from "liteplugin" to what we're currently using for medium.
232 - *
233 - * @since 6.25.1
234 - *
235 - * @param array $args
236 - *
237 - * @return array
238 - */
239 - private static function adjust_legacy_utm_args( $args ) {
240 - if ( isset( $args['medium'] ) ) {
241 - $args['campaign'] = $args['medium'];
242 - unset( $args['medium'] );
243 - }
244 -
245 - return $args;
246 - }
247 -
248 - /**
249 - * @since 6.21
250 - *
251 - * @param string $cta_link
252 - * @param array $utm
253 - */
254 - public static function maybe_add_missing_utm( $cta_link, $utm ) {
255 - $utm = self::adjust_legacy_utm_args( $utm );
256 - $query_args = array();
257 -
258 - if ( false === strpos( $cta_link, 'utm_source' ) ) {
259 - $query_args['utm_source'] = 'plugin';
260 - }
261 -
262 - if ( false === strpos( $cta_link, 'utm_medium' ) ) {
263 - $query_args['utm_medium'] = self::get_utm_medium();
264 - }
265 -
266 - if ( false === strpos( $cta_link, 'utm_campaign' ) && isset( $utm['campaign'] ) ) {
267 - $query_args['utm_campaign'] = $utm['campaign'];
268 - }
269 -
270 - if ( false === strpos( $cta_link, 'utm_content' ) && isset( $utm['content'] ) ) {
271 - $query_args['utm_content'] = $utm['content'];
272 - }
273 -
274 - $query_args = self::maybe_add_utm_license( $query_args, $cta_link );
275 -
276 - return $query_args ? add_query_arg( $query_args, $cta_link ) : $cta_link;
277 - }
278 -
279 - /**
280 130 * Get the Formidable settings
281 131 *
282 132 * @since 2.0
283 133 *
284 134 * @param array $args - May include the form id when values need translation.
285 - *
286 - * @return FrmSettings $frm_settings
135 + * @return FrmSettings $frm_setings
287 136 */
288 137 public static function get_settings( $args = array() ) {
289 138 global $frm_settings;
290 -
291 139 if ( empty( $frm_settings ) ) {
292 140 $frm_settings = new FrmSettings( $args );
293 141 } elseif ( isset( $args['current_form'] ) ) {
294 142 // If the global has already been set, allow strings to be filtered.
@@ -297,40 +145,16 @@
297 145
298 146 return $frm_settings;
299 147 }
300 148
301 - /**
302 - * @return string
303 - */
304 149 public static function get_menu_name() {
305 150 $frm_settings = self::get_settings();
306 151
307 - return FrmAddonsController::is_license_expired() || ! self::pro_is_installed() ? 'Formidable' : $frm_settings->menu;
152 + return $frm_settings->menu;
308 153 }
309 154
310 155 /**
311 - * Determine if the current branding is set to 'formidable'.
312 - * Checks the menu icon, and verifies if it matches the formidable branding.
313 - *
314 - * @since 6.4.2
315 - *
316 - * @return bool True if the menu icon is the logo, false otherwise.
317 - */
318 - public static function is_formidable_branding() {
319 - if ( ! self::pro_is_installed() ) {
320 - return true;
321 - }
322 -
323 - $menu_icon = self::get_menu_icon_class();
324 - return strpos( $menu_icon, 'frm_logo_icon' ) !== false;
325 - }
326 -
327 - /**
328 156 * @since 3.05
329 - *
330 - * @param array $atts
331 - *
332 - * @return string
333 157 */
334 158 public static function svg_logo( $atts = array() ) {
335 159 $defaults = array(
336 160 'height' => 18,
@@ -347,12 +171,8 @@
347 171 }
348 172
349 173 /**
350 174 * @since 4.0
351 - *
352 - * @param array $atts
353 - *
354 - * @return void
355 175 */
356 176 public static function show_logo( $atts = array() ) {
357 177 echo self::kses( self::svg_logo( $atts ), 'all' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
358 178 }
@@ -358,10 +178,8 @@
358 178 }
359 179
360 180 /**
361 181 * @since 4.03.02
362 - *
363 - * @return void
364 182 */
365 183 public static function show_header_logo() {
366 184 $icon = self::svg_logo(
367 185 array(
@@ -370,9 +188,8 @@
370 188 )
371 189 );
372 190
373 191 $new_icon = apply_filters( 'frm_icon', $icon, true );
374 -
375 192 if ( $new_icon !== $icon ) {
376 193 if ( strpos( $new_icon, '<svg' ) === 0 ) {
377 194 $icon = str_replace( 'viewBox="0 0 20', 'width="30" height="35" style="color:#929699" viewBox="0 0 20', $new_icon );
378 195 } else {
@@ -384,38 +201,21 @@
384 201 }
385 202
386 203 /**
387 204 * @since 2.02.04
388 - *
389 - * @return bool
390 205 */
391 206 public static function ips_saved() {
392 207 $frm_settings = self::get_settings();
208 +
393 209 return ! $frm_settings->no_ips;
394 210 }
395 211
396 - /**
397 - * @return bool
398 - */
399 212 public static function pro_is_installed() {
400 - return (bool) apply_filters( 'frm_pro_installed', false );
213 + return apply_filters( 'frm_pro_installed', false );
401 214 }
402 215
403 216 /**
404 - * Check if the Pro plugin is installed, whether authorized or not.
405 - *
406 - * @since 6.8.3
407 - *
408 - * @return bool
409 - */
410 - public static function pro_is_included() {
411 - return function_exists( 'load_formidable_pro' );
412 - }
413 -
414 - /**
415 217 * @since 4.06.02
416 - *
417 - * @return bool
418 218 */
419 219 public static function pro_is_connected() {
420 220 global $frm_vars;
421 221 return self::pro_is_installed() && $frm_vars['pro_is_authorized'];
@@ -422,31 +222,17 @@
422 222 }
423 223
424 224 /**
425 225 * @since 4.06
426 - * @since 6.16.2 Added $check_for_settings parameter
427 - *
428 - * @param bool $check_for_settings
429 - *
430 - * @return bool
431 226 */
432 - public static function is_form_builder_page( $check_for_settings = true ) {
433 - $action = self::simple_get( 'frm_action', 'sanitize_title' );
434 - $check_actions = array( 'edit', 'duplicate' );
435 -
436 - if ( $check_for_settings ) {
437 - $check_actions[] = 'settings';
438 - }
439 - return self::is_admin_page( 'formidable' ) && in_array( $action, $check_actions, true );
227 + public static function is_form_builder_page() {
228 + $action = self::simple_get( 'frm_action', 'sanitize_title' );
229 + return self::is_admin_page( 'formidable' ) && ( $action === 'edit' || $action === 'settings' || $action === 'duplicate' );
440 230 }
441 231
442 - /**
443 - * @return bool
444 - */
445 232 public static function is_formidable_admin() {
446 233 $page = self::simple_get( 'page', 'sanitize_title' );
447 234 $is_formidable = strpos( $page, 'formidable' ) !== false;
448 -
449 235 if ( empty( $page ) ) {
450 236 $is_formidable = self::is_view_builder_page();
451 237 }
452 238
@@ -453,69 +239,28 @@
453 239 return $is_formidable;
454 240 }
455 241
456 242 /**
457 - * Checks if is a list page.
458 - *
459 - * @since 6.19
460 - *
461 - * @param string $page The name of the page to check.
462 - *
463 - * @return bool
464 - */
465 - public static function is_admin_list_page( $page = 'formidable' ) {
466 - if ( 'formidable' === $page ) {
467 - return self::on_form_listing_page();
468 - }
469 -
470 - if ( ! self::is_admin_page( $page ) ) {
471 - return false;
472 - }
473 -
474 - if ( 'formidable-entries' === $page ) {
475 - $action = self::simple_get( 'frm_action' );
476 -
477 - if ( ! $action || in_array( $action, self::get_entries_listing_page_form_actions(), true ) ) {
478 - return true;
479 - }
480 - }
481 -
482 - // Check edit or settings page.
483 - return ! self::simple_get( 'frm_action' );
484 - }
485 -
486 - /**
487 - * @since 6.20
488 - *
489 - * @return array<string>
490 - */
491 - private static function get_entries_listing_page_form_actions() {
492 - return array( 'list', 'destroy' );
493 - }
494 -
495 - /**
496 243 * Check for certain page in Formidable settings
497 244 *
498 245 * @since 2.0
499 246 *
500 - * @param string $page The name of the page to check.
247 + * @param string $page The name of the page to check
501 248 *
502 - * @return bool
249 + * @return boolean
503 250 */
504 251 public static function is_admin_page( $page = 'formidable' ) {
505 252 global $pagenow;
506 253 $get_page = self::simple_get( 'page', 'sanitize_title' );
507 -
508 254 if ( $pagenow ) {
509 255 // allow this to be true during ajax load i.e. ajax form builder loading
510 - $is_page = ( $pagenow === 'admin.php' || $pagenow === 'admin-ajax.php' ) && $get_page === $page;
511 -
256 + $is_page = ( $pagenow == 'admin.php' || $pagenow == 'admin-ajax.php' ) && $get_page == $page;
512 257 if ( $is_page ) {
513 258 return true;
514 259 }
515 260 }
516 261
517 - return is_admin() && $get_page === $page;
262 + return is_admin() && $get_page == $page;
518 263 }
519 264
520 265 /**
521 266 * If the current page is for editing or creating a view.
@@ -521,10 +266,8 @@
521 266 * If the current page is for editing or creating a view.
522 267 * Returns false for the views listing page.
523 268 *
524 269 * @since 4.0
525 - *
526 - * @return bool
527 270 */
528 271 public static function is_view_builder_page() {
529 272 global $pagenow;
530 273
@@ -534,10 +277,10 @@
534 277
535 278 $post_type = self::simple_get( 'post_type', 'sanitize_title' );
536 279
537 280 if ( empty( $post_type ) ) {
538 - $post_id = self::simple_get( 'post', 'absint' );
539 - $post = get_post( $post_id );
281 + $post_id = self::simple_get( 'post', 'absint' );
282 + $post = get_post( $post_id );
540 283 $post_type = $post ? $post->post_type : '';
541 284 }
542 285
543 286 return $post_type === 'frm_display';
@@ -547,15 +290,17 @@
547 290 * Check for the form preview page
548 291 *
549 292 * @since 2.0
550 293 *
551 - * @return bool
294 + * @param None
295 + *
296 + * @return boolean
552 297 */
553 298 public static function is_preview_page() {
554 299 global $pagenow;
555 300 $action = self::simple_get( 'action', 'sanitize_title' );
556 301
557 - return $pagenow && $pagenow === 'admin-ajax.php' && $action === 'frm_forms_preview';
302 + return $pagenow && $pagenow == 'admin-ajax.php' && $action == 'frm_forms_preview';
558 303 }
559 304
560 305 /**
561 306 * Check for ajax except the form preview page
@@ -561,17 +306,16 @@
561 306 * Check for ajax except the form preview page
562 307 *
563 308 * @since 2.0
564 309 *
565 - * @return bool
310 + * @param None
311 + *
312 + * @return boolean
566 313 */
567 314 public static function doing_ajax() {
568 315 return wp_doing_ajax() && ! self::is_preview_page();
569 316 }
570 317
571 - /**
572 - * @return string
573 - */
574 318 public static function js_suffix() {
575 319 return defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
576 320 }
577 321
@@ -576,14 +320,13 @@
576 320 }
577 321
578 322 /**
579 323 * @since 2.0.8
580 - *
581 - * @return bool
582 324 */
583 325 public static function prevent_caching() {
584 326 global $frm_vars;
585 - return ! empty( $frm_vars['prevent_caching'] );
327 +
328 + return isset( $frm_vars['prevent_caching'] ) && $frm_vars['prevent_caching'];
586 329 }
587 330
588 331 /**
589 332 * Check if on an admin page
@@ -589,19 +332,14 @@
589 332 * Check if on an admin page
590 333 *
591 334 * @since 2.0
592 335 *
593 - * @return bool
336 + * @param None
337 + *
338 + * @return boolean
594 339 */
595 340 public static function is_admin() {
596 - $is_admin = is_admin() && ! wp_doing_ajax();
597 -
598 - /**
599 - * @since 6.0
600 - *
601 - * @param bool $is_admin
602 - */
603 - return apply_filters( 'frm_is_admin', $is_admin );
341 + return is_admin() && ! wp_doing_ajax();
604 342 }
605 343
606 344 /**
607 345 * Check if value contains blank value or empty array
@@ -607,23 +345,17 @@
607 345 * Check if value contains blank value or empty array
608 346 *
609 347 * @since 2.0
610 348 *
611 - * @param mixed $value Value to check.
612 - * @param string $empty
349 + * @param mixed $value - value to check
350 + * @param string
613 351 *
614 - * @return bool
352 + * @return boolean
615 353 */
616 354 public static function is_empty_value( $value, $empty = '' ) {
617 355 return ( is_array( $value ) && empty( $value ) ) || $value === $empty;
618 356 }
619 357
620 - /**
621 - * @param mixed $value
622 - * @param string $empty
623 - *
624 - * @return bool
625 - */
626 358 public static function is_not_empty_value( $value, $empty = '' ) {
627 359 return ! self::is_empty_value( $value, $empty );
628 360 }
629 361
@@ -640,37 +372,26 @@
640 372 return isset( $_SERVER[ $value ] ) ? wp_strip_all_tags( wp_unslash( $_SERVER[ $value ] ) ) : '';
641 373 }
642 374
643 375 /**
644 - * Get the server OS
376 + * Check for the IP address in several places
377 + * Used by [ip] shortcode
645 378 *
646 - * @since 6.4.2
647 - *
648 - * @return string
649 - */
650 - public static function get_server_os() {
651 - if ( function_exists( 'php_uname' ) ) {
652 - return php_uname( 's' );
653 - }
654 -
655 - if ( ! defined( 'PHP_OS' ) ) {
656 - return '';
657 - }
658 -
659 - // match the same response for Windows server as php_uname('s')
660 - return in_array( PHP_OS, array( 'WIN32', 'WINNT', 'Windows_NT' ), true ) ? 'Windows NT' : PHP_OS;
661 - }
662 -
663 - /**
664 - * Check for the IP address in several places (when custom headers are enabled).
665 - * Used by [ip] shortcode.
666 - *
667 379 * @return string The IP address of the current user
668 380 */
669 381 public static function get_ip_address() {
670 - $ip_options = self::should_use_custom_header_ip() ? self::get_custom_header_keys_for_ip() : array( 'REMOTE_ADDR' );
671 - $ip = '';
672 -
382 + $ip_options = array(
383 + 'HTTP_CLIENT_IP',
384 + 'HTTP_CF_CONNECTING_IP',
385 + 'HTTP_X_FORWARDED_FOR',
386 + 'HTTP_X_FORWARDED',
387 + 'HTTP_X_CLUSTER_CLIENT_IP',
388 + 'HTTP_X_REAL_IP',
389 + 'HTTP_FORWARDED_FOR',
390 + 'HTTP_FORWARDED',
391 + 'REMOTE_ADDR',
392 + );
393 + $ip = '';
673 394 foreach ( $ip_options as $key ) {
674 395 if ( ! isset( $_SERVER[ $key ] ) ) {
675 396 continue;
676 397 }
@@ -675,12 +396,10 @@
675 396 continue;
676 397 }
677 398
678 399 $key = self::get_server_value( $key );
679 -
680 400 foreach ( explode( ',', $key ) as $ip ) {
681 - // Just to be safe.
682 - $ip = trim( $ip );
401 + $ip = trim( $ip ); // just to be safe.
683 402
684 403 if ( filter_var( $ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE ) !== false ) {
685 404 return sanitize_text_field( $ip );
686 405 }
@@ -689,60 +408,8 @@
689 408
690 409 return sanitize_text_field( $ip );
691 410 }
692 411
693 - /**
694 - * @since 6.1
695 - *
696 - * @return array
697 - */
698 - public static function get_custom_header_keys_for_ip() {
699 - return array(
700 - 'HTTP_CLIENT_IP',
701 - 'HTTP_CF_CONNECTING_IP',
702 - 'HTTP_X_FORWARDED_FOR',
703 - 'HTTP_X_FORWARDED',
704 - 'HTTP_X_CLUSTER_CLIENT_IP',
705 - 'HTTP_X_REAL_IP',
706 - 'HTTP_FORWARDED_FOR',
707 - 'HTTP_FORWARDED',
708 - 'REMOTE_ADDR',
709 - );
710 - }
711 -
712 - /**
713 - * Check if we should check every HTTP header or just $_SERVER['REMOTE_ADDR'].
714 - * The other HTTP headers can be spoofed so this isn't recommended.
715 - * But in some cases (like reverse proxies), the IP may be empty if you use $_SERVER['REMOTE_ADDR'].
716 - *
717 - * @since 6.1
718 - *
719 - * @return bool
720 - */
721 - private static function should_use_custom_header_ip() {
722 - $settings = self::get_settings();
723 - $should_use_custom_header_ip = ! $settings->no_ips && $settings->custom_header_ip;
724 -
725 - /**
726 - * Filter whether to check spoofable HTTP headers.
727 - * This uses the custom_header_ip setting, but it is hidden if the GDPR option is also on.
728 - * As the IP is still checked for blacklist checks, someone with the GDPR option may still want to enable this when behind a reverse proxy.
729 - *
730 - * @since 6.1
731 - *
732 - * @param bool $should_use_custom_header_ip
733 - */
734 - return apply_filters( 'frm_use_custom_header_ip', $should_use_custom_header_ip );
735 - }
736 -
737 - /**
738 - * @param string $param
739 - * @param mixed $default
740 - * @param string $src
741 - * @param callable|string $sanitize
742 - *
743 - * @return mixed
744 - */
745 412 public static function get_param( $param, $default = '', $src = 'get', $sanitize = '' ) {
746 413 if ( strpos( $param, '[' ) ) {
747 414 $params = explode( '[', $param );
748 415 $param = $params[0];
@@ -749,9 +416,8 @@
749 416 }
750 417
751 418 if ( $src === 'get' ) {
752 419 $value = isset( $_POST[ $param ] ) ? wp_unslash( $_POST[ $param ] ) : ( isset( $_GET[ $param ] ) ? wp_unslash( $_GET[ $param ] ) : $default ); // phpcs:ignore WordPress.Security.NonceVerification.Missing, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
753 -
754 420 if ( ! isset( $_POST[ $param ] ) && isset( $_GET[ $param ] ) && ! is_array( $value ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
755 421 // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
756 422 $value = htmlspecialchars_decode( wp_unslash( $_GET[ $param ] ) );
757 423 }
@@ -773,9 +439,9 @@
773 439 continue;
774 440 }
775 441
776 442 $p = trim( $p, ']' );
777 - $value = $value[ $p ] ?? $default;
443 + $value = isset( $value[ $p ] ) ? $value[ $p ] : $default;
778 444 }
779 445 }
780 446
781 447 return $value;
@@ -780,25 +446,15 @@
780 446
781 447 return $value;
782 448 }
783 449
784 - /**
785 - * Get a value from $_POST data.
786 - *
787 - * @param string $param The key we are trying to access data from in $_POST.
788 - * @param mixed $default The default if nothing is being sent.
789 - * @param callable|string $sanitize Make sure to pass a sanitize method here. This function will NOT sanitize by default.
790 - * @param bool $serialized
791 - *
792 - * @return mixed
793 - */
794 450 public static function get_post_param( $param, $default = '', $sanitize = '', $serialized = false ) {
795 451 return self::get_simple_request(
796 452 array(
797 - 'type' => 'post',
798 - 'param' => $param,
799 - 'default' => $default,
800 - 'sanitize' => $sanitize,
453 + 'type' => 'post',
454 + 'param' => $param,
455 + 'default' => $default,
456 + 'sanitize' => $sanitize,
801 457 'serialized' => $serialized,
802 458 )
803 459 );
804 460 }
@@ -809,9 +465,9 @@
809 465 * @param string $param
810 466 * @param string $sanitize
811 467 * @param string $default
812 468 *
813 - * @return array|string
469 + * @return string|array
814 470 */
815 471 public static function simple_get( $param, $sanitize = 'sanitize_text_field', $default = '' ) {
816 472 return self::get_simple_request(
817 473 array(
@@ -829,40 +485,39 @@
829 485 * @since 2.0.6
830 486 *
831 487 * @param array $args
832 488 *
833 - * @return array|string
489 + * @return string|array
834 490 */
835 491 public static function get_simple_request( $args ) {
836 492 $defaults = array(
837 - 'param' => '',
838 - 'default' => '',
839 - 'type' => 'get',
840 - 'sanitize' => 'sanitize_text_field',
493 + 'param' => '',
494 + 'default' => '',
495 + 'type' => 'get',
496 + 'sanitize' => 'sanitize_text_field',
841 497 'serialized' => false,
842 498 );
843 499 $args = wp_parse_args( $args, $defaults );
844 500
845 501 $value = $args['default'];
846 -
847 - if ( $args['type'] === 'get' ) {
502 + if ( $args['type'] == 'get' ) {
848 503 if ( $_GET && isset( $_GET[ $args['param'] ] ) ) {
849 504 // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
850 505 $value = wp_unslash( $_GET[ $args['param'] ] );
851 506 }
852 - } elseif ( $args['type'] === 'post' ) {
507 + } elseif ( $args['type'] == 'post' ) {
853 508 if ( isset( $_POST[ $args['param'] ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
854 509 // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
855 510 $value = wp_unslash( $_POST[ $args['param'] ] );
856 -
857 511 if ( $args['serialized'] === true && is_serialized_string( $value ) && is_serialized( $value ) ) {
858 512 self::unserialize_or_decode( $value );
859 513 }
860 514 }
861 - } elseif ( isset( $_REQUEST[ $args['param'] ] ) ) {
862 - // phpcs:ignore WordPress.Security.NonceVerification.Missing
515 + } else {
516 + if ( isset( $_REQUEST[ $args['param'] ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
863 517 // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
864 518 $value = wp_unslash( $_REQUEST[ $args['param'] ] );
519 + }
865 520 }
866 521
867 522 self::sanitize_value( $args['sanitize'], $value );
868 523
@@ -886,48 +541,23 @@
886 541
887 542 return $value;
888 543 }
889 544
890 - /**
891 - * Sanitize a value in-place.
892 - * If $value is an array, the sanitize function will get called for each item.
893 - *
894 - * @param callable $sanitize
895 - * @param mixed $value
896 - *
897 - * @return void
898 - */
899 545 public static function sanitize_value( $sanitize, &$value ) {
900 - if ( ! $sanitize ) {
901 - return;
902 - }
903 -
904 - if ( is_object( $value ) ) {
905 - $value = '';
906 - return;
907 - }
908 -
909 - if ( is_array( $value ) ) {
910 - $temp_values = $value;
911 -
912 - foreach ( $temp_values as $k => $v ) {
913 - self::sanitize_value( $sanitize, $value[ $k ] );
546 + if ( ! empty( $sanitize ) ) {
547 + if ( is_array( $value ) ) {
548 + $temp_values = $value;
549 + foreach ( $temp_values as $k => $v ) {
550 + self::sanitize_value( $sanitize, $value[ $k ] );
551 + }
552 + } else {
553 + $value = call_user_func( $sanitize, $value );
914 554 }
915 - return;
916 555 }
917 -
918 - $value = call_user_func( $sanitize, $value );
919 556 }
920 557
921 - /**
922 - * @param array $sanitize_method
923 - * @param array $values
924 - *
925 - * @return void
926 - */
927 558 public static function sanitize_request( $sanitize_method, &$values ) {
928 559 $temp_values = $values;
929 -
930 560 foreach ( $temp_values as $k => $val ) {
931 561 if ( isset( $sanitize_method[ $k ] ) ) {
932 562 $values[ $k ] = call_user_func( $sanitize_method[ $k ], $val );
933 563 }
@@ -935,64 +565,23 @@
935 565 }
936 566
937 567 /**
938 568 * @since 4.0.04
939 - *
940 - * @param mixed $value
941 - *
942 - * @return void
943 569 */
944 570 public static function sanitize_with_html( &$value ) {
945 - if ( current_user_can( 'frm_edit_entries' ) || current_user_can( 'administrator' ) ) {
946 - // Only strip unsafe HTML like scripts for a privileged user submitting a form.
947 - self::sanitize_value( 'wp_kses_post', $value );
948 - } else {
949 - self::sanitize_value( self::class . '::strip_most_html', $value );
950 - }
571 + self::sanitize_value( 'wp_kses_post', $value );
951 572 self::decode_specialchars( $value );
952 573 }
953 574
954 575 /**
955 - * Allow only a small set of very basic HTML for unprivileged users.
956 - *
957 - * @since 6.7.1
958 - *
959 - * @param string $value
960 - */
961 - public static function strip_most_html( $value ) {
962 - $allowed_html = array(
963 - 'b' => array(),
964 - 'br' => array(),
965 - 'strong' => array(),
966 - 'p' => array(),
967 - 'i' => array(),
968 - 'ul' => array(),
969 - 'ol' => array(),
970 - 'li' => array(),
971 - );
972 -
973 - /**
974 - * @since 6.7.1
975 - *
976 - * @param array $allowed_html
977 - */
978 - $allowed_html = apply_filters( 'frm_allowed_form_input_html', $allowed_html );
979 -
980 - return wp_kses( $value, $allowed_html );
981 - }
982 -
983 - /**
984 576 * Do wp_specialchars_decode to get back '&' that wp_kses_post might have turned to '&amp;'
985 577 * this MUST be done, else we'll be back to the '& entity' problem.
986 578 *
987 579 * @since 4.0.04
988 - *
989 - * @param mixed $value Value to decode, passed by reference.
990 580 */
991 581 public static function decode_specialchars( &$value ) {
992 582 if ( is_array( $value ) ) {
993 583 $temp_values = $value;
994 -
995 584 foreach ( $temp_values as $k => $v ) {
996 585 self::decode_specialchars( $value[ $k ] );
997 586 }
998 587 } else {
@@ -1006,9 +595,9 @@
1006 595 * Adapted from wp_specialchars_decode().
1007 596 *
1008 597 * @since 4.03.01
1009 598 *
1010 - * @param string $string The string to prep, passed by reference.
599 + * @param string $string The string to prep.
1011 600 */
1012 601 private static function decode_amp( &$string ) {
1013 602 // Don't bother if there are no entities - saves a lot of processing
1014 603 if ( empty( $string ) || strpos( $string, '&' ) === false ) {
@@ -1018,12 +607,10 @@
1018 607 $translation = array(
1019 608 '&quot;' => '"',
1020 609 '&#034;' => '"',
1021 610 '&#x22;' => '"',
1022 - // The space preserves the HTML.
1023 - '&lt; ' => '< ',
1024 - // The space preserves the HTML.
1025 - '&#060; ' => '< ',
611 + '&lt; ' => '< ', // The space preserves the HTML.
612 + '&#060; ' => '< ', // The space preserves the HTML.
1026 613 '&gt;' => '>',
1027 614 '&#062;' => '>',
1028 615 '&amp;' => '&',
1029 616 '&#038;' => '&',
@@ -1050,10 +637,10 @@
1050 637 * Sanitize the value, and allow some HTML
1051 638 *
1052 639 * @since 2.0
1053 640 *
1054 - * @param string $value The value to sanitize.
1055 - * @param array|string $allowed Allowed HTML tags and attributes, or 'all' for defaults.
641 + * @param string $value
642 + * @param array|string $allowed 'all' for everything included as defaults
1056 643 *
1057 644 * @return string
1058 645 */
1059 646 public static function kses( $value, $allowed = array() ) {
@@ -1062,28 +649,13 @@
1062 649 return wp_kses( $value, $allowed_html );
1063 650 }
1064 651
1065 652 /**
1066 - * Sanitizes and echoes a given value.
1067 - *
1068 - * @since 6.18
1069 - *
1070 - * @param string $value The value to sanitize and output.
1071 - * @param array|string $allowed Allowed HTML tags and attributes.
1072 - *
1073 - * @return void
1074 - */
1075 - public static function kses_echo( $value, $allowed = array() ) {
1076 - echo self::kses( $value, $allowed ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1077 - }
1078 -
1079 - /**
1080 653 * The regular kses function strips [button_action] from submit button HTML.
1081 654 *
1082 655 * @since 5.0.13
1083 656 *
1084 657 * @param string $html
1085 - *
1086 658 * @return string
1087 659 */
1088 660 public static function kses_submit_button( $html ) {
1089 661 $included_button_action = false !== strpos( $html, '[button_action]' );
@@ -1093,9 +665,8 @@
1093 665 add_filter( 'frm_striphtml_allowed_tags', 'FrmAppHelper::add_allowed_submit_button_tags' );
1094 666 $html = self::kses( $html, 'all' );
1095 667 remove_filter( 'safe_style_css', 'FrmAppHelper::allow_visibility_style' );
1096 668 remove_filter( 'frm_striphtml_allowed_tags', 'FrmAppHelper::add_allowed_submit_button_tags' );
1097 -
1098 669 if ( $included_button_action ) {
1099 670 if ( false !== strpos( $html, '<input type="submit"' ) ) {
1100 671 $pattern = '/(<input type="submit")([^>]*)(\/>)/';
1101 672 $html = preg_replace( $pattern, '$1$2[button_action] $3', $html, 1 );
@@ -1103,13 +674,11 @@
1103 674 $pattern = '/(<button)(.*)(class=")(.*)(frm_button_submit)(.*)(")(.*)([^>]+)(>)/';
1104 675 $html = preg_replace( $pattern, '$1$2$3$4$5$6$7 [button_action]$8$9$10', $html, 1 );
1105 676 }
1106 677 }
1107 -
1108 678 if ( $included_back_hook ) {
1109 679 $html = str_replace( 'class="frm_prev_page"', 'class="frm_prev_page" [back_hook]', $html );
1110 680 }
1111 -
1112 681 if ( $included_draft_hook ) {
1113 682 $html = str_replace( 'class="frm_save_draft"', 'class="frm_save_draft" [draft_hook]', $html );
1114 683 }
1115 684 return $html;
@@ -1118,9 +687,8 @@
1118 687 /**
1119 688 * @since 5.0.13
1120 689 *
1121 690 * @param array $allowed_attr
1122 - *
1123 691 * @return array
1124 692 */
1125 693 public static function allow_visibility_style( $allowed_attr ) {
1126 694 $allowed_attr[] = 'visibility';
@@ -1130,9 +698,8 @@
1130 698 /**
1131 699 * @since 5.0.13
1132 700 *
1133 701 * @param array $allowed_html
1134 - *
1135 702 * @return array
1136 703 */
1137 704 public static function add_allowed_submit_button_tags( $allowed_html ) {
1138 705 $allowed_html['input'] = array(
@@ -1149,22 +716,17 @@
1149 716 }
1150 717
1151 718 /**
1152 719 * @since 2.05.03
1153 - *
1154 - * @param array|string $allowed
1155 - *
1156 - * @return array
1157 720 */
1158 721 private static function allowed_html( $allowed ) {
1159 722 $html = self::safe_html();
1160 723 $allowed_html = array();
1161 -
1162 724 if ( $allowed === 'all' ) {
1163 725 $allowed_html = $html;
1164 726 } elseif ( ! empty( $allowed ) ) {
1165 727 foreach ( (array) $allowed as $a ) {
1166 - $allowed_html[ $a ] = $html[ $a ] ?? array();
728 + $allowed_html[ $a ] = isset( $html[ $a ] ) ? $html[ $a ] : array();
1167 729 }
1168 730 }
1169 731
1170 732 return apply_filters( 'frm_striphtml_allowed_tags', $allowed_html );
@@ -1179,9 +741,9 @@
1179 741 'id' => true,
1180 742 );
1181 743
1182 744 return array(
1183 - 'a' => array(
745 + 'a' => array(
1184 746 'class' => true,
1185 747 'href' => true,
1186 748 'id' => true,
1187 749 'rel' => true,
@@ -1250,16 +812,16 @@
1250 812 'cite' => true,
1251 813 'title' => true,
1252 814 ),
1253 815 'rect' => array(
1254 - 'class' => true,
1255 - 'fill' => true,
1256 - 'height' => true,
1257 - 'width' => true,
1258 - 'x' => true,
1259 - 'y' => true,
1260 - 'rx' => true,
1261 - 'stroke' => true,
816 + 'class' => true,
817 + 'fill' => true,
818 + 'height' => true,
819 + 'width' => true,
820 + 'x' => true,
821 + 'y' => true,
822 + 'rx' => true,
823 + 'stroke' => true,
1262 824 'stroke-opacity' => true,
1263 825 'stroke-width' => true,
1264 826 ),
1265 827 'section' => $allow_class,
@@ -1294,9 +856,9 @@
1294 856 'xlink:href' => true,
1295 857 ),
1296 858 'ul' => $allow_class,
1297 859 'label' => array(
1298 - 'for' => true,
860 + 'for' => true,
1299 861 'class' => true,
1300 862 'id' => true,
1301 863 ),
1302 864 'button' => array(
@@ -1305,13 +867,8 @@
1305 867 ),
1306 868 'legend' => array(
1307 869 'class' => true,
1308 870 ),
1309 - 'option' => array(
1310 - 'class' => true,
1311 - 'value' => true,
1312 - 'selected' => true,
1313 - ),
1314 871 );
1315 872 }
1316 873
1317 874 /**
@@ -1319,20 +876,18 @@
1319 876 *
1320 877 * @since 2.0
1321 878 */
1322 879 public static function remove_get_action() {
1323 - if ( empty( $_GET ) ) {
880 + if ( ! isset( $_GET ) ) {
1324 881 return;
1325 882 }
1326 883
1327 884 $action_name = isset( $_GET['action'] ) ? 'action' : ( isset( $_GET['action2'] ) ? 'action2' : '' );
1328 -
1329 885 if ( empty( $action_name ) ) {
1330 886 return;
1331 887 }
1332 888
1333 889 $new_action = self::get_param( $action_name, '', 'get', 'sanitize_text_field' );
1334 -
1335 890 if ( ! empty( $new_action ) ) {
1336 891 $_SERVER['REQUEST_URI'] = str_replace( '&action=' . $new_action, '', self::get_server_value( 'REQUEST_URI' ) );
1337 892 }
1338 893 }
@@ -1340,13 +895,9 @@
1340 895 /**
1341 896 * Check the WP query for a parameter
1342 897 *
1343 898 * @since 2.0
1344 - *
1345 - * @param array|string $value
1346 - * @param string $param
1347 - *
1348 - * @return array|string
899 + * @return string|array
1349 900 */
1350 901 public static function get_query_var( $value, $param ) {
1351 902 if ( $value != '' ) {
1352 903 return $value;
@@ -1352,9 +903,8 @@
1352 903 return $value;
1353 904 }
1354 905
1355 906 global $wp_query;
1356 -
1357 907 if ( isset( $wp_query->query_vars[ $param ] ) ) {
1358 908 $value = $wp_query->query_vars[ $param ];
1359 909 }
1360 910
@@ -1364,17 +914,13 @@
1364 914 /**
1365 915 * Try to show the SVG if possible. Otherwise, use the font icon.
1366 916 *
1367 917 * @since 4.0.02
1368 - *
1369 918 * @param string $class
1370 919 * @param array $atts
1371 - *
1372 - * @return string|null
1373 920 */
1374 921 public static function icon_by_class( $class, $atts = array() ) {
1375 922 $echo = ! isset( $atts['echo'] ) || $atts['echo'];
1376 -
1377 923 if ( isset( $atts['echo'] ) ) {
1378 924 unset( $atts['echo'] );
1379 925 }
1380 926
@@ -1380,32 +926,19 @@
1380 926
1381 927 $html_atts = self::array_to_html_params( $atts );
1382 928
1383 929 $icon = trim( str_replace( array( 'frm_icon_font', 'frmfont ' ), '', $class ) );
1384 -
1385 - // Replace icons that have been removed or renamed.
1386 - $deprecated = array(
1387 - 'frm_clone_solid_icon' => 'frm_clone_icon',
1388 - 'frm_keyalt_icon' => 'frm_key_icon',
1389 - 'frm_keyalt_solid_icon' => 'frm_key_solid_icon',
1390 - );
1391 -
1392 - if ( isset( $deprecated[ $icon ] ) ) {
1393 - $icon = $deprecated[ $icon ];
1394 - $class = str_replace( $icon, $deprecated[ $icon ], $class );
1395 - }
1396 -
1397 930 if ( $icon === $class ) {
1398 931 $icon = '<i class="' . esc_attr( $class ) . '"' . $html_atts . '></i>';
1399 932 } else {
1400 933 $class = strpos( $icon, ' ' ) === false ? '' : ' ' . $icon;
1401 -
1402 934 if ( strpos( $icon, ' ' ) ) {
1403 935 $icon = explode( ' ', $icon );
1404 936 $icon = reset( $icon );
1405 937 }
1406 -
1407 - $icon = '<svg class="frmsvg' . esc_attr( $class ) . '"' . $html_atts . '><use xlink:href="#' . esc_attr( $icon ) . '" /></svg>';
938 + $icon = '<svg class="frmsvg' . esc_attr( $class ) . '"' . $html_atts . '>
939 + <use xlink:href="#' . esc_attr( $icon ) . '" />
940 + </svg>';
1408 941 }
1409 942
1410 943 if ( $echo ) {
1411 944 echo self::kses_icon( $icon ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
@@ -1419,9 +952,8 @@
1419 952 *
1420 953 * @since 5.0.13
1421 954 *
1422 955 * @param string $icon
1423 - *
1424 956 * @return string
1425 957 */
1426 958 public static function kses_icon( $icon ) {
1427 959 add_filter( 'safe_style_css', 'FrmAppHelper::allow_vars_in_styles' );
@@ -1437,15 +969,13 @@
1437 969 /**
1438 970 * @since 5.0.13.1
1439 971 *
1440 972 * @param array $allowed_html
1441 - *
1442 973 * @return array
1443 974 */
1444 975 public static function add_allowed_icon_tags( $allowed_html ) {
1445 976 $allowed_html['svg']['data-open'] = true;
1446 977 $allowed_html['svg']['title'] = true;
1447 - $allowed_html['svg']['tabindex'] = true;
1448 978 return $allowed_html;
1449 979 }
1450 980
1451 981 /**
@@ -1451,13 +981,12 @@
1451 981 /**
1452 982 * @since 5.0.13
1453 983 *
1454 984 * @param array $allowed_attr
1455 - *
1456 985 * @return array
1457 986 */
1458 987 public static function allow_vars_in_styles( $allowed_attr ) {
1459 - $allowed_attr[] = '--primary-700';
988 + $allowed_attr[] = '--primary-hover';
1460 989 return $allowed_attr;
1461 990 }
1462 991
1463 992 /**
@@ -1466,9 +995,9 @@
1466 995 * @param bool $allow_css
1467 996 * @param string $css_string
1468 997 */
1469 998 public static function allow_style( $allow_css, $css_string ) {
1470 - if ( ! $allow_css && 0 === strpos( $css_string, '--primary-700:' ) ) {
999 + if ( ! $allow_css && 0 === strpos( $css_string, '--primary-hover:' ) ) {
1471 1000 $split = explode( ':', $css_string, 2 );
1472 1001 $allow_css = 2 === count( $split ) && self::is_a_valid_color( $split[1] );
1473 1002 }
1474 1003 return $allow_css;
@@ -1477,14 +1006,12 @@
1477 1006 /**
1478 1007 * @since 5.0.13
1479 1008 *
1480 1009 * @param string $value
1481 - *
1482 1010 * @return bool
1483 1011 */
1484 1012 private static function is_a_valid_color( $value ) {
1485 1013 $match = 0;
1486 -
1487 1014 if ( 0 === strpos( $value, 'rgba(' ) ) {
1488 1015 $match = preg_match( '/^rgba\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3}),\s*(\d*(?:\.\d+)?)\)$/', $value );
1489 1016 } elseif ( 0 === strpos( $value, 'rgb(' ) ) {
1490 1017 $match = preg_match( '/^rgb\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3})\)$/', $value );
@@ -1497,19 +1024,11 @@
1497 1024 /**
1498 1025 * Include svg images.
1499 1026 *
1500 1027 * @since 4.0.02
1501 - *
1502 - * @return void
1503 1028 */
1504 1029 public static function include_svg() {
1505 - if ( self::$included_svg ) {
1506 - return;
1507 - }
1508 -
1509 - // Use readfile instead of include_once because of a default security rule in Snuffleupagus.
1510 - readfile( self::plugin_path() . '/images/icons.svg' );
1511 - self::$included_svg = true;
1030 + include_once self::plugin_path() . '/images/icons.svg';
1512 1031 }
1513 1032
1514 1033 /**
1515 1034 * Convert an associative array to HTML values.
@@ -1518,13 +1037,12 @@
1518 1037 * @since 5.0.13 added $echo parameter.
1519 1038 *
1520 1039 * @param array $atts
1521 1040 * @param bool $echo
1522 - *
1523 1041 * @return string|void
1524 1042 */
1525 1043 public static function array_to_html_params( $atts, $echo = false ) {
1526 - $callback = function () use ( $atts ) {
1044 + $callback = function() use ( $atts ) {
1527 1045 if ( $atts ) {
1528 1046 foreach ( $atts as $key => $value ) {
1529 1047 echo ' ' . esc_attr( $key ) . '="' . esc_attr( $value ) . '"';
1530 1048 }
@@ -1539,10 +1057,9 @@
1539 1057 * @since 5.0.13
1540 1058 *
1541 1059 * @param Closure $echo_function
1542 1060 * @param bool $echo
1543 - *
1544 - * @return string|null
1061 + * @return string|void
1545 1062 */
1546 1063 public static function clip( $echo_function, $echo = false ) {
1547 1064 if ( ! $echo ) {
1548 1065 ob_start();
@@ -1547,11 +1064,9 @@
1547 1064 if ( ! $echo ) {
1548 1065 ob_start();
1549 1066 }
1550 1067
1551 - if ( is_callable( $echo_function ) ) {
1552 - $echo_function();
1553 - }
1068 + $echo_function();
1554 1069
1555 1070 if ( ! $echo ) {
1556 1071 $return = ob_get_contents();
1557 1072 ob_end_clean();
@@ -1560,49 +1075,27 @@
1560 1075 }
1561 1076
1562 1077 /**
1563 1078 * @since 3.0
1564 - *
1565 - * @param array $atts
1566 - *
1567 - * @return void
1568 1079 */
1569 1080 public static function get_admin_header( $atts ) {
1570 - $has_nav = ! empty( $atts['form'] ) && empty( $atts['is_template'] );
1571 -
1572 - if ( empty( $atts['close'] ) ) {
1081 + $has_nav = ( isset( $atts['form'] ) && ! empty( $atts['form'] ) && ( ! isset( $atts['is_template'] ) || ! $atts['is_template'] ) );
1082 + if ( ! isset( $atts['close'] ) || empty( $atts['close'] ) ) {
1573 1083 $atts['close'] = admin_url( 'admin.php?page=formidable' );
1574 1084 }
1575 -
1576 1085 if ( ! isset( $atts['import_link'] ) ) {
1577 1086 $atts['import_link'] = false;
1578 1087 }
1579 1088
1580 - include self::plugin_path() . '/classes/views/shared/admin-header.php';
1089 + include( self::plugin_path() . '/classes/views/shared/admin-header.php' );
1581 1090 }
1582 1091
1583 1092 /**
1584 - * @since 6.0
1585 - *
1586 - * @param string $type
1587 - *
1588 - * @return void
1589 - */
1590 - public static function import_link( $type = 'secondary' ) {
1591 - ?>
1592 - <a href="<?php echo esc_url( admin_url( 'admin.php?page=formidable-import' ) ); ?>" class="button frm-button-<?php echo esc_attr( $type ); ?> frm_animate_bg">
1593 - <?php esc_html_e( 'Import', 'formidable' ); ?>
1594 - </a>
1595 - <?php
1596 - }
1597 -
1598 - /**
1599 1093 * Print applicable admin banner.
1600 1094 *
1601 1095 * @since 5.4.2
1602 1096 *
1603 1097 * @param bool $should_show_lite_upgrade
1604 - *
1605 1098 * @return void
1606 1099 */
1607 1100 public static function print_admin_banner( $should_show_lite_upgrade ) {
1608 1101 if ( ! current_user_can( 'administrator' ) ) {
@@ -1609,9 +1102,9 @@
1609 1102 FrmInbox::maybe_show_banner();
1610 1103 return;
1611 1104 }
1612 1105
1613 - if ( FrmSalesApi::maybe_show_banner() || self::maybe_show_license_warning() || FrmInbox::maybe_show_banner() || ! $should_show_lite_upgrade || self::pro_is_installed() ) {
1106 + if ( self::maybe_show_license_warning() || FrmInbox::maybe_show_banner() || ! $should_show_lite_upgrade || self::pro_is_installed() ) {
1614 1107 // Print license warning or inbox banner and exit if either prints.
1615 1108 // And exit before printing the upgrade bar if it shouldn't be shown.
1616 1109 return;
1617 1110 }
@@ -1616,37 +1109,10 @@
1616 1109 return;
1617 1110 }
1618 1111 ?>
1619 1112 <div class="frm-upgrade-bar">
1620 - <div class="frm-upgrade-bar-inner">
1621 - <?php
1622 - $cta_text = FrmSalesApi::get_best_sale_value( 'lite_banner_cta_text' );
1623 -
1624 - if ( ! $cta_text ) {
1625 - $cta_text = __( 'upgrading to PRO', 'formidable' );
1626 - }
1627 -
1628 - $upgrade_link = FrmSalesApi::get_best_sale_value( 'lite_banner_cta_link' );
1629 - $utm = array(
1630 - 'campaign' => 'settings-license',
1631 - 'content' => 'lite-banner',
1632 - );
1633 -
1634 - if ( $upgrade_link ) {
1635 - $upgrade_link = self::maybe_add_missing_utm( $upgrade_link, $utm );
1636 - } else {
1637 - $upgrade_link = self::admin_upgrade_link( $utm );
1638 - }
1639 -
1640 - printf(
1641 - /* translators: %1$s: Start link HTML, %2$s: CTA text ("upgrading to PRO" by default), %3$s: End link HTML */
1642 - esc_html__( 'You\'re using Formidable Forms Lite. To unlock more features consider %1$s%2$s%3$s.', 'formidable' ),
1643 - '<a href="' . esc_url( $upgrade_link ) . '">',
1644 - esc_html( $cta_text ),
1645 - '</a>'
1646 - );
1647 - ?>
1648 - </div>
1113 + <span>You're using Formidable Forms Lite. To unlock more features consider</span>
1114 + <a href="<?php echo esc_url( self::admin_upgrade_link( 'top-bar' ) ); ?>" target="_blank" rel="noopener">upgrading to Pro</a>.
1649 1115 </div>
1650 1116 <?php
1651 1117 }
1652 1118
@@ -1662,18 +1128,14 @@
1662 1128 /**
1663 1129 * Render a button for a new item (Form, Application, etc).
1664 1130 *
1665 1131 * @since 3.0
1666 - *
1667 1132 * @param array $atts {
1668 - * Details about the button.
1669 - *
1670 1133 * @type array $link_hook Custom link hook, calls do_action and exits early.
1671 1134 * @type string $new_link Href value, default #.
1672 1135 * @type string $class Custom class names, space separated.
1673 1136 * @type string $button_text Button text. Default "Add New".
1674 1137 * }
1675 - *
1676 1138 * @return void
1677 1139 */
1678 1140 public static function add_new_item_link( $atts ) {
1679 1141 if ( isset( $atts['link_hook'] ) ) {
@@ -1680,16 +1142,20 @@
1680 1142 do_action( $atts['link_hook']['hook'], $atts['link_hook']['param'] );
1681 1143 return;
1682 1144 }
1683 1145
1684 - if ( empty( $atts['new_link'] ) && empty( $atts['create_form'] ) && empty( $atts['class'] ) ) {
1146 + if ( empty( $atts['new_link'] ) && empty( $atts['trigger_new_form_modal'] ) && empty( $atts['class'] ) ) {
1685 1147 // Do not render a button if none of these attributes are set.
1686 1148 return;
1687 1149 }
1688 1150
1689 1151 $href = ! empty( $atts['new_link'] ) ? esc_url( $atts['new_link'] ) : '#';
1690 - $class = 'button button-primary frm-button-primary';
1152 + $class = 'button button-primary frm-button-primary frm-with-plus';
1691 1153
1154 + if ( ! empty( $atts['trigger_new_form_modal'] ) ) {
1155 + $class .= ' frm-trigger-new-form-modal';
1156 + }
1157 +
1692 1158 if ( ! empty( $atts['class'] ) ) {
1693 1159 $class .= ' ' . $atts['class'];
1694 1160 }
1695 1161
@@ -1699,12 +1165,8 @@
1699 1165 }
1700 1166
1701 1167 /**
1702 1168 * @since 3.06
1703 - *
1704 - * @param array $atts
1705 - *
1706 - * @return void
1707 1169 */
1708 1170 public static function show_search_box( $atts ) {
1709 1171 $defaults = array(
1710 1172 'placeholder' => '',
@@ -1710,12 +1172,10 @@
1710 1172 'placeholder' => '',
1711 1173 'tosearch' => '',
1712 1174 'text' => __( 'Search', 'formidable' ),
1713 1175 'input_id' => '',
1714 - 'value' => false,
1715 - 'class' => '',
1716 1176 );
1717 - $atts = array_merge( $defaults, $atts );
1177 + $atts = array_merge( $defaults, $atts );
1718 1178
1719 1179 if ( $atts['input_id'] === 'template' && empty( $atts['tosearch'] ) ) {
1720 1180 $atts['tosearch'] = 'frm-card';
1721 1181 }
@@ -1720,9 +1180,8 @@
1720 1180 $atts['tosearch'] = 'frm-card';
1721 1181 }
1722 1182
1723 1183 $class = 'frm-search-input';
1724 -
1725 1184 if ( ! empty( $atts['tosearch'] ) ) {
1726 1185 $class .= ' frm-auto-search';
1727 1186 }
1728 1187
@@ -1727,34 +1186,21 @@
1727 1186 }
1728 1187
1729 1188 $input_id = $atts['input_id'] . '-search-input';
1730 1189
1731 - $input_atts = array(
1732 - 'type' => 'search',
1733 - 'id' => $input_id,
1734 - 'name' => 's',
1735 - 'placeholder' => $atts['placeholder'],
1736 - 'class' => $class,
1737 - 'data-tosearch' => $atts['tosearch'],
1738 - );
1739 -
1740 - if ( is_string( $atts['value'] ) ) {
1741 - $input_atts['value'] = $atts['value'];
1742 - } elseif ( isset( $_REQUEST['s'] ) ) {
1743 - // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
1744 - $input_atts['value'] = wp_unslash( $_REQUEST['s'] );
1745 - }
1746 -
1747 - if ( ! empty( $atts['tosearch'] ) ) {
1748 - $input_atts['autocomplete'] = 'off';
1749 - }
1750 1190 ?>
1751 - <p class="frm-search <?php echo esc_attr( $atts['class'] ); ?>">
1191 + <p class="frm-search">
1752 1192 <label class="screen-reader-text" for="<?php echo esc_attr( $input_id ); ?>">
1753 1193 <?php echo esc_html( $atts['text'] ); ?>:
1754 1194 </label>
1755 - <?php self::icon_by_class( 'frm_icon_font frm_search_icon frm_svg20' ); ?>
1756 - <input <?php self::array_to_html_params( $input_atts, true ); ?> />
1195 + <span class="frmfont frm_search_icon"></span>
1196 + <input type="search" id="<?php echo esc_attr( $input_id ); ?>" name="s"
1197 + value="<?php _admin_search_query(); ?>" placeholder="<?php echo esc_attr( $atts['placeholder'] ); ?>"
1198 + class="<?php echo esc_attr( $class ); ?>" data-tosearch="<?php echo esc_attr( $atts['tosearch'] ); ?>"
1199 + <?php if ( ! empty( $atts['tosearch'] ) ) { ?>
1200 + autocomplete="off"
1201 + <?php } ?>
1202 + />
1757 1203 <?php
1758 1204 if ( empty( $atts['tosearch'] ) ) {
1759 1205 submit_button( $atts['text'], 'button-secondary', '', false, array( 'id' => 'search-submit' ) );
1760 1206 }
@@ -1763,17 +1209,13 @@
1763 1209 <?php
1764 1210 }
1765 1211
1766 1212 /**
1767 - * @param string $type Hook type slug.
1768 - * @param object|null $object Optional related object.
1769 - *
1770 - * @return void
1213 + * @param string $type
1771 1214 */
1772 1215 public static function trigger_hook_load( $type, $object = null ) {
1773 1216 // Only load the form hooks once.
1774 1217 $hooks_loaded = apply_filters( 'frm_' . $type . '_hooks_loaded', false, $object );
1775 -
1776 1218 if ( ! $hooks_loaded ) {
1777 1219 do_action( 'frm_load_' . $type . '_hooks' );
1778 1220 }
1779 1221 }
@@ -1778,14 +1220,11 @@
1778 1220 }
1779 1221 }
1780 1222
1781 1223 /**
1782 - * Save all front-end js scripts into a single file.
1783 - * And save an additional single file of all front-end Stripe JS scripts.
1224 + * Save all front-end js scripts into a single file
1784 1225 *
1785 1226 * @since 3.0
1786 - *
1787 - * @return void
1788 1227 */
1789 1228 public static function save_combined_js() {
1790 1229 $file_atts = apply_filters(
1791 1230 'frm_js_location',
@@ -1798,34 +1237,10 @@
1798 1237
1799 1238 $files = array(
1800 1239 self::plugin_path() . '/js/formidable.min.js',
1801 1240 );
1802 - /**
1803 - * @param array $files
1804 - */
1805 1241 $files = apply_filters( 'frm_combined_js_files', $files );
1806 1242 $new_file->combine_files( $files );
1807 -
1808 - // Create the minified Stripe Script.
1809 - $file_atts = apply_filters(
1810 - 'frm_stripe_js_location',
1811 - array(
1812 - 'file_name' => 'frmstrp.min.js',
1813 - 'new_file_path' => self::plugin_path() . '/js',
1814 - )
1815 - );
1816 - $new_file = new FrmCreateFile( $file_atts );
1817 - $files = array(
1818 - FrmStrpLiteAppHelper::plugin_path() . 'js/frmstrp.min.js',
1819 - );
1820 -
1821 - /**
1822 - * @since 6.5
1823 - *
1824 - * @param array $files
1825 - */
1826 - $files = apply_filters( 'frm_stripe_combined_js_files', $files );
1827 - $new_file->combine_files( $files );
1828 1243 }
1829 1244
1830 1245 /**
1831 1246 * Check a value from a shortcode to see if true or false.
@@ -1832,14 +1247,14 @@
1832 1247 * True when value is 1, true, 'true', 'yes'
1833 1248 *
1834 1249 * @since 1.07.10
1835 1250 *
1836 - * @param string $value The value to compare.
1251 + * @param string $value The value to compare
1837 1252 *
1838 - * @return bool
1253 + * @return boolean True or False
1839 1254 */
1840 1255 public static function is_true( $value ) {
1841 - return true === $value || 1 == $value || 'true' === $value || 'yes' === $value;
1256 + return ( true === $value || 1 == $value || 'true' == $value || 'yes' == $value );
1842 1257 }
1843 1258
1844 1259 /**
1845 1260 * Gets all post from a specific post type.
@@ -1847,9 +1262,8 @@
1847 1262 *
1848 1263 * @since 4.10.01 Add `$post_type` argument.
1849 1264 *
1850 1265 * @param string $post_type Post type to query. Default is `page`.
1851 - *
1852 1266 * @return WP_Post[]
1853 1267 */
1854 1268 public static function get_pages( $post_type = 'page' ) {
1855 1269 $query = array(
@@ -1868,9 +1282,8 @@
1868 1282 *
1869 1283 * @since 5.0.09
1870 1284 *
1871 1285 * @param string $post_type Post type to query. Default is `page`.
1872 - *
1873 1286 * @return array
1874 1287 */
1875 1288 public static function get_post_ids_and_titles( $post_type = 'page' ) {
1876 1289 return FrmDb::get_results(
@@ -1899,9 +1312,9 @@
1899 1312 $args = self::preformat_selection_args( $args );
1900 1313
1901 1314 $pages_count = wp_count_posts( $args['post_type'] );
1902 1315
1903 - if ( ! isset( $pages_count->publish ) || $pages_count->publish <= 50 ) {
1316 + if ( $pages_count->publish <= 50 ) {
1904 1317 self::wp_pages_dropdown( $args );
1905 1318 return;
1906 1319 }
1907 1320
@@ -1907,9 +1320,9 @@
1907 1320
1908 1321 wp_enqueue_script( 'jquery-ui-autocomplete' );
1909 1322
1910 1323 $selected = self::get_post_param( $args['field_name'], $args['page_id'], 'absint' );
1911 - $title = '';
1324 + $title = '';
1912 1325
1913 1326 if ( $selected ) {
1914 1327 $title = get_the_title( $selected );
1915 1328 }
@@ -1925,116 +1338,18 @@
1925 1338 <?php
1926 1339 }
1927 1340
1928 1341 /**
1929 - * Maybe show an HTML select or autocomplete input based on the number of options.
1930 - *
1931 - * @since 6.21
1932 - *
1933 - * @param array $args Args. See the method for details.
1342 + * @param array $args
1343 + * @param string $page_id Deprecated.
1344 + * @param boolean $truncate Deprecated.
1934 1345 */
1935 - public static function maybe_autocomplete_options( $args ) {
1936 - $defaults = array(
1937 - 'truncate' => false,
1938 - 'placeholder' => ' ',
1939 - 'name' => '',
1940 - 'id' => '',
1941 - 'selected' => '',
1942 - 'source' => array(),
1943 - 'dropdown_limit' => 50,
1944 - 'autocomplete_placeholder' => __( 'Select an option', 'formidable' ),
1945 - 'value_key' => 'value',
1946 - 'label_key' => 'label',
1947 - );
1948 -
1949 - $args = wp_parse_args( $args, $defaults );
1950 -
1951 - $html_attrs = array();
1952 -
1953 - if ( ! empty( $args['name'] ) ) {
1954 - $html_attrs['name'] = $args['name'];
1955 - }
1956 -
1957 - if ( ! empty( $args['id'] ) ) {
1958 - $html_attrs['id'] = $args['id'];
1959 - }
1960 -
1961 - if ( count( $args['source'] ) <= $args['dropdown_limit'] ) {
1962 - ?>
1963 - <select <?php self::array_to_html_params( $html_attrs, true ); ?>>
1964 - <option value=""><?php echo esc_html( $args['placeholder'] ); ?></option>
1965 - <?php
1966 - foreach ( $args['source'] as $key => $source ) :
1967 - $value_label = self::get_dropdown_value_and_label_from_option( $source, $key, $args );
1968 -
1969 - if ( ! empty( $args['truncate'] ) ) {
1970 - $value_label['label'] = self::truncate( $value_label['label'], $args['truncate'] );
1971 - }
1972 - ?>
1973 - <option value="<?php echo esc_attr( $value_label['value'] ); ?>" <?php selected( $value_label['value'], $args['selected'] ); ?>><?php echo esc_html( $value_label['label'] ); ?></option>
1974 - <?php endforeach; ?>
1975 - </select>
1976 - <?php
1977 - } else {
1978 - $options = array();
1979 - $autocomplete_value = '';
1980 -
1981 - foreach ( $args['source'] as $key => $source ) {
1982 - $value_label = self::get_dropdown_value_and_label_from_option( $source, $key, $args );
1983 -
1984 - if ( $value_label['value'] === $args['selected'] ) {
1985 - $autocomplete_value = $value_label['label'];
1986 - }
1987 -
1988 - $options[] = $value_label;
1989 - }
1990 -
1991 - $html_attrs['type'] = 'hidden';
1992 - $html_attrs['class'] = 'frm_autocomplete_value_input';
1993 - $html_attrs['value'] = $args['selected'];
1994 - ?>
1995 - <input type="text" class="frm-custom-search"
1996 - data-source="<?php echo esc_attr( wp_json_encode( $options ) ); ?>"
1997 - placeholder="<?php echo esc_attr( $args['autocomplete_placeholder'] ); ?>"
1998 - value="<?php echo esc_attr( $autocomplete_value ); ?>" />
1999 - <input <?php self::array_to_html_params( $html_attrs, true ); ?> />
2000 - <?php
2001 - }//end if
2002 - }
2003 -
2004 - /**
2005 - * Gets dropdown value and label from autodropdown option.
2006 - *
2007 - * @since 6.21
2008 - *
2009 - * @param array|string $option Autocomplete option.
2010 - * @param string $key Array key of the option.
2011 - * @param array $args See {@see FrmAppHelper::maybe_autocomplete_options()}.
2012 - *
2013 - * @return array
2014 - */
2015 - private static function get_dropdown_value_and_label_from_option( $option, $key, $args ) {
2016 - if ( is_array( $option ) ) {
2017 - $value = $option[ $args['value_key'] ] ?? '';
2018 - $label = $option[ $args['label_key'] ] ?? '';
2019 - } else {
2020 - $value = $key;
2021 - $label = $option;
2022 - }
2023 -
2024 - return compact( 'value', 'label' );
2025 - }
2026 -
2027 - /**
2028 - * @param array $args
2029 - * @param string $page_id Deprecated.
2030 - * @param bool $truncate Deprecated.
2031 - */
2032 1346 public static function wp_pages_dropdown( $args = array(), $page_id = '', $truncate = false ) {
2033 1347 self::prep_page_dropdown_params( $page_id, $truncate, $args );
2034 1348
2035 1349 $pages = self::get_post_ids_and_titles( $args['post_type'] );
2036 1350 $selected = self::get_post_param( $args['field_name'], $args['page_id'], 'absint' );
1351 +
2037 1352 ?>
2038 1353 <select name="<?php echo esc_attr( $args['field_name'] ); ?>" id="<?php echo esc_attr( $args['field_name'] ); ?>" class="frm-pages-dropdown">
2039 1354 <option value=""><?php echo esc_html( $args['placeholder'] ); ?></option>
2040 1355 <?php foreach ( $pages as $page ) { ?>
@@ -2050,14 +1365,8 @@
2050 1365 * Fill in missing parameters passed to wp_pages_dropdown().
2051 1366 * This is for reverse compatibility with switching 3 params to 1.
2052 1367 *
2053 1368 * @since 4.03.06
2054 - *
2055 - * @param string $page_id Deprecated.
2056 - * @param bool $truncate Deprecated.
2057 - * @param mixed $args
2058 - *
2059 - * @return void
2060 1369 */
2061 1370 private static function prep_page_dropdown_params( $page_id, $truncate, &$args ) {
2062 1371 if ( ! is_array( $args ) ) {
2063 1372 $args = array(
@@ -2074,20 +1383,16 @@
2074 1383 * Filter to format args for page dropdown or autocomplete
2075 1384 *
2076 1385 * @since 4.03.06
2077 1386 * @since 4.10.01 Added `post_type` and `autocomplete_placeholder` to the arguments array.
2078 - *
2079 - * @param array $args
2080 - *
2081 - * @return array
2082 1387 */
2083 1388 private static function preformat_selection_args( $args ) {
2084 1389 $defaults = array(
2085 - 'truncate' => false,
2086 - 'placeholder' => ' ',
2087 - 'field_name' => '',
2088 - 'page_id' => '',
2089 - 'post_type' => 'page',
1390 + 'truncate' => false,
1391 + 'placeholder' => ' ',
1392 + 'field_name' => '',
1393 + 'page_id' => '',
1394 + 'post_type' => 'page',
2090 1395 'autocomplete_placeholder' => __( 'Select a Page', 'formidable' ),
2091 1396 );
2092 1397
2093 1398 return array_merge( $defaults, $args );
@@ -2092,18 +1397,13 @@
2092 1397
2093 1398 return array_merge( $defaults, $args );
2094 1399 }
2095 1400
2096 - /**
2097 - * @param int $post_id
2098 - *
2099 - * @return string
2100 - */
2101 1401 public static function post_edit_link( $post_id ) {
2102 1402 $post = get_post( $post_id );
2103 -
2104 1403 if ( $post ) {
2105 1404 $post_url = admin_url( 'post.php?post=' . $post_id . '&action=edit' );
1405 + $post_url = self::maybe_full_screen_link( $post_url );
2106 1406
2107 1407 return '<a href="' . esc_url( $post_url ) . '">' . self::truncate( $post->post_title, 50 ) . '</a>';
2108 1408 }
2109 1409
@@ -2118,63 +1418,34 @@
2118 1418 * @return bool
2119 1419 */
2120 1420 public static function is_full_screen() {
2121 1421 return self::is_form_builder_page() ||
2122 - self::is_style_editor_page() ||
2123 - self::is_full_screen_view_builder_page();
1422 + self::is_admin_page( 'formidable-styles' ) ||
1423 + self::is_admin_page( 'formidable-styles2' ) ||
1424 + self::simple_get( 'frm-full', 'absint' ) ||
1425 + self::is_view_builder_page();
2124 1426 }
2125 1427
2126 1428 /**
2127 - * Check if user is on the style editor or its alternative URL.
2128 - * The first URL is a submenu "Styles" in the Formidable menu /wp-admin/admin.php?page=formidable-styles.
2129 - * The alternative URL is linked as a submenu "Forms" item of the Appearance menu /wp-admin/themes.php?page=formidable-styles2.
2130 - *
2131 - * @since 5.5.3
2132 - * @since 6.0 Added the $view parameter. Previously there was only a 'edit' view.
2133 - *
2134 - * @param string $view Supports 'edit', 'list', and ''. If '', both 'edit' and 'list' will match.
2135 - *
2136 - * @return bool
1429 + * @since 4.0
2137 1430 */
2138 - public static function is_style_editor_page( $view = '' ) {
2139 - if ( ! self::is_admin_page( 'formidable-styles' ) && ! self::is_admin_page( 'formidable-styles2' ) ) {
2140 - return false;
1431 + public static function maybe_full_screen_link( $link ) {
1432 + $is_full = self::simple_get( 'frm-full', 'absint' );
1433 + if ( $is_full && ! empty( $link ) && $link !== '#' ) {
1434 + $link .= '&frm-full=1';
2141 1435 }
2142 -
2143 - if ( ! in_array( $view, array( 'list', 'edit' ), true ) ) {
2144 - return true;
2145 - }
2146 -
2147 - $action = self::simple_get( 'frm_action' );
2148 - $is_edit_mode = 'edit' === $action || ( ! $action && ! self::simple_get( 'id' ) && ! self::simple_get( 'form' ) );
2149 -
2150 - if ( ! $is_edit_mode && class_exists( 'FrmProStylesController' ) && in_array( $action, array( 'new_style', 'duplicate' ), true ) ) {
2151 - $is_edit_mode = true;
2152 - }
2153 -
2154 - $checking_for_edit_mode = 'edit' === $view;
2155 -
2156 - return $is_edit_mode === $checking_for_edit_mode;
1436 + return $link;
2157 1437 }
2158 1438
2159 1439 /**
2160 - * @since 5.5.3
2161 - *
2162 - * @return bool
1440 + * @param string $field_name
1441 + * @param string|array $capability
1442 + * @param string $multiple 'single' and 'multiple'
2163 1443 */
2164 - private static function is_full_screen_view_builder_page() {
2165 - return self::is_admin_page( 'formidable-views-editor' );
2166 - }
2167 -
2168 - /**
2169 - * @param string $field_name
2170 - * @param array|string $capability
2171 - * @param string $multiple 'single' and 'multiple'.
2172 - */
2173 1444 public static function wp_roles_dropdown( $field_name, $capability, $multiple = 'single' ) {
2174 1445 ?>
2175 1446 <select name="<?php echo esc_attr( $field_name ); ?>" id="<?php echo esc_attr( $field_name ); ?>"
2176 - <?php echo 'multiple' === $multiple ? 'multiple="multiple"' : ''; ?>
1447 + <?php echo ( 'multiple' === $multiple ) ? 'multiple="multiple"' : ''; ?>
2177 1448 class="frm_multiselect">
2178 1449 <?php self::roles_options( $capability ); ?>
2179 1450 </select>
2180 1451 <?php
@@ -2181,11 +1452,10 @@
2181 1452 }
2182 1453
2183 1454 /**
2184 1455 * @since 4.07
2185 - *
2186 1456 * @param array|string $selected
2187 - * @param string $current
1457 + * @param string $current
2188 1458 */
2189 1459 private static function selected( $selected, $current ) {
2190 1460 if ( is_callable( 'FrmProAppHelper::selected' ) ) {
2191 1461 FrmProAppHelper::selected( $selected, $current );
@@ -2194,13 +1464,12 @@
2194 1464 }
2195 1465 }
2196 1466
2197 1467 /**
2198 - * @param array|string $capability
1468 + * @param string|array $capability
2199 1469 */
2200 1470 public static function roles_options( $capability ) {
2201 1471 global $frm_vars;
2202 -
2203 1472 if ( isset( $frm_vars['editable_roles'] ) ) {
2204 1473 $editable_roles = $frm_vars['editable_roles'];
2205 1474 } else {
2206 1475 $editable_roles = get_editable_roles();
@@ -2209,9 +1478,9 @@
2209 1478
2210 1479 foreach ( $editable_roles as $role => $details ) {
2211 1480 $name = translate_user_role( $details['name'] );
2212 1481 ?>
2213 - <option value="<?php echo esc_attr( $role ); ?>" <?php self::selected( $capability, $role ); ?>><?php echo esc_html( $name ); ?></option>
1482 + <option value="<?php echo esc_attr( $role ); ?>" <?php self::selected( $capability, $role ); ?>><?php echo esc_attr( $name ); ?> </option>
2214 1483 <?php
2215 1484 unset( $role, $details );
2216 1485 }
2217 1486 }
@@ -2221,9 +1490,8 @@
2221 1490 *
2222 1491 * @since 5.0 Parameter `$type` supports `pro_only` value.
2223 1492 *
2224 1493 * @param string $type Supports `auto`, `pro`, or `pro_only`.
2225 - *
2226 1494 * @return array
2227 1495 */
2228 1496 public static function frm_capabilities( $type = 'auto' ) {
2229 1497 if ( ! self::pro_is_installed() && ! in_array( $type, array( 'pro', 'pro_only' ), true ) ) {
@@ -2233,8 +1501,9 @@
2233 1501 $pro_cap = array(
2234 1502 'frm_create_entries' => __( 'Add Entries from Admin Area', 'formidable' ),
2235 1503 'frm_edit_entries' => __( 'Edit Entries from Admin Area', 'formidable' ),
2236 1504 'frm_view_reports' => __( 'View Reports', 'formidable' ),
1505 + 'frm_edit_displays' => __( 'Add/Edit Views', 'formidable' ),
2237 1506 );
2238 1507 /**
2239 1508 * @since 5.3.1
2240 1509 *
@@ -2257,9 +1526,9 @@
2257 1526 * @return array<string,string>
2258 1527 */
2259 1528 private static function get_lite_capabilities() {
2260 1529 return array(
2261 - 'frm_view_forms' => __( 'View Forms List', 'formidable' ),
1530 + 'frm_view_forms' => __( 'View Forms', 'formidable' ),
2262 1531 'frm_edit_forms' => __( 'Add and Edit Forms', 'formidable' ),
2263 1532 'frm_delete_forms' => __( 'Delete Forms', 'formidable' ),
2264 1533 'frm_change_settings' => __( 'Access this Settings Page', 'formidable' ),
2265 1534 'frm_view_entries' => __( 'View Entries from Admin Area', 'formidable' ),
@@ -2300,10 +1569,9 @@
2300 1569 return current_user_can( $role );
2301 1570 }
2302 1571
2303 1572 /**
2304 - * @param array|string $needed_role
2305 - *
1573 + * @param string|array $needed_role
2306 1574 * @return bool
2307 1575 */
2308 1576 public static function user_has_permission( $needed_role ) {
2309 1577 if ( is_array( $needed_role ) ) {
@@ -2322,14 +1590,12 @@
2322 1590 return $can;
2323 1591 }
2324 1592
2325 1593 $roles = array( 'administrator', 'editor', 'author', 'contributor', 'subscriber' );
2326 -
2327 1594 foreach ( $roles as $role ) {
2328 1595 if ( current_user_can( $role ) ) {
2329 1596 return true;
2330 1597 }
2331 -
2332 1598 if ( $role == $needed_role ) {
2333 1599 break;
2334 1600 }
2335 1601 }
@@ -2351,9 +1617,8 @@
2351 1617
2352 1618 $user_id = get_current_user_id();
2353 1619 $user = new WP_User( $user_id );
2354 1620 $frm_roles = self::frm_capabilities();
2355 -
2356 1621 foreach ( $frm_roles as $frm_role => $frm_role_description ) {
2357 1622 $user->add_cap( $frm_role );
2358 1623 unset( $frm_role, $frm_role_description );
2359 1624 }
@@ -2362,18 +1627,13 @@
2362 1627 /**
2363 1628 * Make sure admins have permission to see the menu items
2364 1629 *
2365 1630 * @since 2.0.6
2366 - *
2367 - * @param string $cap
2368 - *
2369 - * @return void
2370 1631 */
2371 1632 public static function force_capability( $cap = 'frm_change_settings' ) {
2372 1633 if ( current_user_can( 'administrator' ) && ! current_user_can( $cap ) ) {
2373 1634 $role = get_role( 'administrator' );
2374 1635 $frm_roles = self::frm_capabilities();
2375 -
2376 1636 foreach ( $frm_roles as $frm_role => $frm_role_description ) {
2377 1637 $role->add_cap( $frm_role );
2378 1638 }
2379 1639 }
@@ -2379,19 +1639,17 @@
2379 1639 }
2380 1640 }
2381 1641
2382 1642 /**
2383 - * Check if the user has permission for action.
1643 + * Check if the user has permision for action.
2384 1644 * Return permission message and stop the action if no permission
2385 1645 *
2386 1646 * @since 2.0
2387 1647 *
2388 1648 * @param string $permission
2389 - * @param string $show_message
2390 1649 */
2391 1650 public static function permission_check( $permission, $show_message = 'show' ) {
2392 1651 $permission_error = self::permission_nonce_error( $permission );
2393 -
2394 1652 if ( $permission_error !== false ) {
2395 1653 if ( 'hide' == $show_message ) {
2396 1654 $permission_error = '';
2397 1655 }
@@ -2404,10 +1662,8 @@
2404 1662 *
2405 1663 * @since 2.0
2406 1664 *
2407 1665 * @param string $permission
2408 - * @param string $nonce_name
2409 - * @param string $nonce
2410 1666 *
2411 1667 * @return false|string The permission message or false if allowed
2412 1668 */
2413 1669 public static function permission_nonce_error( $permission, $nonce_name = '', $nonce = '' ) {
@@ -2417,15 +1673,13 @@
2417 1673 return $frm_settings->admin_permission;
2418 1674 }
2419 1675
2420 1676 $error = false;
2421 -
2422 1677 if ( empty( $nonce_name ) ) {
2423 1678 return $error;
2424 1679 }
2425 1680
2426 - $nonce_value = $_REQUEST && isset( $_REQUEST[ $nonce_name ] ) ? sanitize_text_field( wp_unslash( $_REQUEST[ $nonce_name ] ) ) : '';
2427 -
1681 + $nonce_value = ( $_REQUEST && isset( $_REQUEST[ $nonce_name ] ) ) ? sanitize_text_field( wp_unslash( $_REQUEST[ $nonce_name ] ) ) : '';
2428 1682 if ( $_REQUEST && ( ! isset( $_REQUEST[ $nonce_name ] ) || ! wp_verify_nonce( $nonce_value, $nonce ) ) ) {
2429 1683 $frm_settings = self::get_settings();
2430 1684 $error = $frm_settings->admin_permission;
2431 1685 }
@@ -2432,14 +1686,8 @@
2432 1686
2433 1687 return $error;
2434 1688 }
2435 1689
2436 - /**
2437 - * @param array|string $values
2438 - * @param string $current
2439 - *
2440 - * @return void
2441 - */
2442 1690 public static function checked( $values, $current ) {
2443 1691 if ( self::check_selected( $values, $current ) ) {
2444 1692 echo ' checked="checked"';
2445 1693 }
@@ -2444,39 +1692,24 @@
2444 1692 echo ' checked="checked"';
2445 1693 }
2446 1694 }
2447 1695
2448 - /**
2449 - * @param array|string $values
2450 - * @param string $current
2451 - *
2452 - * @return bool
2453 - */
2454 1696 public static function check_selected( $values, $current ) {
2455 - $values = self::recursive_function_map( $values, 'trim' );
2456 - $values = self::recursive_function_map( $values, 'htmlspecialchars_decode' );
1697 + $values = self::recursive_function_map( $values, 'trim' );
1698 + $values = self::recursive_function_map( $values, 'htmlspecialchars_decode' );
1699 + $current = htmlspecialchars_decode( trim( $current ) );
2457 1700
2458 - $current = is_null( $current ) ? '' : htmlspecialchars_decode( trim( $current ) );
2459 -
2460 1701 return ( is_array( $values ) && in_array( $current, $values ) ) || ( ! is_array( $values ) && $values == $current );
2461 1702 }
2462 1703
2463 - /**
2464 - * @param array|string $value
2465 - * @param callable|string $function
2466 - *
2467 - * @return array|string
2468 - */
2469 1704 public static function recursive_function_map( $value, $function ) {
2470 1705 if ( is_array( $value ) ) {
2471 1706 $original_function = $function;
2472 -
2473 1707 if ( count( $value ) ) {
2474 1708 $function = explode( ', ', FrmDb::prepare_array_values( $value, $function ) );
2475 1709 } else {
2476 1710 $function = array( $function );
2477 1711 }
2478 -
2479 1712 if ( ! self::is_assoc( $value ) ) {
2480 1713 $value = array_map( array( 'FrmAppHelper', 'recursive_function_map' ), $value, $function );
2481 1714 } else {
2482 1715 foreach ( $value as $k => $v ) {
@@ -2485,38 +1718,14 @@
2485 1718 }
2486 1719 }
2487 1720 }
2488 1721 } else {
2489 - $value = self::maybe_update_value_if_null( $value, $function );
2490 1722 $value = call_user_func( $function, $value );
2491 - }//end if
2492 -
2493 - return $value;
2494 - }
2495 -
2496 - /**
2497 - * Updates value to empty string if it is null and being passed to a string function.
2498 - *
2499 - * @since 6.8.4
2500 - *
2501 - * @param mixed $value
2502 - * @param string $function
2503 - *
2504 - * @return mixed
2505 - */
2506 - private static function maybe_update_value_if_null( $value, $function ) {
2507 - if ( null === $value && in_array( $function, array( 'trim', 'strlen' ), true ) ) {
2508 - $value = '';
2509 1723 }
2510 1724
2511 1725 return $value;
2512 1726 }
2513 1727
2514 - /**
2515 - * @param array $array
2516 - *
2517 - * @return bool
2518 - */
2519 1728 public static function is_assoc( $array ) {
2520 1729 return (bool) count( array_filter( array_keys( $array ), 'is_string' ) );
2521 1730 }
2522 1731
@@ -2521,24 +1730,20 @@
2521 1730 }
2522 1731
2523 1732 /**
2524 1733 * Flatten a multi-dimensional array
2525 - *
2526 - * @param array $array
2527 - * @param string $keys
2528 - *
2529 - * @return array
2530 1734 */
2531 1735 public static function array_flatten( $array, $keys = 'keep' ) {
2532 1736 $return = array();
2533 -
2534 1737 foreach ( $array as $key => $value ) {
2535 1738 if ( is_array( $value ) ) {
2536 1739 $return = array_merge( $return, self::array_flatten( $value, $keys ) );
2537 - } elseif ( $keys === 'keep' ) {
1740 + } else {
1741 + if ( $keys == 'keep' ) {
2538 1742 $return[ $key ] = $value;
2539 - } else {
2540 - $return[] = $value;
1743 + } else {
1744 + $return[] = $value;
1745 + }
2541 1746 }
2542 1747 }
2543 1748
2544 1749 return $return;
@@ -2543,43 +1748,16 @@
2543 1748
2544 1749 return $return;
2545 1750 }
2546 1751
2547 - /**
2548 - * Flatten an array before imploding it to avoid Array to string conversion warnings.
2549 - *
2550 - * @since 6.16.1
2551 - *
2552 - * @param string $sep
2553 - * @param array $array
2554 - *
2555 - * @return string
2556 - */
2557 - public static function safe_implode( $sep, $array ) {
2558 - $array = self::array_flatten( $array );
2559 - return implode( $sep, $array );
2560 - }
2561 -
2562 - /**
2563 - * @param string $text
2564 - * @param bool $is_rich_text
2565 - *
2566 - * @return string
2567 - */
2568 1752 public static function esc_textarea( $text, $is_rich_text = false ) {
2569 1753 $safe_text = str_replace( '&quot;', '"', $text );
2570 -
2571 1754 if ( ! $is_rich_text ) {
2572 1755 $safe_text = htmlspecialchars( $safe_text, ENT_NOQUOTES );
2573 1756 }
2574 -
2575 1757 $safe_text = str_replace( '&amp; ', '& ', $safe_text );
2576 1758
2577 - /**
2578 - * @param string $safe_text
2579 - * @param string $text
2580 - */
2581 - return (string) apply_filters( 'esc_textarea', $safe_text, $text );
1759 + return apply_filters( 'esc_textarea', $safe_text, $text );
2582 1760 }
2583 1761
2584 1762 /**
2585 1763 * Add auto paragraphs to text areas
@@ -2584,15 +1762,11 @@
2584 1762 /**
2585 1763 * Add auto paragraphs to text areas
2586 1764 *
2587 1765 * @since 2.0
2588 - *
2589 - * @param mixed $content
2590 - *
2591 - * @return mixed
2592 1766 */
2593 1767 public static function use_wpautop( $content ) {
2594 - if ( apply_filters( 'frm_use_wpautop', true ) && is_string( $content ) ) {
1768 + if ( apply_filters( 'frm_use_wpautop', true ) && ! is_array( $content ) ) {
2595 1769 $content = wpautop( str_replace( '<br>', '<br />', $content ) );
2596 1770 }
2597 1771
2598 1772 return $content;
@@ -2597,15 +1771,8 @@
2597 1771
2598 1772 return $content;
2599 1773 }
2600 1774
2601 - /**
2602 - * Replace quotes with their HTML entities.
2603 - *
2604 - * @param string $val
2605 - *
2606 - * @return string
2607 - */
2608 1775 public static function replace_quotes( $val ) {
2609 1776 // Replace double quotes.
2610 1777 $val = str_replace( array( '&#8220;', '&#8221;', '&#8243;' ), '"', $val );
2611 1778
@@ -2615,28 +1782,22 @@
2615 1782 return $val;
2616 1783 }
2617 1784
2618 1785 /**
2619 - * @param string $handle
2620 - * @param int|string $default
2621 - *
2622 - * @return int|string
1786 + * @param string $handle
2623 1787 */
2624 1788 public static function script_version( $handle, $default = 0 ) {
2625 1789 global $wp_scripts;
2626 -
2627 1790 if ( ! $wp_scripts ) {
2628 1791 return $default;
2629 1792 }
2630 1793
2631 1794 $ver = $default;
2632 -
2633 1795 if ( ! isset( $wp_scripts->registered[ $handle ] ) ) {
2634 1796 return $ver;
2635 1797 }
2636 1798
2637 1799 $query = $wp_scripts->registered[ $handle ];
2638 -
2639 1800 if ( is_object( $query ) && ! empty( $query->ver ) ) {
2640 1801 $ver = $query->ver;
2641 1802 }
2642 1803
@@ -2647,23 +1808,17 @@
2647 1808 * @since 5.0.13 added $echo param.
2648 1809 *
2649 1810 * @param string $url
2650 1811 * @param bool $echo
2651 - *
2652 - * @return string|null
1812 + * @return string|void
2653 1813 */
2654 1814 public static function js_redirect( $url, $echo = false ) {
2655 - $callback = function () use ( $url ) {
1815 + $callback = function() use ( $url ) {
2656 1816 echo '<script type="text/javascript">window.location="' . esc_url_raw( $url ) . '"</script>';
2657 1817 };
2658 1818 return self::clip( $callback, $echo );
2659 1819 }
2660 1820
2661 - /**
2662 - * @param int|string $user_id
2663 - *
2664 - * @return int|string
2665 - */
2666 1821 public static function get_user_id_param( $user_id ) {
2667 1822 if ( ! $user_id || is_numeric( $user_id ) ) {
2668 1823 return $user_id;
2669 1824 }
@@ -2668,10 +1823,9 @@
2668 1823 return $user_id;
2669 1824 }
2670 1825
2671 1826 $user_id = sanitize_text_field( $user_id );
2672 -
2673 - if ( $user_id === 'current' ) {
1827 + if ( $user_id == 'current' ) {
2674 1828 $user_id = get_current_user_id();
2675 1829 } else {
2676 1830 if ( is_email( $user_id ) ) {
2677 1831 $user = get_user_by( 'email', $user_id );
@@ -2687,14 +1841,8 @@
2687 1841
2688 1842 return $user_id;
2689 1843 }
2690 1844
2691 - /**
2692 - * @param string $filename
2693 - * @param array $atts
2694 - *
2695 - * @return false|string
2696 - */
2697 1845 public static function get_file_contents( $filename, $atts = array() ) {
2698 1846 if ( ! is_file( $filename ) ) {
2699 1847 return false;
2700 1848 }
@@ -2700,9 +1848,9 @@
2700 1848 }
2701 1849
2702 1850 extract( $atts ); // phpcs:ignore WordPress.PHP.DontExtract
2703 1851 ob_start();
2704 - include $filename;
1852 + include( $filename );
2705 1853 $contents = ob_get_contents();
2706 1854 ob_end_clean();
2707 1855
2708 1856 return $contents;
@@ -2716,9 +1864,8 @@
2716 1864 * @param int $num_chars
2717 1865 */
2718 1866 public static function get_unique_key( $name, $table_name, $column, $id = 0, $num_chars = 5 ) {
2719 1867 $key = '';
2720 -
2721 1868 if ( $name ) {
2722 1869 $key = sanitize_key( $name );
2723 1870 $key = self::maybe_clear_long_key( $key, $column );
2724 1871 }
@@ -2758,9 +1905,9 @@
2758 1905 ++$suffix;
2759 1906 } while ( in_array( $key_check, $similar_keys, true ) );
2760 1907
2761 1908 $key = $key_check;
2762 - }//end if
1909 + }
2763 1910
2764 1911 return $key;
2765 1912 }
2766 1913
@@ -2769,18 +1916,15 @@
2769 1916 * The database limit is 100 for form and field keys so we want to avoid getting too close.
2770 1917 *
2771 1918 * @param string $column
2772 1919 * @param string $key
2773 - *
2774 1920 * @return string
2775 1921 */
2776 1922 private static function maybe_truncate_key_before_appending( $column, $key ) {
2777 1923 if ( in_array( $column, array( 'form_key', 'field_key' ), true ) ) {
2778 1924 $max_key_length_before_truncating = 60;
2779 -
2780 1925 if ( strlen( $key ) > $max_key_length_before_truncating ) {
2781 1926 $key = substr( $key, 0, $max_key_length_before_truncating );
2782 -
2783 1927 if ( is_numeric( $key ) ) {
2784 1928 $key .= 'a';
2785 1929 }
2786 1930 }
@@ -2792,9 +1936,8 @@
2792 1936 * Possibly reset a key to avoid conflicts with column size limits.
2793 1937 *
2794 1938 * @param string $key
2795 1939 * @param string $column
2796 - *
2797 1940 * @return string either the original key value, or an empty string if the key was too long.
2798 1941 */
2799 1942 private static function maybe_clear_long_key( $key, $column ) {
2800 1943 if ( 'field_key' === $column && strlen( $key ) >= 70 ) {
@@ -2803,25 +1946,19 @@
2803 1946 return $key;
2804 1947 }
2805 1948
2806 1949 /**
2807 - * @since 6.21 This is changed from `private` to `public`.
2808 - *
2809 1950 * @param int $num_chars
2810 - *
2811 1951 * @return string
2812 1952 */
2813 - public static function generate_new_key( $num_chars ) {
2814 - $max_slug_value = 36 ** $num_chars;
2815 -
2816 - // We want to have at least 2 characters in the slug.
2817 - $min_slug_value = 37;
2818 - return base_convert( random_int( $min_slug_value, $max_slug_value ), 10, 36 );
1953 + private static function generate_new_key( $num_chars ) {
1954 + $max_slug_value = pow( 36, $num_chars );
1955 + $min_slug_value = 37; // we want to have at least 2 characters in the slug
1956 + return base_convert( rand( $min_slug_value, $max_slug_value ), 10, 36 );
2819 1957 }
2820 1958
2821 1959 /**
2822 1960 * @param string $key
2823 - *
2824 1961 * @return string
2825 1962 */
2826 1963 private static function prevent_numeric_and_reserved_keys( $key ) {
2827 1964 if ( is_numeric( $key ) ) {
@@ -2835,9 +1972,8 @@
2835 1972 'editlink',
2836 1973 'siteurl',
2837 1974 'evenodd',
2838 1975 );
2839 -
2840 1976 if ( in_array( $key, $not_allowed, true ) ) {
2841 1977 $key .= 'a';
2842 1978 }
2843 1979 }
@@ -2846,16 +1982,11 @@
2846 1982
2847 1983 /**
2848 1984 * Editing a Form or Entry
2849 1985 *
2850 - * @param object $record
2851 - * @param string $table
2852 - * @param array|string $fields
2853 - * @param bool $default
2854 - * @param array $post_values
2855 - * @param array $args
1986 + * @param string $table
2856 1987 *
2857 - * @return array|bool
1988 + * @return bool|array
2858 1989 */
2859 1990 public static function setup_edit_vars( $record, $table, $fields = '', $default = false, $post_values = array(), $args = array() ) {
2860 1991 if ( ! $record ) {
2861 1992 return false;
@@ -2870,9 +2001,9 @@
2870 2001 'fields' => array(),
2871 2002 );
2872 2003
2873 2004 foreach ( array( 'name', 'description' ) as $var ) {
2874 - $default_val = $record->{$var} ?? '';
2005 + $default_val = isset( $record->{$var} ) ? $record->{$var} : '';
2875 2006 $values[ $var ] = self::get_param( $var, $default_val, 'get', 'wp_kses_post' );
2876 2007 unset( $var, $default_val );
2877 2008 }
2878 2009
@@ -2890,16 +2021,8 @@
2890 2021
2891 2022 return $values;
2892 2023 }
2893 2024
2894 - /**
2895 - * @param array|string $fields
2896 - * @param object $record
2897 - * @param array $values
2898 - * @param array $args
2899 - *
2900 - * @return void
2901 - */
2902 2025 private static function prepare_field_arrays( $fields, $record, array &$values, $args ) {
2903 2026 if ( ! empty( $fields ) ) {
2904 2027 foreach ( (array) $fields as $field ) {
2905 2028 if ( ! self::is_admin_page() ) {
@@ -2905,32 +2028,24 @@
2905 2028 if ( ! self::is_admin_page() ) {
2906 2029 // Don't prep default values on the form settings page.
2907 2030 $field->default_value = apply_filters( 'frm_get_default_value', $field->default_value, $field, true );
2908 2031 }
2909 - $args['parent_form_id'] = $args['parent_form_id'] ?? $field->form_id;
2032 + $args['parent_form_id'] = isset( $args['parent_form_id'] ) ? $args['parent_form_id'] : $field->form_id;
2910 2033 self::fill_field_defaults( $field, $record, $values, $args );
2911 2034 }
2912 2035 }
2913 2036 }
2914 2037
2915 - /**
2916 - * @param object $field
2917 - * @param object $record
2918 - * @param array $values
2919 - * @param array $args
2920 - *
2921 - * @return void
2922 - */
2923 2038 private static function fill_field_defaults( $field, $record, array &$values, $args ) {
2924 2039 $post_values = $args['post_values'];
2925 2040
2926 2041 if ( $args['default'] ) {
2927 2042 $meta_value = $field->default_value;
2928 - } elseif ( $record->post_id && self::pro_is_installed() && isset( $field->field_options['post_field'] ) && $field->field_options['post_field'] ) {
2929 - if ( ! isset( $field->field_options['custom_field'] ) ) {
2930 - $field->field_options['custom_field'] = '';
2931 - }
2932 -
2043 + } else {
2044 + if ( $record->post_id && self::pro_is_installed() && isset( $field->field_options['post_field'] ) && $field->field_options['post_field'] ) {
2045 + if ( ! isset( $field->field_options['custom_field'] ) ) {
2046 + $field->field_options['custom_field'] = '';
2047 + }
2933 2048 $meta_value = FrmProEntryMetaHelper::get_post_value(
2934 2049 $record->post_id,
2935 2050 $field->field_options['post_field'],
2936 2051 $field->field_options['custom_field'],
@@ -2940,14 +2055,14 @@
2940 2055 'form_id' => $field->form_id,
2941 2056 'field' => $field,
2942 2057 )
2943 2058 );
2944 - } else {
2945 - $meta_value = FrmEntryMeta::get_meta_value( $record, $field->id );
2946 - }//end if
2059 + } else {
2060 + $meta_value = FrmEntryMeta::get_meta_value( $record, $field->id );
2061 + }
2062 + }
2947 2063
2948 - $field_type = $post_values['field_options'][ 'type_' . $field->id ] ?? $field->type;
2949 -
2064 + $field_type = isset( $post_values['field_options'][ 'type_' . $field->id ] ) ? $post_values['field_options'][ 'type_' . $field->id ] : $field->type;
2950 2065 if ( isset( $post_values['item_meta'][ $field->id ] ) ) {
2951 2066 $new_value = $post_values['item_meta'][ $field->id ];
2952 2067 self::unserialize_or_decode( $new_value );
2953 2068 } else {
@@ -2993,15 +2108,12 @@
2993 2108 );
2994 2109 }
2995 2110
2996 2111 /**
2997 - * @param object $record
2998 2112 * @param string $table
2999 - * @param array $post_values
3000 - * @param array $values
3001 2113 */
3002 2114 private static function fill_form_opts( $record, $table, $post_values, array &$values ) {
3003 - if ( $table === 'entries' ) {
2115 + if ( $table == 'entries' ) {
3004 2116 $form = $record->form_id;
3005 2117 FrmForm::maybe_get_form( $form );
3006 2118 } else {
3007 2119 $form = $record;
@@ -3031,13 +2143,8 @@
3031 2143 }
3032 2144
3033 2145 /**
3034 2146 * Set to POST value or default
3035 - *
3036 - * @param array $post_values
3037 - * @param array $values
3038 - *
3039 - * @return void
3040 2147 */
3041 2148 private static function fill_form_defaults( $post_values, array &$values ) {
3042 2149 $form_defaults = FrmFormsHelper::get_default_opts();
3043 2150
@@ -3042,9 +2149,9 @@
3042 2149 $form_defaults = FrmFormsHelper::get_default_opts();
3043 2150
3044 2151 foreach ( $form_defaults as $opt => $default ) {
3045 2152 if ( ! isset( $values[ $opt ] ) || $values[ $opt ] == '' ) {
3046 - $values[ $opt ] = $post_values && isset( $post_values['options'][ $opt ] ) ? $post_values['options'][ $opt ] : $default;
2153 + $values[ $opt ] = ( $post_values && isset( $post_values['options'][ $opt ] ) ) ? $post_values['options'][ $opt ] : $default;
3047 2154 }
3048 2155
3049 2156 unset( $opt, $default );
3050 2157 }
@@ -3054,9 +2161,9 @@
3054 2161 }
3055 2162
3056 2163 foreach ( array( 'before', 'after', 'submit' ) as $h ) {
3057 2164 if ( ! isset( $values[ $h . '_html' ] ) ) {
3058 - $values[ $h . '_html' ] = ( $post_values['options'][ $h . '_html' ] ?? FrmFormsHelper::get_default_html( $h ) );
2165 + $values[ $h . '_html' ] = ( isset( $post_values['options'][ $h . '_html' ] ) ? $post_values['options'][ $h . '_html' ] : FrmFormsHelper::get_default_html( $h ) );
3059 2166 }
3060 2167 unset( $h );
3061 2168 }
3062 2169 }
@@ -3065,9 +2172,9 @@
3065 2172 * @since 2.2.10
3066 2173 *
3067 2174 * @param array $post_values
3068 2175 *
3069 - * @return bool|int
2176 + * @return boolean|int
3070 2177 */
3071 2178 public static function custom_style_value( $post_values ) {
3072 2179 if ( ! empty( $post_values ) && isset( $post_values['options']['custom_style'] ) ) {
3073 2180 $custom_style = absint( $post_values['options']['custom_style'] );
@@ -3072,38 +2179,29 @@
3072 2179 if ( ! empty( $post_values ) && isset( $post_values['options']['custom_style'] ) ) {
3073 2180 $custom_style = absint( $post_values['options']['custom_style'] );
3074 2181 } else {
3075 2182 $frm_settings = self::get_settings();
3076 - $custom_style = ( $frm_settings->load_style !== 'none' );
2183 + $custom_style = ( $frm_settings->load_style != 'none' );
3077 2184 }
3078 2185
3079 2186 return $custom_style;
3080 2187 }
3081 2188
3082 - /**
3083 - * @param mixed $original_string
3084 - * @param int|string $length
3085 - * @param int $minword
3086 - * @param string $continue
3087 - *
3088 - * @return string
3089 - */
3090 - public static function truncate( $original_string, $length, $minword = 3, $continue = '...' ) {
3091 - if ( ! is_string( $original_string ) && ! is_int( $original_string ) ) {
2189 + public static function truncate( $str, $length, $minword = 3, $continue = '...' ) {
2190 + if ( is_array( $str ) ) {
3092 2191 return '';
3093 2192 }
3094 2193
3095 2194 $length = (int) $length;
3096 - $str = wp_strip_all_tags( (string) $original_string );
2195 + $str = wp_strip_all_tags( $str );
3097 2196 $original_len = self::mb_function( array( 'mb_strlen', 'strlen' ), array( $str ) );
3098 2197
3099 2198 if ( $length == 0 ) {
3100 2199 return '';
3101 - }
2200 + } elseif ( $length <= 10 ) {
2201 + $sub = self::mb_function( array( 'mb_substr', 'substr' ), array( $str, 0, $length ) );
3102 2202
3103 - if ( $length <= 10 ) {
3104 - $sub = self::mb_function( array( 'mb_substr', 'substr' ), array( $str, 0, $length ) );
3105 - return $sub . ( $length < $original_len ? $continue : '' );
2203 + return $sub . ( ( $length < $original_len ) ? $continue : '' );
3106 2204 }
3107 2205
3108 2206 $sub = '';
3109 2207 $len = 0;
@@ -3109,16 +2207,11 @@
3109 2207 $len = 0;
3110 2208
3111 2209 $words = self::mb_function( array( 'mb_split', 'explode' ), array( ' ', $str ) );
3112 2210
3113 - if ( ! is_array( $words ) ) {
3114 - return $original_string;
3115 - }
3116 -
3117 2211 foreach ( $words as $word ) {
3118 - $part = ( $sub !== '' ? ' ' : '' ) . $word;
2212 + $part = ( ( $sub != '' ) ? ' ' : '' ) . $word;
3119 2213 $total_len = self::mb_function( array( 'mb_strlen', 'strlen' ), array( $sub . $part ) );
3120 -
3121 2214 if ( $total_len > $length && substr_count( $sub, ' ' ) ) {
3122 2215 break;
3123 2216 }
3124 2217
@@ -3131,49 +2224,14 @@
3131 2224
3132 2225 unset( $total_len, $word );
3133 2226 }
3134 2227
3135 - $sub = self::maybe_force_truncate_on_string_with_no_spaces( $sub, $length );
3136 -
3137 - return $sub . ( $len < $original_len ? $continue : '' );
2228 + return $sub . ( ( $len < $original_len ) ? $continue : '' );
3138 2229 }
3139 2230
3140 - /**
3141 - * If the string is still too long because there may not have been any spaces, force truncate.
3142 - *
3143 - * @since 6.5.4
3144 - *
3145 - * @param string $sub Current substring.
3146 - * @param int $length The length limit.
3147 - *
3148 - * @return string
3149 - */
3150 - private static function maybe_force_truncate_on_string_with_no_spaces( $sub, $length ) {
3151 - if ( strlen( $sub ) < $length + 50 ) {
3152 - // If the string isn't way over the limit, leave it.
3153 - return $sub;
3154 - }
3155 -
3156 - $first_space = strpos( $sub, ' ', $length );
3157 -
3158 - if ( false !== $first_space ) {
3159 - // Ignore anything with spaces.
3160 - return $sub;
3161 - }
3162 -
3163 - return substr( $sub, 0, $length + 10 );
3164 - }
3165 -
3166 - /**
3167 - * @param array $function_names
3168 - * @param array $args
3169 - *
3170 - * @return mixed
3171 - */
3172 2231 public static function mb_function( $function_names, $args ) {
3173 2232 $mb_function_name = $function_names[0];
3174 2233 $function_name = $function_names[1];
3175 -
3176 2234 if ( function_exists( $mb_function_name ) ) {
3177 2235 $function_name = $mb_function_name;
3178 2236 }
3179 2237
@@ -3179,15 +2237,8 @@
3179 2237
3180 2238 return call_user_func_array( $function_name, $args );
3181 2239 }
3182 2240
3183 - /**
3184 - * @param string $date
3185 - * @param string $date_format
3186 - * @param string $time_format
3187 - *
3188 - * @return string
3189 - */
3190 2241 public static function get_formatted_time( $date, $date_format = '', $time_format = '' ) {
3191 2242 if ( empty( $date ) ) {
3192 2243 return $date;
3193 2244 }
@@ -3202,10 +2253,9 @@
3202 2253 }
3203 2254
3204 2255 $formatted = self::get_localized_date( $date_format, $date );
3205 2256
3206 - $do_time = ( gmdate( 'H:i:s', strtotime( $date ) ) !== '00:00:00' );
3207 -
2257 + $do_time = ( gmdate( 'H:i:s', strtotime( $date ) ) != '00:00:00' );
3208 2258 if ( $do_time ) {
3209 2259 $formatted .= self::add_time_to_date( $time_format, $date );
3210 2260 }
3211 2261
@@ -3211,14 +2261,8 @@
3211 2261
3212 2262 return $formatted;
3213 2263 }
3214 2264
3215 - /**
3216 - * @param string $time_format
3217 - * @param string $date
3218 - *
3219 - * @return string
3220 - */
3221 2265 private static function add_time_to_date( $time_format, $date ) {
3222 2266 if ( empty( $time_format ) ) {
3223 2267 $time_format = get_option( 'time_format' );
3224 2268 }
@@ -3224,9 +2268,8 @@
3224 2268 }
3225 2269
3226 2270 $trimmed_format = trim( $time_format );
3227 2271 $time = '';
3228 -
3229 2272 if ( $time_format && ! empty( $trimmed_format ) ) {
3230 2273 $time = ' ' . __( 'at', 'formidable' ) . ' ' . self::get_localized_date( $time_format, $date );
3231 2274 }
3232 2275
@@ -3234,13 +2277,8 @@
3234 2277 }
3235 2278
3236 2279 /**
3237 2280 * @since 2.0.8
3238 - *
3239 - * @param string $date_format
3240 - * @param string $date
3241 - *
3242 - * @return string
3243 2281 */
3244 2282 public static function get_localized_date( $date_format, $date ) {
3245 2283 $date = get_date_from_gmt( $date );
3246 2284
@@ -3247,23 +2285,21 @@
3247 2285 return date_i18n( $date_format, strtotime( $date ) );
3248 2286 }
3249 2287
3250 2288 /**
3251 - * Gets the time ago in words.
2289 + * Gets the time ago in words
3252 2290 *
3253 - * @param int $from In seconds.
3254 - * @param int|string $to In seconds.
3255 - * @param int|string $levels Number of time units to include or a specific unit.
2291 + * @param int $from in seconds
2292 + * @param int|string $to in seconds
3256 2293 *
3257 2294 * @return string $time_ago
3258 2295 */
3259 2296 public static function human_time_diff( $from, $to = '', $levels = 1 ) {
3260 - if ( empty( $to ) && 0 !== $to ) {
2297 + if ( empty( $to ) ) {
3261 2298 $now = new DateTime();
3262 2299 } else {
3263 2300 $now = new DateTime( '@' . $to );
3264 2301 }
3265 -
3266 2302 $ago = new DateTime( '@' . $from );
3267 2303
3268 2304 // Get the time difference
3269 2305 $diff_object = $now->diff( $ago );
@@ -3269,9 +2305,9 @@
3269 2305 $diff_object = $now->diff( $ago );
3270 2306 $diff = get_object_vars( $diff_object );
3271 2307
3272 2308 // Add week amount and update day amount
3273 - $diff['w'] = floor( $diff['d'] / 7 );
2309 + $diff['w'] = floor( $diff['d'] / 7 );
3274 2310 $diff['d'] -= $diff['w'] * 7;
3275 2311
3276 2312 $time_strings = self::get_time_strings();
3277 2313
@@ -3277,11 +2313,10 @@
3277 2313
3278 2314 if ( ! is_numeric( $levels ) ) {
3279 2315 // Show time in specified unit.
3280 2316 $levels = self::get_unit( $levels );
3281 -
3282 2317 if ( isset( $time_strings[ $levels ] ) ) {
3283 - $diff = array(
2318 + $diff = array(
3284 2319 $levels => self::time_format( $levels, $diff ),
3285 2320 );
3286 2321 $time_strings = array(
3287 2322 $levels => $time_strings[ $levels ],
@@ -3286,9 +2321,8 @@
3286 2321 $time_strings = array(
3287 2322 $levels => $time_strings[ $levels ],
3288 2323 );
3289 2324 }
3290 -
3291 2325 $levels = 1;
3292 2326 }
3293 2327
3294 2328 foreach ( $time_strings as $k => $v ) {
@@ -3310,13 +2344,8 @@
3310 2344 }
3311 2345
3312 2346 /**
3313 2347 * @since 4.05.01
3314 - *
3315 - * @param string $unit
3316 - * @param array $diff
3317 - *
3318 - * @return int
3319 2348 */
3320 2349 private static function time_format( $unit, $diff ) {
3321 2350 $return = array(
3322 2351 'y' => 'y',
@@ -3321,9 +2350,8 @@
3321 2350 $return = array(
3322 2351 'y' => 'y',
3323 2352 'd' => 'days',
3324 2353 );
3325 -
3326 2354 if ( isset( $return[ $unit ] ) ) {
3327 2355 return $diff[ $return[ $unit ] ];
3328 2356 }
3329 2357
@@ -3343,13 +2371,8 @@
3343 2371 }
3344 2372
3345 2373 /**
3346 2374 * @since 4.05.01
3347 - *
3348 - * @param string $from
3349 - * @param string $to
3350 - *
3351 - * @return int
3352 2375 */
3353 2376 private static function convert_time( $from, $to ) {
3354 2377 $convert = array(
3355 2378 's' => 1,
@@ -3365,16 +2388,11 @@
3365 2388 }
3366 2389
3367 2390 /**
3368 2391 * @since 4.05.01
3369 - *
3370 - * @param string $unit
3371 - *
3372 - * @return int|string
3373 2392 */
3374 2393 private static function get_unit( $unit ) {
3375 2394 $units = self::get_time_strings();
3376 -
3377 2395 if ( isset( $units[ $unit ] ) || is_numeric( $unit ) ) {
3378 2396 return $unit;
3379 2397 }
3380 2398
@@ -3387,12 +2405,11 @@
3387 2405 }
3388 2406
3389 2407 /**
3390 2408 * Get the translatable time strings. The untranslated version is a failsafe
3391 - * in case languages are changing for the unit set in the shortcode.
2409 + * in case langauges are changing for the unit set in the shortcode.
3392 2410 *
3393 2411 * @since 2.0.20
3394 - *
3395 2412 * @return array
3396 2413 */
3397 2414 private static function get_time_strings() {
3398 2415 return array(
@@ -3436,47 +2453,35 @@
3436 2453
3437 2454 // Pagination Methods.
3438 2455
3439 2456 /**
3440 - * @param int $r_count
3441 - * @param int $current_p
3442 - * @param int $p_size
3443 - *
3444 - * @return int
2457 + * @param integer $current_p
3445 2458 */
3446 2459 public static function get_last_record_num( $r_count, $current_p, $p_size ) {
3447 - return ( $r_count < $current_p * $p_size ? $r_count : $current_p * $p_size );
2460 + return ( ( $r_count < ( $current_p * $p_size ) ) ? $r_count : ( $current_p * $p_size ) );
3448 2461 }
3449 2462
3450 2463 /**
3451 - * @param int $r_count
3452 - * @param int $current_p
3453 - * @param int $p_size
3454 - *
3455 - * @return int
2464 + * @param integer $current_p
3456 2465 */
3457 2466 public static function get_first_record_num( $r_count, $current_p, $p_size ) {
3458 2467 if ( $current_p == 1 ) {
3459 2468 return 1;
2469 + } else {
2470 + return ( self::get_last_record_num( $r_count, ( $current_p - 1 ), $p_size ) + 1 );
3460 2471 }
3461 - return self::get_last_record_num( $r_count, $current_p - 1, $p_size ) + 1;
3462 2472 }
3463 2473
3464 2474 /**
3465 - * @param array $json_vars
3466 - *
3467 2475 * @return array
3468 2476 */
3469 2477 public static function json_to_array( $json_vars ) {
3470 2478 $vars = array();
3471 -
3472 2479 foreach ( $json_vars as $jv ) {
3473 2480 $jv_name = explode( '[', $jv['name'] );
3474 2481 $last = count( $jv_name ) - 1;
3475 -
3476 2482 foreach ( $jv_name as $p => $n ) {
3477 2483 $name = trim( $n, ']' );
3478 -
3479 2484 if ( ! isset( $l1 ) ) {
3480 2485 $l1 = $name;
3481 2486 }
3482 2487
@@ -3487,9 +2492,9 @@
3487 2492 if ( ! isset( $l3 ) ) {
3488 2493 $l3 = $name;
3489 2494 }
3490 2495
3491 - $this_val = $p == $last ? $jv['value'] : array();
2496 + $this_val = ( $p == $last ) ? $jv['value'] : array();
3492 2497
3493 2498 switch ( $p ) {
3494 2499 case 0:
3495 2500 $l1 = $name;
@@ -3511,12 +2516,12 @@
3511 2516 self::add_value_to_array( $name, $l4, $this_val, $vars[ $l1 ][ $l2 ][ $l3 ] );
3512 2517 }
3513 2518
3514 2519 unset( $this_val, $n );
3515 - }//end foreach
2520 + }
3516 2521
3517 2522 unset( $last, $jv );
3518 - }//end foreach
2523 + }
3519 2524
3520 2525 return $vars;
3521 2526 }
3522 2527
@@ -3522,12 +2527,8 @@
3522 2527
3523 2528 /**
3524 2529 * @param string $name
3525 2530 * @param string $l1
3526 - * @param mixed $val
3527 - * @param array $vars
3528 - *
3529 - * @return void
3530 2531 */
3531 2532 public static function add_value_to_array( $name, $l1, $val, &$vars ) {
3532 2533 if ( $name == '' ) {
3533 2534 $vars[] = $val;
@@ -3535,19 +2536,12 @@
3535 2536 $vars[ $l1 ] = $val;
3536 2537 }
3537 2538 }
3538 2539
3539 - /**
3540 - * @param string $name
3541 - * @param string $class
3542 - * @param string $form_name
3543 - *
3544 - * @return void
3545 - */
3546 2540 public static function maybe_add_tooltip( $name, $class = 'closed', $form_name = '' ) {
3547 2541 $tooltips = array(
3548 2542 'action_title' => __( 'Give this action a label for easy reference.', 'formidable' ),
3549 - 'email_to' => __( 'Add one or more recipient addresses separated by a ",". FORMAT: Name <[email protected]> or [email protected]. [default-email] is the address set in the global "Default Email Address" settings.', 'formidable' ),
2543 + 'email_to' => __( 'Add one or more recipient addresses separated by a ",". FORMAT: Name <[email protected]> or [email protected]. [admin_email] is the address set in WP General Settings.', 'formidable' ),
3550 2544 'cc' => __( 'Add CC addresses separated by a ",". FORMAT: Name <[email protected]> or [email protected].', 'formidable' ),
3551 2545 'bcc' => __( 'Add BCC addresses separated by a ",". FORMAT: Name <[email protected]> or [email protected].', 'formidable' ),
3552 2546 'reply_to' => __( 'If you would like a different reply to address than the "from" address, add a single address here. FORMAT: Name <[email protected]> or [email protected].', 'formidable' ),
3553 2547 'from' => __( 'Enter the name and/or email address of the sender. FORMAT: John Bates <[email protected]> or [email protected].', 'formidable' ),
@@ -3552,9 +2546,8 @@
3552 2546 'reply_to' => __( 'If you would like a different reply to address than the "from" address, add a single address here. FORMAT: Name <[email protected]> or [email protected].', 'formidable' ),
3553 2547 'from' => __( 'Enter the name and/or email address of the sender. FORMAT: John Bates <[email protected]> or [email protected].', 'formidable' ),
3554 2548 /* translators: %1$s: Form name, %2$s: Date */
3555 2549 'email_subject' => esc_attr( sprintf( __( 'If you leave the subject blank, the default will be used: %1$s Form submitted on %2$s', 'formidable' ), $form_name, self::site_name() ) ),
3556 - 'new_tab' => __( 'This option will open the link in a new browser tab. Please note that some popup blockers may prevent this from happening, in which case the link will be displayed.', 'formidable' ),
3557 2550 );
3558 2551
3559 2552 if ( ! isset( $tooltips[ $name ] ) ) {
3560 2553 return;
@@ -3574,14 +2567,8 @@
3574 2567 }
3575 2568
3576 2569 /**
3577 2570 * Add the current_page class to that page in the form nav
3578 - *
3579 - * @param int|string $page
3580 - * @param int|string $current_page
3581 - * @param array $action
3582 - *
3583 - * @return void
3584 2571 */
3585 2572 public static function select_current_page( $page, $current_page, $action = array() ) {
3586 2573 if ( $current_page != $page ) {
3587 2574 return;
@@ -3587,9 +2574,8 @@
3587 2574 return;
3588 2575 }
3589 2576
3590 2577 $frm_action = self::simple_get( 'frm_action', 'sanitize_title' );
3591 -
3592 2578 if ( 'lite-reports' === $frm_action ) {
3593 2579 $frm_action = 'reports';
3594 2580 }
3595 2581
@@ -3630,15 +2616,8 @@
3630 2616
3631 2617 return $post_content;
3632 2618 }
3633 2619
3634 - /**
3635 - * @param array|string $val
3636 - * @param int|string $key
3637 - * @param array $post_content
3638 - *
3639 - * @return void
3640 - */
3641 2620 private static function prepare_action_slashes( $val, $key, &$post_content ) {
3642 2621 if ( ! isset( $post_content[ $key ] ) || is_numeric( $val ) ) {
3643 2622 return;
3644 2623 }
@@ -3657,16 +2636,12 @@
3657 2636 }
3658 2637 }
3659 2638
3660 2639 /**
3661 - * Check for either json or serialized data. This is temporary while transitioning
2640 + * Check for either json or serilized data. This is temporary while transitioning
3662 2641 * all data to json.
3663 2642 *
3664 2643 * @since 4.02.03
3665 - *
3666 - * @param array|string $value
3667 - *
3668 - * @return void
3669 2644 */
3670 2645 public static function unserialize_or_decode( &$value ) {
3671 2646 if ( is_array( $value ) ) {
3672 2647 return;
@@ -3672,9 +2647,9 @@
3672 2647 return;
3673 2648 }
3674 2649
3675 2650 if ( is_serialized( $value ) ) {
3676 - $value = self::maybe_unserialize_array( $value );
2651 + $value = maybe_unserialize( $value );
3677 2652 } else {
3678 2653 $value = self::maybe_json_decode( $value, false );
3679 2654 }
3680 2655 }
@@ -3679,43 +2654,13 @@
3679 2654 }
3680 2655 }
3681 2656
3682 2657 /**
3683 - * Safely unserialize an array if necessary.
3684 - * This function doesn't actually use unserialize. The string is parsed instead.
3685 - *
3686 - * @since 6.2
3687 - *
3688 - * @param mixed $value
3689 - *
3690 - * @return mixed
3691 - */
3692 - public static function maybe_unserialize_array( $value ) {
3693 - if ( ! is_string( $value ) ) {
3694 - return $value;
3695 - }
3696 -
3697 - // Since we only expect an array, skip anything that doesn't start with a:.
3698 - if ( ! is_serialized( $value ) || 'a:' !== substr( $value, 0, 2 ) ) {
3699 - return $value;
3700 - }
3701 -
3702 - $parsed = FrmSerializedStringParserHelper::get()->parse( $value );
3703 -
3704 - if ( is_array( $parsed ) ) {
3705 - $value = $parsed;
3706 - }
3707 -
3708 - return $value;
3709 - }
3710 -
3711 - /**
3712 2658 * Decode a JSON string.
3713 2659 * Do not switch shortcodes like [24] to array unless intentional ie XML values.
3714 2660 *
3715 2661 * @param mixed $string
3716 2662 * @param bool $single_to_array
3717 - *
3718 2663 * @return mixed
3719 2664 */
3720 2665 public static function maybe_json_decode( $string, $single_to_array = true ) {
3721 2666 if ( is_array( $string ) || is_null( $string ) ) {
@@ -3722,17 +2667,14 @@
3722 2667 return $string;
3723 2668 }
3724 2669
3725 2670 $new_string = json_decode( $string, true );
3726 -
3727 2671 if ( function_exists( 'json_last_error' ) ) {
3728 2672 // php 5.3+
3729 2673 $single_value = false;
3730 -
3731 2674 if ( ! $single_to_array ) {
3732 2675 $single_value = is_array( $new_string ) && count( $new_string ) === 1 && isset( $new_string[0] );
3733 2676 }
3734 -
3735 2677 if ( json_last_error() == JSON_ERROR_NONE && is_array( $new_string ) && ! $single_value ) {
3736 2678 $string = $new_string;
3737 2679 }
3738 2680 }
@@ -3740,45 +2682,11 @@
3740 2682 return $string;
3741 2683 }
3742 2684
3743 2685 /**
3744 - * @since 6.2.3
3745 - *
3746 - * @param string $value
3747 - *
3748 - * @return string
3749 - */
3750 - public static function maybe_utf8_encode( $value ) {
3751 - $from_format = 'ISO-8859-1';
3752 - $to_format = 'UTF-8';
3753 -
3754 - if ( function_exists( 'mb_check_encoding' ) && function_exists( 'mb_convert_encoding' ) ) {
3755 - if ( mb_check_encoding( $value, $from_format ) ) {
3756 - return mb_convert_encoding( $value, $to_format, $from_format );
3757 - }
3758 - return $value;
3759 - }
3760 -
3761 - if ( function_exists( 'iconv' ) ) {
3762 - $converted = iconv( $from_format, $to_format, $value );
3763 -
3764 - // Value is false if $value is not ISO-8859-1.
3765 - if ( false !== $converted ) {
3766 - return $converted;
3767 - }
3768 - }
3769 -
3770 - return $value;
3771 - }
3772 -
3773 - /**
3774 2686 * Reformat the json serialized array in name => value array.
3775 2687 *
3776 2688 * @since 4.02.03
3777 - *
3778 - * @param array $form
3779 - *
3780 - * @return void
3781 2689 */
3782 2690 public static function format_form_data( &$form ) {
3783 2691 $formatted = array();
3784 2692
@@ -3785,11 +2693,9 @@
3785 2693 foreach ( $form as $input ) {
3786 2694 if ( ! isset( $input['name'] ) ) {
3787 2695 continue;
3788 2696 }
3789 -
3790 2697 $key = $input['name'];
3791 -
3792 2698 if ( isset( $formatted[ $key ] ) ) {
3793 2699 if ( is_array( $formatted[ $key ] ) ) {
3794 2700 $formatted[ $key ][] = $input['value'];
3795 2701 } else {
@@ -3804,12 +2710,8 @@
3804 2710 }
3805 2711
3806 2712 /**
3807 2713 * @since 4.02.03
3808 - *
3809 - * @param array|string $value
3810 - *
3811 - * @return string
3812 2714 */
3813 2715 public static function maybe_json_encode( $value ) {
3814 2716 if ( is_array( $value ) ) {
3815 2717 $value = wp_json_encode( $value );
@@ -3817,15 +2719,12 @@
3817 2719 return $value;
3818 2720 }
3819 2721
3820 2722 /**
3821 - * Echo The javascript to open and highlight the Formidable menu
3822 - *
3823 2723 * @since 1.07.10
3824 2724 *
3825 - * @param string $post_type The name of the post type that may need to be highlighted.
3826 - *
3827 - * @return void
2725 + * @param string $post_type The name of the post type that may need to be highlighted
2726 + * echo The javascript to open and highlight the Formidable menu
3828 2727 */
3829 2728 public static function maybe_highlight_menu( $post_type ) {
3830 2729 global $post;
3831 2730
@@ -3844,12 +2743,8 @@
3844 2743 /**
3845 2744 * Load the JS file on non-Formidable pages in the admin area
3846 2745 *
3847 2746 * @since 2.0
3848 - *
3849 - * @param bool $load
3850 - *
3851 - * @return void
3852 2747 */
3853 2748 public static function load_admin_wide_js( $load = true ) {
3854 2749 $version = self::plugin_version();
3855 2750 wp_register_script( 'formidable_admin_global', self::plugin_url() . '/js/formidable_admin_global.js', array( 'jquery' ), $version );
@@ -3863,9 +2758,8 @@
3863 2758 'canAccessApplicationDashboard' => current_user_can( is_callable( 'FrmProApplicationsHelper::get_required_templates_capability' ) ? FrmProApplicationsHelper::get_required_templates_capability() : 'frm_edit_forms' ),
3864 2759 'loading' => __( 'Loading&hellip;', 'formidable' ),
3865 2760 'nonce' => wp_create_nonce( 'frm_ajax' ),
3866 2761 'proIncludesSliderJs' => is_callable( 'FrmProFormsHelper::prepare_custom_currency' ),
3867 - 'inboxSlideIn' => FrmInbox::get_inbox_slide_in_value_for_js(),
3868 2762 );
3869 2763 wp_localize_script( 'formidable_admin_global', 'frmGlobal', $global_strings );
3870 2764
3871 2765 if ( $load ) {
@@ -3874,10 +2768,8 @@
3874 2768 }
3875 2769
3876 2770 /**
3877 2771 * @since 2.0.9
3878 - *
3879 - * @return void
3880 2772 */
3881 2773 public static function load_font_style() {
3882 2774 wp_enqueue_style( 'frm_fonts', self::plugin_url() . '/css/frm_fonts.css', array(), self::plugin_version() );
3883 2775 }
@@ -3883,147 +2775,99 @@
3883 2775 }
3884 2776
3885 2777 /**
3886 2778 * @param string $location
3887 - *
3888 - * @return void
3889 2779 */
3890 2780 public static function localize_script( $location ) {
3891 - global $wp_scripts, $wp_version;
2781 + global $wp_scripts;
3892 2782
2783 + $ajax_url = admin_url( 'admin-ajax.php', is_ssl() ? 'admin' : 'http' );
2784 + $ajax_url = apply_filters( 'frm_ajax_url', $ajax_url );
2785 +
3893 2786 $script_strings = array(
3894 - 'ajax_url' => esc_url_raw( self::get_ajax_url() ),
3895 - 'images_url' => self::plugin_url() . '/images',
3896 - 'loading' => __( 'Loading&hellip;', 'formidable' ),
3897 - 'remove' => __( 'Remove', 'formidable' ),
3898 - 'offset' => apply_filters( 'frm_scroll_offset', 4 ),
3899 - 'nonce' => wp_create_nonce( 'frm_ajax' ),
3900 - 'id' => __( 'ID', 'formidable' ),
3901 - 'no_results' => __( 'No results match', 'formidable' ),
3902 - 'file_spam' => __( 'That file looks like Spam.', 'formidable' ),
3903 - 'calc_error' => __( 'There is an error in the calculation in the field with key', 'formidable' ),
3904 - 'empty_fields' => __( 'Please complete the preceding required fields before uploading a file.', 'formidable' ),
3905 - 'focus_first_error' => self::should_focus_first_error(),
3906 - 'include_alert_role' => self::should_include_alert_role_on_field_errors(),
3907 - // We need to keep this setting for a few versions because Pro checks for this.
3908 - 'include_resend_email' => false,
2787 + 'ajax_url' => $ajax_url,
2788 + 'images_url' => self::plugin_url() . '/images',
2789 + 'loading' => __( 'Loading&hellip;', 'formidable' ),
2790 + 'remove' => __( 'Remove', 'formidable' ),
2791 + 'offset' => apply_filters( 'frm_scroll_offset', 4 ),
2792 + 'nonce' => wp_create_nonce( 'frm_ajax' ),
2793 + 'id' => __( 'ID', 'formidable' ),
2794 + 'no_results' => __( 'No results match', 'formidable' ),
2795 + 'file_spam' => __( 'That file looks like Spam.', 'formidable' ),
2796 + 'calc_error' => __( 'There is an error in the calculation in the field with key', 'formidable' ),
2797 + 'empty_fields' => __( 'Please complete the preceding required fields before uploading a file.', 'formidable' ),
2798 + 'focus_first_error' => self::should_focus_first_error(),
2799 + 'include_alert_role' => self::should_include_alert_role_on_field_errors(),
3909 2800 );
3910 2801
3911 2802 $data = $wp_scripts->get_data( 'formidable', 'data' );
3912 -
3913 - if ( ! $data ) {
2803 + if ( empty( $data ) ) {
3914 2804 wp_localize_script( 'formidable', 'frm_js', $script_strings );
3915 2805 }
3916 2806
3917 - if ( $location === 'admin' ) {
2807 + if ( $location == 'admin' ) {
2808 + $frm_settings = self::get_settings();
3918 2809 $admin_script_strings = array(
3919 - 'desc' => __( '(Click to add description)', 'formidable' ),
3920 - 'blank' => __( '(Blank)', 'formidable' ),
3921 - 'no_label' => self::get_no_label_text(),
3922 - 'ok' => __( 'OK', 'formidable' ),
3923 - 'cancel' => __( 'Cancel', 'formidable' ),
3924 - 'default_label' => __( 'Default', 'formidable' ),
3925 - 'clear_default' => __( 'Clear default value when typing', 'formidable' ),
3926 - 'no_clear_default' => __( 'Do not clear default value when typing', 'formidable' ),
3927 - 'valid_default' => __( 'Default value will pass form validation', 'formidable' ),
3928 - 'no_valid_default' => __( 'Default value will NOT pass form validation', 'formidable' ),
3929 - 'confirm' => __( 'Are you sure?', 'formidable' ),
3930 - 'conf_delete' => __( 'Are you sure you want to delete this field and all data associated with it?', 'formidable' ),
3931 - 'conf_delete_sec' => __( 'All fields inside this Section will be deleted along with their data. Are you sure you want to delete this group of fields?', 'formidable' ),
3932 - 'conf_no_repeat' => __( 'Warning: If you have entries with multiple rows, all but the first row will be lost.', 'formidable' ),
3933 - 'default_unique' => FrmFieldsHelper::default_unique_msg(),
3934 - 'default_conf' => __( 'The entered values do not match', 'formidable' ),
3935 - 'enter_email' => __( 'Enter Email', 'formidable' ),
3936 - 'confirm_email' => __( 'Confirm Email', 'formidable' ),
3937 - 'conditional_text' => __( 'Conditional content here', 'formidable' ),
3938 - 'new_option' => __( 'New Option', 'formidable' ),
3939 - 'css_invalid_size' => __( 'In certain browsers (e.g. Firefox) text will not display correctly if the field height is too small relative to the field padding and text size. Please increase your field height or decrease your field padding.', 'formidable' ),
3940 - 'enter_password' => __( 'Enter Password', 'formidable' ),
3941 - 'confirm_password' => __( 'Confirm Password', 'formidable' ),
3942 - 'import_complete' => __( 'Import Complete', 'formidable' ),
3943 - 'updating' => __( 'Please wait while your site updates.', 'formidable' ),
3944 - 'no_save_warning' => __( 'Warning: There is no way to retrieve unsaved entries.', 'formidable' ),
3945 - 'private_label' => __( 'Private', 'formidable' ),
3946 - 'jquery_ui_url' => '',
3947 - 'pro_url' => is_callable( 'FrmProAppHelper::plugin_url' ) ? FrmProAppHelper::plugin_url() : '',
3948 - 'no_licenses' => __( 'No new licenses were found', 'formidable' ),
3949 - 'unmatched_parens' => __( 'This calculation has at least one unmatched ( ) { } [ ].', 'formidable' ),
3950 - 'view_shortcodes' => __( 'This calculation may have shortcodes that work in Views but not forms.', 'formidable' ),
3951 - 'text_shortcodes' => __( 'This calculation may have shortcodes that work in text calculations but not numeric calculations.', 'formidable' ),
3952 - /* translators: %d is the number of allowed actions per form */
3953 - 'only_one_action' => sprintf( __( 'This form action is limited to %d per form.', 'formidable' ), 1 ),
3954 - 'edit_action_text' => __( 'Please edit the existing form action.', 'formidable' ),
3955 - 'unsafe_params' => FrmFormsHelper::reserved_words(),
2810 + 'desc' => __( '(Click to add description)', 'formidable' ),
2811 + 'blank' => __( '(Blank)', 'formidable' ),
2812 + 'no_label' => __( '(no label)', 'formidable' ),
2813 + 'saving' => esc_attr( __( 'Saving', 'formidable' ) ),
2814 + 'saved' => esc_attr( __( 'Saved', 'formidable' ) ),
2815 + 'ok' => __( 'OK', 'formidable' ),
2816 + 'cancel' => __( 'Cancel', 'formidable' ),
2817 + 'default_label' => __( 'Default', 'formidable' ),
2818 + 'clear_default' => __( 'Clear default value when typing', 'formidable' ),
2819 + 'no_clear_default' => __( 'Do not clear default value when typing', 'formidable' ),
2820 + 'valid_default' => __( 'Default value will pass form validation', 'formidable' ),
2821 + 'no_valid_default' => __( 'Default value will NOT pass form validation', 'formidable' ),
2822 + 'caution' => __( 'Heads up', 'formidable' ),
2823 + 'confirm' => __( 'Are you sure?', 'formidable' ),
2824 + 'conf_delete' => __( 'Are you sure you want to delete this field and all data associated with it?', 'formidable' ),
2825 + 'conf_delete_sec' => __( 'All fields inside this Section will be deleted along with their data. Are you sure you want to delete this group of fields?', 'formidable' ),
2826 + 'conf_no_repeat' => __( 'Warning: If you have entries with multiple rows, all but the first row will be lost.', 'formidable' ),
2827 + 'default_unique' => $frm_settings->unique_msg,
2828 + 'default_conf' => __( 'The entered values do not match', 'formidable' ),
2829 + 'enter_email' => __( 'Enter Email', 'formidable' ),
2830 + 'confirm_email' => __( 'Confirm Email', 'formidable' ),
2831 + 'conditional_text' => __( 'Conditional content here', 'formidable' ),
2832 + 'new_option' => __( 'New Option', 'formidable' ),
2833 + 'css_invalid_size' => __( 'In certain browsers (e.g. Firefox) text will not display correctly if the field height is too small relative to the field padding and text size. Please increase your field height or decrease your field padding.', 'formidable' ),
2834 + 'enter_password' => __( 'Enter Password', 'formidable' ),
2835 + 'confirm_password' => __( 'Confirm Password', 'formidable' ),
2836 + 'import_complete' => __( 'Import Complete', 'formidable' ),
2837 + 'updating' => __( 'Please wait while your site updates.', 'formidable' ),
2838 + 'no_save_warning' => __( 'Warning: There is no way to retrieve unsaved entries.', 'formidable' ),
2839 + 'private_label' => __( 'Private', 'formidable' ),
2840 + 'jquery_ui_url' => '',
2841 + 'pro_url' => is_callable( 'FrmProAppHelper::plugin_url' ) ? FrmProAppHelper::plugin_url() : '',
2842 + 'no_licenses' => __( 'No new licenses were found', 'formidable' ),
2843 + 'unmatched_parens' => __( 'This calculation has at least one unmatched ( ) { } [ ].', 'formidable' ),
2844 + 'view_shortcodes' => __( 'This calculation may have shortcodes that work in Views but not forms.', 'formidable' ),
2845 + 'text_shortcodes' => __( 'This calculation may have shortcodes that work in text calculations but not numeric calculations.', 'formidable' ),
2846 + 'only_one_action' => __( 'This form action is limited to one per form. Please edit the existing form action.', 'formidable' ),
2847 + 'unsafe_params' => FrmFormsHelper::reserved_words(),
3956 2848 /* Translators: %s is the name of a Detail Page Slug that is a reserved word.*/
3957 - 'slug_is_reserved' => sprintf( __( 'The Detail Page Slug "%s" is reserved by WordPress. This may cause problems. Is this intentional?', 'formidable' ), '****' ),
2849 + 'slug_is_reserved' => sprintf( __( 'The Detail Page Slug "%s" is reserved by WordPress. This may cause problems. Is this intentional?', 'formidable' ), '****' ),
3958 2850 /* Translators: %s is the name of a parameter that is a reserved word. More than one word could be listed here, though that would not be common. */
3959 - 'param_is_reserved' => sprintf( __( 'The parameter "%s" is reserved by WordPress. This may cause problems when included in the URL. Is this intentional? ', 'formidable' ), '****' ),
3960 - 'reserved_words' => __( 'See the list of reserved words in WordPress.', 'formidable' ),
3961 - 'repeat_limit_min' => __( 'Please enter a Repeat Limit that is greater than 1.', 'formidable' ),
3962 - 'checkbox_limit' => __( 'Please select a limit between 0 and 200.', 'formidable' ),
3963 - 'install' => __( 'Install', 'formidable' ),
3964 - 'active' => __( 'Active', 'formidable' ),
3965 - 'installed' => __( 'Installed', 'formidable' ),
3966 - 'not_installed' => __( 'Not Installed', 'formidable' ),
3967 - 'select_a_field' => __( 'Select a Field', 'formidable' ),
3968 - 'no_items_found' => __( 'No items found.', 'formidable' ),
3969 - 'field_already_used' => __( 'Oops. You have already used that field.', 'formidable' ),
3970 -
3971 - // Deprecated in 6.0.
3972 - 'saving' => '',
3973 -
3974 - // Deprecated in 6.0.
3975 - 'saved' => '',
3976 -
3977 - // translators: %1$s: HTML open tag, %2$s: HTML end tag.
3978 - 'holdShiftMsg' => esc_html__( 'You can hold %1$sShift%2$s on your keyboard to select multiple fields', 'formidable' ),
3979 - 'noTitleText' => FrmFormsHelper::get_no_title_text(),
3980 -
3981 - // In older versions this event listener causes the section to immediately close again
3982 - // when the h3 element is clicked. It's only required in WP 6.7+.
3983 - 'requireAccordionTitleClickListener' => version_compare( $wp_version, '6.7', '>=' ),
2851 + 'param_is_reserved' => sprintf( __( 'The parameter "%s" is reserved by WordPress. This may cause problems when included in the URL. Is this intentional? ', 'formidable' ), '****' ),
2852 + 'reserved_words' => __( 'See the list of reserved words in WordPress.', 'formidable' ),
2853 + 'repeat_limit_min' => __( 'Please enter a Repeat Limit that is greater than 1.', 'formidable' ),
2854 + 'checkbox_limit' => __( 'Please select a limit between 0 and 200.', 'formidable' ),
2855 + 'install' => __( 'Install', 'formidable' ),
2856 + 'active' => __( 'Active', 'formidable' ),
2857 + 'select_a_field' => __( 'Select a Field', 'formidable' ),
2858 + 'no_items_found' => __( 'No items found.', 'formidable' ),
3984 2859 );
3985 - /**
3986 - * @param array $admin_script_strings
3987 - */
3988 2860 $admin_script_strings = apply_filters( 'frm_admin_script_strings', $admin_script_strings );
3989 2861
3990 2862 $data = $wp_scripts->get_data( 'formidable_admin', 'data' );
3991 -
3992 - if ( ! $data ) {
2863 + if ( empty( $data ) ) {
3993 2864 wp_localize_script( 'formidable_admin', 'frm_admin_js', $admin_script_strings );
3994 2865 }
3995 - }//end if
2866 + }
3996 2867 }
3997 2868
3998 2869 /**
3999 - * Get the no label text.
4000 - *
4001 - * @since 6.25.1
4002 - *
4003 - * @return string
4004 - */
4005 - public static function get_no_label_text() {
4006 - return __( '(no label)', 'formidable' );
4007 - }
4008 -
4009 - /**
4010 - * @since 6.5
4011 - *
4012 - * @return string
4013 - */
4014 - public static function get_ajax_url() {
4015 - $ajax_url = admin_url( 'admin-ajax.php', is_ssl() ? 'admin' : 'http' );
4016 -
4017 - /**
4018 - * @since 2.0.13
4019 - *
4020 - * @param string $ajax_url
4021 - */
4022 - return apply_filters( 'frm_ajax_url', $ajax_url );
4023 - }
4024 -
4025 - /**
4026 2870 * Returns whether or not the first errored input should be auto-focused (default true).
4027 2871 *
4028 2872 * @since 5.2.05
4029 2873 *
@@ -4048,11 +2892,9 @@
4048 2892 * Echo the message on the plugins listing page
4049 2893 *
4050 2894 * @since 1.07.10
4051 2895 *
4052 - * @param float $min_version The version the add-on requires.
4053 - *
4054 - * @return void
2896 + * @param float $min_version The version the add-on requires
4055 2897 */
4056 2898 public static function min_version_notice( $min_version ) {
4057 2899 $frm_version = self::plugin_version();
4058 2900
@@ -4071,10 +2913,8 @@
4071 2913 * If Pro is far outdated, show a message.
4072 2914 *
4073 2915 * @since 4.0.01
4074 2916 *
4075 - * @param string $min_version
4076 - *
4077 2917 * @return void
4078 2918 */
4079 2919 public static function min_pro_version_notice( $min_version ) {
4080 2920 if ( ! self::is_formidable_admin() ) {
@@ -4084,14 +2924,26 @@
4084 2924
4085 2925 self::php_version_notice();
4086 2926
4087 2927 $is_pro = self::pro_is_installed() && class_exists( 'FrmProDb' );
4088 -
4089 2928 if ( ! $is_pro || self::meets_min_pro_version( $min_version ) ) {
4090 2929 return;
4091 2930 }
4092 2931
4093 - include self::plugin_path() . '/classes/views/addons/min-version-notice.php';
2932 + $pro_version = FrmProDb::$plug_version;
2933 + $expired = FrmAddonsController::is_license_expired();
2934 + ?>
2935 + <div class="error frm_previous_install">
2936 + <?php
2937 + esc_html_e( 'You are running a version of Formidable Forms that may not be compatible with your version of Formidable Forms Pro.', 'formidable' );
2938 + if ( empty( $expired ) ) {
2939 + echo ' Please <a href="' . esc_url( admin_url( 'plugins.php?s=formidable%20forms%20pro' ) ) . '">update now</a>.';
2940 + } else {
2941 + echo '<br/>Please <a href="https://formidableforms.com/account/downloads/?utm_source=WordPress&utm_medium=outdated">renew now</a> to get the latest version.';
2942 + }
2943 + ?>
2944 + </div>
2945 + <?php
4094 2946 }
4095 2947
4096 2948 /**
4097 2949 * If Pro is installed, check the version number.
@@ -4096,12 +2948,8 @@
4096 2948 /**
4097 2949 * If Pro is installed, check the version number.
4098 2950 *
4099 2951 * @since 4.0.01
4100 - *
4101 - * @param string $min_version
4102 - *
4103 - * @return bool
4104 2952 */
4105 2953 public static function meets_min_pro_version( $min_version ) {
4106 2954 return ! class_exists( 'FrmProDb' ) || version_compare( FrmProDb::$plug_version, $min_version, '>=' );
4107 2955 }
@@ -4106,24 +2954,27 @@
4106 2954 return ! class_exists( 'FrmProDb' ) || version_compare( FrmProDb::$plug_version, $min_version, '>=' );
4107 2955 }
4108 2956
4109 2957 /**
4110 - * Show a message if the PHP version is below the recommendations.
2958 + * Show a message if the browser or PHP version is below the recommendations.
4111 2959 *
4112 2960 * @since 4.0.02
4113 - *
4114 - * @return void
4115 2961 */
4116 2962 private static function php_version_notice() {
4117 2963 $message = array();
2964 + if ( version_compare( phpversion(), '5.6', '<' ) ) {
2965 + $message[] = __( 'The version of PHP on your server is too low. If this is not corrected, you may see issues with Formidable Forms. Please contact your web host and ask to be updated to PHP 7.0+.', 'formidable' );
2966 + }
4118 2967
4119 - if ( version_compare( phpversion(), '7.0', '<' ) ) {
4120 - $message[] = __( 'The version of PHP on your server is too low. If this is not corrected, you may see issues with Formidable Forms. Please contact your web host and ask to be updated to PHP 7.0+.', 'formidable' );
2968 + $browser = self::get_server_value( 'HTTP_USER_AGENT' );
2969 + $is_ie = strpos( $browser, 'MSIE' ) !== false;
2970 + if ( $is_ie ) {
2971 + $message[] = __( 'You are using an outdated browser that is not compatible with Formidable Forms. Please update to a more current browser (we recommend Chrome).', 'formidable' );
4121 2972 }
4122 2973
4123 2974 foreach ( $message as $m ) {
4124 2975 ?>
4125 - <div class="frm-banner-alert frm_error_style frm_previous_install">
2976 + <div class="error frm_previous_install">
4126 2977 <?php echo esc_html( $m ); ?>
4127 2978 </div>
4128 2979 <?php
4129 2980 }
@@ -4128,26 +2979,17 @@
4128 2979 <?php
4129 2980 }
4130 2981 }
4131 2982
4132 - /**
4133 - * @param string $type
4134 - *
4135 - * @return array<string,string>
4136 - */
4137 2983 public static function locales( $type = 'date' ) {
4138 2984 $locales = array(
4139 2985 'en' => __( 'English', 'formidable' ),
4140 2986 'af' => __( 'Afrikaans', 'formidable' ),
4141 2987 'sq' => __( 'Albanian', 'formidable' ),
4142 - 'ar-DZ' => __( 'Algerian Arabic', 'formidable' ),
4143 - 'am' => __( 'Amharic', 'formidable' ),
4144 2988 'ar' => __( 'Arabic', 'formidable' ),
4145 2989 'hy' => __( 'Armenian', 'formidable' ),
4146 2990 'az' => __( 'Azerbaijani', 'formidable' ),
4147 2991 'eu' => __( 'Basque', 'formidable' ),
4148 - 'be' => __( 'Belarusian', 'formidable' ),
4149 - 'bn' => __( 'Bengali', 'formidable' ),
4150 2992 'bs' => __( 'Bosnian', 'formidable' ),
4151 2993 'bg' => __( 'Bulgarian', 'formidable' ),
4152 2994 'ca' => __( 'Catalan', 'formidable' ),
4153 2995 'zh-HK' => __( 'Chinese Hong Kong', 'formidable' ),
@@ -4166,15 +3008,12 @@
4166 3008 'fi' => __( 'Finnish', 'formidable' ),
4167 3009 'fr' => __( 'French', 'formidable' ),
4168 3010 'fr-CA' => __( 'French/Canadian', 'formidable' ),
4169 3011 'fr-CH' => __( 'French/Swiss', 'formidable' ),
4170 - 'gl' => __( 'Galician', 'formidable' ),
4171 - 'ka' => __( 'Georgian', 'formidable' ),
4172 3012 'de' => __( 'German', 'formidable' ),
4173 3013 'de-AT' => __( 'German/Austria', 'formidable' ),
4174 3014 'de-CH' => __( 'German/Switzerland', 'formidable' ),
4175 3015 'el' => __( 'Greek', 'formidable' ),
4176 - 'gu' => __( 'Gujarati', 'formidable' ),
4177 3016 'he' => __( 'Hebrew', 'formidable' ),
4178 3017 'iw' => __( 'Hebrew', 'formidable' ),
4179 3018 'hi' => __( 'Hindi', 'formidable' ),
4180 3019 'hu' => __( 'Hungarian', 'formidable' ),
@@ -4181,85 +3020,59 @@
4181 3020 'is' => __( 'Icelandic', 'formidable' ),
4182 3021 'id' => __( 'Indonesian', 'formidable' ),
4183 3022 'it' => __( 'Italian', 'formidable' ),
4184 3023 'ja' => __( 'Japanese', 'formidable' ),
4185 - 'kn' => __( 'Kannada', 'formidable' ),
4186 - 'kk' => __( 'Kazakh', 'formidable' ),
4187 - 'km' => __( 'Khmer', 'formidable' ),
4188 3024 'ko' => __( 'Korean', 'formidable' ),
4189 - 'ky' => __( 'Kyrgyz', 'formidable' ),
4190 - 'lo' => __( 'Laothian', 'formidable' ),
4191 3025 'lv' => __( 'Latvian', 'formidable' ),
4192 3026 'lt' => __( 'Lithuanian', 'formidable' ),
4193 - 'lb' => __( 'Luxembourgish', 'formidable' ),
4194 - 'mk' => __( 'Macedonian', 'formidable' ),
4195 - 'ml' => __( 'Malayalam', 'formidable' ),
4196 3027 'ms' => __( 'Malaysian', 'formidable' ),
4197 - 'mr' => __( 'Marathi', 'formidable' ),
4198 3028 'no' => __( 'Norwegian', 'formidable' ),
4199 - 'nb' => __( 'Norwegian Bokmål', 'formidable' ),
4200 - 'nn' => __( 'Norwegian Nynorsk', 'formidable' ),
4201 3029 'pl' => __( 'Polish', 'formidable' ),
4202 3030 'pt' => __( 'Portuguese', 'formidable' ),
4203 3031 'pt-BR' => __( 'Portuguese/Brazilian', 'formidable' ),
4204 3032 'pt-PT' => __( 'Portuguese/Portugal', 'formidable' ),
4205 - 'rm' => __( 'Romansh', 'formidable' ),
4206 3033 'ro' => __( 'Romanian', 'formidable' ),
4207 3034 'ru' => __( 'Russian', 'formidable' ),
4208 3035 'sr' => __( 'Serbian', 'formidable' ),
4209 3036 'sr-SR' => __( 'Serbian', 'formidable' ),
4210 - 'si' => __( 'Sinhalese', 'formidable' ),
4211 3037 'sk' => __( 'Slovak', 'formidable' ),
4212 3038 'sl' => __( 'Slovenian', 'formidable' ),
4213 3039 'es' => __( 'Spanish', 'formidable' ),
4214 3040 'es-419' => __( 'Spanish/Latin America', 'formidable' ),
4215 - 'sw' => __( 'Swahili', 'formidable' ),
4216 3041 'sv' => __( 'Swedish', 'formidable' ),
4217 3042 'ta' => __( 'Tamil', 'formidable' ),
4218 - 'te' => __( 'Telugu', 'formidable' ),
4219 3043 'th' => __( 'Thai', 'formidable' ),
4220 - 'tj' => __( 'Tajiki', 'formidable' ),
4221 3044 'tr' => __( 'Turkish', 'formidable' ),
4222 3045 'uk' => __( 'Ukrainian', 'formidable' ),
4223 - 'ur' => __( 'Urdu', 'formidable' ),
4224 3046 'vi' => __( 'Vietnamese', 'formidable' ),
4225 - 'cy-GB' => __( 'Welsh', 'formidable' ),
4226 - 'zu' => __( 'Zulu', 'formidable' ),
4227 3047 );
4228 3048
4229 3049 if ( $type === 'captcha' ) {
4230 3050 // remove the languages unavailable for the captcha
4231 - $unset = array( 'sq', 'bs', 'eo', 'fo', 'fr-CH', 'sr-SR', 'ar-DZ', 'be', 'cy-GB', 'kk', 'km', 'ky', 'lb', 'mk', 'nb', 'nn', 'rm', 'tj' );
3051 + $unset = array( 'af', 'sq', 'hy', 'az', 'eu', 'bs', 'zh-HK', 'eo', 'et', 'fo', 'fr-CH', 'he', 'is', 'ms', 'sr-SR', 'ta' );
4232 3052 } else {
4233 3053 // remove the languages unavailable for the datepicker
4234 - $unset = array( 'fil', 'fr-CA', 'de-AT', 'de-CH', 'iw', 'hi', 'pt', 'pt-PT', 'es-419', 'mr', 'lo', 'kn', 'si', 'gu', 'bn', 'zu', 'ur', 'te', 'sw', 'am' );
3054 + $unset = array( 'fil', 'fr-CA', 'de-AT', 'de-CH', 'iw', 'hi', 'pt', 'pt-PT', 'es-419' );
4235 3055 }
4236 3056
4237 3057 $locales = array_diff_key( $locales, array_flip( $unset ) );
3058 + $locales = apply_filters( 'frm_locales', $locales );
4238 3059
4239 - /**
4240 - * Filter available locale options.
4241 - *
4242 - * @since 5.4.5 Added $args parameter with type.
4243 - *
4244 - * @param array<string,string> $locales
4245 - * @param array $args {
4246 - *
4247 - * @type string $type
4248 - * }
4249 - */
4250 - $locales = apply_filters( 'frm_locales', $locales, compact( 'type' ) );
4251 -
4252 3060 return $locales;
4253 3061 }
4254 3062
4255 3063 /**
4256 - * @return string
3064 + * Output HTML containing reference text for accessibility
3065 + *
3066 + * @deprecated 5.1
4257 3067 */
3068 + public static function multiselect_accessibility() {
3069 + _deprecated_function( __METHOD__, '5.1' );
3070 + }
3071 +
4258 3072 public static function get_menu_icon_class() {
4259 3073 if ( is_callable( 'FrmProAppHelper::get_settings' ) ) {
4260 3074 $settings = FrmProAppHelper::get_settings();
4261 -
4262 3075 if ( is_object( $settings ) && ! empty( $settings->menu_icon ) ) {
4263 3076 return $settings->menu_icon;
4264 3077 }
4265 3078 }
@@ -4305,9 +3118,8 @@
4305 3118 *
4306 3119 * @since 5.0.04
4307 3120 *
4308 3121 * @param array $args The arguments.
4309 - *
4310 3122 * @return array
4311 3123 */
4312 3124 private static function fill_default_images_dropdown_args( $args ) {
4313 3125 $defaults = array(
@@ -4320,8 +3132,14 @@
4320 3132
4321 3133 $new_args['options'] = (array) $new_args['options'];
4322 3134 $new_args['input_attrs'] = (array) $new_args['input_attrs'];
4323 3135
3136 + // Set the number of columns.
3137 + $new_args['col_class'] = ceil( 12 / count( $new_args['options'] ) );
3138 + if ( $new_args['col_class'] > 6 ) {
3139 + $new_args['col_class'] = ceil( $new_args['col_class'] / 2 );
3140 + }
3141 +
4324 3142 /**
4325 3143 * Allows modifying the arguments of images_dropdown() method.
4326 3144 *
4327 3145 * @since 5.0.04
@@ -4337,9 +3155,8 @@
4337 3155 *
4338 3156 * @since 5.0.04
4339 3157 *
4340 3158 * @param array $args The arguments.
4341 - *
4342 3159 * @return string
4343 3160 */
4344 3161 private static function get_images_dropdown_input_attrs( $args ) {
4345 3162 $input_attrs = $args['input_attrs'];
@@ -4346,9 +3163,8 @@
4346 3163 $input_attrs['type'] = 'radio';
4347 3164 $input_attrs['name'] = $args['name'];
4348 3165
4349 3166 $input_attrs_str = '';
4350 -
4351 3167 foreach ( $input_attrs as $key => $input_attr ) {
4352 3168 $input_attrs_str .= ' ' . sprintf( '%s="%s"', esc_attr( $key ), esc_attr( $input_attr ) );
4353 3169 }
4354 3170
@@ -4363,23 +3179,8 @@
4363 3179 return apply_filters( 'frm_images_dropdown_input_attrs', $input_attrs_str, $args );
4364 3180 }
4365 3181
4366 3182 /**
4367 - * @since 6.7.1
4368 - *
4369 - * @param array $option Option data.
4370 - * @param array $args The arguments of images_dropdown() method.
4371 - *
4372 - * @return array
4373 - */
4374 - public static function get_images_dropdown_atts( $option, $args ) {
4375 - $image = self::get_images_dropdown_option_image( $option, $args );
4376 - $classes = self::get_images_dropdown_option_classes( $option, $args );
4377 - $custom_attrs = self::get_images_dropdown_option_html_attrs( $option, $args );
4378 - return compact( 'image', 'classes', 'custom_attrs' );
4379 - }
4380 -
4381 - /**
4382 3183 * Gets the image of each option in images_dropdown() method.
4383 3184 *
4384 3185 * @since 5.0.04
4385 3186 *
@@ -4384,9 +3185,8 @@
4384 3185 * @since 5.0.04
4385 3186 *
4386 3187 * @param array $option Option data.
4387 3188 * @param array $args The arguments of images_dropdown() method.
4388 - *
4389 3189 * @return string
4390 3190 */
4391 3191 private static function get_images_dropdown_option_image( $option, $args ) {
4392 3192 $image = self::icon_by_class(
@@ -4391,9 +3191,9 @@
4391 3191 private static function get_images_dropdown_option_image( $option, $args ) {
4392 3192 $image = self::icon_by_class(
4393 3193 'frmfont ' . $option['svg'],
4394 3194 array(
4395 - 'echo' => false,
3195 + 'echo' => false,
4396 3196 )
4397 3197 );
4398 3198
4399 3199 $args['option'] = $option;
@@ -4415,9 +3215,8 @@
4415 3215 * @since 5.0.04
4416 3216 *
4417 3217 * @param array $option Option data.
4418 3218 * @param array $args The arguments of images_dropdown() method.
4419 - *
4420 3219 * @return string
4421 3220 */
4422 3221 private static function get_images_dropdown_option_classes( $option, $args ) {
4423 3222 $classes = '';
@@ -4445,14 +3244,12 @@
4445 3244 * @since 5.0.04
4446 3245 *
4447 3246 * @param array $option Option data.
4448 3247 * @param array $args The arguments of images_dropdown() method.
4449 - *
4450 3248 * @return string
4451 3249 */
4452 3250 private static function get_images_dropdown_option_html_attrs( $option, $args ) {
4453 3251 $html_attrs = '';
4454 -
4455 3252 if ( ! empty( $option['custom_attrs'] ) && is_array( $option['custom_attrs'] ) ) {
4456 3253 $html_attrs_arr = array();
4457 3254
4458 3255 foreach ( $option['custom_attrs'] as $key => $value ) {
@@ -4515,9 +3312,8 @@
4515 3312 * @since 5.0.07
4516 3313 *
4517 3314 * @param array $values
4518 3315 * @param array $keys
4519 - *
4520 3316 * @return array
4521 3317 */
4522 3318 public static function maybe_filter_array( $values, $keys ) {
4523 3319 $allow_unfiltered_html = self::allow_unfiltered_html();
@@ -4535,16 +3331,15 @@
4535 3331 return $values;
4536 3332 }
4537 3333
4538 3334 /**
4539 - * Some back end fields allow privileged users to add scripts.
3335 + * Some back end fields allow privleged users to add scripts.
4540 3336 * A site that uses the DISALLOW_UNFILTERED_HTML always remove scripts on echo.
4541 3337 *
4542 3338 * @since 5.0.13
4543 3339 *
4544 3340 * @param string $value
4545 - * @param array|string $allowed 'all' for everything included as defaults.
4546 - *
3341 + * @param array|string $allowed 'all' for everything included as defaults
4547 3342 * @return string
4548 3343 */
4549 3344 public static function maybe_kses( $value, $allowed = 'all' ) {
4550 3345 if ( self::should_never_allow_unfiltered_html() ) {
@@ -4553,69 +3348,19 @@
4553 3348 return $value;
4554 3349 }
4555 3350
4556 3351 /**
4557 - * Check if an option attribute used in an [input] shortcode is safe.
3352 + * @since 5.0.16
4558 3353 *
4559 - * @since 6.11.2
4560 - *
4561 - * @param string $key
4562 - * @param string $context Either 'display' or 'update'. On update, we want to allow a few keys that are never displayed.
4563 - *
4564 3354 * @return bool
4565 3355 */
4566 - public static function input_key_is_safe( $key, $context = 'display' ) {
4567 - if ( 'update' === $context && in_array( $key, array( 'opt', 'label' ), true ) ) {
4568 - $safe = true;
4569 - } elseif ( 0 === strpos( $key, 'data-' ) ) {
4570 - // Allow all data attributes.
4571 - $safe = true;
4572 - } elseif ( 0 === strpos( $key, 'aria-' ) ) {
4573 - // Allow all aria attributes.
4574 - $safe = true;
4575 - } else {
4576 - $safe_keys = array(
4577 - 'class',
4578 - 'required',
4579 - 'title',
4580 - 'placeholder',
4581 - 'value',
4582 - 'readonly',
4583 - 'disabled',
4584 - 'size',
4585 - 'maxlength',
4586 - 'min',
4587 - 'max',
4588 - 'pattern',
4589 - 'step',
4590 - 'autofocus',
4591 - 'width',
4592 - 'height',
4593 - 'autocomplete',
4594 - 'tabindex',
4595 - 'role',
4596 - 'style',
4597 - );
4598 - $safe = in_array( $key, $safe_keys, true );
4599 - }//end if
4600 -
4601 - /**
4602 - * Filter the $safe value so additional keys can be allowed or disallowed.
4603 - *
4604 - * @since 6.11.2
4605 - *
4606 - * @param bool $safe True if the key is considered safe.
4607 - * @param string $key
4608 - * @param string $context Either 'display' or 'update'.
4609 - */
4610 - return (bool) apply_filters( 'frm_input_key_is_safe', $safe, $key, $context );
3356 + public static function show_landing_pages() {
3357 + return self::show_new_feature( 'landing' );
4611 3358 }
4612 3359
4613 3360 /**
4614 3361 * @since 5.0.16
4615 3362 *
4616 - * @param string $medium
4617 - *
4618 3363 * @return array
4619 3364 */
4620 3365 public static function get_landing_page_upgrade_data_params( $medium = 'landing' ) {
4621 3366 $params = array(
@@ -4622,9 +3367,8 @@
4622 3367 'medium' => $medium,
4623 3368 'upgrade' => __( 'Form Landing Pages', 'formidable' ),
4624 3369 'message' => __( 'Easily manage a landing page for your form. Upgrade to get form landing pages.', 'formidable' ),
4625 3370 'screenshot' => 'landing.png',
4626 - 'learn-more' => self::get_doc_url( 'landing-page-forms', 'form-landing-page-settings', false ),
4627 3371 );
4628 3372 return self::get_upgrade_data_params( 'landing', $params );
4629 3373 }
4630 3374
@@ -4630,10 +3374,20 @@
4630 3374
4631 3375 /**
4632 3376 * @since 5.0.17
4633 3377 *
4634 - * @param string $feature
3378 + * @param string $plugin
3379 + * @return string|false
3380 + */
3381 + private static function get_plan_required( $plugin ) {
3382 + $link = FrmAddonsController::install_link( $plugin );
3383 + return FrmFormsHelper::get_plan_required( $link );
3384 + }
3385 +
3386 + /**
3387 + * @since 5.0.17
4635 3388 *
3389 + * @param string
4636 3390 * @return bool
4637 3391 */
4638 3392 public static function show_new_feature( $feature ) {
4639 3393 $link = FrmAddonsController::install_link( $feature );
@@ -4640,21 +3394,16 @@
4640 3394 return array_key_exists( 'status', $link ) || array_key_exists( 'class', $link );
4641 3395 }
4642 3396
4643 3397 /**
4644 - * Enhances upgrade data parameters with installation link and plan requirement information.
4645 - *
4646 3398 * @since 5.0.17
4647 3399 *
4648 - * @param string $plugin The plugin slug to get installation data for.
4649 - * @param array $params Initial parameters for the upgrade data.
4650 - * @param bool $detailed Whether to include detailed information.
4651 - *
4652 - * @return array Modified parameters with installation data.
3400 + * @param string $plugin
3401 + * @param array $params
3402 + * @return array
4653 3403 */
4654 - public static function get_upgrade_data_params( $plugin, $params, $detailed = false ) {
3404 + public static function get_upgrade_data_params( $plugin, $params ) {
4655 3405 $link = FrmAddonsController::install_link( $plugin );
4656 -
4657 3406 if ( ! $link ) {
4658 3407 return $params;
4659 3408 }
4660 3409
@@ -4660,20 +3409,15 @@
4660 3409
4661 3410 if ( ! empty( $link['url'] ) && self::pro_is_installed() ) {
4662 3411 $params['oneclick'] = json_encode( $link );
4663 3412 unset( $params['message'] );
4664 -
4665 3413 if ( ! isset( $params['medium'] ) ) {
4666 3414 $params['medium'] = $plugin;
4667 3415 }
4668 3416 } else {
4669 - $params['requires'] = $params['requires'] ?? FrmFormsHelper::get_plan_required( $link );
3417 + $params['requires'] = FrmFormsHelper::get_plan_required( $link );
4670 3418 }
4671 3419
4672 - if ( $detailed ) {
4673 - $params['plugin-status'] = $link['status'] ?? '';
4674 - }
4675 -
4676 3420 return $params;
4677 3421 }
4678 3422
4679 3423 /**
@@ -4682,9 +3426,8 @@
4682 3426 *
4683 3427 * @since 5.0.17
4684 3428 *
4685 3429 * @param string $text
4686 - *
4687 3430 * @return bool
4688 3431 */
4689 3432 public static function ctype_xdigit( $text ) {
4690 3433 if ( function_exists( 'ctype_xdigit' ) ) {
@@ -4699,9 +3442,8 @@
4699 3442 * @since 5.2.01
4700 3443 */
4701 3444 public static function set_current_screen_and_hook_suffix() {
4702 3445 global $hook_suffix;
4703 -
4704 3446 if ( is_null( $hook_suffix ) ) {
4705 3447 // $hook_suffix gets used in substr so make sure it's not null. PHP 8.1 deprecates null in substr.
4706 3448 $hook_suffix = ''; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
4707 3449 }
@@ -4718,9 +3460,9 @@
4718 3460 public static function show_pill_text( $text = null ) {
4719 3461 if ( null === $text ) {
4720 3462 $text = __( 'NEW', 'formidable' );
4721 3463 }
4722 - echo '<span class="frm-meta-tag frm-new-pill">' . esc_html( $text ) . '</span>';
3464 + echo '<span class="frm-new-pill">' . esc_html( $text ) . '</span>';
4723 3465 }
4724 3466
4725 3467 /**
4726 3468 * Count the number of decimals digits.
@@ -4727,10 +3469,9 @@
4727 3469 *
4728 3470 * @since 5.2.07
4729 3471 *
4730 3472 * @param mixed $num Number.
4731 - *
4732 - * @return false|int Returns `false` if the passed parameter is not number.
3473 + * @return int|false Returns `false` if the passed parameter is not number.
4733 3474 */
4734 3475 public static function count_decimals( $num ) {
4735 3476 if ( ! is_numeric( $num ) ) {
4736 3477 return false;
@@ -4737,9 +3478,8 @@
4737 3478 }
4738 3479
4739 3480 $num = (string) $num;
4740 3481 $parts = explode( '.', $num );
4741 -
4742 3482 if ( 1 === count( $parts ) ) {
4743 3483 return 0;
4744 3484 }
4745 3485
@@ -4762,9 +3502,9 @@
4762 3502 }
4763 3503
4764 3504 add_filter(
4765 3505 'option_gmt_offset',
4766 - function ( $offset ) {
3506 + function( $offset ) {
4767 3507 if ( ! is_string( $offset ) || is_numeric( $offset ) ) {
4768 3508 // Leave a valid value alone.
4769 3509 return $offset;
4770 3510 }
@@ -4800,285 +3540,221 @@
4800 3540 return array( 'list', 'trash', 'untrash', 'destroy' );
4801 3541 }
4802 3542
4803 3543 /**
4804 - * Safely call get_plugins, importing the required files if they are not yet loaded.
4805 - *
4806 - * @since 5.5
4807 - *
4808 - * @return array
3544 + * @since 4.08
3545 + * @deprecated 4.09.01
4809 3546 */
4810 - public static function get_plugins() {
4811 - if ( ! function_exists( 'get_plugins' ) ) {
4812 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
3547 + public static function expiring_message() {
3548 + _deprecated_function( __METHOD__, '4.09.01', 'FrmProAddonsController::expiring_message' );
3549 + if ( is_callable( 'FrmProAddonsController::expiring_message' ) ) {
3550 + FrmProAddonsController::expiring_message();
4813 3551 }
4814 - return get_plugins();
4815 3552 }
4816 3553
4817 3554 /**
4818 - * Make sure that the file we're trying to load is in fact the expected file type, and that it's coming from our S3 bucket.
4819 - * This is to make sure that the URL can't be exploited for a SSRF attack.
3555 + * Use the WP 4.7 wp_doing_ajax function
4820 3556 *
4821 - * @since 5.5.5
4822 - *
4823 - * @param string $url
4824 - * @param string $expected_extension
4825 - *
4826 - * @return bool
3557 + * @since 2.05.07
3558 + * @deprecated 4.04.04
4827 3559 */
4828 - public static function validate_url_is_in_s3_bucket( $url, $expected_extension ) {
4829 - $file_is_in_expected_s3_bucket = 0 === strpos( $url, 'https://s3.amazonaws.com/fp.strategy11.com' );
3560 + public static function wp_doing_ajax() {
3561 + _deprecated_function( __METHOD__, '4.04.04', 'wp_doing_ajax' );
3562 + return wp_doing_ajax();
3563 + }
4830 3564
4831 - if ( ! $file_is_in_expected_s3_bucket ) {
4832 - return false;
4833 - }
4834 -
4835 - $parsed = parse_url( $url );
4836 -
4837 - if ( ! is_array( $parsed ) ) {
4838 - // URL is malformed.
4839 - return false;
4840 - }
4841 -
4842 - $path = $parsed['path'];
4843 - $ext = pathinfo( $path, PATHINFO_EXTENSION );
4844 -
4845 - if ( $expected_extension !== $ext ) {
4846 - // The URL isn't to an XML file.
4847 - return false;
4848 - }
4849 -
4850 - return true;
3565 + /**
3566 + * @deprecated 4.0
3567 + */
3568 + public static function insert_opt_html( $args ) {
3569 + _deprecated_function( __METHOD__, '4.0', 'FrmFormsHelper::insert_opt_html' );
3570 + FrmFormsHelper::insert_opt_html( $args );
4851 3571 }
4852 3572
4853 3573 /**
4854 - * Display a dismissable warning message and save its dismissal state.
3574 + * Used to filter shortcode in text widgets
4855 3575 *
4856 - * @since 6.3
4857 - *
4858 - * @param string $message The warning message to display.
4859 - * @param string $option The unique identifier for the dismissal state of the message and the WP Ajax action.
4860 - *
4861 - * @return void
3576 + * @deprecated 2.5.4
3577 + * @codeCoverageIgnore
4862 3578 */
4863 - public static function add_dismissable_warning_message( $message = '', $option = '' ) {
4864 - if ( ! $message || ! $option ) {
4865 - return;
4866 - }
3579 + public static function widget_text_filter_callback( $matches ) {
3580 + return FrmDeprecated::widget_text_filter_callback( $matches );
3581 + }
4867 3582
4868 - $ajax_callback = function () use ( $option ) {
4869 - self::dismiss_warning_message( $option );
4870 - };
4871 -
4872 - // We're handling JS codes with `doJsonPost` and it adds 'frm_' to the beginning of the action.
4873 - // To prevent any issues, we add 'frm_' from the beginning of the action.
4874 - add_action( 'wp_ajax_frm_' . $option, $ajax_callback );
4875 -
4876 - add_filter(
4877 - 'frm_message_list',
4878 - function ( $show_messages ) use ( $message, $option ) {
4879 - if ( get_option( $option, false ) ) {
4880 - return $show_messages;
4881 - }
4882 -
4883 - $dismiss_icon = self::icon_by_class(
4884 - 'frmfont frm_close_icon',
4885 - array(
4886 - 'aria-label' => _x( 'Dismiss', 'warning message: close icon label', 'formidable' ),
4887 - 'echo' => false,
4888 - )
4889 - );
4890 -
4891 - $show_messages[] = $message;
4892 - $show_messages[] = '<span class="frm-warning-dismiss frmsvg" data-action="' . esc_attr( $option ) . '">' . $dismiss_icon . '</span>';
4893 -
4894 - return $show_messages;
4895 - }
4896 - );
3583 + /**
3584 + * @deprecated 3.01
3585 + * @codeCoverageIgnore
3586 + */
3587 + public static function sanitize_array( &$values ) {
3588 + FrmDeprecated::sanitize_array( $values );
4897 3589 }
4898 3590
4899 3591 /**
4900 - * Dismiss a warning message and update the dismissal state.
3592 + * @param array $settings
3593 + * @param string $group
4901 3594 *
4902 - * @since 6.3
4903 - *
4904 - * @param string $option The unique identifier for the dismissal state of the message.
4905 - *
4906 - * @return void
3595 + * @since 2.0.6
3596 + * @deprecated 2.05.06
3597 + * @codeCoverageIgnore
4907 3598 */
4908 - public static function dismiss_warning_message( $option = '' ) {
4909 - self::permission_check( 'frm_change_settings' );
4910 - check_ajax_referer( 'frm_ajax', 'nonce' );
3599 + public static function save_settings( $settings, $group ) {
3600 + return FrmDeprecated::save_settings( $settings, $group );
3601 + }
4911 3602
4912 - if ( $option ) {
4913 - update_option( $option, true, 'no' );
4914 - }
4915 -
4916 - wp_send_json_success();
3603 + /**
3604 + * @since 2.0.4
3605 + * @deprecated 2.05.06
3606 + * @codeCoverageIgnore
3607 + */
3608 + public static function save_json_post( $settings ) {
3609 + return FrmDeprecated::save_json_post( $settings );
4917 3610 }
4918 3611
4919 3612 /**
4920 - * Lite license copy.
4921 - * Used in FrmDashboardController & FrmSettingsController
3613 + * @since 2.0
3614 + * @deprecated 2.05.06
3615 + * @codeCoverageIgnore
4922 3616 *
4923 - * @since 6.8
3617 + * @param string $cache_key The unique name for this cache
3618 + * @param string $group The name of the cache group
3619 + * @param string $query If blank, don't run a db call
3620 + * @param string $type The wpdb function to use with this query
4924 3621 *
4925 - * @return string
3622 + * @return mixed $results The cache or query results
4926 3623 */
4927 - public static function copy_for_lite_license() {
4928 - $message = __( 'You\'re using Formidable Forms Lite - no license needed. Enjoy!', 'formidable' ) . ' 🙂';
3624 + public static function check_cache( $cache_key, $group = '', $query = '', $type = 'get_var', $time = 300 ) {
3625 + return FrmDeprecated::check_cache( $cache_key, $group, $query, $type, $time );
3626 + }
4929 3627
4930 - return apply_filters( 'frm_license_type_text', $message );
3628 + /**
3629 + * @deprecated 2.05.06
3630 + * @codeCoverageIgnore
3631 + */
3632 + public static function set_cache( $cache_key, $results, $group = '', $time = 300 ) {
3633 + return FrmDeprecated::set_cache( $cache_key, $results, $group, $time );
4931 3634 }
4932 3635
4933 3636 /**
4934 - * Removes scripts that are unnecessarily loaded across the pages!
4935 - *
4936 - * @since 6.9
4937 - *
4938 - * @return void
3637 + * @deprecated 2.05.06
3638 + * @codeCoverageIgnore
4939 3639 */
4940 - public static function dequeue_extra_global_scripts() {
4941 - wp_dequeue_script( 'frm-surveys-admin' );
4942 - wp_dequeue_script( 'frm-quizzes-form-action' );
3640 + public static function add_key_to_group_cache( $key, $group ) {
3641 + FrmDeprecated::add_key_to_group_cache( $key, $group );
4943 3642 }
4944 3643
4945 3644 /**
4946 - * Shows tooltip icon.
4947 - *
4948 - * @since 6.12
4949 - *
4950 - * @param string $tooltip_text Tooltip text.
4951 - * @param array $atts Tooltip wrapper HTML attributes.
4952 - *
4953 - * @return void
3645 + * @deprecated 2.05.06
3646 + * @codeCoverageIgnore
4954 3647 */
4955 - public static function tooltip_icon( $tooltip_text, $atts = array() ) {
4956 - $atts['title'] = $tooltip_text;
3648 + public static function get_group_cached_keys( $group ) {
3649 + return FrmDeprecated::get_group_cached_keys( $group );
3650 + }
4957 3651
4958 - if ( isset( $atts['class'] ) ) {
4959 - $atts['class'] .= ' frm_help';
4960 - } else {
4961 - $atts['class'] = 'frm_help';
4962 - }
4963 - ?>
4964 - <span <?php self::array_to_html_params( $atts, true ); ?>>
4965 - <?php self::icon_by_class( 'frmfont frm_tooltip_icon' ); ?>
4966 - </span>
4967 - <?php
3652 + /**
3653 + * @since 2.0
3654 + * @deprecated 2.05.06
3655 + * @codeCoverageIgnore
3656 + * @return mixed The cached value or false
3657 + */
3658 + public static function check_cache_and_transient( $cache_key ) {
3659 + return FrmDeprecated::check_cache( $cache_key );
4968 3660 }
4969 3661
4970 3662 /**
4971 - * Prints errors for settings in onboarding wizard or template settings.
3663 + * @since 2.0
3664 + * @deprecated 2.05.06
3665 + * @codeCoverageIgnore
4972 3666 *
4973 - * @since 6.15
4974 - *
4975 - * @param array $args Args.
4976 - *
4977 - * @return void
3667 + * @param string $cache_key
4978 3668 */
4979 - public static function print_setting_error( $args ) {
4980 - $args = wp_parse_args(
4981 - $args,
4982 - array(
4983 - 'id' => '',
4984 - 'errors' => array(),
4985 - 'class' => '',
4986 - )
4987 - );
4988 -
4989 - $args['class'] .= ' frm-validation-error frm-mt-xs frm_hidden';
4990 - ?>
4991 - <span id="<?php echo esc_attr( $args['id'] ); ?>" class="<?php echo esc_attr( $args['class'] ); ?>">
4992 - <?php
4993 - if ( is_array( $args['errors'] ) ) {
4994 - foreach ( $args['errors'] as $key => $msg ) {
4995 - ?>
4996 - <span frm-error="<?php echo esc_attr( $key ); ?>"><?php echo esc_html( $msg ); ?></span>
4997 - <?php
4998 - }
4999 - } else {
5000 - echo '<span>' . esc_html( $args['errors'] ) . '</span>';
5001 - }
5002 - ?>
5003 - </span>
5004 - <?php
3669 + public static function delete_cache_and_transient( $cache_key, $group = 'default' ) {
3670 + FrmDeprecated::delete_cache_and_transient( $cache_key, $group );
5005 3671 }
5006 3672
5007 3673 /**
5008 - * Check if GDPR is enabled.
3674 + * @since 2.0
3675 + * @deprecated 2.05.06
3676 + * @codeCoverageIgnore
5009 3677 *
5010 - * @since 6.19
5011 - *
5012 - * @return bool
3678 + * @param string $group The name of the cache group
5013 3679 */
5014 - public static function is_gdpr_enabled() {
5015 - $frm_settings = self::get_settings();
5016 - return $frm_settings->enable_gdpr || $frm_settings->no_ips || $frm_settings->custom_header_ip || $frm_settings->no_gdpr_cookies;
3680 + public static function cache_delete_group( $group ) {
3681 + FrmDeprecated::cache_delete_group( $group );
5017 3682 }
5018 3683
5019 3684 /**
5020 - * Check if GDPR cookies are disabled.
3685 + * @since 1.07.10
3686 + * @deprecated 2.05.06
3687 + * @codeCoverageIgnore
5021 3688 *
5022 - * @since 6.19
3689 + * @param string $term The value to escape
5023 3690 *
5024 - * @return bool
3691 + * @return string The escaped value
5025 3692 */
5026 - public static function no_gdpr_cookies() {
5027 - $frm_settings = self::get_settings();
5028 - return $frm_settings->enable_gdpr && $frm_settings->no_gdpr_cookies;
3693 + public static function esc_like( $term ) {
3694 + return FrmDeprecated::esc_like( $term );
5029 3695 }
5030 3696
5031 3697 /**
5032 - * Check if a string is valid UTF-8.
3698 + * @param string $order_query
5033 3699 *
5034 - * @since 6.24
5035 - *
5036 - * @param string $string The string to check.
5037 - *
5038 - * @return bool
3700 + * @deprecated 2.05.06
3701 + * @codeCoverageIgnore
5039 3702 */
5040 - public static function is_valid_utf8( $string ) {
5041 - // wp_is_valid_utf8 is added in WP 6.9.
5042 - if ( function_exists( 'wp_is_valid_utf8' ) ) {
5043 - return wp_is_valid_utf8( $string );
5044 - }
3703 + public static function esc_order( $order_query ) {
3704 + return FrmDeprecated::esc_order( $order_query );
3705 + }
5045 3706
5046 - // As of WP 6.9, seems_utf8 is deprecated.
5047 - if ( function_exists( 'seems_utf8' ) ) {
5048 - return seems_utf8( $string );
5049 - }
5050 - return false;
3707 + /**
3708 + * @deprecated 2.05.06
3709 + * @codeCoverageIgnore
3710 + */
3711 + public static function esc_order_by( &$order_by ) {
3712 + FrmDeprecated::esc_order_by( $order_by );
5051 3713 }
5052 3714
5053 3715 /**
5054 - * Get a documentation URL with UTM parameters and affiliate tracking.
3716 + * @param string $limit
5055 3717 *
5056 - * @since 6.26
5057 - *
5058 - * @param string $path The relative path to append to the base URL.
5059 - * @param string $campaign The campaign to use for UTM parameters.
5060 - * @param bool $add_kb_base Whether to prepend 'knowledgebase/' to the path. Default true.
5061 - *
5062 - * @return string The processed URL with UTM parameters and affiliate tracking.
3718 + * @deprecated 2.05.06
3719 + * @codeCoverageIgnore
5063 3720 */
5064 - public static function get_doc_url( $path, $campaign, $add_kb_base = true ) {
5065 - $path = trim( $path, '/' );
3721 + public static function esc_limit( $limit ) {
3722 + return FrmDeprecated::esc_limit( $limit );
3723 + }
5066 3724
5067 - if ( $add_kb_base ) {
5068 - $path = 'knowledgebase/' . $path;
5069 - }
3725 + /**
3726 + * @since 2.0
3727 + * @deprecated 2.05.06
3728 + * @codeCoverageIgnore
3729 + */
3730 + public static function prepare_array_values( $array, $type = '%s' ) {
3731 + return FrmDeprecated::prepare_array_values( $array, $type );
3732 + }
5070 3733
5071 - return self::maybe_add_missing_utm( 'https://formidableforms.com/' . $path, array( 'campaign' => $campaign ) );
3734 + /**
3735 + * @deprecated 2.05.06
3736 + * @codeCoverageIgnore
3737 + */
3738 + public static function prepend_and_or_where( $starts_with = ' WHERE ', $where = '' ) {
3739 + return FrmDeprecated::prepend_and_or_where( $starts_with, $where );
5072 3740 }
5073 3741
5074 3742 /**
5075 - * @since 5.0.16
5076 - * @deprecated 6.26
3743 + * @since 2.0
3744 + * @deprecated 5.0.13
5077 3745 *
5078 - * @return bool
3746 + * @return string The base Google APIS url for the current version of jQuery UI
5079 3747 */
5080 - public static function show_landing_pages() {
5081 - _deprecated_function( __METHOD__, '6.26' );
5082 - return true;
3748 + public static function jquery_ui_base_url() {
3749 + _deprecated_function( __FUNCTION__, '5.0.13', 'FrmProAppHelper::jquery_ui_base_url' );
3750 + return is_callable( 'FrmProAppHelper::jquery_ui_base_url' ) ? FrmProAppHelper::jquery_ui_base_url() : '';
3751 + }
3752 +
3753 + /**
3754 + * @since 4.07
3755 + * @deprecated x.x
3756 + */
3757 + public static function renewal_message() {
3758 + _deprecated_function( __METHOD__, 'x.x', 'FrmProAddonsController::renewal_message' );
5083 3759 }
5084 3760 }