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

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

948 lines 25.7 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' );
437 $vars = array_diff( $vars, $remove );
438
439 foreach ( $vars as $var ) {
440 if ( ! isset( $settings[ $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 ) {
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 * Remove anything that isn't used as a CSS variable name.
455 *
456 * @param string $var_name
457 * @return string
458 */
459 private static function clean_var_name( $var_name ) {
460 return preg_replace( '/[^a-zA-Z0-9_-]/', '', $var_name );
461 }
462
463 /**
464 * Prepare the value for a CSS variable.
465 *
466 * @since 6.14
467 *
468 * @param array $settings An array of css style.
469 * @param string $key
470 *
471 * @return string
472 */
473 private static function css_var_prepare_value( $settings, $key ) {
474 $value = $settings[ $key ];
475
476 switch ( $key ) {
477 case 'font':
478 return safecss_filter_attr( $value );
479
480 case 'border_width_error':
481 case 'field_border_width':
482 if ( ! empty( $settings['field_shape_type'] ) && 'underline' === $settings['field_shape_type'] ) {
483 return safecss_filter_attr( '0px 0px ' . $value . ' 0px' );
484 }
485 break;
486
487 case 'box_shadow':
488 if ( ! empty( $settings['field_shape_type'] ) && 'underline' === $settings['field_shape_type'] ) {
489 return safecss_filter_attr( 'none' );
490 }
491 break;
492
493 case 'border_radius':
494 if ( ! empty( $settings['field_shape_type'] ) ) {
495 switch ( $settings['field_shape_type'] ) {
496 case 'underline':
497 case 'regular':
498 return safecss_filter_attr( '0px' );
499 case 'circle':
500 return safecss_filter_attr( '30px' );
501 }
502 }
503 break;
504 }//end switch
505
506 return esc_html( $settings[ $key ] );
507 }
508
509 /**
510 * @since 2.3
511 *
512 * @param WP_Post $style
513 * @return array
514 */
515 public static function get_settings_for_output( $style ) {
516 if ( self::previewing_style() ) {
517 $frm_style = new FrmStyle();
518 if ( isset( $_POST['frm_style_setting'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
519
520 // Sanitizing is done later.
521 $posted = wp_unslash( $_POST['frm_style_setting'] ); //phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
522 if ( ! is_array( $posted ) ) {
523 $posted = json_decode( $posted, true );
524 FrmAppHelper::format_form_data( $posted );
525 $settings = $frm_style->sanitize_post_content( $posted['frm_style_setting']['post_content'] );
526 $style_name = sanitize_title( $posted['style_name'] );
527 } else {
528 $settings = $frm_style->sanitize_post_content( $posted['post_content'] );
529 $style_name = FrmAppHelper::get_post_param( 'style_name', '', 'sanitize_title' );
530 }
531 } else {
532 $settings = $frm_style->sanitize_post_content( wp_unslash( $_GET ) );
533 $style_name = FrmAppHelper::get_param( 'style_name', '', 'get', 'sanitize_title' );
534 }
535
536 $settings = self::update_base_font_size( $settings, $frm_style->get_defaults() );
537
538 FrmAppHelper::sanitize_value( 'sanitize_text_field', $settings );
539
540 $settings['style_class'] = '';
541 if ( ! empty( $style_name ) ) {
542 $settings['style_class'] = $style_name . '.';
543 }
544 } else {
545 $settings = $style->post_content;
546 $settings['style_class'] = 'frm_style_' . $style->post_name . '.';
547 }//end if
548
549 $settings['style_class'] .= 'with_frm_style';
550 $settings['font'] = stripslashes( $settings['font'] );
551 $settings['change_margin'] = self::description_margin_for_screensize( $settings['width'] );
552
553 $checkbox_opts = array( 'important_style', 'auto_width', 'submit_style', 'collapse_icon', 'center_form' );
554 foreach ( $checkbox_opts as $opt ) {
555 if ( ! isset( $settings[ $opt ] ) ) {
556 $settings[ $opt ] = 0;
557 }
558 }
559
560 self::prepare_color_output( $settings );
561
562 $settings['field_height'] = $settings['field_height'] === '' ? 'auto' : $settings['field_height'];
563 $settings['field_width'] = $settings['field_width'] === '' ? 'auto' : $settings['field_width'];
564 $settings['auto_width'] = $settings['auto_width'] ? 'auto' : $settings['field_width'];
565 $settings['box_shadow'] = ! empty( $settings['remove_box_shadow'] ) ? 'none' : '0 1px 2px 0 rgba(18, 18, 23, 0.05)';
566
567 if ( ! isset( $settings['repeat_icon'] ) ) {
568 $settings['repeat_icon'] = 1;
569 }
570
571 return $settings;
572 }
573
574 /**
575 * Update the "Base Font Size" value from "Quick Settings across multiple settings values".
576 *
577 * @since 6.14
578 *
579 * @param array $settings An array of css style.
580 *
581 * @return array
582 */
583 public static function update_base_font_size( $settings, $defaults ) {
584 if ( empty( $settings['base_font_size'] ) || empty( $settings['use_base_font_size'] ) || 'false' === $settings['use_base_font_size'] ) {
585 return $settings;
586 }
587 $base_font_size = (int) $settings['base_font_size'];
588 $font_size = $settings['font_size'];
589 $font_sizes_to_update = array(
590 'font_size',
591 'field_font_size',
592 'check_font_size',
593 'title_size',
594 'form_desc_size',
595 'description_font_size',
596 'section_font_size',
597 'submit_font_size',
598 'success_font_size',
599 'error_font_size',
600 'progress_size',
601 );
602
603 array_map(
604 function ( $key ) use ( $defaults, $font_size, $base_font_size, &$settings ) {
605 if ( isset( $settings[ $key ] ) ) {
606 $settings[ $key ] = round( self::get_base_font_size_scale( $key, $font_size, $defaults ) * $base_font_size ) . 'px';
607 }
608 },
609 $font_sizes_to_update
610 );
611
612 return $settings;
613 }
614
615 /**
616 * Get style font size scale value.
617 *
618 * @since 6.14
619 *
620 * @return float
621 */
622 private static function get_base_font_size_scale( $key, $value, $defaults ) {
623 if ( empty( $defaults[ $key ] ) || ! is_numeric( (int) $defaults[ $key ] ) || ! is_numeric( (int) $value ) || 0 === (int) $value ) {
624 return 1;
625 }
626
627 return round( (int) $defaults[ $key ] / (int) $value, 2 );
628 }
629
630 /**
631 * @since 2.3
632 */
633 public static function prepare_color_output( &$settings, $allow_transparent = true ) {
634 $colors = self::allow_color_override();
635 foreach ( $colors as $css => $opts ) {
636 if ( $css === 'transparent' && ! $allow_transparent ) {
637 $css = '';
638 }
639 foreach ( $opts as $opt ) {
640 self::get_color_output( $css, $settings[ $opt ] );
641 }
642 }
643 }
644
645 /**
646 * @since 2.3
647 *
648 * @return array
649 */
650 private static function allow_color_override() {
651 $frm_style = new FrmStyle();
652 $colors = $frm_style->get_color_settings();
653
654 $transparent = array(
655 'fieldset_color',
656 'fieldset_bg_color',
657 'bg_color',
658 'bg_color_active',
659 'bg_color_disabled',
660 'section_bg_color',
661 'error_bg',
662 'success_bg_color',
663 'progress_bg_color',
664 'progress_active_bg_color',
665 'submit_border_color',
666 'submit_hover_border_color',
667 'submit_active_border_color',
668 'submit_hover_bg_color',
669 'submit_active_bg_color',
670 );
671
672 return array(
673 'transparent' => $transparent,
674 '' => array_diff( $colors, $transparent ),
675 );
676 }
677
678 /**
679 * @since 2.3
680 */
681 private static function get_color_output( $default, &$color ) {
682 $color = trim( $color );
683 if ( empty( $color ) ) {
684 $color = $default;
685 } elseif ( false !== strpos( $color, 'rgb(' ) ) {
686 $color = str_replace( 'rgb(', 'rgba(', $color );
687 $color = str_replace( ')', ',1)', $color );
688 } elseif ( strpos( $color, '#' ) === false && self::is_hex( $color ) ) {
689 $color = '#' . $color;
690 }
691 }
692
693 /**
694 * If a color looks like a hex code without the #, prepend the #.
695 * A color looks like a hex code if it does not contain the substrings "rgb", "rgba", "hsl", "hsla", or "hwb".
696 *
697 * @since 6.8
698 *
699 * @param string $color
700 * @return bool
701 */
702 private static function is_hex( $color ) {
703 $non_hex_substrings = array(
704 'rgba(',
705 'hsl(',
706 'hsla(',
707 'hwb(',
708 );
709
710 foreach ( $non_hex_substrings as $substring ) {
711 if ( false !== strpos( $color, $substring ) ) {
712 return false;
713 }
714 }
715
716 return true;
717 }
718
719 /**
720 * If left/right label is over a certain size,
721 * adjust the field description margin at a different screen size
722 *
723 * @since 2.3
724 */
725 private static function description_margin_for_screensize( $width ) {
726 $temp_label_width = str_replace( 'px', '', $width );
727 $change_margin = false;
728 if ( $temp_label_width >= 230 ) {
729 $change_margin = '800px';
730 } elseif ( $width >= 215 ) {
731 $change_margin = '700px';
732 } elseif ( $width >= 180 ) {
733 $change_margin = '650px';
734 }
735
736 return $change_margin;
737 }
738
739 /**
740 * @since 2.3
741 *
742 * @return bool
743 */
744 public static function previewing_style() {
745 $ajax_change = isset( $_POST['action'] ) && $_POST['action'] === 'frm_change_styling' && isset( $_POST['frm_style_setting'] ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
746
747 return $ajax_change || isset( $_GET['flat'] );
748 }
749
750 /**
751 * 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.
752 *
753 * @since 6.0
754 *
755 * @param int|string $form_id
756 * @return string
757 */
758 public static function get_list_url( $form_id ) {
759 return admin_url( 'admin.php?page=formidable-styles&form=' . absint( $form_id ) );
760 }
761
762 /**
763 * Get the back button args from Style settings.
764 *
765 * @since 6.14
766 *
767 * @param stdClass|WP_Post $style
768 * @param int $form_id
769 * @return array
770 */
771 public static function get_style_options_back_button_args( $style, $form_id ) {
772 if ( self::is_advanced_settings() ) {
773 return array(
774 'title' => __( 'Quick Settings', 'formidable' ),
775 'id' => 'frm_style_back_to_quick_settings',
776 );
777 }
778 return array(
779 'href' => self::get_list_url( $form_id ),
780 'title' => $style->post_title,
781 );
782 }
783
784 /**
785 * Get a link to edit a target style post object in the visual styler.
786 *
787 * @param stdClass|WP_Post $style
788 * @param int|string $form_id Used for the back button and preview form target.
789 * @param string $section The url param section.
790 *
791 * @return string
792 */
793 public static function get_edit_url( $style, $form_id = 0, $section = '' ) {
794 $query_args = array(
795 'page' => 'formidable-styles',
796 'frm_action' => 'edit',
797 'id' => $style->ID,
798 'section' => $section,
799 );
800
801 if ( $form_id ) {
802 // We include &form_id for the back button to know where to point to.
803 $query_args['form'] = $form_id;
804 }
805
806 return add_query_arg( $query_args, admin_url( 'admin.php' ) );
807 }
808
809 /**
810 * Get a count of the number of forms assigned to a target style ID.
811 * All unassigned forms are included in the count for the default style.
812 *
813 * @since 6.0
814 *
815 * @param int|string $style_id
816 * @param bool $is_default
817 * @return int
818 */
819 public static function get_form_count_for_style( $style_id, $is_default ) {
820 $serialized = serialize( array( 'custom_style' => (string) $style_id ) );
821 // Chop off the "a:1:{" from the front and the "}" from the back.
822 $substring = substr( $serialized, 5, -1 );
823 $number_of_forms = FrmDb::get_count(
824 'frm_forms',
825 array(
826 'status' => 'published',
827 'options LIKE' => $substring,
828 )
829 );
830
831 if ( ! $is_default ) {
832 // Exit early as the rest of the code is about including the default count.
833 return $number_of_forms;
834 }
835
836 $conversational_style_id = FrmDb::get_var( 'posts', array( 'post_name' => 'lines-no-boxes' ), 'ID' );
837 $number_of_forms += self::get_default_style_count( $style_id, $conversational_style_id );
838
839 return $number_of_forms;
840 }
841
842 /**
843 * Get the number of forms that use the default style.
844 *
845 * @since 6.0
846 *
847 * @param int|string $style_id
848 * @param mixed $conversational_style_id
849 * @return int
850 */
851 private static function get_default_style_count( $style_id, $conversational_style_id ) {
852 $substrings = array_map(
853 function ( $value ) {
854 $substring = serialize( array( 'custom_style' => $value ) );
855 return substr( $substring, 5, -1 );
856 },
857 array( '1', 1 )
858 );
859 $where = array(
860 'status' => 'published',
861 0 => array(
862 'options NOT LIKE' => 'custom_style',
863 'or' => 1,
864 'options LIKE' => $substrings,
865 ),
866 );
867
868 if ( $conversational_style_id ) {
869 // When a conversational style is set, check for it in the query by wrapping the where and adding a conversational option check.
870 $is_conversational_style = (int) $style_id === (int) $conversational_style_id;
871 $where[0] = array(
872 // The chat option doesn't exist if it isn't on.
873 ( $is_conversational_style ? 'options LIKE' : 'options NOT LIKE' ) => ';s:4:"chat";',
874 $where[0],
875 );
876 }
877
878 return FrmDb::get_count( 'frm_forms', $where );
879 }
880
881 /**
882 * Check if the current page is the advanced settings page.
883 *
884 * @since 6.14
885 *
886 * @return bool True if is advanced settings, false otherwise.
887 */
888 public static function is_advanced_settings() {
889 return FrmAppHelper::get_param( 'section' ) === 'advanced-settings' && FrmAppHelper::get_param( 'page' ) === 'formidable-styles';
890 }
891
892 /**
893 * Get wrapper classname for style editor sections.
894 *
895 * @since 6.16
896 *
897 * @param string $section_type
898 *
899 * @return string The style editor wrapper classname.
900 */
901 public static function style_editor_get_wrapper_classname( $section_type ) {
902 $is_quick_settings = ( 'quick-settings' === $section_type );
903 $classname = 'frm-style-editor-form';
904 $classname .= ( ! self::is_advanced_settings() xor $is_quick_settings ) ? ' frm_hidden' : '';
905 $classname .= FrmAppHelper::pro_is_installed() ? ' frm-pro' : '';
906
907 return $classname;
908 }
909
910 /**
911 * Retrieve the background image URL of the submit button.
912 * 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).
913 *
914 * @since 6.14
915 *
916 * @param array $settings
917 * @return false|string Return image url or false.
918 */
919 public static function get_submit_image_bg_url( $settings ) {
920 $background_image = $settings['submit_bg_img'];
921 if ( empty( $background_image ) ) {
922 return false;
923 }
924 // 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.
925 if ( ! is_numeric( $background_image ) ) {
926 return $background_image;
927 }
928
929 return wp_get_attachment_url( (int) $background_image );
930 }
931 /**
932 * Determines if the chosen JavaScript library should be used.
933 *
934 * @since 6.13
935 *
936 * @return bool
937 */
938 public static function use_chosen_js() {
939 if ( ! FrmAppHelper::pro_is_installed() ) {
940 return false;
941 }
942
943 return is_callable( 'FrmProAppHelper::use_chosen_js' )
944 ? FrmProAppHelper::use_chosen_js()
945 : true;
946 }
947 }
948