private function get_themes_data_object(): ThemesData {
if ( wpforms()->is_pro() ) {
return new ProThemesData( new StockPhotos() );
return new LiteThemesData();
* Form builder saves values without pixels, we need to add them before outputting as CSS vars.
* @param array $css_vars CSS vars.
private function add_css_vars_units( array $css_vars ): array {
'container-border-width',
'container-border-radius',
foreach ( $has_pixels as $key ) {
if ( isset( $css_vars[ $key ] ) && is_numeric( $css_vars[ $key ] ) && $css_vars[ $key ] > 0 ) {
$css_vars[ $key ] .= 'px';
* Get selector variables CSS.
* @param string $selector Selector.
* @param array $vars Variables data.
* @param string|int $form_id Form ID. Optional. Default is an empty string.
private function get_selector_vars_css( string $selector, array $vars, $form_id = '' ): string {
$selector, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
wp_strip_all_tags( $this->get_vars_css( $vars, $form_id ) )
* @param array $vars Variables data.
* @param string|int $form_id Form ID. Optional. Default is an empty string.
private function get_pre_print_vars( array $vars, $form_id = '' ): array {
// Normalize the `background-url` variable.
if ( isset( $vars['background-url'] ) ) {
$vars['background-url'] = $vars['background-url'] === 'url()' ? 'none' : $vars['background-url'];
* Filter CSS variables right before printing the CSS.
* @param array $vars CSS variables.
* @param int $form_id Form ID. Optional. Default is an empty string.
return (array) apply_filters( 'wpforms_frontend_css_vars_pre_print_filter', $vars, $form_id );
* Generate CSS code from given vars data.
* @param array $vars Variables data.
* @param string|int $form_id Form ID. Optional. Default is an empty string.
private function get_vars_css( array $vars, $form_id = '' ): string {
$vars = $this->get_pre_print_vars( $vars, $form_id );
foreach ( $vars as $name => $value ) {
if ( ! is_string( $value ) ) {
$result .= "--wpforms-{$name}: {$value};\n";
if ( in_array( $name, self::SPARE_VARS, true ) ) {
$result .= "--wpforms-{$name}-spare: {$value};\n";
* Get customized CSS vars.
* @param array $attr Attributes passed by integration.
public function get_customized_css_vars( array $attr ): array { // phpcs:ignore Generic.Metrics.CyclomaticComplexity.TooHigh
$root_css_vars = $this->get_vars();
foreach ( $attr as $key => $value ) {
$var_name = strtolower( preg_replace( '/[A-Z]/', '-$0', $key ) );
// Skip an attribute that is not the CSS var or has the default value.
if ( empty( $root_css_vars[ $var_name ] ) || $root_css_vars[ $var_name ] === $value ) {
$css_vars[ $var_name ] = $value;
// Reset border size in case of border style is `none`.
$css_vars = $this->maybe_reset_border( $css_vars, 'field-border' );
$css_vars = $this->maybe_reset_border( $css_vars, 'button-border' );
// Set the button alternative background color and use border color for accent in case of transparent color.
$button_bg_color = $css_vars['button-background-color'] ?? $root_css_vars['button-background-color'];
if ( $this->is_transparent_color( $button_bg_color ) ) {
$css_vars['button-background-color-alt'] = $button_bg_color;
$border_color = $css_vars['button-border-color'] ?? $root_css_vars['button-border-color'];
$css_vars['button-background-color'] = $this->is_transparent_color( $border_color ) ? $root_css_vars['button-background-color'] : $border_color;
$button_bg_color = $css_vars['button-background-color'];
$button_bg_color = strtolower( $button_bg_color );
// Set the button alternative text color in case if the background and text color are identical.
$button_text_color = strtolower( $css_vars['button-text-color'] ?? $root_css_vars['button-text-color'] );
if ( $button_bg_color === $button_text_color || $this->is_transparent_color( $button_text_color ) ) {
$css_vars['button-text-color-alt'] = $this->get_contrast_color( $button_bg_color );
$size_css_vars = $this->get_size_css_vars( $attr );
return array_merge( $css_vars, $size_css_vars );
* Reset border size in case of border style is `none`.
* @param array $css_vars CSS vars.
* @param string $key Key.
private function maybe_reset_border( array $css_vars, string $key ): array {
$style_key = $key . '-style';
$size_key = $key . '-size';
if ( isset( $css_vars[ $style_key ] ) && $css_vars[ $style_key ] === 'none' ) {
$css_vars[ $size_key ] = '0px';
* Checks if the provided color has transparency.
* @param string $color The color to check.
private function is_transparent_color( string $color ): bool {
$rgba = $this->get_color_as_rgb_array( $color );
$opacity_threshold = 0.33;
$opacity = $rgba[3] ?? 1;
return $opacity < $opacity_threshold;
* Get contrast color relative to a given color.
* @param string|array $color The color.
private function get_contrast_color( $color ): string {
$rgba = is_array( $color ) ? $color : $this->get_color_as_rgb_array( $color );
$avg = (int) ( ( ( array_sum( $rgba ) ) / 3 ) * ( $rgba[3] ?? 1 ) );
return $avg < 128 ? '#ffffff' : '#000000';
* @since 1.8.8 Removed $css_vars argument.
* @param array $attr Attributes passed by integration.
private function get_size_css_vars( array $attr ): array {
$size_items = [ 'field', 'label', 'button', 'container-shadow' ];
foreach ( $size_items as $item ) {
$item_attr = preg_replace_callback(
static function ( $matches ) {
return strtoupper( $matches[1] );
$item_key = $item . '-size';
$item_constant = 'self::' . str_replace( '-', '_', strtoupper( $item ) ) . '_SIZE';
if ( empty( $attr[ $item_attr ] ) ) {
$size_css_vars[] = $this->get_complex_vars( $item_key, constant( $item_constant )[ $attr[ $item_attr ] ] );
return empty( $size_css_vars ) ? [] : array_merge( ...$size_css_vars );
* Get color as an array of RGB(A) values.
* @param string $color Color.
* @return array|bool Color as an array of RGBA values. False on error.
private function get_color_as_rgb_array( string $color ) {
// Remove # from the beginning of the string and remove whitespaces.
$color = preg_replace( '/^#/', '', strtolower( trim( $color ) ) );
$color = str_replace( ' ', '', (string) $color );
if ( $color === 'transparent' ) {
$color = 'rgba(0,0,0,0)';
// Check if color is in HEX(A) format.
$is_hex = preg_match( '/[0-9a-f]{6,8}$/', $rgba );
// Search and split HEX(A) color into an array of char couples.
preg_match_all( '/\w\w/', $rgba, $rgb_array );
static function ( $value ) {
return hexdec( '0x' . $value );
$rgb_array[3] = ( $rgb_array[3] ?? 255 ) / 255;
$rgba = preg_replace( '/[^\d,.]/', '', $rgba );
$rgb_array = explode( ',', $rgba );