Файловый менеджер - Редактировать - /home/tuudkjt/globeasy/wp-content/plugins/woocommerce/packages/email-editor/src/Integrations/Utils/class-styles-helper.php
Назад
<?php /** * This file is part of the WooCommerce Email Editor package * * @package Automattic\WooCommerce\EmailEditor */ declare( strict_types = 1 ); namespace Automattic\WooCommerce\EmailEditor\Integrations\Utils; use Automattic\WooCommerce\EmailEditor\Engine\Renderer\ContentRenderer\Rendering_Context; use WP_Style_Engine; /** * This class should guarantee that our work with the DOMDocument is unified and safe. */ class Styles_Helper { /** * Default empty styles block structure. * * @var array */ public static $empty_block_styles = array( 'css' => '', 'declarations' => array(), 'classnames' => '', ); /** * Parse number value from a string. * * @param string|float|int $value String with value and unit or integer value. * @return float */ public static function parse_value( $value ): float { // Handle numeric values. if ( is_numeric( $value ) ) { return (float) $value; } // Handle string values. if ( is_string( $value ) ) { if ( preg_match( '/^\s*(-?\d+(?:\.\d+)?)/', $value, $m ) ) { return (float) $m[1]; } } return 0.0; } /** * Parse styles string to array. * * @param string $styles Styles string. * @return array */ public static function parse_styles_to_array( string $styles ): array { $styles = explode( ';', $styles ); $parsed_styles = array(); foreach ( $styles as $style ) { $style = explode( ':', $style, 2 ); if ( count( $style ) === 2 ) { $parsed_styles[ trim( $style[0] ) ] = trim( $style[1] ); } } return $parsed_styles; } /** * Get normalized block styles by translating color slugs to actual color values. * * This method handles the normalization of color-related attributes like backgroundColor, * textColor, borderColor, and linkColor by translating them from slugs to actual color values * using the rendering context. * * @param array $block_attributes Block attributes containing color slugs. * @param Rendering_Context $rendering_context Rendering context for color translation. * @return array Normalized block styles with translated color values. */ public static function get_normalized_block_styles( array $block_attributes, Rendering_Context $rendering_context ): array { $normalized_colors = array_filter( array( 'color' => array_filter( array( 'background' => isset( $block_attributes['backgroundColor'] ) && $block_attributes['backgroundColor'] ? $rendering_context->translate_slug_to_color( $block_attributes['backgroundColor'] ) : null, 'text' => isset( $block_attributes['textColor'] ) && $block_attributes['textColor'] ? $rendering_context->translate_slug_to_color( $block_attributes['textColor'] ) : null, ) ), 'border' => array_filter( array( 'color' => isset( $block_attributes['borderColor'] ) && $block_attributes['borderColor'] ? $rendering_context->translate_slug_to_color( $block_attributes['borderColor'] ) : null, ) ), ) ); return array_replace_recursive( $normalized_colors, $block_attributes['style'] ?? array() ); } /** * Wrapper for wp_style_engine_get_styles which ensures all values are returned. * * @param array $block_styles Array of block styles. * @param bool $skip_convert_vars If true, --wp_preset--spacing--x type values will be left in the original var:preset:spacing:x format. * @return array { * @type string $css A CSS ruleset or declarations block * formatted to be placed in an HTML `style` attribute or tag. * @type string[] $declarations An associative array of CSS definitions, * e.g. `array( "$property" => "$value", "$property" => "$value" )`. * @type string $classnames Classnames separated by a space. * } */ public static function get_styles_from_block( array $block_styles, $skip_convert_vars = false ) { return wp_parse_args( wp_style_engine_get_styles( $block_styles, array( 'convert_vars_to_classnames' => $skip_convert_vars ) ), self::$empty_block_styles ); } /** * Extend block styles with CSS declarations. * * @param array $block_styles WP_Style_Engine styles array (must contain 'declarations' and 'css' keys). * @param array $css_declarations An associative array of CSS definitions, * e.g. `array( "$property" => "$value", "$property" => "$value" )`. * @return array { * @type string $css A CSS ruleset or declarations block * formatted to be placed in an HTML `style` attribute or tag. * @type string[] $declarations An associative array of CSS definitions, * e.g. `array( "$property" => "$value", "$property" => "$value" )`. * @type string $classnames Classnames separated by a space. * } */ public static function extend_block_styles( array $block_styles, array $css_declarations ) { // Ensure block_styles has the required WP_Style_Engine structure. if ( ! isset( $block_styles['declarations'] ) || ! is_array( $block_styles['declarations'] ) ) { $block_styles = self::$empty_block_styles; } $block_styles['declarations'] = array_merge( $block_styles['declarations'], $css_declarations ); $block_styles['css'] = WP_Style_Engine::compile_css( $block_styles['declarations'], '' ); return $block_styles; } /** * Get block styles. * * @param array $block_attributes Block attributes. * @param Rendering_Context $rendering_context Rendering context. * @param array $properties List of style properties to include. Supported values: * 'spacing', 'padding', 'margin', * 'border', 'border-width', 'border-style', 'border-radius', 'border-color', * 'background', 'background-color', 'color', * 'typography', 'font-size', 'font-family', 'font-weight', 'text-align'. * @return array { * @type string $css A CSS ruleset or declarations block * formatted to be placed in an HTML `style` attribute or tag. * @type string[] $declarations An associative array of CSS definitions, * e.g. `array( "$property" => "$value", "$property" => "$value" )`. * @type string $classnames Classnames separated by a space. * } */ public static function get_block_styles( array $block_attributes, Rendering_Context $rendering_context, array $properties ) { $styles = self::get_normalized_block_styles( $block_attributes, $rendering_context ); $filtered_styles = array(); $style_mappings = array( 'spacing' => array( 'spacing' ), 'padding' => array( 'spacing', 'padding' ), 'margin' => array( 'spacing', 'margin' ), 'border' => array( 'border' ), 'border-width' => array( 'border', 'width' ), 'border-style' => array( 'border', 'style' ), 'border-radius' => array( 'border', 'radius' ), 'border-color' => array( 'border', 'color' ), 'background' => array( 'background' ), 'background-color' => array( 'color', 'background' ), 'color' => array( 'color', 'text' ), 'typography' => array( 'typography' ), 'font-size' => array( 'typography', 'fontSize' ), 'font-family' => array( 'typography', 'fontFamily' ), 'font-weight' => array( 'typography', 'fontWeight' ), ); foreach ( $properties as $property ) { if ( ! isset( $style_mappings[ $property ] ) ) { continue; } $style_pointer = $styles; foreach ( $style_mappings[ $property ] as $path_segment ) { if ( ! isset( $style_pointer[ $path_segment ] ) ) { continue 2; } $style_pointer = $style_pointer[ $path_segment ]; } /** * Pointer to filtered styles. * * @var array<string, mixed> $filtered_styles_pointer */ $filtered_styles_pointer = & $filtered_styles; foreach ( $style_mappings[ $property ] as $path_index => $path_segment ) { if ( count( $style_mappings[ $property ] ) - 1 === $path_index ) { $filtered_styles_pointer[ $path_segment ] = $style_pointer; break; } if ( ! isset( $filtered_styles_pointer[ $path_segment ] ) || ! is_array( $filtered_styles_pointer[ $path_segment ] ) ) { $filtered_styles_pointer[ $path_segment ] = array(); } $filtered_styles_pointer = & $filtered_styles_pointer[ $path_segment ]; } } $additional_css_declarations = array_filter( array_intersect_key( array( 'text-align' => $block_attributes['textAlign'] ?? null, ), array_flip( $properties ) ) ); $styles = count( $filtered_styles ) > 0 ? self::get_styles_from_block( $filtered_styles ) : self::$empty_block_styles; return self::extend_block_styles( $styles, $additional_css_declarations ); } /** * Convert a CSS value to a static px value for email clients. * * This is mostly for use in font size, spacing, etc. * * @param string $input The CSS value to convert. * @param bool $use_fallback Whether to use the fallback value if the input is not a valid CSS value. * @param ?int $base_font_size The base font size to use for conversion. * @return ?string The static pixel value (e.g., 30px). */ public static function convert_to_px( string $input, bool $use_fallback = true, ?int $base_font_size = 16 ): ?string { $fallback = $use_fallback ? $base_font_size . 'px' : null; if ( ! $input ) { return $fallback; } $input = trim( $input ); // Validate input against potentially malicious values. if ( preg_match( '/[<>"\']/', $input ) ) { return $fallback; } if ( str_ends_with( $input, 'px' ) ) { // If already in px, return as is. return $input; } if ( str_ends_with( $input, 'rem' ) || str_ends_with( $input, 'em' ) ) { // Convert rem/em to px (assuming 16px base). $value = (float) str_replace( array( 'rem', 'em' ), '', $input ); return round( $value * $base_font_size ) . 'px'; } if ( str_ends_with( $input, '%' ) ) { // Convert percentage to px (assuming 16px base). $value = (float) str_replace( '%', '', $input ); return round( ( $value / 100 ) * $base_font_size ) . 'px'; } if ( is_numeric( $input ) ) { // If it's just a number, assume px. return $input . 'px'; } return $fallback; } /** * Remove the CSS unit from a string. * * @param string $input The string to remove the unit from. * @return string The string without the unit. */ public static function remove_css_unit( string $input ): string { $units = array( 'px', 'pt', 'pc', 'rem', 'em', 'vmin', 'vmax', '%', 'vh', 'vw', 'ex', 'ch', 'fr' ); return str_ireplace( $units, '', $input ); } /** * Convert a CSS clamp() value to a static px value for email clients. * * @param string $clamp_str The clamp() CSS string (e.g., "clamp(30px, 5vw, 50px)"). * @param string $strategy "min"|"max"|"avg" — which strategy to use. * @return ?string The static pixel value (e.g., 30px). */ public static function clamp_to_static_px( $clamp_str, $strategy = 'min' ): ?string { if ( stripos( $clamp_str, 'clamp(' ) === false ) { return $clamp_str; } $value_array = explode( ',', $clamp_str ); if ( count( $value_array ) < 2 ) { return $clamp_str; // Invalid clamp format. } $first_element = $value_array[0]; $min = trim( str_ireplace( array( 'clamp(', 'min(', 'max(' ), '', $first_element ) ); $last_element = $value_array[ count( $value_array ) - 1 ]; $max = trim( rtrim( $last_element, ')' ) ); $min_px = self::convert_to_px( $min, false ); $max_px = self::convert_to_px( $max, false ); // Determine which value to use. if ( 'min' === $strategy && ! is_null( $min_px ) ) { return $min_px; } if ( 'max' === $strategy && ! is_null( $max_px ) ) { return $max_px; } if ( 'avg' === $strategy && ! is_null( $min_px ) && ! is_null( $max_px ) ) { $avg = ( self::parse_value( $min_px ) + self::parse_value( $max_px ) ) / 2; return $avg . 'px'; } // Default. return $min_px ?? $max_px ?? $clamp_str; } }
| ver. 1.6 |
Github
|
.
| PHP 8.1.34 | Генерация страницы: 0 |
proxy
|
phpinfo
|
Настройка