| Server IP : 80.74.154.100 / Your IP : 216.73.217.0 Web Server : Apache System : Linux marissa.metanet.ch 4.18.0-553.141.2.lve.el7h.x86_64 #1 SMP Wed Jul 8 17:20:31 UTC 2026 x86_64 User : onlineadmin ( 10487) PHP Version : 8.5.7 Disable Function : opcache_get_status MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /home/httpd/vhosts/comeonline.ch/httpdocs/wp-content/plugins/wpsso/lib/com/ |
Upload File : |
<?php
/*
* License: GPLv3
* License URI: https://www.gnu.org/licenses/gpl.txt
* Copyright 2012-2026 Jean-Sebastien Morisset (https://surniaulula.com/)
*/
if ( ! defined( 'ABSPATH' ) ) {
die( 'These aren\'t the droids you\'re looking for.' );
}
if ( ! class_exists( 'SucomUtil' ) ) {
class SucomUtil {
protected static $url_clean_query = array(
// Age Verify plugin:
'age-verified',
// Autoptimize:
'ao_noptimize',
// AMP:
'usqp',
// Cookie Notice:
'cn-reloaded',
// ShareASale:
'sscid',
// Adobe Advertising Cloud:
'ef_id',
// Adobe Analytics:
's_kwcid',
// Bronto:
'_bta_tid',
'_bta_c',
// Dotdigital:
'dm_i',
// Facebook:
'fb_action_ids',
'fb_action_types',
'fb_source',
'fbclid',
// Google Analytics and Ads:
'utm_source',
'utm_campaign',
'utm_medium',
'utm_expid',
'utm_term',
'utm_content',
'_ga',
'gclid',
'campaignid',
'adgroupid',
'adid',
'gbraid',
'wbraid',
// Google Web Stories:
'_gl',
// Google DoubleClick:
'gclsrc',
// GoDataFeed:
'gdfms',
'gdftrk',
'gdffi',
// Klaviyo
'_ke',
// Listrak:
'trk_contact',
'trk_msg',
'trk_module',
'trk_sid',
// Mailchimp:
'mc_cid',
'mc_eid',
// Marin:
'mkwid',
'pcrid',
// Matomo:
'mtm_source',
'mtm_medium',
'mtm_campaign',
'mtm_keyword',
'mtm_cid',
'mtm_content',
// Microsoft Advertising:
'msclkid',
// Pinterest:
'epik',
'pp',
// Piwik Pro:
'pk_source',
'pk_medium',
'pk_campaign',
'pk_keyword',
'pk_cid',
'pk_content',
// Springbot:
'redirect_log_mongo_id',
'redirect_mongo_id',
'sb_referer_host',
// WordPress:
'doing_wp_cron',
);
protected static $publisher_languages = array(
/*
* https://developers.facebook.com/docs/messenger-platform/messenger-profile/supported-locales
*/
'facebook' => array(
'af_ZA' => 'Afrikaans',
'ar_AR' => 'Arabic',
'as_IN' => 'Assamese',
'az_AZ' => 'Azerbaijani',
'be_BY' => 'Belarusian',
'bg_BG' => 'Bulgarian',
'bn_IN' => 'Bengali',
'br_FR' => 'Breton',
'bs_BA' => 'Bosnian',
'ca_ES' => 'Catalan',
'cb_IQ' => 'Sorani Kurdish',
'co_FR' => 'Corsican',
'cs_CZ' => 'Czech',
'cx_PH' => 'Cebuano',
'cy_GB' => 'Welsh',
'da_DK' => 'Danish',
'de_DE' => 'German',
'el_GR' => 'Greek',
'en_GB' => 'English (UK)',
'en_UD' => 'English (Upside Down)',
'en_US' => 'English (US)',
'es_ES' => 'Spanish (Spain)',
'es_LA' => 'Spanish',
'et_EE' => 'Estonian',
'eu_ES' => 'Basque',
'fa_IR' => 'Persian',
'ff_NG' => 'Fulah',
'fi_FI' => 'Finnish',
'fo_FO' => 'Faroese',
'fr_CA' => 'French (Canada)',
'fr_FR' => 'French (France)',
'fy_NL' => 'Frisian',
'ga_IE' => 'Irish',
'gl_ES' => 'Galician',
'gn_PY' => 'Guarani',
'gu_IN' => 'Gujarati',
'ha_NG' => 'Hausa',
'he_IL' => 'Hebrew',
'hi_IN' => 'Hindi',
'hr_HR' => 'Croatian',
'hu_HU' => 'Hungarian',
'hy_AM' => 'Armenian',
'id_ID' => 'Indonesian',
'is_IS' => 'Icelandic',
'it_IT' => 'Italian',
'ja_JP' => 'Japanese',
'ja_KS' => 'Japanese (Kansai)',
'jv_ID' => 'Javanese',
'ka_GE' => 'Georgian',
'kk_KZ' => 'Kazakh',
'km_KH' => 'Khmer',
'kn_IN' => 'Kannada',
'ko_KR' => 'Korean',
'ku_TR' => 'Kurdish (Kurmanji)',
'lt_LT' => 'Lithuanian',
'lv_LV' => 'Latvian',
'mg_MG' => 'Malagasy',
'mk_MK' => 'Macedonian',
'ml_IN' => 'Malayalam',
'mn_MN' => 'Mongolian',
'mr_IN' => 'Marathi',
'ms_MY' => 'Malay',
'mt_MT' => 'Maltese',
'my_MM' => 'Burmese',
'nb_NO' => 'Norwegian (bokmal)',
'ne_NP' => 'Nepali',
'nl_BE' => 'Dutch (België)',
'nl_NL' => 'Dutch',
'nn_NO' => 'Norwegian (nynorsk)',
'or_IN' => 'Oriya',
'pa_IN' => 'Punjabi',
'pl_PL' => 'Polish',
'ps_AF' => 'Pashto',
'pt_BR' => 'Portuguese (Brazil)',
'pt_PT' => 'Portuguese (Portugal)',
'ro_RO' => 'Romanian',
'ru_RU' => 'Russian',
'rw_RW' => 'Kinyarwanda',
'sc_IT' => 'Sardinian',
'si_LK' => 'Sinhala',
'sk_SK' => 'Slovak',
'sl_SI' => 'Slovenian',
'so_SO' => 'Somali',
'sq_AL' => 'Albanian',
'sr_RS' => 'Serbian',
'sv_SE' => 'Swedish',
'sw_KE' => 'Swahili',
'sz_PL' => 'Silesian',
'ta_IN' => 'Tamil',
'te_IN' => 'Telugu',
'tg_TJ' => 'Tajik',
'th_TH' => 'Thai',
'tl_PH' => 'Filipino',
'tr_TR' => 'Turkish',
'tz_MA' => 'Tamazight',
'uk_UA' => 'Ukrainian',
'ur_PK' => 'Urdu',
'uz_UZ' => 'Uzbek',
'vi_VN' => 'Vietnamese',
'zh_CN' => 'Simplified Chinese (China)',
'zh_HK' => 'Traditional Chinese (Hong Kong)',
'zh_TW' => 'Traditional Chinese (Taiwan)',
),
/*
* https://developers.google.com/+/web/api/supported-languages
*/
'google' => array(
'af' => 'Afrikaans',
'am' => 'Amharic',
'ar' => 'Arabic',
'eu' => 'Basque',
'bn' => 'Bengali',
'bg' => 'Bulgarian',
'ca' => 'Catalan',
'zh-CN' => 'Chinese (Simplified)',
'zh-HK' => 'Chinese (Hong Kong)',
'zh-TW' => 'Chinese (Traditional)',
'hr' => 'Croatian',
'cs' => 'Czech',
'da' => 'Danish',
'nl' => 'Dutch',
'en-GB' => 'English (UK)',
'en-US' => 'English (US)',
'et' => 'Estonian',
'fil' => 'Filipino',
'fi' => 'Finnish',
'fr' => 'French',
'fr-CA' => 'French (Canadian)',
'gl' => 'Galician',
'de' => 'German',
'el' => 'Greek',
'gu' => 'Gujarati',
'iw' => 'Hebrew',
'hi' => 'Hindi',
'hu' => 'Hungarian',
'is' => 'Icelandic',
'id' => 'Indonesian',
'it' => 'Italian',
'ja' => 'Japanese',
'kn' => 'Kannada',
'ko' => 'Korean',
'lv' => 'Latvian',
'lt' => 'Lithuanian',
'ms' => 'Malay',
'ml' => 'Malayalam',
'mr' => 'Marathi',
'no' => 'Norwegian',
'fa' => 'Persian',
'pl' => 'Polish',
'pt-BR' => 'Portuguese (Brazil)',
'pt-PT' => 'Portuguese (Portugal)',
'ro' => 'Romanian',
'ru' => 'Russian',
'sr' => 'Serbian',
'sk' => 'Slovak',
'sl' => 'Slovenian',
'es' => 'Spanish',
'es-419' => 'Spanish (Latin America)',
'sw' => 'Swahili',
'sv' => 'Swedish',
'ta' => 'Tamil',
'te' => 'Telugu',
'th' => 'Thai',
'tr' => 'Turkish',
'uk' => 'Ukrainian',
'ur' => 'Urdu',
'vi' => 'Vietnamese',
'zu' => 'Zulu',
),
'pinterest' => array(
'en' => 'English',
'ja' => 'Japanese',
),
/*
* https://dev.twitter.com/web/overview/languages
*/
'twitter' => array(
'ar' => 'Arabic',
'bn' => 'Bengali',
'zh-tw' => 'Chinese (Traditional)',
'zh-cn' => 'Chinese (Simplified)',
'cs' => 'Czech',
'da' => 'Danish',
'en' => 'English',
'de' => 'German',
'el' => 'Greek',
'fi' => 'Finnish',
'fil' => 'Filipino',
'fr' => 'French',
'he' => 'Hebrew',
'hi' => 'Hindi',
'hu' => 'Hungarian',
'id' => 'Indonesian',
'it' => 'Italian',
'ja' => 'Japanese',
'ko' => 'Korean',
'msa' => 'Malay',
'nl' => 'Dutch',
'no' => 'Norwegian',
'fa' => 'Persian',
'pl' => 'Polish',
'pt' => 'Portuguese',
'ro' => 'Romanian',
'ru' => 'Russian',
'es' => 'Spanish',
'sv' => 'Swedish',
'th' => 'Thai',
'tr' => 'Turkish',
'uk' => 'Ukrainian',
'ur' => 'Urdu',
'vi' => 'Vietnamese',
)
);
public function __construct() {}
/*
* ARRAY HANDLING METHODS:
*
* add_after_key()
* add_before_key()
* add_multi_values()
* array_count_diff()
* array_flatten()
* array_implode()
* array_insert_element()
* array_key_last()
* array_map_recursive()
* array_maybe_unserialize()
* array_merge_recursive_distinct()
* array_slice_fifo()
* array_to_hashtags()
* array_to_keywords()
* get_array_or_element()
* get_array_pretty()
* get_assoc_salt()
* get_multi_values()
* move_to_front()
* move_to_end()
* natasort()
* natksort()
* next_key()
* preg_grep_keys()
* unset_keys()
* unset_numeric_keys()
*
* Modify the referenced array and return true or false.
*/
public static function add_after_key( array &$arr, $match_key, $arr_or_key, $value = null ) {
return self::array_insert_element( $arr, $insert = 'after', $match_key, $arr_or_key, $value );
}
/*
* Modify the referenced array and return true or false.
*/
public static function add_before_key( array &$arr, $match_key, $arr_or_key, $value = null ) {
return self::array_insert_element( $arr, $insert = 'before', $match_key, $arr_or_key, $value );
}
/*
* Add an array of values that have a common numbered prefix key.
*/
public static function add_multi_values( array &$opts, $opt_pre, $new_key = null ) {
if ( null === $new_key ) $new_key = $opt_pre;
$opts[ $new_key ] = self::get_multi_values( $opts, $opt_pre );
}
public static function array_count_diff( array $arr, $max = 0 ) {
$diff = 0;
if ( $max > 0 && $max >= count( $arr ) ) {
$diff = $max - count( $arr );
}
return $diff;
}
/*
* Convert a multi-dimentional array to a single dimension array.
*/
public static function array_flatten( array $arr ) {
$flattened = array();
foreach ( $arr as $key => $value ) {
if ( is_array( $value ) ) {
$flattened = array_merge( $flattened, self::array_flatten( $value ) );
} else $flattened[ $key ] = $value;
}
return $flattened;
}
/*
* Implode multi-dimentional array.
*/
public static function array_implode( array $arr, $glue = ' ' ) {
$imploded = '';
foreach ( $arr as $value ) {
if ( is_array( $value ) ) {
$imploded .= self::array_implode( $value, $glue ) . $glue;
} else $imploded .= $value . $glue;
}
return strlen( $glue ) ? rtrim( $imploded, $glue ) : $glue;
}
/*
* Modify the referenced array and return true or false.
*/
public static function array_insert_element( array &$arr, $insert, $match_key, $arr_or_key, $value = null ) {
$found_match = false;
if ( array_key_exists( $match_key, $arr ) ) {
$new_arr = array();
foreach ( $arr as $key => $val ) {
if ( 'after' === $insert ) {
$new_arr[ $key ] = $val;
}
/*
* Add new value before/after the matched key.
*
* Replace the matched key by default (no test required).
*/
if ( $key === $match_key ) {
if ( is_array( $arr_or_key ) ) {
$new_arr = array_merge( $new_arr, $arr_or_key );
} elseif ( is_string( $arr_or_key ) ) {
$new_arr[ $arr_or_key ] = $value;
} else $new_arr[] = $value;
$found_match = true;
}
if ( 'before' === $insert ) {
$new_arr[ $key ] = $val;
}
}
$arr = $new_arr;
unset( $new_arr );
}
return $found_match;
}
public static function array_key_last( array $array ) {
if ( function_exists( 'array_key_last' ) ) {
return array_key_last( $array ); // Since PHP v7.3.
}
return key( array_slice( $array, -1, 1, true ) );
}
public static function array_map_recursive( $func, array $arr ) {
foreach ( $arr as $key => $el ) {
$arr[ $key ] = is_array( $el ) ? self::array_map_recursive( $func, $el ) : $func( $el );
}
return $arr;
}
public static function array_maybe_unserialize( array $arr ) {
return self::array_map_recursive( 'maybe_unserialize', $arr );
}
/*
* PHP's array_merge_recursive() merges arrays, but it converts values with duplicate keys to arrays rather than
* overwriting the value in the first array with the duplicate value in the second array, as array_merge does. The
* following method does not change the datatypes of the values in the arrays. Matching key values in the second
* array overwrite those in the first array, as is the case with array_merge().
*/
public static function array_merge_recursive_distinct( array &$arr1, array &$arr2 ) {
$merged = $arr1;
foreach ( $arr2 as $key => &$value ) {
if ( is_array( $value ) && isset( $merged[ $key ] ) && is_array( $merged[ $key ] ) ) {
$merged[ $key ] = self::array_merge_recursive_distinct( $merged[ $key ], $value );
} else $merged[ $key ] = $value;
}
return $merged;
}
/*
* Maybe limit the number of array elements.
*/
public static function array_slice_fifo( array $array, $max = 1 ) {
if ( ! empty( $array ) && is_numeric( $max ) && $max > 0 && count( $array ) > $max ) {
return array_slice( $array, -$max, $length = null, $preserve_keys = true );
}
return $array;
}
public static function array_to_hashtags( array $arr = array() ) {
$hashtags = self::sanitize_hashtags( $arr );
$hashtags = array_filter( $hashtags ); // Removes empty array elements.
$hashtags = trim( implode( $glue = ' ', $hashtags ) );
return $hashtags;
}
/*
* Convert an array to a comma delimited text string.
*/
public static function array_to_keywords( array $arr = array() ) {
$keywords = array_map( 'sanitize_text_field', $arr );
$keywords = trim( implode( $glue = ', ', $keywords ) );
return $keywords;
}
/*
* Convert an array to an HTML list.
*/
public static function array_to_list_html( array $arr, $type = 'ul' ) {
return '<' . $type . '><li>' . implode( $glue = '</li> <li>', $arr ) . '</li></' . $type . '> ';
}
public static function get_array_or_element( $arr, $key = false, $add_none = false ) {
if ( null === $key ) {
// Nothing to do.
} elseif ( false === $key ) {
// Nothing to do.
} elseif ( true === $key ) { // Sort elements.
asort( $arr ); // Sort an array in ascending order and maintain index association.
} elseif ( isset( $arr[ $key ] ) ) { // Return a specific array element.
return $arr[ $key ];
} else return null; // Array key not found - return null.
if ( true === $add_none ) { // Prefix array with 'none'.
/*
* The union operator (+) gives priority to values in the first array, while
* array_replace() gives priority to values in the the second array.
*/
$arr = array( 'none' => 'none' ) + $arr; // Maintains numeric index.
}
return $arr;
}
public static function get_array_parents( array $arr, $parent_key = '', $gparent_key = '', &$parents = array() ) {
foreach ( $arr as $child_key => $value ) {
if ( is_array( $value ) ) {
self::get_array_parents( $value, $child_key, $parent_key, $parents );
} elseif ( $parent_key && $child_key !== $parent_key ) {
$parents[ $child_key ][] = $parent_key;
} elseif ( $gparent_key && $child_key === $parent_key ) {
$parents[ $child_key ][] = $gparent_key;
}
}
return $parents;
}
public static function get_array_pretty( $mixed, $flatten = false ) {
$pretty = '';
if ( is_array( $mixed ) ) {
foreach ( $mixed as $key => $val ) {
$val = self::get_array_pretty( $val, $flatten );
if ( $flatten ) {
$pretty .= $key . '=' . $val.', ';
} else {
if ( is_object( $mixed[ $key ] ) ) {
unset( $mixed[ $key ] ); // Dereference the object first.
}
$mixed[ $key ] = $val;
}
}
$pretty = $flatten ? '(' . trim( $pretty, ', ' ) . ')' : $mixed;
} elseif ( false === $mixed ) {
$pretty = 'false';
} elseif ( true === $mixed ) {
$pretty = 'true';
} elseif ( null === $mixed ) {
$pretty = 'null';
} elseif ( '' === $mixed ) {
$pretty = '\'\'';
} elseif ( is_object( $mixed ) ) {
$pretty = 'object ' . get_class( $mixed );
} else $pretty = $mixed;
return $pretty;
}
public static function get_assoc_salt( array $assoc ) {
$assoc_salt = '';
foreach ( $assoc as $key => $val ) {
$assoc_salt .= '-' . $key . ':' . (string) $val;
}
$assoc_salt = ltrim( $assoc_salt, '-' );
return $assoc_salt;
}
/*
* Return a indexed array of values that have a common prefix key.
*/
public static function get_multi_values( array &$opts, $opt_pre ) {
$values = self::preg_grep_keys( '/^' . $opt_pre . '_([0-9]+)$/', $opts, $invert = false, $replace = '$1' );
foreach ( $values as $num => $val ) {
if ( ! self::is_valid_option_value( $val ) ) { // Allow for 0 but not empty string.
unset( $values[ $num ] );
}
}
return $values;
}
/*
* Move an array element to the front.
*/
public static function move_to_front( array &$arr, $key ) {
if ( array_key_exists( $key, $arr ) ) {
$val = $arr[ $key ];
unset( $arr[ $key ] );
$arr = array_merge( array( $key => $val ), $arr );
}
return $arr;
}
/*
* Move an array element to the end.
*/
public static function move_to_end( array &$arr, $key ) {
if ( array_key_exists( $key, $arr ) ) {
$val = $arr[ $key ];
unset( $arr[ $key ] );
$arr[ $key ] = $val;
}
return $arr;
}
public static function natasort( array &$arr ) {
if ( function_exists( 'remove_accents' ) ) { // WordPress function.
return uasort( $arr, array( __CLASS__, 'strnatcasecmp_remove_accents' ) );
}
return uasort( $arr, 'strnatcasecmp' );
}
public static function natksort( array &$arr ) {
if ( function_exists( 'remove_accents' ) ) { // WordPress function.
return uksort( $arr, array( __CLASS__, 'strnatcasecmp_remove_accents' ) );
}
return uksort( $arr, 'strnatcasecmp' );
}
public static function next_key( $needle, array &$arr, $loop_around = true ) {
$keys = array_keys( $arr );
$pos = array_search( $needle, $keys );
if ( false !== $pos ) {
if ( isset( $keys[ $pos + 1 ] ) ) {
return $keys[ $pos + 1 ];
} elseif ( true === $loop_around ) {
return $keys[ 0 ];
}
}
return false;
}
/*
* $keys_preg must be a string.
*
* $replace can be a string or an associative array of 'pattern' => 'replacement'.
*/
public static function preg_grep_keys( $keys_preg, $in_array, $invert = false, $replace = false ) {
if ( ! is_array( $in_array ) || empty( $in_array ) ) { // Just in case.
return array();
}
$in_array_keys = array_keys( $in_array );
$matched_keys = preg_grep( $keys_preg, $in_array_keys, $invert ? PREG_GREP_INVERT : 0 );
if ( empty( $matched_keys ) && $invert ) { // Nothing to do.
return $in_array;
}
/*
* The $replace value can be a string or an associative array of 'pattern' => 'replacement'.
*/
if ( is_array( $replace ) ) {
$patterns = array_keys( $replace );
$replacements = array_values( $replace );
} else {
$patterns = $keys_preg;
$replacements = $replace;
}
$out_array = array();
foreach ( $matched_keys as $key ) {
if ( false === $replace ) { // Element key remains unchanged.
$out_array[ $key ] = $in_array[ $key ];
} else {
$fixed = preg_replace( $patterns, $replacements, $key );
$out_array[ $fixed ] = $in_array[ $key ];
}
}
return $out_array;
}
public static function unset_keys( &$arr1, $arr2 ) {
foreach ( array_keys( $arr2 ) as $key ) {
unset( $arr1[ $key ] );
}
}
public static function unset_numeric_keys( &$arr ) {
foreach ( array_keys( $arr ) as $key ) {
if ( is_numeric( $key ) ) {
unset( $arr[ $key ] );
}
}
}
/*
* COUNTRY METHODS:
*
* get_alpha2_countries()
* get_alpha2_country_name()
*/
public static function get_alpha2_countries() {
if ( ! class_exists( 'SucomCountryCodes' ) ) {
require_once dirname( __FILE__ ) . '/country-codes.php';
}
return SucomCountryCodes::get( 'alpha2' );
}
public static function get_alpha2_country_name( $country_code, $default_code = false ) {
if ( empty( $country_code ) || 'none' === $country_code ) {
return false;
}
if ( ! class_exists( 'SucomCountryCodes' ) ) {
require_once dirname( __FILE__ ) . '/country-codes.php';
}
$countries = SucomCountryCodes::get( 'alpha2' );
if ( ! isset( $countries[ $country_code ] ) ) {
if ( false === $default_code || ! isset( $countries[ $default_code ] ) ) {
return false;
}
return $countries[ $default_code ];
}
return $countries[ $country_code ];
}
/*
* CURRENCY METHODS:
*
* get_currencies()
* get_currencies_abbrev()
* get_currency_symbol_abbrev()
*
* Used by WpssoSubmenuGeneral->get_table_rows() for 'Default Currency' option.
*/
public static function get_currencies( $key = false, $add_none = false, $format = '%2$s (%1$s)' ) {
if ( ! class_exists( 'SucomCurrencies' ) ) {
require_once dirname( __FILE__ ) . '/currencies.php';
}
if ( is_string( $key ) ) {
return SucomCurrencies::get( $key, $format );
}
return self::get_array_or_element( SucomCurrencies::get( null, $format ), $key, $add_none );
}
public static function get_currencies_abbrev() {
$currencies_by_abbrev = self::get_currencies( null, $add_none = false, $format = '%1$s' );
asort( $currencies_by_abbrev ); // Sort by abbreviation.
return $currencies_by_abbrev;
}
public static function get_currency_symbol_abbrev( $symbol = false, $default = 'USD', $decode = true ) {
if ( $decode ) $symbol = self::decode_html( $symbol );
if ( $symbol === '$' ) return 'USD';
if ( ! class_exists( 'SucomCurrencies' ) ) {
require_once dirname( __FILE__ ) . '/currencies.php';
}
$currencies_by_abbrev = SucomCurrencies::get_symbols( $key = null, $decode );
$currencies_by_symbol = array_flip( $currencies_by_abbrev ); // Index by symbol.
unset( $currencies_by_abbrev );
return isset( $currencies_by_symbol[ $symbol ] ) ? $currencies_by_symbol[ $symbol ] : false;
}
/*
* DASHICON METHODS:
*/
public static function get_dashicons( $key = true, $add_none = false ) {
if ( ! class_exists( 'SucomDashicons' ) ) {
require_once dirname( __FILE__ ) . '/dashicons.php';
}
if ( is_numeric( $key ) || is_string( $key ) ) {
return SucomDashicons::get( $key );
}
return self::get_array_or_element( SucomDashicons::get(), $key, $add_none );
}
/*
* DATE AND TIME METHODS:
*
* format_tz_offset()
* get_default_timezone()
* get_formatted_timezone()
* get_hours()
* get_hours_range()
* get_timezones()
* get_timezone_abbr()
* get_timezone_offset_secs()
* get_timezone_offset_hours()
* get_tz_name()
* iso8601_to_seconds()
* maybe_iso8601_to_seconds()
* sprintf_date_time()
*/
public static function format_human_bytes( $bytes, $dec = 2, $sep = ' ' ) {
$size = array( 'B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB' );
$factor = floor( ( strlen( $bytes ) - 1 ) / 3 );
return sprintf( "%.{$dec}f{$sep}%s", $bytes / pow( 1024, $factor ), $size[ $factor ] );
}
/*
* Returns a date( 'P' ) formatted timezone value (ie. -07:00).
*/
public static function format_tz_offset( $offset ) {
$hours = (int) $offset;
$minutes = ( $offset - $hours );
$sign = ( $offset < 0 ) ? '-' : '+';
$abs_hour = abs( $hours );
$abs_mins = abs( $minutes * 60 );
$tz_offset = sprintf( '%s%02d:%02d', $sign, $abs_hour, $abs_mins );
return $tz_offset;
}
/*
* May return a timezone string (ie. 'Africa/Abidjan'), 'UTC', or an offset (ie. '-07:00').
*/
public static function get_default_timezone() {
static $local_cache = null;
if ( null !== $local_cache ) {
return $local_cache;
}
if ( function_exists( wp_timezone_string() ) ) {
return $local_cache = wp_timezone_string();
}
$timezone_string = get_option( 'timezone_string' );
if ( $timezone_string ) {
return $local_cache = $timezone_string;
}
$offset = (float) get_option( 'gmt_offset' );
$tz_offset = self::format_tz_offset( $offset );
return $local_cache = $tz_offset;
}
public static function get_formatted_timezone( $tz_name, $format ) {
static $local_cache = array();
if ( isset( $local_cache[ $tz_name ][ $format ] ) ) {
return $local_cache[ $tz_name ][ $format ];
}
$dt_obj = new DateTime();
$dt_obj->setTimeZone( new DateTimeZone( $tz_name ) );
return $local_cache[ $tz_name ][ $format ] = $dt_obj->format( $format );
}
public static function get_hours( $step_secs = 3600, $label_format = 'H:i' ) {
return self::get_hours_range( $start_secs = 0, $end_secs = 86400, $step_secs, $label_format );
}
/*
* Returns an associative array.
*
* Example time formats: 'H:i' (default), 'g:i a'.
*/
public static function get_hours_range( $start_secs = 0, $end_secs = 86400, $step_secs = 3600, $label_format = 'H:i' ) {
$times = array();
foreach ( range( $start_secs, $end_secs, $step_secs ) as $ts ) {
$value = gmdate( 'H:i', $ts );
if ( 'H:i' !== $label_format ) {
$times[ $value ] = gmdate( $label_format, $ts );
} else $times[ $value ] = $value;
}
return $times;
}
/*
* Returns an associative array of timezone strings (ie. 'Africa/Abidjan'), 'UTC', and offsets (ie. '-07:00').
*/
public static function get_timezones() {
/*
* See https://www.php.net/manual/en/function.timezone-identifiers-list.php.
*/
$timezones = timezone_identifiers_list();
$timezones = array_combine( $timezones, $timezones ); // Create an associative array.
$offset_range = array( -12, -11.5, -11, -10.5, -10, -9.5, -9, -8.5, -8, -7.5, -7, -6.5, -6, -5.5, -5, -4.5,
-4, -3.5, -3, -2.5, -2, -1.5, -1, -0.5, 0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 5.75, 6,
6.5, 7, 7.5, 8, 8.5, 8.75, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.75, 13, 13.75, 14 );
/*
* Create date( 'P' ) formatted timezone values (ie. -07:00).
*/
foreach ( $offset_range as $offset ) {
$offset_value = self::format_tz_offset( $offset );
$offset_name = 'UTC' . $offset_value;
$timezones[ $offset_value ] = $offset_name;
}
return $timezones;
}
/*
* Get timezone abbreviation (ie. 'EST', 'MDT', etc.).
*/
public static function get_timezone_abbr( $tz_name ) {
return self::get_formatted_timezone( $tz_name, 'T' );
}
/*
* Get timezone offset in seconds (west of UTC is negative, and east of UTC is positive).
*/
public static function get_timezone_offset_secs( $tz_name ) {
return self::get_formatted_timezone( $tz_name, 'Z' );
}
/*
* Timezone difference to UTC with colon between hours and minutes.
*/
public static function get_timezone_offset_hours( $tz_name ) {
/*
* See https://www.php.net/manual/en/datetime.format.php.
*
* P Difference to Greenwich time (GMT) with colon between hours and minutes.
* p The same as P, but returns Z instead of +00:00.
*
* Unfortunately 'p' is only available since PHP v8, so we must use 'P' and check for '+00:00'.
*/
$offset = self::get_formatted_timezone( $tz_name, 'P' );
if ( '+00:00' == $offset ) {
$offset = 'Z';
}
return $offset;
}
/*
* "tz" is used in the method name to hint that the argument is an abbreviation.
*/
public static function get_tz_name( $tz_abbr ) {
return timezone_name_from_abbr( $tz_abbr );
}
/*
* Convert ISO 8601 value (like P2DT15M33S) to seconds.
*/
public static function iso8601_to_seconds( $iso8601 ) {
$interval = new \DateInterval( $iso8601 );
return ( $interval->d * 24 * 60 * 60 ) + ( $interval->h * 60 * 60 ) + ( $interval->i * 60 ) + $interval->s;
}
public static function maybe_iso8601_to_seconds( $mixed ) {
if ( 0 === strpos( $mixed, 'P' ) ) {
return self::iso8601_to_seconds( $mixed );
}
return $mixed;
}
/*
* See WpssoUser->add_person_role().
* See WpssoUser->remove_person_role().
* See WpssoUtilCache->refresh().
*/
public static function sprintf_date_time( $fmt = '%1$s %2$s' ) {
$wp_timezone = wp_timezone();
$wp_date_fmt = get_option( 'date_format' );
$wp_time_fmt = get_option( 'time_format' );
$now = date_create_immutable( $datetime = 'now', $wp_timezone );
$date_val = $now->format( $wp_date_fmt );
$time_val = $now->format( $wp_time_fmt );
$date_time_val = sprintf( $fmt, $date_val, $time_val );
return $date_time_val;
}
/*
* IS CHECK METHODS:
*
* is_assoc()
* is_https()
* is_md5()
* is_non_assoc()
* is_true()
* is_valid_option_value()
*
* Note that an empty array is not an associative array (ie. returns false for an empty array).
*/
public static function is_assoc( $mixed ) {
$is_assoc = false;
if ( ! empty( $mixed ) ) { // Optimize.
if ( is_array( $mixed ) ) { // Just in case.
if ( ! is_numeric( implode( array_keys( $mixed ) ) ) ) {
$is_assoc = true;
}
}
}
return $is_assoc;
}
public static function is_https( $url = '' ) {
static $local_cache = array();
if ( isset( $local_cache[ $url ] ) ) {
return $local_cache[ $url ];
}
if ( strpos( $url, '://' ) ) {
if ( 'https' === wp_parse_url( $url, PHP_URL_SCHEME ) ) {
return $local_cache[ $url ] = true;
}
return $local_cache[ $url ] = false;
} elseif ( is_ssl() ) {
return $local_cache[ $url ] = true;
} elseif ( isset( $_SERVER[ 'HTTP_X_FORWARDED_PROTO' ] ) && 'https' === strtolower( $_SERVER[ 'HTTP_X_FORWARDED_PROTO' ] ) ) {
return $local_cache[ $url ] = true;
} elseif ( isset( $_SERVER[ 'HTTP_X_FORWARDED_SSL' ] ) && 'on' === strtolower( $_SERVER[ 'HTTP_X_FORWARDED_SSL' ] ) ) {
return $local_cache[ $url ] = true;
}
return $local_cache[ $url ] = false;
}
public static function is_md5( $md5 ) {
return strlen( $md5 ) === 32 && preg_match( '/^[a-f0-9]+$/', $md5 ) ? true : false;
}
/*
* Note that an empty array is not an associative array (ie. returns false for an empty array).
*/
public static function is_non_assoc( $mixed ) {
$is_non_assoc = false;
if ( is_array( $mixed ) ) { // Just in case.
if ( empty( $mixed ) ) { // Optimize.
$is_non_assoc = true;
} elseif ( is_numeric( implode( array_keys( $mixed ) ) ) ) {
$is_non_assoc = true;
}
}
return $is_non_assoc;
}
public static function is_true( $mixed, $allow_null = false ) {
$is_true = is_string( $mixed ) ? filter_var( $mixed, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE ) : (bool) $mixed;
return null === $is_true && ! $allow_null ? false : $is_true;
}
/*
* Check that the option value is not true, false, null, empty string, or 'none'.
*/
public static function is_valid_option_value( $value ) {
if ( true === $value ) {
return false;
} elseif ( empty( $value ) && ! is_numeric( $value ) ) { // False, null, or empty string.
return false;
} elseif ( 'none' === $value ) { // Disabled option.
return false;
}
return true;
}
/*
* OPEN GRAPH AND META TAG METHODS:
*
* get_mt_og_seed()
* get_mt_image_seed()
* get_mt_product_seed()
* get_mt_video_seed()
* get_first_og_image_id()
* get_first_og_image_url()
* get_first_og_video_url()
* get_first_mt_media_id()
* get_first_mt_media_url()
* get_publisher_languages()
* merge_mt_og()
*/
public static function get_mt_og_seed() {
return array(
'fb:admins' => null,
'fb:app_id' => null,
'og:time' => null, // Internal meta tag.
'og:type' => null,
'og:url' => null,
'og:redirect_url' => null, // Internal meta tag.
'og:locale' => null,
'og:site_name' => null,
'og:title' => null,
'og:description' => null,
'og:updated_time' => null,
'og:video' => null,
'og:image' => null,
'schema:language' => null, // Internal meta tag.
'schema:type:id' => null, // Internal meta tag.
'schema:type:url' => null, // Internal meta tag.
'schema:type:context' => null, // Internal meta tag.
'schema:type:name' => null, // Internal meta tag.
'schema:type:path' => null, // Internal meta tag.
'schema:review:rating' => null, // Internal meta tag.
);
}
/*
* Pre-define the array key order for the list() construct.
*/
public static function get_mt_image_seed( $mt_pre = 'og', array $mt_og = array() ) {
$mt_ret = array(
$mt_pre . ':image:secure_url' => null,
$mt_pre . ':image:url' => null,
$mt_pre . ':image:width' => null,
$mt_pre . ':image:height' => null,
$mt_pre . ':image:cropped' => null, // Internal meta tag.
$mt_pre . ':image:id' => null, // Internal meta tag.
$mt_pre . ':image:alt' => null,
$mt_pre . ':image:size_name' => null, // Internal meta tag.
);
return self::merge_mt_og( $mt_ret, $mt_og );
}
/*
* This method is used by e-Commerce modules to pre-define and pre-sort the product meta tags.
*
* Use null values so WpssoOpengraph->add_data_og_type_md() can load metadata default values.
*/
public static function get_mt_product_seed( $mt_pre = 'product', array $mt_og = array() ) {
$mt_ret = array(
/*
* Product part numbers.
*/
$mt_pre . ':retailer_item_id' => null, // Product ID.
$mt_pre . ':retailer_part_no' => null, // Product SKU.
$mt_pre . ':mfr_part_no' => null, // Product MPN.
$mt_pre . ':item_group_id' => null, // Product variant group ID.
$mt_pre . ':ean' => null, // aka EAN, EAN-13, GTIN-13.
$mt_pre . ':gtin14' => null, // Internal meta tag.
$mt_pre . ':gtin13' => null, // Internal meta tag.
$mt_pre . ':gtin12' => null, // Internal meta tag.
$mt_pre . ':gtin8' => null, // Internal meta tag.
$mt_pre . ':gtin' => null, // Internal meta tag.
$mt_pre . ':isbn' => null,
$mt_pre . ':upc' => null, // Aka the UPC, UPC-A, UPC, GTIN-12.
/*
* Product attributes and descriptions.
*/
$mt_pre . ':url' => null, // Internal meta tag.
$mt_pre . ':title' => null, // Internal meta tag.
$mt_pre . ':description' => null, // Internal meta tag.
$mt_pre . ':updated_time' => null, // Internal meta tag.
$mt_pre . ':adult_type' => null, // Internal meta tag.
$mt_pre . ':age_group' => null,
$mt_pre . ':quantity' => null, // Internal meta tag.
$mt_pre . ':availability' => null,
$mt_pre . ':brand' => null,
$mt_pre . ':category' => null, // The product category according to the Google product taxonomy.
$mt_pre . ':retailer_category' => null, // Internal meta tag.
$mt_pre . ':awards' => array(), // Internal meta tag.
$mt_pre . ':condition' => null,
$mt_pre . ':energy_efficiency:value' => null, // Internal meta tag.
$mt_pre . ':energy_efficiency:min_value' => null, // Internal meta tag.
$mt_pre . ':energy_efficiency:max_value' => null, // Internal meta tag.
$mt_pre . ':expiration_time' => null,
$mt_pre . ':color' => null,
$mt_pre . ':material' => null,
$mt_pre . ':mrp_id' => null, // Internal meta tag.
$mt_pre . ':pattern' => null,
$mt_pre . ':purchase_limit' => null,
$mt_pre . ':eligible_quantity:value' => null, // Internal meta tag.
$mt_pre . ':eligible_quantity:min_value' => null, // Internal meta tag.
$mt_pre . ':eligible_quantity:max_value' => null, // Internal meta tag.
$mt_pre . ':eligible_quantity:unit_code' => null, // Internal meta tag.
$mt_pre . ':eligible_quantity:unit_text' => null, // Internal meta tag.
$mt_pre . ':target_gender' => null,
$mt_pre . ':size' => null,
$mt_pre . ':size_group' => null, // Internal meta tag.
$mt_pre . ':size_system' => null, // Internal meta tag.
$mt_pre . ':is_virtual' => null, // Internal meta tag.
/*
* Product net dimensions and weight.
*/
$mt_pre . ':length:value' => null, // Internal meta tag.
$mt_pre . ':length:units' => null, // Internal meta tag (units after value).
$mt_pre . ':width:value' => null, // Internal meta tag.
$mt_pre . ':width:units' => null, // Internal meta tag (units after value).
$mt_pre . ':height:value' => null, // Internal meta tag.
$mt_pre . ':height:units' => null, // Internal meta tag (units after value).
$mt_pre . ':weight:value' => null,
$mt_pre . ':weight:units' => null,
$mt_pre . ':fluid_volume:value' => null, // Internal meta tag.
$mt_pre . ':fluid_volume:units' => null, // Internal meta tag (units after value).
/*
* Product prices.
*/
$mt_pre . ':min_advert_price:amount' => null, // Internal meta tag.
$mt_pre . ':min_advert_price:currency' => null, // Internal meta tag.
$mt_pre . ':original_price:type' => null, // Internal meta tag.
$mt_pre . ':original_price:amount' => null,
$mt_pre . ':original_price:currency' => null,
$mt_pre . ':pretax_price:amount' => null,
$mt_pre . ':pretax_price:currency' => null,
$mt_pre . ':price:type' => null, // Internal meta tag.
$mt_pre . ':price:amount' => null,
$mt_pre . ':price:currency' => null,
$mt_pre . ':price:vat_included' => null, // Internal meta tag.
$mt_pre . ':sale_price:type' => null, // Internal meta tag.
$mt_pre . ':sale_price:amount' => null,
$mt_pre . ':sale_price:currency' => null,
$mt_pre . ':sale_price_dates:start' => null,
$mt_pre . ':sale_price_dates:start_date' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:start_time' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:start_timezone' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:start_iso' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:end' => null,
$mt_pre . ':sale_price_dates:end_date' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:end_time' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:end_timezone' => null, // Internal meta tag.
$mt_pre . ':sale_price_dates:end_iso' => null, // Internal meta tag.
$mt_pre . ':offers' => array(), // Internal meta tag.
/*
* Product shipping.
*/
$mt_pre . ':shipping_cost:amount' => null,
$mt_pre . ':shipping_cost:currency' => null,
$mt_pre . ':shipping_length:value' => null, // Internal meta tag.
$mt_pre . ':shipping_length:units' => null, // Internal meta tag (units after value).
$mt_pre . ':shipping_width:value' => null, // Internal meta tag.
$mt_pre . ':shipping_width:units' => null, // Internal meta tag (units after value).
$mt_pre . ':shipping_height:value' => null, // Internal meta tag.
$mt_pre . ':shipping_height:units' => null, // Internal meta tag (units after value).
$mt_pre . ':shipping_weight:value' => null,
$mt_pre . ':shipping_weight:units' => null,
$mt_pre . ':shipping_class_id' => null, // Internal meta tag.
$mt_pre . ':shipping_offers' => array(), // Internal meta tag.
/*
* Product ratings and reviews.
*/
$mt_pre . ':rating:average' => null, // Internal meta tag.
$mt_pre . ':rating:count' => null, // Internal meta tag.
$mt_pre . ':rating:worst' => null, // Internal meta tag.
$mt_pre . ':rating:best' => null, // Internal meta tag.
$mt_pre . ':review:count' => null, // Internal meta tag.
$mt_pre . ':reviews' => array(), // Internal meta tag.
);
if ( ! empty( $mt_og[ 'og:type' ] ) && 'product' === $mt_og[ 'og:type' ] ) {
$mt_ret = array_merge( $mt_ret, array(
$mt_pre . ':variants' => array(), // Internal meta tag.
) );
}
return self::merge_mt_og( $mt_ret, $mt_og );
}
public static function get_mt_video_seed( $mt_pre = 'og', array $mt_og = array() ) {
$mt_ret = array(
$mt_pre . ':video:secure_url' => null,
$mt_pre . ':video:url' => null,
$mt_pre . ':video:title' => null, // Internal meta tag.
$mt_pre . ':video:description' => null, // Internal meta tag.
$mt_pre . ':video:family_friendly' => null, // Internal meta tag.
$mt_pre . ':video:regions_allowed' => array(), // Internal meta tag.
$mt_pre . ':video:type' => null, // Example: 'application/x-shockwave-flash', 'text/html', 'video/mp4', etc.
$mt_pre . ':video:width' => null,
$mt_pre . ':video:height' => null,
$mt_pre . ':video:tag' => array(),
$mt_pre . ':video:duration' => null, // Internal meta tag.
$mt_pre . ':video:published_date' => null, // Internal meta tag.
$mt_pre . ':video:upload_date' => null, // Internal meta tag.
$mt_pre . ':video:thumbnail_url' => null, // Internal meta tag.
$mt_pre . ':video:embed_url' => null, // Internal meta tag.
$mt_pre . ':video:stream_url' => null, // Internal meta tag. VideoObject contentUrl.
$mt_pre . ':video:stream_size' => null, // Internal meta tag. VideoObject contentSize.
$mt_pre . ':video:has_image' => false, // Internal meta tag.
$mt_pre . ':video:iphone_name' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:iphone_id' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:iphone_url' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:ipad_name' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:ipad_id' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:ipad_url' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:googleplay_name' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:googleplay_id' => null, // Internal meta tag for X (Twitter) player card.
$mt_pre . ':video:googleplay_url' => null, // Internal meta tag for X (Twitter) player card.
);
$mt_ret += self::get_mt_image_seed( $mt_pre );
/*
* Facebook applink meta tags.
*/
if ( $mt_pre === 'og' ) {
$mt_ret += array(
'al:ios:app_name' => null,
'al:ios:app_store_id' => null,
'al:ios:url' => null,
'al:android:app_name' => null,
'al:android:package' => null,
'al:android:url' => null,
'al:web:url' => null,
'al:web:should_fallback' => 'false',
);
}
return self::merge_mt_og( $mt_ret, $mt_og );
}
public static function get_first_og_image_id( array $assoc ) {
return self::get_first_mt_media_id( $assoc, $media_pre = 'og:image' );
}
public static function get_first_og_image_url( array $assoc ) {
return self::get_first_mt_media_url( $assoc, $media_pre = 'og:image', $mt_suffixes = array( ':secure_url', ':url', '' ) );
}
public static function get_first_og_video_url( array $assoc ) {
return self::get_first_mt_media_url( $assoc, $media_pre = 'og:video' );
}
public static function get_first_mt_media_id( array $assoc, $media_pre = 'og:image' ) {
return self::get_first_mt_media_url( $assoc, $media_pre, $mt_suffixes = array( ':id' ) );
}
/*
* Return the first URL from the associative array (og:image:secure_url, og:image:url, og:image).
*/
public static function get_first_mt_media_url( array $assoc, $media_pre = 'og:image', $mt_suffixes = null ) {
/*
* Check for two dimensional arrays and keep following the first array element.
*
* Prefer the $media_pre array key (if it's available).
*/
if ( isset( $assoc[ $media_pre ] ) && is_array( $assoc[ $media_pre ] ) ) {
$first_el = reset( $assoc[ $media_pre ] );
} else $first_el = reset( $assoc ); // Can be array or string.
/*
* If the first element isn't a string (ie. non-array value), then recurse until we hit bottom.
*/
if ( is_array( $first_el ) ) {
return self::get_first_mt_media_url( $first_el, $media_pre, $mt_suffixes );
}
if ( ! is_array( $mt_suffixes ) ) { // Array of meta tag suffixes to use.
$mt_suffixes = array( ':secure_url', ':url', '', ':embed_url', ':stream_url' );
}
/*
* First element is a text string, so check the array keys.
*/
foreach ( $mt_suffixes as $mt_suffix ) {
if ( ! empty( $assoc[ $media_pre . $mt_suffix ] ) ) {
return $assoc[ $media_pre . $mt_suffix ]; // Return first match.
}
}
return ''; // Empty string.
}
public static function get_publisher_languages( $publisher = '' ) {
switch ( $publisher ) {
case 'facebook':
case 'fb':
return self::$publisher_languages[ 'facebook' ];
case 'google':
return self::$publisher_languages[ 'google' ];
case 'pinterest':
case 'pin':
case 'rp':
return self::$publisher_languages[ 'pinterest' ];
default:
if ( isset( self::$publisher_languages[ $publisher ] ) ) {
return self::$publisher_languages[ $publisher ];
}
return array();
}
}
/*
* Protected method used by get_mt_image_seed(), get_mt_product_seed(), and get_mt_video_seed().
*/
protected static function merge_mt_og( array $mt_ret, array $mt_og ) {
if ( empty( $mt_og ) ) { // Nothing to merge.
return $mt_ret;
}
/*
* Always keep the 'og:type' meta tag top-most.
*
* Use array_key_exists() to allow for null value.
*/
if ( array_key_exists( 'og:type', $mt_og ) ) {
return array_merge( array( 'og:type' => $mt_og[ 'og:type' ] ), $mt_ret, $mt_og );
}
return array_merge( $mt_ret, $mt_og );
}
/*
* SANITATION METHODS:
*
* sanitize_classname()
* sanitize_css_class()
* sanitize_css_id()
* sanitize_file_name()
* sanitize_file_path()
* sanitize_hashtags()
* sanitize_hookname()
* sanitize_input_name()
* sanitize_int()
* sanitize_key()
* sanitize_locale()
* sanitize_meta_key()
* sanitize_tag()
* sanitize_twitter_name()
* sanitize_use_post()
*
* Used by WpssoConfig::load_lib() to sanitize file names to class names.
*
* See https://www.php.net/manual/en/language.variables.basics.php.
*/
public static function sanitize_classname( $classname, $allow_underscore = true ) {
$classname = preg_replace( '/^[^a-zA-Z_\x80-\xff]+/', '', $classname ); # Cannot start with numeric characters.
$classname = preg_replace( '/[^a-zA-Z0-9_\x80-\xff]/', '', $classname );
if ( ! $allow_underscore ) $classname = preg_replace( '/_/', '', $classname ); # Remove underscores.
return $classname;
}
public static function sanitize_css_class( $css_class, $sep = '-' ) {
$css_class = preg_replace( '/[^a-zA-Z0-9_\- ]+/', $sep, $css_class ); // Spaces allowed.
$css_class = trim( $css_class, $sep . ' ' ); // Trim separator and space characters.
return $css_class;
}
/*
* See sucomChangeHideUnhideRows() in jquery-metabox.js.
* See sucomSanitizeCssId() in jquery-admin-page.js.
*/
public static function sanitize_css_id( $css_id, $sep = '-' ) {
$css_id = preg_replace( '/[^a-zA-Z0-9_\-]+/', $sep, $css_id ); // Spaces not allowed.
$css_id = trim( $css_id, $sep );
return $css_id;
}
public static function sanitize_file_name( $file_name ) {
if ( '' === $file_name ) { // Just in case.
return $file_name;
}
$special_chars = array( '?', '[', ']', '/', '\\', '=', '<', '>', ':', ';', ',', '\'', '"', '&', '$', '#', '*', '(', ')', '|', '~', '`', '!', '{', '}', '%', '+', chr( 0 ) );
$file_name = preg_replace( '#\x{00a0}#siu', ' ', $file_name );
$file_name = str_replace( $special_chars, '', $file_name );
$file_name = str_replace( array( '%20', '+' ), '-', $file_name );
$file_name = preg_replace( '/[\r\n\t -]+/', '-', $file_name );
$file_name = trim( $file_name, '.-_' );
return $file_name;
}
public static function sanitize_file_path( $file_path ) {
if ( empty( $file_path ) ) { // Just in case.
return false;
}
$file_path = implode( $glue = '/', array_map( array( __CLASS__, 'sanitize_file_name' ), explode( '/', $file_path ) ) );
return $file_path;
}
/*
* Note that hashtags cannot begin with a number. This method truncates tags that begin with a number.
*/
public static function sanitize_hashtags( array $tags = array() ) {
return preg_replace( array( '/^[0-9].*/', '/[ \[\]#!\$\?\\\\\/\*\+\.\-\^]/', '/^.+/' ), array( '', '', '#$0' ), $tags );
}
/*
* See sucomSanitizeHookname() in jquery-admin-page.js.
*/
public static function sanitize_hookname( $hookname ) {
$hookname = preg_replace( '/[\/\-\. \[\]:#]+/', '_', $hookname );
$hookname = rtrim( $hookname, '_' ); // Only trim right side underscores to allow for '__return_false'.
return self::sanitize_key( $hookname, $allow_upper = false );
}
/*
* See WpssoConfig::$cf[ 'opt' ][ 'defaults' ] for example input names.
*
* A colon can be used for qualifiers (example, ':disabled', ':width', ':height', etc.).
*
* A hashtag can be used for the locale (language).
*
* Example sanitation:
*
* 'mrp_method_https://schema.org/ReturnByMail' -> 'mrp_method_https_schema_org_ReturnByMail'
*/
public static function sanitize_input_name( $input_name, $sep = '_' ) {
$input_name = preg_replace( '/:\/\//', $sep, $input_name );
$input_name = preg_replace( '/[^a-zA-Z0-9_\-:#]+/', $sep, $input_name );
$input_name = trim( $input_name, $sep );
return $input_name;
}
/*
* There is no WordPress function to sanitize post IDs and integers.
*
* Returns an integer or null.
*/
public static function sanitize_int( $value ) {
if ( is_numeric( $value ) ) {
return (int) $value;
}
return null;
}
/*
* Sanitize an option array key.
*
* Unlike the WordPress sanitize_key() function, this method allows for colon and hash characters and (optionally)
* upper case characters.
*
* See sucomSanitizeKey() in wpsso/js/com/jquery-admin-page.js
* See wordpress/wp-includes/formatting.php.
*/
public static function sanitize_key( $key, $allow_upper = false ) {
if ( is_scalar( $key ) ) { // Int, float, string or bool.
if ( ! $allow_upper ) $key = strtolower( $key ); // Convert upper case characters to lower case.
return preg_replace( '/[^a-zA-Z0-9_\-:#]/', '', $key );
}
return '';
}
public static function sanitize_schema_id( $key ) {
if ( is_scalar( $key ) ) { // Int, float, string or bool.
$key = strtolower( $key ); // Convert upper case characters to lower case.
$key = preg_replace( '/[_\-]/', '.', $key ); // Convert underscores and hyphens to periods.
return preg_replace( '/[^a-z\.]/', '', $key ); // Keep only alphabetic and period characters.
}
return '';
}
public static function sanitize_locale( $locale ) {
$locale = str_replace( '-', '_', $locale ); // Convert 'en-US' to 'en_US'.
$locale = preg_replace( '/[^a-zA-Z_]/', '', $locale );
return $locale;
}
public static function sanitize_meta_key( $meta_key ) {
$meta_key = self::decode_html( $meta_key );
$meta_key = self::strip_html( $meta_key );
return $meta_key;
}
public static function sanitize_tag( $tag ) {
$tag = sanitize_title_with_dashes( $tag, '', 'display' );
$tag = urldecode( $tag );
return $tag;
}
public static function sanitize_twitter_name( $twitter_name, $prefix_at = true ) {
if ( '' !== $twitter_name ) {
$twitter_name = substr( preg_replace( array( '/^.*\//', '/[^a-zA-Z0-9_]/' ), '', $twitter_name ), 0, 15 );
if ( ! empty( $twitter_name ) && $prefix_at ) {
$twitter_name = '@' . $twitter_name;
}
}
return $twitter_name;
}
/*
* Note that an empty string or a null is sanitized as false.
*
* Used by the wpssorrssb_get_sharing_buttons() function and the WpssoRrssbShortcodeSharing->do_shortcode() method.
*/
public static function sanitize_use_post( $mixed, $default = true ) {
if ( is_array( $mixed ) ) {
$use_post = isset( $mixed[ 'use_post' ] ) ? $mixed[ 'use_post' ] : $default;
} elseif ( is_object( $mixed ) ) {
$use_post = isset( $mixed->use_post ) ? $mixed->use_post : $default;
} else $use_post = $mixed;
if ( empty( $use_post ) || 'false' === $use_post ) { // 0, false, or 'false'
return false;
} elseif ( is_numeric( $use_post ) ) {
return (int) $use_post;
}
return $default;
}
/*
* TEXT HANDLING METHODS:
*
* append_url_fragment()
* decode_html()
* decode_utf8()
* encode_html_emoji()
* decode_url_add_query()
* encode_utf8()
* esc_url_encode()
* explode_csv()
* get_bool()
* get_bool_string()
* get_const()
* get_file_path_locale()
* get_json_scripts()
* get_mod_css_id()
* get_mod_salt()
* get_prot()
* get_stripped_php()
* get_request_value()
* get_url()
* get_use_post_string()
* insert_html_tag_attributes()
* mb_convert_encoding_ucs2_utf8()
* mb_decode_numericentity_utf8()
* minify_css()
* replace_unicode_escape()
* restore_checkboxes()
* safe_error_log()
* strip_html()
* strip_shortcodes()
* strnatcasecmp_remove_accents()
* unparse_url()
* unquote_csv_value()
* update_prot()
*
* Add a fragment to a URL.
*/
public static function append_url_fragment( $url, $fragment ) {
return preg_replace( '/#.*/', '', $url ) . ( empty( $fragment ) ? '' : '#' . self::sanitize_css_id( $fragment ) );
}
/*
* Decode HTML entities and UTF8 encoding.
*/
public static function decode_html( $encoded ) {
if ( false === strpos( $encoded, '&' ) ) {
return $encoded;
}
static $charset = null;
if ( null === $charset ) {
if ( function_exists( 'get_bloginfo' ) ) {
$charset = get_bloginfo( $show = 'charset', $filter = 'raw' );
}
}
return html_entity_decode( self::decode_utf8( $encoded ), ENT_QUOTES, $charset );
}
public static function decode_url_add_query( $url, array $args ) {
if ( false === filter_var( $url, FILTER_VALIDATE_URL ) ) { // Invalid URL.
return false;
}
$parsed_url = wp_parse_url( self::decode_html( urldecode( $url ) ) );
if ( empty( $parsed_url ) ) {
return false;
}
if ( empty( $parsed_url[ 'query' ] ) ) {
$parsed_url[ 'query' ] = http_build_query( $args );
} else $parsed_url[ 'query' ] .= '&' . http_build_query( $args );
$url = self::unparse_url( $parsed_url );
return $url;
}
public static function decode_utf8( $encoded ) {
if ( false === strpos( $encoded, '&#' ) ) {
return $encoded;
}
$encoded = preg_replace( '/…/', '...', $encoded );
if ( function_exists( 'mb_decode_numericentity' ) ) { // Just in case.
return preg_replace_callback( '/&#\d{2,5};/u', array( __CLASS__, 'mb_decode_numericentity_utf8' ), $encoded );
}
return $encoded;
}
public static function encode_html_emoji( $content ) {
static $charset = null;
if ( null === $charset ) {
if ( function_exists( 'get_bloginfo' ) ) {
$charset = get_bloginfo( $show = 'charset', $filter = 'raw' );
}
}
$content = htmlentities( $content, ENT_QUOTES, $charset, $double_encode = false );
if ( function_exists( 'wp_encode_emoji' ) ) {
$content = wp_encode_emoji( $content );
}
return $content;
}
public static function encode_utf8( $decoded ) {
$encoded = $decoded;
if ( function_exists( 'mb_detect_encoding' ) ) { // Just in case.
if ( mb_detect_encoding( $decoded, 'UTF-8') !== 'UTF-8' ) {
if ( function_exists( 'utf8_encode' ) ) {
$encoded = utf8_encode( $decoded );
}
}
}
return $encoded;
}
public static function esc_url_encode( $url, $esc_url = true ) {
$decoded_url = self::decode_html( $url ); // Decode HTML entities.
$encoded_url = urlencode( $esc_url ? esc_url_raw( $decoded_url ) : $decoded_url );
$replace = array( '%21', '%2A', '%27', '%28', '%29', '%3B', '%3A', '%40', '%26', '%3D', '%2B', '%24', '%2C', '%2F',
'%3F', '%25', '%23', '%5B', '%5D' );
$allowed = array( '!', '*', '\'', '(', ')', ';', ':', '@', '&', '=', '+', '$', ',', '/', '?', '%', '#', '[', ']' );
return str_replace( $replace, $allowed, $encoded_url );
}
public static function explode_csv( $str ) {
if ( empty( $str ) ) {
return array();
}
return array_map( array( __CLASS__, 'unquote_csv_value' ), explode( ',', $str ) );
}
/*
* Maybe convert string to boolean.
*
* See WpssoFaqShortcodeQuestion->do_shortcode().
*/
public static function get_bool( $mixed ) {
return is_string( $mixed ) ? filter_var( $mixed, FILTER_VALIDATE_BOOLEAN ) : (bool) $mixed;
}
public static function get_bool_string( $mixed ) {
if ( false === $mixed ) {
return 'false';
} elseif ( true === $mixed ) {
return 'true';
} elseif ( null === $mixed ) {
return 'null';
}
return (string) $mixed;
}
/*
* Return a constant value, or $undef if not defined.
*/
public static function get_const( $const, $undef = null ) {
return defined( $const ) ? constant( $const ) : $undef;
}
/*
* Check for a localized file name.
*/
public static function get_file_path_locale( $file_path ) {
if ( ! class_exists( 'SucomUtilWP' ) ) { // Just in case.
require_once dirname( __FILE__ ) . '/util-wp.php';
}
if ( preg_match( '/^(.*)(\.[a-z0-9]+)$/', $file_path, $matches ) ) {
if ( ! empty( $matches[ 2 ] ) ) { // Just in case.
$file_path_locale = $matches[ 1 ] . '-' . SucomUtilWP::get_locale() . $matches[ 2 ];
if ( file_exists( $file_path_locale ) ) {
$file_path = $file_path_locale;
}
}
}
return $file_path;
}
public static function get_json_scripts( $html, $do_decode = true ) {
/*
* Remove containers that should not include json scripts.
*
* i = Letters in the pattern match both upper and lower case letters.
* m = The "^" and "$" constructs match newlines and the complete subject string.
* s = A dot metacharacter in the pattern matches all characters, including newlines.
* U = Invert greediness of quantifiers, so they are NOT greedy by default, but become greedy if followed by ?.
*
* See http://php.net/manual/en/reference.pcre.pattern.modifiers.php.
*/
$html = preg_replace( '/<!--.*-->/Ums', '', $html );
$html = preg_replace( '/<pre[ >].*<\/pre>/Uims', '', $html );
$html = preg_replace( '/<textarea[ >].*<\/textarea>/Uims', '', $html );
$json_scripts = array();
/*
* i = Letters in the pattern match both upper and lower case letters.
* s = A dot metacharacter in the pattern matches all characters, including newlines.
* U = Inverts the "greediness" of quantifiers so that they are not greedy by default.
*
* See http://php.net/manual/en/reference.pcre.pattern.modifiers.php.
*/
if ( preg_match_all( '/(<script\b[^>]*type=["\']application\/ld\+json["\'][^>]*>)(.+)(<\/script>)/Uis', $html, $all_matches, PREG_SET_ORDER ) ) {
foreach ( $all_matches as $num => $matches ) {
$json_data = json_decode( $matches[ 2 ], $assoc = true );
if ( preg_match( '/ id=["\']([^"\']+)["\']/', $matches[ 1 ], $m ) ) {
$single_id = 'id:' . $m[ 1 ];
} else $single_id = 'md5:' . md5( serialize( $json_data ) ); // md5() input must be a string.
if ( $do_decode ) { // Return the decoded json data.
if ( is_array( $json_data ) ) {
$json_scripts[ $single_id ] = $json_data;
} else {
$error_pre = sprintf( '%s error:', __METHOD__ );
$error_msg = sprintf( 'Error decoding json script: %s', print_r( $matches[ 2 ], true ) );
self::safe_error_log( $error_pre . ' ' . $error_msg );
}
} else { // Return the json script instead.
$json_scripts[ $single_id ] = $matches[ 0 ];
}
}
}
return $json_scripts;
}
public static function get_mod_css_id( array $mod, $sep = '-' ) {
/*
* Note that the sort order, page number, locale, amp and embed checks are provided by
* WpssoHead->get_head_cache_index() and not SucomUtil::get_mod_salt().
*
* Example cache salts:
*
* 'post:123_type:page'
* 'post:123_type:product_is_pta' // WooCommerce shop page.
* 'term:123_tax:product_cat' // WooCommerce category page.
*/
$css_id = self::get_mod_salt( $mod, $canonical_url = false, $sep );
$css_id = self::sanitize_css_id( $css_id );
return $css_id;
}
/*
* A cache salt string based on the $mod array. If $mod is not an array, then use the canonical URL value.
*
* Note that the sort order, page number, locale, amp and embed checks are provided by
* WpssoHead->get_head_cache_index() and not SucomUtil::get_mod_salt().
*
* Example cache salts:
*
* 'post:123_type:page'
* 'post:123_type:product_is_pta' // WooCommerce shop page.
* 'term:123_tax:product_cat' // WooCommerce category page.
*
* 'is_home_url:https_example_com' // When a canonical URL is provided.
* 'post:123_type:page_url:https_example_com_page-slug' // When a canonical URL is provided.
* 'url:https_example_com_2022_01' // When a canonical URL is provided.
*
* See SucomUtil::get_mod_css_id().
* See SucomUtilWP::get_locale().
* See WpssoAbstractWpMeta->check_sortable_meta().
* See WpssoHead->clear_head_array().
* See WpssoHead->get_head_array().
* See WpssoOpenGraph->get_mod_og_type().
* See WpssoPage->clear_the_content().
* See WpssoPage->get_the_content().
* See WpssoPinterest->get_mod_image_html().
* See WpssoSchema->get_mod_schema_type().
* See WpssoUtil->get_canonical_url().
* See WpssoUtil->clear_uniq_urls().
* See WpssoUtil->is_uniq_url().
*/
public static function get_mod_salt( $mod = false, $canonical_url = false, $sep = '_' ) {
$mod_salt = '';
if ( is_array( $mod ) ) {
if ( ! empty( $mod[ 'name' ] ) ) { // Add the module name and ID.
$mod_salt .= $sep . $mod[ 'name' ];
if ( is_bool( $mod[ 'id' ] ) ) {
$mod_salt .= ':' . ( $mod[ 'id' ] ? 'true' : 'false' );
} elseif ( is_numeric( $mod[ 'id' ] ) ) { // Just in case.
$mod_salt .= ':' . $mod[ 'id' ];
}
}
if ( ! empty( $mod[ 'post_type' ] ) ) { // Add the post type name.
$mod_salt .= $sep . 'type:' . ( is_string( $mod[ 'post_type' ] ) ?
$mod[ 'post_type' ] : print_r( $mod[ 'post_type' ], true ) );
if ( ! empty( $mod[ 'is_post_type_archive' ] ) ) { // Post type archive page.
$mod_salt .= $sep . 'is_pta';
}
} elseif ( ! empty( $mod[ 'tax_slug' ] ) ) { // Add the taxonomy name.
$mod_salt .= $sep . 'tax:' . $mod[ 'tax_slug' ];
}
if ( ! empty( $mod[ 'is_home' ] ) ) { // Home page (static or blog archive).
$mod_salt .= $sep . 'is_home';
}
}
if ( ! empty( $canonical_url ) ) {
$mod_salt .= $sep . 'url:' . self::sanitize_input_name( $canonical_url, $sep );
}
$mod_salt = trim( $mod_salt, $sep );
return apply_filters( 'sucom_mod_salt', $mod_salt, $canonical_url );
}
public static function get_prot( $url = '' ) {
if ( $url ) {
return self::is_https( $url ) ? 'https' : 'http';
} elseif ( self::is_https() ) {
return 'https';
} elseif ( is_admin() ) {
if ( defined( 'FORCE_SSL_ADMIN' ) && FORCE_SSL_ADMIN ) {
return 'https';
}
} elseif ( defined( 'FORCE_SSL' ) && FORCE_SSL ) {
return 'https';
}
return 'http';
}
/*
* $method = 'ANY' uses the current request method.
*/
public static function get_request_value( $key, $method = 'ANY', $default = '' ) {
switch ( 'ANY' === $method ? $_SERVER[ 'REQUEST_METHOD' ] : $method ) {
case 'POST':
if ( isset( $_POST[ $key ] ) ) {
return sanitize_text_field( $_POST[ $key ] );
}
break;
case 'GET':
if ( isset( $_GET[ $key ] ) ) {
return sanitize_text_field( $_GET[ $key ] );
}
break;
}
return $default;
}
public static function get_stripped_php( $file_path ) {
$stripped_php = '';
if ( file_exists( $file_path ) ) {
$content = file_get_contents( $file_path );
$comments = array( T_COMMENT );
if ( defined( 'T_DOC_COMMENT' ) ) {
$comments[] = T_DOC_COMMENT; // PHP 5.
}
if ( defined( 'T_ML_COMMENT' ) ) {
$comments[] = T_ML_COMMENT; // PHP 4.
}
$tokens = token_get_all( $content );
foreach ( $tokens as $token ) {
if ( is_array( $token ) ) {
if ( in_array( $token[ 0 ], $comments ) ) {
continue;
}
$token = $token[ 1 ];
}
$stripped_php .= $token;
}
} else $stripped_php = false;
return $stripped_php;
}
/*
* Get the current $_SERVER[ 'REQUEST_URI' ] URL, optionally with tracking and advertising query args removed.
*/
public static function get_url( $clean_args = true ) {
static $local_cache = array();
$cache_idx = $clean_args ? 0 : 1; // Converts null to 0.
if ( isset( $local_cache[ $cache_idx ] ) ) {
return $local_cache[ $cache_idx ];
}
$base_url = preg_replace( '/^(.*\/\/[^\/]*).*$/', '$1', get_home_url() );
$local_cache[ $cache_idx ] = esc_url_raw( $base_url . $_SERVER[ 'REQUEST_URI' ] );
if ( $clean_args ) { // Remove tracking and advertising query args.
$query_args = apply_filters( 'sucom_url_clean_query_args', self::$url_clean_query );
if ( ! empty( $query_args ) ) { // Just in case.
$query_args = array_flip( $query_args ); // Move values to keys.
$query_args = array_fill_keys( array_keys( $query_args ), false ); // Set all values to false.
$local_cache[ $cache_idx ] = add_query_arg( $query_args, $local_cache[ $cache_idx ] ); // Remove keys with false values.
}
}
return $local_cache[ $cache_idx ];
}
public static function get_use_post_string( $use_post ) {
$use_post = self::sanitize_use_post( $use_post );
return self::get_bool_string( $use_post );
}
/*
* Add one or more attributes to the HTML tag.
*
* Example HTML tag:
*
* $html argument = '<img src="/image.jpg">
* $html returned = '<img src="/image.jpg" data-pin-nopin="nopin">'
*/
public static function insert_html_tag_attributes( $html, array $attr_names_values ) {
foreach ( $attr_names_values as $attr_name => $attr_value ) {
if ( false !== $attr_value && false === strpos( $html, ' ' . $attr_name . '=' ) ) {
$html = preg_replace( '/ *\/?' . '>/', ' ' . $attr_name . '="' . $attr_value . '"$0', $html );
}
}
return $html;
}
public static function mb_convert_encoding_ucs2_utf8( array $match ) {
return mb_convert_encoding( pack( 'H*', $match[ 1 ] ), $to_encoding = 'UTF-8', $from_encoding = 'UCS-2' );
}
public static function mb_decode_numericentity_utf8( array $match ) {
$convmap = array( 0x0, 0x10000, 0, 0xfffff );
return mb_decode_numericentity( $match[ 0 ], $convmap, 'UTF-8' );
}
public static function minify_css( $css_data, $filter_prefix = 'sucom' ) {
if ( ! empty( $css_data ) ) { // Make sure we have something to minify.
$classname = apply_filters( $filter_prefix . '_load_lib', false, 'ext/compressor', 'SuextMinifyCssCompressor' );
if ( 'SuextMinifyCssCompressor' === $classname && class_exists( $classname ) ) {
$css_data = $classname::process( $css_data );
}
}
return $css_data;
}
/*
* Decode Facebook video URLs.
*/
public static function replace_unicode_escape( $str ) {
if ( function_exists( 'mb_convert_encoding' ) ) {
return preg_replace_callback( '/\\\\u([0-9a-f]{4})/i', array( __CLASS__, 'mb_convert_encoding_ucs2_utf8' ), $str );
}
return $str;
}
/*
* Unchecked checkboxes are not submitted, so re-create them based on hidden form values.
*/
public static function restore_checkboxes( $opts ) {
if ( is_array( $opts ) ) { // Just in case.
$checkbox = self::preg_grep_keys( '/^is_checkbox_/', $opts, $invert = false, $replace = '' );
foreach ( $checkbox as $key => $val ) {
if ( ! array_key_exists( $key, $opts ) ) {
$opts[ $key ] = 0; // Add missing checkbox as empty.
}
unset( $opts[ 'is_checkbox_' . $key] );
}
}
return $opts;
}
public static function safe_error_log( $error_msg, $strip_html = false ) {
$ini_safe = array(
'display_errors' => 0,
'log_errors' => 1,
'error_log' => defined( 'WP_DEBUG_LOG' ) && is_string( WP_DEBUG_LOG ) && WP_DEBUG_LOG ?
WP_DEBUG_LOG : WP_CONTENT_DIR . '/debug.log',
);
$ini_orig = array();
foreach ( $ini_safe as $name => $value ) {
$value_orig = ini_get( $name ); // Returns false on failure.
if ( $value !== $value_orig ) {
if ( false !== ini_set( $name, $value ) ) { // Returns false on failure.
$ini_orig[ $name ] = $value_orig;
}
}
}
if ( $strip_html ) {
$error_msg = self::strip_html( $error_msg );
}
/*
* Use error_log() instead of trigger_error() to avoid HTTP 500.
*/
error_log( $error_msg );
foreach ( $ini_orig as $name => $value_orig ) {
/*
* Failed getting the original value.
*/
if ( false === $value_orig ) {
ini_restore( $name );
/*
* PHP does not allow setting an empty 'error_log' when ini_get( 'open_basedir' ) is true.
*/
} elseif ( 'error_log' === $name && empty( $value_orig ) && ini_get( 'open_basedir' ) ) {
ini_restore( $name );
} else ini_set( $name, $value_orig );
}
}
public static function strip_html( $text ) {
/*
* i = Letters in the pattern match both upper and lower case letters.
* s = A dot metacharacter in the pattern matches all characters, including newlines.
* U = Invert greediness of quantifiers, so they are NOT greedy by default, but become greedy if followed by ?.
*
* See http://php.net/manual/en/reference.pcre.pattern.modifiers.php.
*/
$text = self::strip_shortcodes( $text ); // Remove any remaining shortcodes.
$text = preg_replace( '/[\s\n\r]+/s', ' ', $text ); // Put everything on one line.
$text = preg_replace( '/<\?.*\?' . '>/U', ' ', $text ); // Remove php.
$text = preg_replace( '/<script\b[^>]*>(.*)<\/script>/Ui', ' ', $text ); // Remove javascript.
$text = preg_replace( '/<style\b[^>]*>(.*)<\/style>/Ui', ' ', $text ); // Remove inline stylesheets.
$text = preg_replace( '/([\w])<\/(button|dt|h[0-9]+|li|th)>/i', '$1. ', $text ); // Add missing dot to buttons, headers, lists, etc.
$text = preg_replace( '/(<p>|<p[^>]+>|<\/p>)/i', ' ', $text ); // Replace paragraph tags with a space.
$text = trim( strip_tags( $text ) ); // Strip HTML and PHP tags from a string.
$text = preg_replace( '/(\xC2\xA0|\s)+/s', ' ', $text ); // Replace 1+ spaces to a single space.
return trim( $text );
}
/*
* Remove registered shortcodes from the content, along with some known unregistered shortcodes.
*/
public static function strip_shortcodes( $content ) {
if ( false === strpos( $content, '[' ) ) { // Optimize and check if there are shortcodes.
return $content;
}
if ( function_exists( 'strip_shortcodes' ) ) {
$content = strip_shortcodes( $content ); // Remove registered shortcodes.
if ( false === strpos( $content, '[' ) ) { // Stop here if there are no more shortcodes.
return $content;
}
}
$shortcodes_preg = array( '/\[\/?(cs_element_|et_|fusion_|mk_|rev_slider_|vc_)[^\]]+\]/' );
$content = preg_replace( $shortcodes_preg, ' ', $content );
return $content;
}
protected static function strnatcasecmp_remove_accents( $a, $b ) {
return strnatcasecmp( remove_accents( $a ), remove_accents( $b ) );
}
public static function unparse_url( $parsed_url ) {
$scheme = isset( $parsed_url[ 'scheme' ] ) ? $parsed_url[ 'scheme' ] . '://' : '';
$user = isset( $parsed_url[ 'user' ] ) ? $parsed_url[ 'user' ] : '';
$pass = isset( $parsed_url[ 'pass' ] ) ? ':' . $parsed_url[ 'pass' ] : '';
$host = isset( $parsed_url[ 'host' ] ) ? $parsed_url[ 'host' ] : '';
$port = isset( $parsed_url[ 'port' ] ) ? ':' . $parsed_url[ 'port' ] : '';
$path = isset( $parsed_url[ 'path' ] ) ? $parsed_url[ 'path' ] : '';
$query = isset( $parsed_url[ 'query' ] ) ? '?' . $parsed_url[ 'query' ] : '';
$fragment = isset( $parsed_url[ 'fragment' ] ) ? '#' . $parsed_url[ 'fragment' ] : '';
return $scheme . $user . $pass . ( $user || $pass ? '@' : '' ) . $host . $port . $path . $query . $fragment;
}
protected static function unquote_csv_value( $val ) {
return trim( $val, '\'" ' ); // Remove quotes and spaces.
}
public static function update_prot( $url = '' ) {
if ( 0 === strpos( $url, '/' ) ) { // Skip relative URLs.
return $url;
}
$prot_slash = self::get_prot() . '://';
if ( 0 === strpos( $url, $prot_slash ) ) { // Skip correct URLs.
return $url;
}
return preg_replace( '/^([a-z]+:\/\/)/', $prot_slash, $url );
}
}
}