PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 6.20
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v6.20
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
formidable / classes / helpers / FrmStylesHelper.php

FrmStylesHelper.php in Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More 6.20, at classes/helpers/FrmStylesHelper.php

1,013 lines 27.1 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 if ( ! defined( 'ABSPATH' ) ) {
3 die( 'You are not allowed to call this page directly.' );
4 }
5
6 class FrmStylesHelper {
7
8 public static function get_upload_base() {
9 $uploads = wp_upload_dir();
10 if ( is_ssl() && ! preg_match( '/^https:\/\/.*\..*$/', $uploads['baseurl'] ) ) {
11 $uploads['baseurl'] = str_replace( 'http://', 'https://', $uploads['baseurl'] );
12 }
13
14 return $uploads;
15 }
16
17 /**
18 * Called from the admin header.
19 *
20 * @since 4.0
21 */
22 public static function save_button() {
23 ?>
24 <input type="submit" name="submit" class="button button-primary frm-button-primary" value="<?php esc_attr_e( 'Update', 'formidable' ); ?>" />
25 <?php
26 }
27
28 /**
29 * @since 2.05
30 */
31 public static function get_css_label_positions() {
32 return array(
33 'none' => __( 'top', 'formidable' ),
34 'left' => __( 'left', 'formidable' ),
35 'right' => __( 'right', 'formidable' ),
36 'no_label' => __( 'none', 'formidable' ),
37 'inside' => __( 'inside', 'formidable' ),
38 );
39 }
40
41 /**
42 * @since 6.11 Added $field param.
43 *
44 * @param array|object $field
45 *
46 * @return array
47 */
48 public static function get_single_label_positions( $field = array() ) {
49 $label_positions = array(
50 'top' => __( 'Top', 'formidable' ),
51 'left' => __( 'Left', 'formidable' ),
52 'right' => __( 'Right', 'formidable' ),
53 'inline' => __( 'Inline (left without a set width)', 'formidable' ),
54 'none' => __( 'None', 'formidable' ),
55 'hidden' => __( 'Hidden (but leave the space)', 'formidable' ),
56 'inside' => __( 'Placeholder inside the field', 'formidable' ),
57 );
58
59 /**
60 * Allows updating label positions in field settings.
61 *
62 * @since 6.11
63 *
64 * @param array $label_positions
65 * @param array|object $field
66 */
67 return apply_filters( 'frm_single_label_positions', $label_positions, $field );
68 }
69
70 public static function minus_icons() {
71 return array(
72 0 => array(
73 '-' => '62e',
74 '+' => '62f',
75 ),
76 1 => array(
77 '-' => '600',
78 '+' => '602',
79 ),
80 2 => array(
81 '-' => '604',
82 '+' => '603',
83 ),
84 3 => array(
85 '-' => '633',
86 '+' => '632',
87 ),
88 4 => array(
89 '-' => '613',
90 '+' => '60f',
91 ),
92 );
93 }
94
95 public static function arrow_icons() {
96 $minus_icons = self::minus_icons();
97
98 return array(
99 6 => array(
100 '-' => '62d',
101 '+' => '62a',
102 ),
103 0 => array(
104 '-' => '60d',
105 '+' => '609',
106 ),
107 1 => array(
108 '-' => '60e',
109 '+' => '60c',
110 ),
111 2 => array(
112 '-' => '630',
113 '+' => '631',
114 ),
115 3 => array(
116 '-' => '62b',
117 '+' => '628',
118 ),
119 4 => array(
120 '-' => '62c',
121 '+' => '629',
122 ),
123 5 => array(
124 '-' => '635',
125 '+' => '634',
126 ),
127 'p0' => $minus_icons[0],
128 'p1' => $minus_icons[1],
129 'p2' => $minus_icons[2],
130 'p3' => $minus_icons[3],
131 'p4' => $minus_icons[4],
132 );
133 }
134
135 /**
136 * @since 2.0
137 * @return string The class for this icon.
138 */
139 public static function icon_key_to_class( $key, $icon = '+', $type = 'arrow' ) {
140 if ( 'arrow' === $type && is_numeric( $key ) ) {
141 // frm_arrowup6_icon.
142 $arrow = array(
143 '-' => 'down',
144 '+' => 'up',
145 );
146 $class = 'frm_arrow' . $arrow[ $icon ];
147 } else {
148 // frm_minus1_icon.
149 $key = str_replace( 'p', '', $key );
150 $plus = array(
151 '-' => 'minus',
152 '+' => 'plus',
153 );
154 $class = 'frm_' . $plus[ $icon ];
155 }
156
157 if ( $key ) {
158 $class .= $key;
159 }
160 $class .= '_icon';
161
162 return $class;
163 }
164
165 /**
166 * @param WP_Post $style
167 * @param FrmStyle $frm_style
168 * @param string $type
169 * @return void
170 */
171 public static function bs_icon_select( $style, $frm_style, $type = 'arrow' ) {
172 $function_name = $type . '_icons';
173 $icons = self::$function_name();
174 unset( $function_name );
175
176 $name = 'arrow' === $type ? 'collapse_icon' : 'repeat_icon';
177 ?>
178 <div class="btn-group" id="frm_<?php echo esc_attr( $name ); ?>_select">
179 <button class="multiselect dropdown-toggle btn btn-default" data-toggle="dropdown" type="button">
180 <?php FrmAppHelper::icon_by_class( 'frmfont ' . self::icon_key_to_class( $style->post_content[ $name ], '+', $type ) ); ?>
181 <?php FrmAppHelper::icon_by_class( 'frmfont ' . self::icon_key_to_class( $style->post_content[ $name ], '-', $type ) ); ?>
182 <b class="caret"></b>
183 </button>
184 <ul class="multiselect-container frm-dropdown-menu">
185 <?php foreach ( $icons as $key => $icon ) { ?>
186 <li <?php echo $style->post_content['collapse_icon'] == $key ? 'class="active"' : ''; ?>>
187 <a href="javascript:void(0);">
188 <label>
189 <input type="radio" value="<?php echo esc_attr( $key ); ?>" name="<?php echo esc_attr( $frm_style->get_field_name( $name ) ); ?>" <?php checked( $style->post_content[ $name ], $key ); ?> />
190 <span>
191 <?php
192 FrmAppHelper::icon_by_class( 'frmfont ' . self::icon_key_to_class( $key, '+', $type ) );
193 FrmAppHelper::icon_by_class( 'frmfont ' . self::icon_key_to_class( $key, '-', $type ) );
194 ?>
195 </span>
196 </label>
197 </a>
198 </li>
199 <?php } ?>
200 </ul>
201 </div>
202 <?php
203 }
204
205 /**
206 * Convert a color setting to a RGB CSV (without the rgb()/rgba() wrapper).
207 *
208 * @since 2.0
209 *
210 * @param string $color Color setting value. This could be hex or rgb.
211 * @return string RGB value without the rgb() wrapper.
212 */
213 public static function hex2rgb( $color ) {
214 if ( 0 === strpos( $color, 'rgb' ) ) {
215 $rgb = self::get_rgb_array_from_rgb( $color );
216 } else {
217 $rgb = self::get_rgb_array_from_hex( $color );
218 }
219 return implode( ',', $rgb );
220 }
221
222 /**
223 * Remove the rgb()/rgba() wrapper from a RGB color and return its R, G and B values as an array.
224 *
225 * @since 6.8.3
226 *
227 * @param string $rgb RGB value including the rgb() or rgba() wrapper.
228 * @return array<string> including three numeric values for R, G, and B.
229 */
230 private static function get_rgb_array_from_rgb( $rgb ) {
231 $rgb = str_replace( array( 'rgb(', 'rgba(', ')' ), '', $rgb );
232 $rgb = explode( ',', $rgb );
233 if ( 4 === count( $rgb ) ) {
234 // Drop the alpha. The function is expected to only return r,g,b with no alpha.
235 array_pop( $rgb );
236 }
237 return $rgb;
238 }
239
240 /**
241 * Get the R, G, and B array values from a Hex color code.
242 *
243 * @since 6.8.3
244 *
245 * @param string $hex A hex color string.
246 * @return array<string> Including three numeric values for R, G, and B.
247 */
248 private static function get_rgb_array_from_hex( $hex ) {
249 $hex = str_replace( '#', '', $hex );
250 list( $r, $g, $b ) = sscanf( $hex, '%02x%02x%02x' );
251 return array( $r, $g, $b );
252 }
253
254 /**
255 * @since 4.0
256 */
257 public static function hex2rgba( $hex, $a ) {
258 $rgb = self::hex2rgb( $hex );
259
260 return 'rgba(' . $rgb . ',' . $a . ')';
261 }
262
263 /**
264 * @since 6.0
265 *
266 * @param string $rgba Color setting value. This could be hex or rgb.
267 * @return string Hex color value.
268 */
269 private static function rgb_to_hex( $rgba ) {
270 if ( strpos( $rgba, '#' ) === 0 ) {
271 // Color is already hex.
272 return $rgba;
273 }
274 preg_match( '/^rgba?[\s+]?\([\s+]?(\d+)[\s+]?,[\s+]?(\d+)[\s+]?,[\s+]?(\d+)[\s+]?/i', $rgba, $by_color );
275 return sprintf( '%02x%02x%02x', $by_color[1], $by_color[2], $by_color[3] );
276 }
277
278 /**
279 * @since 6.8
280 *
281 * @param string $hsl
282 * @return string|null Null if it fails to parse the HSL string.
283 */
284 private static function hsl_to_hex( $hsl ) {
285 // Convert hsla to hsl.
286 $hsl = preg_replace( '/hsla\((\d+),\s*([\d.]+)%,\s*([\d.]+)%,\s*([\d.]+)\)/', 'hsl($1, $2%, $3%)', $hsl );
287
288 // Extract HSL components from the color string.
289 preg_match( '/hsl\((\d+),\s*(\d+)%,\s*(\d+)%\)/', $hsl, $matches );
290
291 if ( count( $matches ) !== 4 ) {
292 // Invalid HSL string format.
293 return null;
294 }
295
296 // Extract HSL values.
297 $h = (int) $matches[1];
298 $s = (int) $matches[2] / 100;
299 $l = (int) $matches[3] / 100;
300
301 // Calculate RGB values.
302 $c = ( 1 - abs( 2 * $l - 1 ) ) * $s;
303 $x = $c * ( 1 - abs( ( (int) ( $h / 60 ) % 2 ) - 1 ) );
304 $m = $l - $c / 2;
305 $r = 0;
306 $g = 0;
307 $b = 0;
308
309 if ( $h >= 0 && $h < 60 ) {
310 $r = $c;
311 $g = $x;
312 } elseif ( $h >= 60 && $h < 120 ) {
313 $r = $x;
314 $g = $c;
315 } elseif ( $h >= 120 && $h < 180 ) {
316 $g = $c;
317 $b = $x;
318 } elseif ( $h >= 180 && $h < 240 ) {
319 $g = $x;
320 $b = $c;
321 } elseif ( $h >= 240 && $h < 300 ) {
322 $r = $x;
323 $b = $c;
324 } elseif ( $h >= 300 && $h < 360 ) {
325 $r = $c;
326 $b = $x;
327 }//end if
328
329 // Convert RGB to 8-bit values
330 $r = round( ( $r + $m ) * 255 );
331 $g = round( ( $g + $m ) * 255 );
332 $b = round( ( $b + $m ) * 255 );
333
334 // Convert RGB to hex
335 $hex = sprintf( '%02x%02x%02x', $r, $g, $b );
336
337 return $hex;
338 }
339
340 /**
341 * @since 2.3
342 * @param string $hex string The original color in hex format #ffffff.
343 * @param int $steps integer Should be between -255 and 255. Negative = darker, positive = lighter.
344 */
345 public static function adjust_brightness( $hex, $steps ) {
346 $steps = max( - 255, min( 255, $steps ) );
347
348 if ( 0 === strpos( $hex, 'rgba(' ) ) {
349 $rgba = str_replace( ')', '', str_replace( 'rgba(', '', $hex ) );
350 list ( $r, $g, $b, $a ) = array_map( 'trim', explode( ',', $rgba ) );
351 $r = max( 0, min( 255, $r + $steps ) );
352 $g = max( 0, min( 255, $g + $steps ) );
353 $b = max( 0, min( 255, $b + $steps ) );
354 return 'rgba(' . $r . ',' . $g . ',' . $b . ',' . $a . ')';
355 }
356
357 // Normalize into a six character long hex string
358 $hex = str_replace( '#', '', $hex );
359 self::fill_hex( $hex );
360
361 // Split into three parts: R, G and B
362 $color_parts = str_split( $hex, 2 );
363 $return = '#';
364
365 foreach ( $color_parts as $color ) {
366 // Convert to decimal.
367 $color = hexdec( $color );
368 // Adjust color.
369 $color = max( 0, min( 255, $color + $steps ) );
370
371 // Make two char hex code.
372 $return .= str_pad( dechex( $color ), 2, '0', STR_PAD_LEFT );
373 }
374
375 return $return;
376 }
377
378 /**
379 * @since 6.0
380 *
381 * @param string $color
382 * @return int
383 */
384 public static function get_color_brightness( $color ) {
385 if ( 0 === strpos( $color, 'rgb' ) ) {
386 $color = self::rgb_to_hex( $color );
387 }
388
389 if ( 0 === strpos( $color, 'hsl' ) ) {
390 $hsl_to_hex = self::hsl_to_hex( $color );
391 if ( is_null( $hsl_to_hex ) ) {
392 // Fallback if we cannot convert the HSL value.
393 return 0;
394 }
395 $color = $hsl_to_hex;
396 }
397
398 self::fill_hex( $color );
399
400 $c_r = hexdec( substr( $color, 0, 2 ) );
401 $c_g = hexdec( substr( $color, 2, 2 ) );
402 $c_b = hexdec( substr( $color, 4, 2 ) );
403 $brightness = ( ( $c_r * 299 ) + ( $c_g * 587 ) + ( $c_b * 114 ) ) / 1000;
404
405 return $brightness;
406 }
407
408 /**
409 * Change a 3 character hex color to a 6 character one.
410 *
411 * @since 6.0
412 *
413 * @return void
414 */
415 private static function fill_hex( &$color ) {
416 if ( 3 === strlen( $color ) ) {
417 $color = $color[0] . $color[0] . $color[1] . $color[1] . $color[2] . $color[2];
418 }
419 }
420
421 /**
422 * @since 4.05.02
423 */
424 public static function get_css_vars( $vars = array() ) {
425 $vars = apply_filters( 'frm_css_vars', $vars );
426 return array_unique( $vars );
427 }
428
429 /**
430 * @since 4.05.02
431 */
432 public static function output_vars( $settings, $defaults = array(), $vars = array() ) {
433 if ( empty( $vars ) ) {
434 $vars = self::get_css_vars( array_keys( $settings ) );
435 }
436 $remove = array( 'remove_box_shadow', 'remove_box_shadow_active', 'theme_css', 'theme_name', 'theme_selector', 'important_style', 'submit_style', 'collapse_icon', 'center_form', 'custom_css', 'style_class', 'submit_bg_img', 'change_margin', 'repeat_icon', 'use_base_font_size' );
437 $vars = array_diff( $vars, $remove );
438
439 foreach ( $vars as $var ) {
440 if ( ! isset( $settings[ $var ] ) || ! self::css_key_is_valid( $var ) ) {
441 continue;
442 }
443 if ( ! isset( $defaults[ $var ] ) ) {
444 $defaults[ $var ] = '';
445 }
446 $show = empty( $defaults ) || ( $settings[ $var ] !== '' && $settings[ $var ] !== $defaults[ $var ] );
447 if ( $show && self::css_value_is_valid( $settings[ $var ] ) ) {
448 echo '--' . esc_html( self::clean_var_name( str_replace( '_', '-', $var ) ) ) . ':' . self::css_var_prepare_value( $settings, $var ) . ';'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
449 }
450 }
451 }
452
453 /**
454 * Prevent invalid CSS keys from getting added to the generated CSS.
455 *
456 * @since 6.20
457 *
458 * @param string $key
459 * @return bool
460 */
461 private static function css_key_is_valid( $key ) {
462 // Any key that is abnormally large is not valid.
463 // Any key that contains a '{' is not valid.
464 return strlen( $key ) < 100 && false === strpos( $key, '{' );
465 }
466
467 /**
468 * Confirm a CSS value is valid.
469 * If it appears to contain JavaScript, it will not be added.
470 *
471 * @since 6.20
472 *
473 * @param string $var
474 * @return bool
475 */
476 private static function css_value_is_valid( $var ) {
477 // None of these substrings should be present in any CSS value.
478 $invalid_substrings = array(
479 'function(',
480 ';userAgent',
481 ';stopPropagation',
482 '{const',
483 'window[',
484 'navigator[',
485 'Array;',
486 );
487
488 foreach ( $invalid_substrings as $substring ) {
489 if ( strpos( $var, $substring ) !== false ) {
490 return false;
491 }
492 }
493
494 return true;
495 }
496
497
498 /**
499 * Remove anything that isn't used as a CSS variable name.
500 *
501 * @param string $var_name
502 * @return string
503 */
504 private static function clean_var_name( $var_name ) {
505 return preg_replace( '/[^a-zA-Z0-9_-]/', '', $var_name );
506 }
507
508 /**
509 * Prepare the value for a CSS variable.
510 *
511 * @since 6.14
512 *
513 * @param array $settings An array of css style.
514 * @param string $key
515 *
516 * @return string
517 */
518 private static function css_var_prepare_value( $settings, $key ) {
519 $value = $settings[ $key ];
520
521 switch ( $key ) {
522 case 'font':
523 return safecss_filter_attr( $value );
524
525 case 'border_width_error':
526 case 'field_border_width':
527 if ( ! empty( $settings['field_shape_type'] ) && 'underline' === $settings['field_shape_type'] ) {
528 return safecss_filter_attr( '0px 0px ' . $value . ' 0px' );
529 }
530 break;
531
532 case 'box_shadow':
533 if ( ! empty( $settings['field_shape_type'] ) && 'underline' === $settings['field_shape_type'] ) {
534 return safecss_filter_attr( 'none' );
535 }
536 break;
537
538 case 'border_radius':
539 if ( ! empty( $settings['field_shape_type'] ) ) {
540 switch ( $settings['field_shape_type'] ) {
541 case 'underline':
542 case 'regular':
543 return safecss_filter_attr( '0px' );
544 case 'circle':
545 return safecss_filter_attr( '30px' );
546 }
547 }
548 break;
549 }//end switch
550
551 return esc_html( $settings[ $key ] );
552 }
553
554 /**
555 * @since 2.3
556 *
557 * @param WP_Post $style
558 * @return array
559 */
560 public static function get_settings_for_output( $style ) {
561 if ( self::previewing_style() ) {
562 $frm_style = new FrmStyle();
563 if ( isset( $_POST['frm_style_setting'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
564
565 // Sanitizing is done later.
566 $posted = wp_unslash( $_POST['frm_style_setting'] ); //phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
567 if ( ! is_array( $posted ) ) {
568 $posted = json_decode( $posted, true );
569 FrmAppHelper::format_form_data( $posted );
570 $settings = $frm_style->sanitize_post_content( $posted['frm_style_setting']['post_content'] );
571 $style_name = sanitize_title( $posted['style_name'] );
572 } else {
573 $settings = $frm_style->sanitize_post_content( $posted['post_content'] );
574 $style_name = FrmAppHelper::get_post_param( 'style_name', '', 'sanitize_title' );
575 }
576 } else {
577 $settings = $frm_style->sanitize_post_content( wp_unslash( $_GET ) );
578 $style_name = FrmAppHelper::get_param( 'style_name', '', 'get', 'sanitize_title' );
579 }
580
581 $settings = self::update_base_font_size( $settings, $frm_style->get_defaults() );
582
583 FrmAppHelper::sanitize_value( 'sanitize_text_field', $settings );
584
585 $settings['style_class'] = '';
586 if ( ! empty( $style_name ) ) {
587 $settings['style_class'] = $style_name . '.';
588 }
589 } else {
590 $settings = $style->post_content;
591 $settings['style_class'] = 'frm_style_' . $style->post_name . '.';
592 }//end if
593
594 $settings['style_class'] .= 'with_frm_style';
595 $settings['font'] = stripslashes( $settings['font'] );
596 $settings['change_margin'] = self::description_margin_for_screensize( $settings['width'] );
597
598 $checkbox_opts = array( 'important_style', 'auto_width', 'submit_style', 'collapse_icon', 'center_form' );
599 foreach ( $checkbox_opts as $opt ) {
600 if ( ! isset( $settings[ $opt ] ) ) {
601 $settings[ $opt ] = 0;
602 }
603 }
604
605 self::prepare_color_output( $settings );
606
607 $settings['field_height'] = $settings['field_height'] === '' ? 'auto' : $settings['field_height'];
608 $settings['field_width'] = $settings['field_width'] === '' ? 'auto' : $settings['field_width'];
609 $settings['auto_width'] = $settings['auto_width'] ? 'auto' : $settings['field_width'];
610 $settings['box_shadow'] = ! empty( $settings['remove_box_shadow'] ) ? 'none' : '0 1px 2px 0 rgba(18, 18, 23, 0.05)';
611
612 if ( ! isset( $settings['repeat_icon'] ) ) {
613 $settings['repeat_icon'] = 1;
614 }
615
616 return $settings;
617 }
618
619 /**
620 * Update the "Base Font Size" value from "Quick Settings across multiple settings values".
621 *
622 * @since 6.14
623 *
624 * @param array $settings An array of css style.
625 *
626 * @return array
627 */
628 public static function update_base_font_size( $settings, $defaults ) {
629 if ( empty( $settings['base_font_size'] ) || empty( $settings['use_base_font_size'] ) || 'false' === $settings['use_base_font_size'] ) {
630 return $settings;
631 }
632 $base_font_size = (int) $settings['base_font_size'];
633 $font_size = $settings['font_size'];
634 $font_sizes_to_update = array(
635 'font_size',
636 'field_font_size',
637 'check_font_size',
638 'title_size',
639 'form_desc_size',
640 'description_font_size',
641 'section_font_size',
642 'submit_font_size',
643 'success_font_size',
644 'error_font_size',
645 'progress_size',
646 );
647
648 array_map(
649 function ( $key ) use ( $defaults, $font_size, $base_font_size, &$settings ) {
650 if ( isset( $settings[ $key ] ) ) {
651 $settings[ $key ] = round( self::get_base_font_size_scale( $key, $font_size, $defaults ) * $base_font_size ) . 'px';
652 }
653 },
654 $font_sizes_to_update
655 );
656
657 return $settings;
658 }
659
660 /**
661 * Get style font size scale value.
662 *
663 * @since 6.14
664 *
665 * @return float
666 */
667 private static function get_base_font_size_scale( $key, $value, $defaults ) {
668 if ( empty( $defaults[ $key ] ) || ! is_numeric( (int) $defaults[ $key ] ) || ! is_numeric( (int) $value ) || 0 === (int) $value ) {
669 return 1;
670 }
671
672 return round( (int) $defaults[ $key ] / (int) $value, 2 );
673 }
674
675 /**
676 * @since 2.3
677 */
678 public static function prepare_color_output( &$settings, $allow_transparent = true ) {
679 $colors = self::allow_color_override();
680 foreach ( $colors as $css => $opts ) {
681 if ( $css === 'transparent' && ! $allow_transparent ) {
682 $css = '';
683 }
684 foreach ( $opts as $opt ) {
685 self::get_color_output( $css, $settings[ $opt ] );
686 }
687 }
688 }
689
690 /**
691 * @since 2.3
692 *
693 * @return array
694 */
695 private static function allow_color_override() {
696 $frm_style = new FrmStyle();
697 $colors = $frm_style->get_color_settings();
698
699 $transparent = array(
700 'fieldset_color',
701 'fieldset_bg_color',
702 'bg_color',
703 'bg_color_active',
704 'bg_color_disabled',
705 'section_bg_color',
706 'error_bg',
707 'success_bg_color',
708 'progress_bg_color',
709 'progress_active_bg_color',
710 'submit_border_color',
711 'submit_hover_border_color',
712 'submit_active_border_color',
713 'submit_hover_bg_color',
714 'submit_active_bg_color',
715 );
716
717 return array(
718 'transparent' => $transparent,
719 '' => array_diff( $colors, $transparent ),
720 );
721 }
722
723 /**
724 * @since 2.3
725 */
726 private static function get_color_output( $default, &$color ) {
727 $color = trim( $color );
728 if ( empty( $color ) ) {
729 $color = $default;
730 } elseif ( false !== strpos( $color, 'rgb(' ) ) {
731 $color = str_replace( 'rgb(', 'rgba(', $color );
732 $color = str_replace( ')', ',1)', $color );
733 } elseif ( strpos( $color, '#' ) === false && self::is_hex( $color ) ) {
734 $color = '#' . $color;
735 }
736 }
737
738 /**
739 * If a color looks like a hex code without the #, prepend the #.
740 * A color looks like a hex code if it does not contain the substrings "rgb", "rgba", "hsl", "hsla", or "hwb".
741 *
742 * @since 6.8
743 *
744 * @param string $color
745 * @return bool
746 */
747 private static function is_hex( $color ) {
748 $non_hex_substrings = array(
749 'rgba(',
750 'hsl(',
751 'hsla(',
752 'hwb(',
753 );
754
755 foreach ( $non_hex_substrings as $substring ) {
756 if ( false !== strpos( $color, $substring ) ) {
757 return false;
758 }
759 }
760
761 return true;
762 }
763
764 /**
765 * If left/right label is over a certain size,
766 * adjust the field description margin at a different screen size
767 *
768 * @since 2.3
769 */
770 private static function description_margin_for_screensize( $width ) {
771 $temp_label_width = str_replace( 'px', '', $width );
772 $change_margin = false;
773 if ( $temp_label_width >= 230 ) {
774 $change_margin = '800px';
775 } elseif ( $width >= 215 ) {
776 $change_margin = '700px';
777 } elseif ( $width >= 180 ) {
778 $change_margin = '650px';
779 }
780
781 return $change_margin;
782 }
783
784 /**
785 * @since 2.3
786 *
787 * @return bool
788 */
789 public static function previewing_style() {
790 $ajax_change = isset( $_POST['action'] ) && $_POST['action'] === 'frm_change_styling' && isset( $_POST['frm_style_setting'] ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
791
792 return $ajax_change || isset( $_GET['flat'] );
793 }
794
795 /**
796 * Get the URL for the Styler page list view (where you can assign styles to a form and view style templates) for a target form.
797 *
798 * @since 6.0
799 *
800 * @param int|string $form_id
801 * @return string
802 */
803 public static function get_list_url( $form_id ) {
804 return admin_url( 'admin.php?page=formidable-styles&form=' . absint( $form_id ) );
805 }
806
807 /**
808 * Get the back button args from Style settings.
809 *
810 * @since 6.14
811 *
812 * @param stdClass|WP_Post $style
813 * @param int $form_id
814 * @return array
815 */
816 public static function get_style_options_back_button_args( $style, $form_id ) {
817 if ( self::is_advanced_settings() ) {
818 return array(
819 'title' => __( 'Quick Settings', 'formidable' ),
820 'id' => 'frm_style_back_to_quick_settings',
821 );
822 }
823 return array(
824 'href' => self::get_list_url( $form_id ),
825 'title' => $style->post_title,
826 );
827 }
828
829 /**
830 * Get a link to edit a target style post object in the visual styler.
831 *
832 * @param stdClass|WP_Post $style
833 * @param int|string $form_id Used for the back button and preview form target.
834 * @param string $section The url param section.
835 *
836 * @return string
837 */
838 public static function get_edit_url( $style, $form_id = 0, $section = '' ) {
839 $query_args = array(
840 'page' => 'formidable-styles',
841 'frm_action' => 'edit',
842 'id' => $style->ID,
843 'section' => $section,
844 );
845
846 if ( $form_id ) {
847 // We include &form_id for the back button to know where to point to.
848 $query_args['form'] = $form_id;
849 }
850
851 return add_query_arg( $query_args, admin_url( 'admin.php' ) );
852 }
853
854 /**
855 * Get a count of the number of forms assigned to a target style ID.
856 * All unassigned forms are included in the count for the default style.
857 *
858 * @since 6.0
859 *
860 * @param int|string $style_id
861 * @param bool $is_default
862 * @return int
863 */
864 public static function get_form_count_for_style( $style_id, $is_default ) {
865 $serialized = serialize( array( 'custom_style' => (string) $style_id ) );
866 // Chop off the "a:1:{" from the front and the "}" from the back.
867 $substring = substr( $serialized, 5, -1 );
868 $number_of_forms = FrmDb::get_count(
869 'frm_forms',
870 array(
871 'status' => 'published',
872 'options LIKE' => $substring,
873 )
874 );
875
876 if ( ! $is_default ) {
877 // Exit early as the rest of the code is about including the default count.
878 return $number_of_forms;
879 }
880
881 $conversational_style_id = FrmDb::get_var( 'posts', array( 'post_name' => 'lines-no-boxes' ), 'ID' );
882 $number_of_forms += self::get_default_style_count( $style_id, $conversational_style_id );
883
884 return $number_of_forms;
885 }
886
887 /**
888 * Get the number of forms that use the default style.
889 *
890 * @since 6.0
891 *
892 * @param int|string $style_id
893 * @param mixed $conversational_style_id
894 * @return int
895 */
896 private static function get_default_style_count( $style_id, $conversational_style_id ) {
897 $substrings = array_map(
898 function ( $value ) {
899 $substring = serialize( array( 'custom_style' => $value ) );
900 return substr( $substring, 5, -1 );
901 },
902 array( '1', 1 )
903 );
904 $where = array(
905 'status' => 'published',
906 0 => array(
907 'options NOT LIKE' => 'custom_style',
908 'or' => 1,
909 'options LIKE' => $substrings,
910 ),
911 );
912
913 if ( $conversational_style_id ) {
914 // When a conversational style is set, check for it in the query by wrapping the where and adding a conversational option check.
915 $is_conversational_style = (int) $style_id === (int) $conversational_style_id;
916 $where[0] = array(
917 // The chat option doesn't exist if it isn't on.
918 ( $is_conversational_style ? 'options LIKE' : 'options NOT LIKE' ) => ';s:4:"chat";',
919 $where[0],
920 );
921 }
922
923 return FrmDb::get_count( 'frm_forms', $where );
924 }
925
926 /**
927 * Check if the current page is the advanced settings page.
928 *
929 * @since 6.14
930 *
931 * @return bool True if is advanced settings, false otherwise.
932 */
933 public static function is_advanced_settings() {
934 return FrmAppHelper::get_param( 'section' ) === 'advanced-settings' && FrmAppHelper::get_param( 'page' ) === 'formidable-styles';
935 }
936
937 /**
938 * Get wrapper classname for style editor sections.
939 *
940 * @since 6.16
941 *
942 * @param string $section_type
943 *
944 * @return string The style editor wrapper classname.
945 */
946 public static function style_editor_get_wrapper_classname( $section_type ) {
947 $is_quick_settings = ( 'quick-settings' === $section_type );
948 $classname = 'frm-style-editor-form';
949 $classname .= ( ! self::is_advanced_settings() xor $is_quick_settings ) ? ' frm_hidden' : '';
950 $classname .= FrmAppHelper::pro_is_installed() ? ' frm-pro' : '';
951
952 return $classname;
953 }
954
955 /**
956 * Retrieve the background image URL of the submit button.
957 * It may be either a full URL string (used in versions prior to 6.14) or a numeric attachment ID (introduced in version 6.14).
958 *
959 * @since 6.14
960 *
961 * @param array $settings
962 * @return false|string Return image url or false.
963 */
964 public static function get_submit_image_bg_url( $settings ) {
965 $background_image = $settings['submit_bg_img'];
966 if ( empty( $background_image ) ) {
967 return false;
968 }
969 // Handle the case where the submit_bg_img is a full URL string. If the settings were saved with the older styler version prior to 6.14, the submit_bg_img will be a full URL string.
970 if ( ! is_numeric( $background_image ) ) {
971 return $background_image;
972 }
973
974 return wp_get_attachment_url( (int) $background_image );
975 }
976
977 /**
978 * Determines if the chosen JavaScript library should be used.
979 *
980 * @since 6.13
981 *
982 * @return bool
983 */
984 public static function use_chosen_js() {
985 if ( ! FrmAppHelper::pro_is_installed() ) {
986 return false;
987 }
988
989 return is_callable( 'FrmProAppHelper::use_chosen_js' )
990 ? FrmProAppHelper::use_chosen_js()
991 : true;
992 }
993
994 /**
995 * Returns the bottom part from a margin/padding value.
996 *
997 * @since 6.17
998 *
999 * @param string $value The margin/padding value.
1000 * @return string
1001 */
1002 public static function get_bottom_value( $value ) {
1003 if ( ! $value ) {
1004 return $value;
1005 }
1006 $parts = explode( ' ', $value );
1007 if ( count( $parts ) < 3 ) {
1008 return $parts[0];
1009 }
1010 return $parts[2];
1011 }
1012 }
1013