array(),
'array_map' => array(),
'sort' => '__return_false',
'comparison' => '__return_false',
);
/**
* Generate an XML-RPC array.
*
* @param array $values
*
* @return string
*/
private function _create_xmlrpc_array( $values ) {
$output = '';
foreach ( $values as $value ) {
$output .= $this->_create_xmlrpc_value( $value );
}
return "{$output}";
}
/**
* Generate an XML-RPC struct.
*
* @param array $members
*
* @return string
*/
private function _create_xmlrpc_struct( $members ) {
$output = '';
foreach ( $members as $name => $value ) {
$output .= sprintf( '%1$s%2$s', esc_html( $name ), $this->_create_xmlrpc_value( $value ) );
}
return "{$output}";
}
/**
* Generate an XML-RPC value.
*
* @param mixed $value
*
* @return string
*/
private function _create_xmlrpc_value( $value ) {
$output = '';
if ( is_string( $value ) ) {
$value = esc_html( wp_strip_all_tags( $value ) );
$output = "{$value}";
} else if ( is_bool( $value ) ) {
$value = (int) $value;
$output = "{$value}";
} else if ( is_int( $value ) ) {
$output = "{$value}";
} else if ( is_array( $value ) && $this->is_assoc_array( $value ) ) {
$output = $this->_create_xmlrpc_struct( $value );
} else if ( is_array( $value ) ) {
$output = $this->_create_xmlrpc_array( $value );
}
return "{$output}";
}
/**
* Convert a SimpleXMLElement to a native PHP data type.
*
* @param SimpleXMLElement $value
*
* @return mixed
*/
private function _parse_value( $value ) {
switch ( true ) {
case is_string( $value ):
$result = $value;
break;
case count( $value->struct ) > 0:
$result = new stdClass();
foreach ( $value->struct->member as $member ) {
$name = (string) $member->name;
$member_value = $this->_parse_value( $member->value );
$result->$name = $member_value;
}
break;
case count( $value->array ) > 0:
$result = array();
foreach ( $value->array->data->value as $array_value ) {
$result[] = $this->_parse_value( $array_value );
}
break;
case count( $value->i4 ) > 0:
$result = (int) $value->i4;
break;
case count( $value->int ) > 0:
$result = (int) $value->int;
break;
case count( $value->boolean ) > 0:
$result = (boolean) $value->boolean;
break;
case count( $value->double ) > 0:
$result = (double) $value->double;
break;
default:
$result = (string) $value;
}
return $result;
}
private function _remove_empty_directories( $path ) {
if ( ! is_dir( $path ) ) {
return false;
}
$empty = true;
$directory_contents = glob( untrailingslashit( $path ) . '/*' );
foreach ( (array) $directory_contents as $item ) {
if ( ! $this->_remove_empty_directories( $item ) ) {
$empty = false;
}
}
return $empty ? @rmdir( $path ) : false;
}
public function _array_pick_callback( $item ) {
$pick = $this->_pick;
$value = $this->_pick_value;
if ( is_array( $item ) && isset( $item[ $pick ] ) ) {
return '_undefined_' !== $value ? $value === $item[ $pick ] : $item[ $pick ];
} else if ( is_object( $item ) && isset( $item->$pick ) ) {
return '_undefined_' !== $value ? $value === $item->$pick : $item->$pick;
}
return false;
}
public function _array_sort_by_callback( $a, $b ) {
$sort_by = $this->_sort_by;
if ( is_array( $a ) ) {
return strcmp( $a[ $sort_by ], $b[ $sort_by ] );
} else if ( is_object( $a ) ) {
return strcmp( $a->$sort_by, $b->$sort_by );
}
return 0;
}
/**
* Returns `true` if all values in `$array` are not empty, `false` otherwise.
* If `$condition` is provided then values are checked against it instead of `empty()`.
*
* @param array $array
* @param bool $condition Compare values to this instead of `empty()`. Optional.
*
* @return bool
*/
public function all( array $array, $condition = null ) {
if ( null === $condition ) {
foreach( $array as $key => $value ) {
if ( empty( $value ) ) {
return false;
}
}
} else {
foreach( $array as $key => $value ) {
if ( $value !== $condition ) {
return false;
}
}
}
return true;
}
/**
* Flattens a multi-dimensional array.
*
* @since 3.0.99
*
* @param array $array An array to flatten.
*
* @return array
*/
function array_flatten( array $array ) {
$iterator = new RecursiveIteratorIterator( new RecursiveArrayIterator( $array ) );
$use_keys = true;
return iterator_to_array( $iterator, $use_keys );
}
/**
* Gets a value from a nested array using an address string.
*
* @param array $array An array which contains value located at `$address`.
* @param string|array $address The location of the value within `$array` (dot notation).
* @param mixed $default Value to return if not found. Default is an empty string.
*
* @return mixed The value, if found, otherwise $default.
*/
public function array_get( $array, $address, $default = '' ) {
$keys = is_array( $address ) ? $address : explode( '.', $address );
$value = $array;
foreach ( $keys as $key ) {
if ( ! empty( $key ) && isset( $key[0] ) && '[' === $key[0] ) {
$index = substr( $key, 1, -1 );
if ( is_numeric( $index ) ) {
$key = (int) $index;
}
}
if ( ! isset( $value[ $key ] ) ) {
return $default;
}
$value = $value[ $key ];
}
return $value;
}
/**
* Wrapper for {@see self::array_get()} that sanitizes the value before returning it.
*
* @since 4.0.7
*
* @param array $array An array which contains value located at `$address`.
* @param string $address The location of the value within `$array` (dot notation).
* @param mixed $default Value to return if not found. Default is an empty string.
* @param string $sanitizer Sanitize function to use. Default is 'sanitize_text_field'.
*
* @return mixed The sanitized value if found, otherwise $default.
*/
public function array_get_sanitized( $array, $address, $default = '', $sanitizer = 'sanitize_text_field' ) {
if ( $value = $this->array_get( $array, $address, $default ) ) {
$value = $sanitizer( $value );
}
return $value;
}
/**
* Creates a new array containing only the items that have a key or property or only the items that
* have a key or property that is equal to a certain value.
*
* @param array $array The array to pick from.
* @param string|array $pick_by The key or property to look for or an array mapping the key or property
* to a value to look for.
*
* @return array
*/
public function array_pick( $array, $pick_by ) {
if ( is_string( $pick_by ) || is_int( $pick_by ) ) {
$this->_pick = $pick_by;
} else if ( is_array( $pick_by ) && 1 === count( $pick_by ) ) {
$this->_pick = key( $pick_by );
$this->_pick_value = array_pop( $pick_by );
} else {
return array();
}
return array_filter( $array, array( $this, '_array_pick_callback' ) );
}
/**
* Sets a value in a nested array using an address string (dot notation)
*
* @see http://stackoverflow.com/a/9628276/419887
*
* @param array $array The array to modify
* @param string|array $path The path in the array
* @param mixed $value The value to set
*/
public function array_set( &$array, $path, $value ) {
$path_parts = is_array( $path ) ? $path : explode( '.', $path );
$current = &$array;
foreach ( $path_parts as $key ) {
if ( ! is_array( $current ) ) {
$current = array();
}
if ( '[' === $key[0] && is_numeric( substr( $key, 1, - 1 ) ) ) {
$key = (int) $key;
}
$current = &$current[ $key ];
}
$current = $value;
}
public function array_sort_by( $array, $key_or_prop ) {
if ( ! is_string( $key_or_prop ) && ! is_int( $key_or_prop ) ) {
return $array;
}
$this->_sort_by = $key_or_prop;
if ( $this->is_assoc_array( $array ) ) {
uasort( $array, array( $this, '_array_sort_by_callback' ) );
} else {
usort( $array, array( $this, '_array_sort_by_callback' ) );
}
return $array;
}
/**
* Update a nested array value found at the provided path using {@see array_merge()}.
*
* @since 4.0.7
*
* @param array $array
* @param $path
* @param $value
*/
public function array_update( &$array, $path, $value ) {
$current_value = $this->array_get( $array, $path, array() );
$this->array_set( $array, $path, array_merge( $current_value, $value ) );
}
/**
* Whether or not a string ends with a substring.
*
* @since 4.5.3
*
* @param string $haystack The string to look in.
* @param string $needle The string to look for.
*
* @return bool
*/
public function ends_with( $haystack, $needle ) {
$length = strlen( $needle );
if ( 0 === $length ) {
return true;
}
return ( substr( $haystack, -$length ) === $needle );
}
public function ensure_directory_exists( $path ) {
if ( file_exists( $path ) ) {
return is_dir( $path );
}
// Try to create the directory
$path = $this->normalize_path( $path );
if ( ! $this->WPFS()->mkdir( $path ) ) {
// Walk up the tree and create any missing parent directories
$this->ensure_directory_exists( dirname( $path ) );
$this->WPFS()->mkdir( $path );
}
return is_dir( $path );
}
public static function instance() {
if ( ! self::$_instance ) {
self::$_instance = new ET_Core_Data_Utils();
}
return self::$_instance;
}
/**
* Determine if an array has any `string` keys (thus would be considered an object in JSON)
*
* @param $array
*
* @return bool
*/
public function is_assoc_array( $array ) {
return is_array( $array ) && count( array_filter( array_keys( $array ), 'is_string' ) ) > 0;
}
/**
* Determine if value is an XML-RPC error.
*
* @param SimpleXMLElement $value
*
* @return bool
*/
public function is_xmlrpc_error( $value ) {
return is_object( $value ) && isset( $value->faultCode );
}
/**
* Replaces any Windows style directory separators in $path with Linux style separators.
* Windows actually supports both styles, even mixed together. However, its better not
* to mix them (especially when doing string comparisons on paths).
*
* @since 4.0.8 Use {@see wp_normalize_path()} if it exists. Remove all occurrences of '..' from paths.
* @since 3.0.52
*
* @param string $path
*
* @return string
*/
public function normalize_path( $path = '' ) {
$path = (string) $path;
$path = str_replace( '..', '', $path );
if ( function_exists( 'wp_normalize_path' ) ) {
return wp_normalize_path( $path );
}
return str_replace( '\\', '/', $path );
}
/**
* Generate post data for a XML-RPC method call
*
* @param string $method_name
* @param array $params
*
* @return string
*/
public function prepare_xmlrpc_method_call( $method_name, $params = array() ) {
$output = '';
foreach ( $params as $param ) {
$value = $this->_create_xmlrpc_value( $param );
$output .= "{$value}";
}
$method_name = esc_html( $method_name );
return
"
{$method_name}
{$output}
";
}
/**
* Disable XML entity loader.
*
* @since 4.7.5 Don't execute deprecated `libxml_disable_entity_loader()` on PHP 8.0.
*
* @param bool $disable
*
* @return void
*/
public function libxml_disable_entity_loader( $disable ) {
// The `libxml_disable_entity_loader()` method is deprecated since PHP 8.0 because
// PHP 8.0 and later uses libxml versions from 2.9.0, which disabled XXE by default.
if ( PHP_VERSION_ID < 80000 && function_exists( 'libxml_disable_entity_loader' ) ) {
libxml_disable_entity_loader( $disable );
}
}
/**
* Securely use simplexml_load_string.
*
* @param string $data XML data string.
*
* @return SimpleXMLElement
*/
public function simplexml_load_string( $data ) {
$this->libxml_disable_entity_loader( true );
return simplexml_load_string( $data );
}
/**
* Creates a path string using the provided arguments.
*
* Examples:
* - ```
* et_()->path( '/this/is', 'a', 'path' );
* // Returns '/this/is/a/path'
* ```
* - ```
* et_()->path( ['/this/is', 'a', 'path', 'to', 'file.php'] );
* // Returns '/this/is/a/path/to/file.php'
* ```
*
* @since 4.0.6
*
* @param string|string[] ...$parts
*
* @return string
*/
public function path() {
$parts = func_get_args();
$path = '';
if ( 1 === count( $parts ) && is_array( reset( $parts ) ) ) {
$parts = array_pop( $parts );
}
foreach ( $parts as $part ) {
$path .= "{$part}/";
}
return substr( $path, 0, -1 );
}
/**
* Process an XML-RPC response string.
*
* @param $response
*
* @return mixed
*/
public function process_xmlrpc_response( $response, $skip_processing = false ) {
$response = $this->simplexml_load_string( $response );
$result = array();
if ( $skip_processing ) {
return $response;
}
if ( count( $response->fault ) > 0 ) {
// An error was returned
return $this->_parse_value( $response->fault->value );
}
$single = count( $response->params->param ) === 1;
foreach ( $response->params->param as $param ) {
$value = $this->_parse_value( $param->value );
if ( $single ) {
return $value;
} else {
$result[] = $value;
}
}
return $result;
}
/**
* Removes empty directories recursively starting at and (possibly) including `$path`. `$path` must be
* an absolute path located under {@see WP_CONTENT_DIR}. Current user must have 'manage_options'
* capability. If the path or permissions check fails, no directories will be removed.
*
* @param string $path Absolute path to parent directory.
*/
public function remove_empty_directories( $path ) {
$path = realpath( $path );
if ( empty( $path ) ) {
// $path doesn't exist
return;
}
$path = $this->normalize_path( $path );
$content_dir = $this->normalize_path( WP_CONTENT_DIR );
if ( 0 !== strpos( $path, $content_dir ) || $content_dir === $path ) {
return;
}
$capability = 0 === strpos( $path, "{$content_dir}/cache/et" ) ? 'edit_posts' : 'manage_options';
if ( ! wp_doing_cron() && ! et_core_security_check_passed( $capability ) ) {
return;
}
$this->_remove_empty_directories( $path );
}
/**
* Whether or not a value includes another value.
*
* @param mixed $haystack The value to look in.
* @param string $needle The value to look for.
*
* @return bool
*/
public function includes( $haystack, $needle ) {
if ( is_string( $haystack ) ) {
return false !== strpos( $haystack, $needle );
}
if ( is_object( $haystack ) ) {
return property_exists( $haystack, $needle );
}
if ( is_array( $haystack ) ) {
return in_array( $needle, $haystack );
}
return false;
}
public function sanitize_text_fields( $fields ) {
if ( ! is_array( $fields ) ) {
return sanitize_text_field( $fields );
}
$result = array();
foreach ( $fields as $field_id => $field_value ) {
$field_id = sanitize_text_field( $field_id );
if ( is_array( $field_value ) ) {
$field_value = $this->sanitize_text_fields( $field_value );
} else {
$field_value = sanitize_text_field( $field_value );
}
$result[ $field_id ] = $field_value;
}
return $result;
}
/**
* Recursively traverses an array and escapes the keys and values according to passed escaping function.
*
* @since 3.17.3
*
* @param array $values The array to be recursively escaped.
* @param string $escaping_function The escaping function to be used on keys and values. Default 'esc_html'. Optional.
*
* @return array
*/
public function esc_array( $values, $escaping_function = 'esc_html' ) {
if ( ! is_array( $values ) ) {
return $escaping_function( $values );
}
$result = array();
foreach ( $values as $key => $value ) {
$key = $escaping_function( $key );
if ( is_array( $value ) ) {
$value = $this->esc_array( $value, $escaping_function );
} else {
$value = $escaping_function( $value );
}
$result[ $key ] = $value;
}
return $result;
}
/**
* Transforms an array of data into a new array based on the provided transformation definition.
*
* @since 3.10 Renamed from `transform_data_to` to `array_transform`.
* @since 3.0.68
*
* @param array $data The data to transform.
* @param array $data_map Transformation definition. See examples below.
* @param string $direction The direction in which to transform. Accepts '->', '<-'. Default '->'
* @param array $exclude_keys Keys that should be excluded from the result. Optional.
*
* @return array
*/
public function array_transform( $data, $data_map, $direction = '->', $exclude_keys = array() ) {
$result = array();
if ( ! in_array( $direction, array( '->', '<-' ) ) ) {
return $result;
}
foreach ( $data_map as $address_1 => $address_2 ) {
$from_address = '->' === $direction ? $address_1 : $address_2;
$to_address = '->' === $direction ? $address_2 : $address_1;
$array_value_required = $negate_bool_value = false;
if ( 0 === strpos( $to_address, '@' ) || 0 === strpos( $from_address, '@' ) ) {
$array_value_required = true;
$to_address = ltrim( $to_address, '@' );
$from_address = ltrim( $from_address, '@' );
} else if ( 0 === strpos( $to_address, '!' ) || 0 === strpos( $from_address, '!' ) ) {
$negate_bool_value = true;
$to_address = ltrim( $to_address, '!' );
$from_address = ltrim( $from_address, '!' );
}
if ( ! empty( $exclude_keys ) && array_key_exists( $to_address, $exclude_keys ) ) {
continue;
}
$value = $this->array_get( $data, $from_address, null );
if ( null === $value ) {
// Unknown key, skip it.
continue;
}
if ( $array_value_required && ! is_array( $value ) ) {
$value = array( $value );
} else if ( $negate_bool_value ) {
$value = (bool) $value;
$value = ! $value;
}
$this->array_set( $result, $to_address, $value );
}
return $result;
}
/**
* Converts xml data to array. Useful in cases where the xml doesn't adhere to XML-RPC spec.
*
* @param string|\SimpleXMLElement $xml_data
*
* @return array
*/
public function xml_to_array( $xml_data ) {
if ( is_string( $xml_data ) ) {
$xml_data = $this->simplexml_load_string( $xml_data );
}
$json = wp_json_encode( $xml_data );
return json_decode( $json, true );
}
/**
* Make sure that in provided selector do not exist sub-selectors that targets inputs placeholders
*
* If they exist they should be split in an apart selector.
*
* @param string $selector
*
* @return array Return a list of selectors
*/
public function sanitize_css_placeholders( $selector ) {
$selectors = explode( ',', $selector );
$selectors = array_map( 'trim', $selectors );
$selectors = array_filter( $selectors );
$main_selector = array();
$exceptions = array();
$placeholders = array(
'::-webkit-input-placeholder',
'::-moz-placeholder',
':-ms-input-placeholder',
);
// No need to sanitize if is a single selector or even no selectors at all
// Also if selectors do not contain placeholder meta-selector
if ( count( $selectors ) < 2 || ! preg_match( '/' . implode( '|', $placeholders ) . '/', $selector ) ) {
return array( $selector );
}
foreach ( $selectors as $_selector ) {
foreach ( $placeholders as $placeholder ) {
if ( strpos( $_selector, $placeholder ) !== false ) {
$exceptions[] = $_selector;
continue 2;
}
}
$main_selector[] = $_selector;
}
return array_filter( array_merge( array( implode( ', ', $main_selector ) ), $exceptions ) );
}
/**
* Whether or not a string starts with a substring.
*
* @since 4.0
*
* @param string $string
* @param string $substring
*
* @return bool
*/
public function starts_with( $string, $substring ) {
return 0 === strpos( $string, $substring );
}
/**
* Convert string to camel case format.
*
* @since 4.0
*
* @param string $string Original string data.
* @param array $no_strip Additional regex pattern exclusion.
*
* @return string
*/
public function camel_case( $string, $no_strip = array() ) {
$words = preg_split( '/[^a-zA-Z0-9' . implode( '', $no_strip ) . ']+/i', strtolower( $string ) );
if ( count( $words ) === 1 ) {
return $words[0];
}
$camel_cased = implode( '', array_map( 'ucwords', $words ) );
$camel_cased[0] = strtolower( $camel_cased[0] );
return $camel_cased;
}
/**
* Returns the WP Filesystem instance.
*
* @since 4.0.6
*
* @return WP_Filesystem_Base {@see ET_Core_PageResource::wpfs()}
*/
public function WPFS() {
return et_core_cache_dir()->wpfs;
}
/**
* Equivalent of usort but preserves relative order of equally weighted values.
*
* @since 4.0.9
*
* @param array &$array
* @param callable $comparison_function
*
* @return array
*/
public function usort( &$array, $comparison_function ) {
return $this->_user_sort( $array, 'usort', $comparison_function );
}
/**
* Equivalent of uasort but preserves relative order of equally weighted values.
*
* @since 4.0.9
*
* @param array &$array
* @param callable $comparison_function
*
* @return array
*/
public function uasort( &$array, $comparison_function ) {
return $this->_user_sort( $array, 'uasort', $comparison_function );
}
/**
* Equivalent of uksort but preserves relative order of equally weighted values.
*
* @since 4.0.9
*
* @param array &$array
* @param callable $comparison_function
*
* @return array
*/
public function uksort( &$array, $comparison_function ) {
return $this->_user_sort( $array, 'uksort', $comparison_function );
}
/**
* Returns a string with a valid CSS property value.
*
* With some locales (ex: ro_RO) the decimal point can be ',' (comma) and
* we need to convert that to a '.' (period) decimal point to ensure that
* the value is a valid CSS property value.
*
* @since 4.4.8
*
* @param float $float Original float value.
*
* @return string
*/
public function to_css_decimal( $float ) {
return strtr( $float, ',', '.' );
}
/**
* Sort using a custom function accounting for the common undefined order
* pitfall due to a return value of 0.
*
* @since 4.0.9
*
* @param array &$array Array to sort
* @param callable $sort_function "usort", "uasort" or "uksort"
* @param callable $comparison_function Custom comparison function
*
* @return array
*/
protected function _user_sort( &$array, $sort_function, $comparison_function ) {
$allowed_sort_functions = array( 'usort', 'uasort', 'uksort' );
if ( ! $this->includes( $allowed_sort_functions, $sort_function ) ) {
_doing_it_wrong( __FUNCTION__, esc_html__( 'Only custom sorting functions can be used.', 'et_core' ), esc_html( et_get_theme_version() ) );
}
// Use properties temporarily to pass values in order to preserve PHP 5.2 support.
$this->sort_arguments['array'] = $array;
$this->sort_arguments['sort'] = $sort_function;
$this->sort_arguments['comparison'] = $comparison_function;
$this->sort_arguments['array_map'] = 'uksort' === $sort_function
? array_flip( array_keys( $array ) )
: array_values( $array );
$sort_function( $array, array( $this, '_user_sort_callback' ) );
$this->sort_arguments['array'] = array();
$this->sort_arguments['array_map'] = array();
$this->sort_arguments['sort'] = '__return_false';
$this->sort_arguments['comparison'] = '__return_false';
return $array;
}
/**
* Sort callback only meant to acompany self::sort().
* Do not use outside of self::_user_sort().
*
* @since 4.0.9
*
* @param mixed $a
* @param mixed $b
*
* @return integer
*/
protected function _user_sort_callback( $a, $b ) {
// @phpcs:ignore Generic.PHP.ForbiddenFunctions.Found
$result = (int) call_user_func( $this->sort_arguments['comparison'], $a, $b );
if ( 0 !== $result ) {
return $result;
}
if ( 'uksort' === $this->sort_arguments['sort'] ) {
// Intentional isset() use for performance reasons.
$a_order = isset( $this->sort_arguments['array_map'][ $a ] ) ? $this->sort_arguments['array_map'][ $a ] : false;
$b_order = isset( $this->sort_arguments['array_map'][ $b ] ) ? $this->sort_arguments['array_map'][ $b ] : false;
} else {
$a_order = array_search( $a, $this->sort_arguments['array_map'] );
$b_order = array_search( $b, $this->sort_arguments['array_map'] );
}
if ( false === $a_order || false === $b_order ) {
// This should not be possible so we fallback to the undefined
// sorting behavior by returning 0.
return 0;
}
return $a_order - $b_order;
}
/**
* Returns RFC 4211 compliant Universally Unique Identifier (UUID) version 4
* https://tools.ietf.org/html/rfc4122
*
* @since 4.5.0
*
* @param array $random_sequence The initial random sequence. Mostly used for test purposes.
*
* @return string
*/
public static function uuid_v4( $random_sequence = null ) {
$buffer = array();
for ( $i = 0; $i < 16; $i++) {
$buffer[] = isset( $random_sequence[ $i ] ) ? $random_sequence[ $i ] : mt_rand(0, 0xff);
}
// The high field of the timestamp multiplexed with the version number
$buffer[6] = ( $buffer[6] & 0x0f ) | 0x40;
// The high field of the clock sequence multiplexed with the variant
$buffer[8] = ( $buffer[8] & 0x3f ) | 0x80;
return sprintf(
'%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x',
// Time low
$buffer[0],
$buffer[1],
$buffer[2],
$buffer[3],
// Time mid
$buffer[4],
$buffer[5],
// Time hi and version
$buffer[6],
$buffer[7],
// Clock seq hi and reserved
$buffer[8],
// Clock seq low
$buffer[9],
// Node
$buffer[10],
$buffer[11],
$buffer[12],
$buffer[13],
$buffer[14],
$buffer[15]
);
}
/**
* Append/Prepend to comma separated selectors.
*
* Example:
*
* @see UtilsTest::testAppendPrependCommaSeparatedSelectors()
*
* @param string $css_selector Comma separated CSS selectors.
* @param string $value Value to append/prepend.
* @param string $prefix_suffix Values can be `prefix` or `suffix`.
* @param bool $is_space_required Is space required? // phpcs:ignore Squiz.Commenting.FunctionComment.ParamCommentFullStop -- Respecting punctuation.
*
* @return string
*/
public function append_prepend_comma_separated_selectors(
$css_selector,
$value,
$prefix_suffix,
$is_space_required = true
) {
$css_selectors = explode( ',', $css_selector );
$css_selectors_processed = array();
$is_prefix = 'prefix' === $prefix_suffix;
foreach ( $css_selectors as $selector ) {
$selector = rtrim( ltrim( $selector ) );
if ( $is_prefix && $is_space_required ) {
$css_selectors_processed[] = sprintf( '%2$s %1$s', $selector, $value );
} elseif ( $is_prefix && ! $is_space_required ) {
$css_selectors_processed[] = sprintf( '%2$s%1$s', $selector, $value );
} elseif ( ! $is_prefix && $is_space_required ) {
$css_selectors_processed[] = sprintf( '%1$s %2$s', $selector, $value );
} elseif ( ! $is_prefix && ! $is_space_required ) {
$css_selectors_processed[] = sprintf( '%1$s%2$s', $selector, $value );
}
}
return implode( ',', $css_selectors_processed );
}
}
function et_core_data_utils_minify_css( $string = '' ) {
$comments = <<< EOS
(?sx)
# don't change anything inside of quotes
( "(?:[^"\\\]++|\\\.)*+" | '(?:[^'\\\]++|\\\.)*+' )
|
# comments
/\* (?> .*? \*/ )
EOS;
$everything_else = <<< EOS
(?six)
# don't change anything inside of quotes
( "(?:[^"\\\]++|\\\.)*+" | '(?:[^'\\\]++|\\\.)*+' )
|
# spaces before and after ; and }
\s*+ ; \s*+ ( } ) \s*+
|
# all spaces around meta chars/operators (excluding + and -)
\s*+ ( [*$~^|]?+= | [{};,>~] | !important\b ) \s*+
|
# all spaces around + and - (in selectors only!)
\s*([+-])\s*(?=[^}]*{)
|
# spaces right of ( [ :
( [[(:] ) \s++
|
# spaces left of ) ]
\s++ ( [])] )
|
# spaces left (and right) of : (but not in selectors)!
\s+(:)(?![^\}]*\{)
|
# spaces at beginning/end of string
^ \s++ | \s++ \z
|
# double spaces to single
(\s)\s+
EOS;
$search_patterns = array( "%{$comments}%", "%{$everything_else}%" );
$replace_patterns = array( '$1', '$1$2$3$4$5$6$7$8' );
return preg_replace( $search_patterns, $replace_patterns, $string );
}