| @@ -37,10 +37,17 @@ | ||
| 37 | 37 | 'inside' => __( 'inside', 'formidable' ), |
| 38 | 38 | ); |
| 39 | 39 | } |
| 40 | 40 | |
| 41 | - public static function get_single_label_positions() { | |
| 42 | - return array( | |
| 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( | |
| 43 | 50 | 'top' => __( 'Top', 'formidable' ), |
| 44 | 51 | 'left' => __( 'Left', 'formidable' ), |
| 45 | 52 | 'right' => __( 'Right', 'formidable' ), |
| 46 | 53 | 'inline' => __( 'Inline (left without a set width)', 'formidable' ), |
| @@ -47,8 +54,18 @@ | ||
| 47 | 54 | 'none' => __( 'None', 'formidable' ), |
| 48 | 55 | 'hidden' => __( 'Hidden (but leave the space)', 'formidable' ), |
| 49 | 56 | 'inside' => __( 'Placeholder inside the field', 'formidable' ), |
| 50 | 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 ); | |
| 51 | 68 | } |
| 52 | 69 | |
| 53 | 70 | public static function minus_icons() { |
| 54 | 71 | return array( |
| @@ -120,9 +137,9 @@ | ||
| 120 | 137 | * @return string The class for this icon. |
| 121 | 138 | */ |
| 122 | 139 | public static function icon_key_to_class( $key, $icon = '+', $type = 'arrow' ) { |
| 123 | 140 | if ( 'arrow' === $type && is_numeric( $key ) ) { |
| 124 | - //frm_arrowup6_icon | |
| 141 | + // frm_arrowup6_icon. | |
| 125 | 142 | $arrow = array( |
| 126 | 143 | '-' => 'down', |
| 127 | 144 | '+' => 'up', |
| 128 | 145 | ); |
| @@ -127,9 +144,9 @@ | ||
| 127 | 144 | '+' => 'up', |
| 128 | 145 | ); |
| 129 | 146 | $class = 'frm_arrow' . $arrow[ $icon ]; |
| 130 | 147 | } else { |
| 131 | - //frm_minus1_icon | |
| 148 | + // frm_minus1_icon. | |
| 132 | 149 | $key = str_replace( 'p', '', $key ); |
| 133 | 150 | $plus = array( |
| 134 | 151 | '-' => 'minus', |
| 135 | 152 | '+' => 'plus', |
| @@ -165,9 +182,9 @@ | ||
| 165 | 182 | <b class="caret"></b> |
| 166 | 183 | </button> |
| 167 | 184 | <ul class="multiselect-container frm-dropdown-menu"> |
| 168 | 185 | <?php foreach ( $icons as $key => $icon ) { ?> |
| 169 | - <li <?php echo ( $style->post_content['collapse_icon'] == $key ) ? 'class="active"' : ''; ?>> | |
| 186 | + <li <?php echo $style->post_content['collapse_icon'] == $key ? 'class="active"' : ''; ?>> | |
| 170 | 187 | <a href="javascript:void(0);"> |
| 171 | 188 | <label> |
| 172 | 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 ); ?> /> |
| 173 | 190 | <span> |
| @@ -184,16 +201,55 @@ | ||
| 184 | 201 | </div> |
| 185 | 202 | <?php |
| 186 | 203 | } |
| 187 | 204 | |
| 188 | - public static function hex2rgb( $hex ) { | |
| 189 | - $hex = str_replace( '#', '', $hex ); | |
| 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 | + } | |
| 190 | 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 ); | |
| 191 | 250 | list( $r, $g, $b ) = sscanf( $hex, '%02x%02x%02x' ); |
| 192 | - | |
| 193 | - $rgb = array( $r, $g, $b ); | |
| 194 | - | |
| 195 | - return implode( ',', $rgb ); | |
| 251 | + return array( $r, $g, $b ); | |
| 196 | 252 | } |
| 197 | 253 | |
| 198 | 254 | /** |
| 199 | 255 | * @since 4.0 |
| @@ -206,13 +262,14 @@ | ||
| 206 | 262 | |
| 207 | 263 | /** |
| 208 | 264 | * @since 6.0 |
| 209 | 265 | * |
| 210 | - * @param string $rgba | |
| 211 | - * @return string | |
| 266 | + * @param string $rgba Color setting value. This could be hex or rgb. | |
| 267 | + * @return string Hex color value. | |
| 212 | 268 | */ |
| 213 | 269 | private static function rgb_to_hex( $rgba ) { |
| 214 | 270 | if ( strpos( $rgba, '#' ) === 0 ) { |
| 271 | + // Color is already hex. | |
| 215 | 272 | return $rgba; |
| 216 | 273 | } |
| 217 | 274 | preg_match( '/^rgba?[\s+]?\([\s+]?(\d+)[\s+]?,[\s+]?(\d+)[\s+]?,[\s+]?(\d+)[\s+]?/i', $rgba, $by_color ); |
| 218 | 275 | return sprintf( '%02x%02x%02x', $by_color[1], $by_color[2], $by_color[3] ); |
| @@ -218,12 +275,73 @@ | ||
| 218 | 275 | return sprintf( '%02x%02x%02x', $by_color[1], $by_color[2], $by_color[3] ); |
| 219 | 276 | } |
| 220 | 277 | |
| 221 | 278 | /** |
| 222 | - * @param $hex string - The original color in hex format #ffffff | |
| 223 | - * @param $steps integer - should be between -255 and 255. Negative = darker, positive = lighter | |
| 279 | + * @since 6.8 | |
| 224 | 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 | + /** | |
| 225 | 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. | |
| 226 | 344 | */ |
| 227 | 345 | public static function adjust_brightness( $hex, $steps ) { |
| 228 | 346 | $steps = max( - 255, min( 255, $steps ) ); |
| 229 | 347 | |
| @@ -244,11 +362,15 @@ | ||
| 244 | 362 | $color_parts = str_split( $hex, 2 ); |
| 245 | 363 | $return = '#'; |
| 246 | 364 | |
| 247 | 365 | foreach ( $color_parts as $color ) { |
| 248 | - $color = hexdec( $color ); // Convert to decimal | |
| 249 | - $color = max( 0, min( 255, $color + $steps ) ); // Adjust color | |
| 250 | - $return .= str_pad( dechex( $color ), 2, '0', STR_PAD_LEFT ); // Make two char hex code | |
| 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 ); | |
| 251 | 373 | } |
| 252 | 374 | |
| 253 | 375 | return $return; |
| 254 | 376 | } |
| @@ -263,8 +385,17 @@ | ||
| 263 | 385 | if ( 0 === strpos( $color, 'rgb' ) ) { |
| 264 | 386 | $color = self::rgb_to_hex( $color ); |
| 265 | 387 | } |
| 266 | 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 | + | |
| 267 | 398 | self::fill_hex( $color ); |
| 268 | 399 | |
| 269 | 400 | $c_r = hexdec( substr( $color, 0, 2 ) ); |
| 270 | 401 | $c_g = hexdec( substr( $color, 2, 2 ) ); |
| @@ -278,9 +409,9 @@ | ||
| 278 | 409 | * Change a 3 character hex color to a 6 character one. |
| 279 | 410 | * |
| 280 | 411 | * @since 6.0 |
| 281 | 412 | * |
| 282 | - * @return array | |
| 413 | + * @return void | |
| 283 | 414 | */ |
| 284 | 415 | private static function fill_hex( &$color ) { |
| 285 | 416 | if ( 3 === strlen( $color ) ) { |
| 286 | 417 | $color = $color[0] . $color[0] . $color[1] . $color[1] . $color[2] . $color[2]; |
| @@ -313,14 +444,70 @@ | ||
| 313 | 444 | $defaults[ $var ] = ''; |
| 314 | 445 | } |
| 315 | 446 | $show = empty( $defaults ) || ( $settings[ $var ] !== '' && $settings[ $var ] !== $defaults[ $var ] ); |
| 316 | 447 | if ( $show ) { |
| 317 | - echo '--' . esc_html( str_replace( '_', '-', $var ) ) . ':' . ( $var === 'font' ? FrmAppHelper::kses( $settings[ $var ] ) : esc_html( $settings[ $var ] ) ) . ';'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped | |
| 448 | + echo '--' . esc_html( self::clean_var_name( str_replace( '_', '-', $var ) ) ) . ':' . self::css_var_prepare_value( $settings, $var ) . ';'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped | |
| 318 | 449 | } |
| 319 | 450 | } |
| 320 | 451 | } |
| 321 | 452 | |
| 322 | 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 | + /** | |
| 323 | 510 | * @since 2.3 |
| 324 | 511 | * |
| 325 | 512 | * @param WP_Post $style |
| 326 | 513 | * @return array |
| @@ -345,8 +532,10 @@ | ||
| 345 | 532 | $settings = $frm_style->sanitize_post_content( wp_unslash( $_GET ) ); |
| 346 | 533 | $style_name = FrmAppHelper::get_param( 'style_name', '', 'get', 'sanitize_title' ); |
| 347 | 534 | } |
| 348 | 535 | |
| 536 | + $settings = self::update_base_font_size( $settings, $frm_style->get_defaults() ); | |
| 537 | + | |
| 349 | 538 | FrmAppHelper::sanitize_value( 'sanitize_text_field', $settings ); |
| 350 | 539 | |
| 351 | 540 | $settings['style_class'] = ''; |
| 352 | 541 | if ( ! empty( $style_name ) ) { |
| @@ -354,9 +543,9 @@ | ||
| 354 | 543 | } |
| 355 | 544 | } else { |
| 356 | 545 | $settings = $style->post_content; |
| 357 | 546 | $settings['style_class'] = 'frm_style_' . $style->post_name . '.'; |
| 358 | - } | |
| 547 | + }//end if | |
| 359 | 548 | |
| 360 | 549 | $settings['style_class'] .= 'with_frm_style'; |
| 361 | 550 | $settings['font'] = stripslashes( $settings['font'] ); |
| 362 | 551 | $settings['change_margin'] = self::description_margin_for_screensize( $settings['width'] ); |
| @@ -372,9 +561,9 @@ | ||
| 372 | 561 | |
| 373 | 562 | $settings['field_height'] = $settings['field_height'] === '' ? 'auto' : $settings['field_height']; |
| 374 | 563 | $settings['field_width'] = $settings['field_width'] === '' ? 'auto' : $settings['field_width']; |
| 375 | 564 | $settings['auto_width'] = $settings['auto_width'] ? 'auto' : $settings['field_width']; |
| 376 | - $settings['box_shadow'] = ! empty( $settings['remove_box_shadow'] ) ? 'none' : '0 1px 1px rgba(0, 0, 0, 0.075) inset'; | |
| 565 | + $settings['box_shadow'] = ! empty( $settings['remove_box_shadow'] ) ? 'none' : '0 1px 2px 0 rgba(18, 18, 23, 0.05)'; | |
| 377 | 566 | |
| 378 | 567 | if ( ! isset( $settings['repeat_icon'] ) ) { |
| 379 | 568 | $settings['repeat_icon'] = 1; |
| 380 | 569 | } |
| @@ -382,8 +571,64 @@ | ||
| 382 | 571 | return $settings; |
| 383 | 572 | } |
| 384 | 573 | |
| 385 | 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 | + /** | |
| 386 | 631 | * @since 2.3 |
| 387 | 632 | */ |
| 388 | 633 | public static function prepare_color_output( &$settings, $allow_transparent = true ) { |
| 389 | 634 | $colors = self::allow_color_override(); |
| @@ -439,14 +684,40 @@ | ||
| 439 | 684 | $color = $default; |
| 440 | 685 | } elseif ( false !== strpos( $color, 'rgb(' ) ) { |
| 441 | 686 | $color = str_replace( 'rgb(', 'rgba(', $color ); |
| 442 | 687 | $color = str_replace( ')', ',1)', $color ); |
| 443 | - } elseif ( strpos( $color, '#' ) === false && false === strpos( $color, 'rgba(' ) ) { | |
| 688 | + } elseif ( strpos( $color, '#' ) === false && self::is_hex( $color ) ) { | |
| 444 | 689 | $color = '#' . $color; |
| 445 | 690 | } |
| 446 | 691 | } |
| 447 | 692 | |
| 448 | 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 | + /** | |
| 449 | 720 | * If left/right label is over a certain size, |
| 450 | 721 | * adjust the field description margin at a different screen size |
| 451 | 722 | * |
| 452 | 723 | * @since 2.3 |
| @@ -476,45 +747,13 @@ | ||
| 476 | 747 | return $ajax_change || isset( $_GET['flat'] ); |
| 477 | 748 | } |
| 478 | 749 | |
| 479 | 750 | /** |
| 480 | - * @since 5.5.1 | |
| 481 | - * @return void | |
| 482 | - */ | |
| 483 | - public static function maybe_include_font_icon_css() { | |
| 484 | - $signature_add_on_is_active = class_exists( 'FrmSigAppHelper', false ); | |
| 485 | - | |
| 486 | - if ( ! FrmAppHelper::pro_is_installed() && ! $signature_add_on_is_active ) { | |
| 487 | - // If Pro and Signatures are both not active, there is no need to include the font icon CSS in lite. | |
| 488 | - return; | |
| 489 | - } | |
| 490 | - | |
| 491 | - $pro_version_will_handle_loading = false; | |
| 492 | - | |
| 493 | - if ( class_exists( 'FrmProDb', false ) ) { | |
| 494 | - $pro_version_that_includes_font_icons_css = '5.5.1'; | |
| 495 | - | |
| 496 | - // Include font icons in Lite for backward compatibility with older version of Pro. | |
| 497 | - $pro_version_will_handle_loading = version_compare( FrmProDb::$plug_version, $pro_version_that_includes_font_icons_css, '>=' ); | |
| 498 | - } | |
| 499 | - | |
| 500 | - $load_it_here = false; | |
| 501 | - if ( ! $pro_version_will_handle_loading ) { | |
| 502 | - // If Pro is not handling it, we still need to include it for the Signature add on. | |
| 503 | - $load_it_here = $signature_add_on_is_active; | |
| 504 | - } | |
| 505 | - | |
| 506 | - if ( $load_it_here ) { | |
| 507 | - readfile( FrmAppHelper::plugin_path() . '/css/font_icons.css' ); | |
| 508 | - } | |
| 509 | - } | |
| 510 | - | |
| 511 | - /** | |
| 512 | 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. |
| 513 | 752 | * |
| 514 | 753 | * @since 6.0 |
| 515 | 754 | * |
| 516 | - * @param string|int $form_id | |
| 755 | + * @param int|string $form_id | |
| 517 | 756 | * @return string |
| 518 | 757 | */ |
| 519 | 758 | public static function get_list_url( $form_id ) { |
| 520 | 759 | return admin_url( 'admin.php?page=formidable-styles&form=' . absint( $form_id ) ); |
| @@ -520,19 +759,44 @@ | ||
| 520 | 759 | return admin_url( 'admin.php?page=formidable-styles&form=' . absint( $form_id ) ); |
| 521 | 760 | } |
| 522 | 761 | |
| 523 | 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 | + /** | |
| 524 | 785 | * Get a link to edit a target style post object in the visual styler. |
| 525 | 786 | * |
| 526 | - * @param WP_Post|stdClass $style | |
| 527 | - * @param string|int $form_id Used for the back button and preview form target. | |
| 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 | + * | |
| 528 | 791 | * @return string |
| 529 | 792 | */ |
| 530 | - public static function get_edit_url( $style, $form_id = 0 ) { | |
| 793 | + public static function get_edit_url( $style, $form_id = 0, $section = '' ) { | |
| 531 | 794 | $query_args = array( |
| 532 | 795 | 'page' => 'formidable-styles', |
| 533 | 796 | 'frm_action' => 'edit', |
| 534 | 797 | 'id' => $style->ID, |
| 798 | + 'section' => $section, | |
| 535 | 799 | ); |
| 536 | 800 | |
| 537 | 801 | if ( $form_id ) { |
| 538 | 802 | // We include &form_id for the back button to know where to point to. |
| @@ -547,15 +811,16 @@ | ||
| 547 | 811 | * All unassigned forms are included in the count for the default style. |
| 548 | 812 | * |
| 549 | 813 | * @since 6.0 |
| 550 | 814 | * |
| 551 | - * @param string|int $style_id | |
| 815 | + * @param int|string $style_id | |
| 552 | 816 | * @param bool $is_default |
| 553 | 817 | * @return int |
| 554 | 818 | */ |
| 555 | 819 | public static function get_form_count_for_style( $style_id, $is_default ) { |
| 556 | - $serialized = serialize( array( 'custom_style' => (string) $style_id ) ); | |
| 557 | - $substring = substr( $serialized, 5, -1 ); // Chop off the "a:1:{" from the front and the "}" from the back. | |
| 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 ); | |
| 558 | 823 | $number_of_forms = FrmDb::get_count( |
| 559 | 824 | 'frm_forms', |
| 560 | 825 | array( |
| 561 | 826 | 'status' => 'published', |
| @@ -578,21 +843,21 @@ | ||
| 578 | 843 | * Get the number of forms that use the default style. |
| 579 | 844 | * |
| 580 | 845 | * @since 6.0 |
| 581 | 846 | * |
| 582 | - * @param string|int $style_id | |
| 847 | + * @param int|string $style_id | |
| 583 | 848 | * @param mixed $conversational_style_id |
| 584 | 849 | * @return int |
| 585 | 850 | */ |
| 586 | 851 | private static function get_default_style_count( $style_id, $conversational_style_id ) { |
| 587 | 852 | $substrings = array_map( |
| 588 | - function( $value ) { | |
| 853 | + function ( $value ) { | |
| 589 | 854 | $substring = serialize( array( 'custom_style' => $value ) ); |
| 590 | 855 | return substr( $substring, 5, -1 ); |
| 591 | 856 | }, |
| 592 | 857 | array( '1', 1 ) |
| 593 | 858 | ); |
| 594 | - $where = array( | |
| 859 | + $where = array( | |
| 595 | 860 | 'status' => 'published', |
| 596 | 861 | 0 => array( |
| 597 | 862 | 'options NOT LIKE' => 'custom_style', |
| 598 | 863 | 'or' => 1, |
| @@ -602,9 +867,9 @@ | ||
| 602 | 867 | |
| 603 | 868 | if ( $conversational_style_id ) { |
| 604 | 869 | // When a conversational style is set, check for it in the query by wrapping the where and adding a conversational option check. |
| 605 | 870 | $is_conversational_style = (int) $style_id === (int) $conversational_style_id; |
| 606 | - $where[0] = array( | |
| 871 | + $where[0] = array( | |
| 607 | 872 | // The chat option doesn't exist if it isn't on. |
| 608 | 873 | ( $is_conversational_style ? 'options LIKE' : 'options NOT LIKE' ) => ';s:4:"chat";', |
| 609 | 874 | $where[0], |
| 610 | 875 | ); |
| @@ -613,89 +878,89 @@ | ||
| 613 | 878 | return FrmDb::get_count( 'frm_forms', $where ); |
| 614 | 879 | } |
| 615 | 880 | |
| 616 | 881 | /** |
| 617 | - * @deprecated 3.01 | |
| 618 | - * @codeCoverageIgnore | |
| 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. | |
| 619 | 887 | */ |
| 620 | - public static function get_sigle_label_postitions() { | |
| 621 | - return FrmDeprecated::get_sigle_label_postitions(); | |
| 888 | + public static function is_advanced_settings() { | |
| 889 | + return FrmAppHelper::get_param( 'section' ) === 'advanced-settings' && FrmAppHelper::get_param( 'page' ) === 'formidable-styles'; | |
| 622 | 890 | } |
| 623 | 891 | |
| 624 | 892 | /** |
| 625 | - * @deprecated 3.02.03 | |
| 626 | - * @codeCoverageIgnore | |
| 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. | |
| 627 | 900 | */ |
| 628 | - public static function jquery_themes() { | |
| 629 | - return FrmDeprecated::jquery_themes(); | |
| 630 | - } | |
| 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' : ''; | |
| 631 | 906 | |
| 632 | - /** | |
| 633 | - * @deprecated 3.02.03 | |
| 634 | - * @codeCoverageIgnore | |
| 635 | - */ | |
| 636 | - public static function jquery_css_url( $theme_css ) { | |
| 637 | - return FrmDeprecated::jquery_css_url( $theme_css ); | |
| 907 | + return $classname; | |
| 638 | 908 | } |
| 639 | 909 | |
| 640 | 910 | /** |
| 641 | - * @deprecated 3.02.03 | |
| 642 | - * @codeCoverageIgnore | |
| 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. | |
| 643 | 918 | */ |
| 644 | - public static function enqueue_jquery_css() { | |
| 645 | - FrmDeprecated::enqueue_jquery_css(); | |
| 646 | - } | |
| 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 | + } | |
| 647 | 928 | |
| 648 | - /** | |
| 649 | - * @deprecated 3.02.03 | |
| 650 | - * @codeCoverageIgnore | |
| 651 | - */ | |
| 652 | - public static function get_form_for_page() { | |
| 653 | - return FrmDeprecated::get_form_for_page(); | |
| 929 | + return wp_get_attachment_url( (int) $background_image ); | |
| 654 | 930 | } |
| 655 | - | |
| 656 | 931 | /** |
| 657 | - * @since 4.0 | |
| 658 | - * @deprecated 6.0 The style menu is no longer used in the styler. | |
| 932 | + * Determines if the chosen JavaScript library should be used. | |
| 659 | 933 | * |
| 660 | - * @param string $active | |
| 661 | - * @return string | |
| 934 | + * @since 6.13 | |
| 935 | + * | |
| 936 | + * @return bool | |
| 662 | 937 | */ |
| 663 | - public static function get_style_menu( $active = '' ) { | |
| 664 | - _deprecated_function( __METHOD__, '6.0' ); | |
| 665 | - return ''; | |
| 666 | - } | |
| 938 | + public static function use_chosen_js() { | |
| 939 | + if ( ! FrmAppHelper::pro_is_installed() ) { | |
| 940 | + return false; | |
| 941 | + } | |
| 667 | 942 | |
| 668 | - /** | |
| 669 | - * @deprecated 6.0 The style menu is no longer used in the styler. | |
| 670 | - * | |
| 671 | - * @param string $active | |
| 672 | - * @return void | |
| 673 | - */ | |
| 674 | - public static function style_menu( $active = '' ) { | |
| 675 | - _deprecated_function( __METHOD__, '6.0' ); | |
| 943 | + return is_callable( 'FrmProAppHelper::use_chosen_js' ) | |
| 944 | + ? FrmProAppHelper::use_chosen_js() | |
| 945 | + : true; | |
| 676 | 946 | } |
| 677 | 947 | |
| 678 | 948 | /** |
| 679 | - * Either get the heading or the style switcher. | |
| 949 | + * Returns the bottom part from a margin/padding value. | |
| 680 | 950 | * |
| 681 | - * @since 4.0 | |
| 682 | - * @deprecated 6.0 The style switcher was replaced with a form switcher and is no longer used. | |
| 951 | + * @since 6.17 | |
| 683 | 952 | * |
| 684 | - * @param array $atts | |
| 685 | - * @return void | |
| 953 | + * @param string $value The margin/padding value. | |
| 954 | + * @return string | |
| 686 | 955 | */ |
| 687 | - public static function styler_switcher( $atts ) { | |
| 688 | - _deprecated_function( __METHOD__, '6.0' ); | |
| 689 | - } | |
| 690 | - | |
| 691 | - /** | |
| 692 | - * @since 4.0 | |
| 693 | - * @deprecated 6.0 The styler now uses the Embed/Preview/Update header. It uses the same save button as other pages with Form tabs. | |
| 694 | - * | |
| 695 | - * @param array $atts | |
| 696 | - * @return void | |
| 697 | - */ | |
| 698 | - public static function styler_save_button( $atts ) { | |
| 699 | - _deprecated_function( __METHOD__, '6.0' ); | |
| 956 | + public static function get_bottom_value( $value ) { | |
| 957 | + if ( ! $value ) { | |
| 958 | + return $value; | |
| 959 | + } | |
| 960 | + $parts = explode( ' ', $value ); | |
| 961 | + if ( count( $parts ) < 3 ) { | |
| 962 | + return $parts[0]; | |
| 963 | + } | |
| 964 | + return $parts[2]; | |
| 700 | 965 | } |
| 701 | 966 | } |
