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

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