/wp-content/plugins/ninja-forms/includes/Helper.php
PHP | 248 lines | 150 code | 29 blank | 69 comment | 19 complexity | 160c26bdc17a872d356e2ecaa41795c8 MD5 | raw file
Possible License(s): LGPL-2.1, MPL-2.0-no-copyleft-exception, Apache-2.0, LGPL-3.0, MIT, BSD-3-Clause
- <?php if ( ! defined( 'ABSPATH' ) ) exit;
- /**
- * Class WPN_Helper
- *
- * The WP Ninjas Static Helper Class
- *
- * Provides additional helper functionality to WordPress helper functions.
- */
- final class WPN_Helper
- {
- /**
- * @param $value
- * @return array|string
- */
- public static function addslashes( $value )
- {
- $value = is_array($value) ?
- array_map(array( 'self', 'addslashes' ), $value) :
- addslashes($value);
- return $value;
- }
- /**
- * @param $input
- * @return array|string
- */
- public static function utf8_encode( $input ){
- if ( is_array( $input ) ) {
- return array_map( array( 'self', 'utf8_encode' ), $input );
- }else{
- return utf8_encode( $input );
- }
- }
- /**
- * @param $input
- * @return array|string
- */
- public static function utf8_decode( $input ){
- if ( is_array( $input ) ) {
- return array_map( array( 'self', 'utf8_decode' ), $input );
- }else{
- return utf8_decode( $input );
- }
- }
- /**
- * @param $search
- * @param $replace
- * @param $subject
- * @return mixed
- */
- public static function str_replace( $search, $replace, $subject ){
- if( is_array( $subject ) ){
- foreach( $subject as &$oneSubject )
- $oneSubject = WPN_Helper::str_replace($search, $replace, $oneSubject);
- unset($oneSubject);
- return $subject;
- } else {
- return str_replace($search, $replace, $subject);
- }
- }
- /**
- * @param $value
- * @param int $flag
- * @return array|string
- */
- public static function html_entity_decode( $value, $flag = ENT_COMPAT ){
- $value = is_array($value) ?
- array_map( array( 'self', 'html_entity_decode' ), $value) :
- html_entity_decode( $value, $flag );
- return $value;
- }
- /**
- * @param $value
- * @return array|string
- */
- public static function htmlspecialchars( $value ){
- $value = is_array($value) ?
- array_map( array( 'self', 'htmlspecialchars' ), $value) :
- htmlspecialchars( $value );
- return $value;
- }
- /**
- * @param $value
- * @return array|string
- */
- public static function stripslashes( $value ){
- $value = is_array($value) ?
- array_map( array( 'self', 'stripslashes' ), $value) :
- stripslashes($value);
- return $value;
- }
- /**
- * @param $value
- * @return array|string
- */
- public static function esc_html( $value )
- {
- $value = is_array($value) ?
- array_map( array( 'self', 'esc_html' ), $value) :
- esc_html($value);
- return $value;
- }
- /**
- * @param $value
- * @return array|string
- */
- public static function kses_post( $value )
- {
- $value = is_array( $value ) ?
- array_map( array( 'self', 'kses_post' ), $value ) :
- wp_kses_post($value);
- return $value;
- }
- /**
- * @param $value
- * @return array|string
- */
- public static function strip_tags( $value )
- {
- $value = is_array( $value ) ?
- array_map( array( 'self', 'strip_tags' ), $value ) :
- strip_tags( $value );
- return $value;
- }
- /**
- * String to Bytes
- *
- * Converts PHP settings from a string to bytes.
- *
- * @param $size
- * @return float
- */
- public static function string_to_bytes( $size )
- {
- // Remove the non-unit characters from the size.
- $unit = preg_replace('/[^bkmgtpezy]/i', '', $size);
- // Remove the non-numeric characters from the size.
- $size = preg_replace('/[^0-9\.]/', '', $size);
- if ( $unit && is_array( $unit ) ) {
- // Find the position of the unit in the ordered string which is the power of magnitude to multiply a kilobyte by.
- $size *= pow( 1024, stripos( 'bkmgtpezy', $unit[0] ) );
- }
- return round($size);
- }
- public static function str_putcsv( $array, $delimiter = ',', $enclosure = '"', $terminator = "\n" ) {
- // First convert associative array to numeric indexed array
- $workArray = array();
- foreach ($array as $key => $value) {
- $workArray[] = $value;
- }
- $returnString = ''; # Initialize return string
- $arraySize = count( $workArray ); # Get size of array
- for ( $i=0; $i<$arraySize; $i++ ) {
- // Nested array, process nest item
- if ( is_array( $workArray[$i] ) ) {
- $returnString .= self::str_putcsv( $workArray[$i], $delimiter, $enclosure, $terminator );
- } else {
- switch ( gettype( $workArray[$i] ) ) {
- // Manually set some strings
- case "NULL": $_spFormat = ''; break;
- case "boolean": $_spFormat = ($workArray[$i] == true) ? 'true': 'false'; break;
- // Make sure sprintf has a good datatype to work with
- case "integer": $_spFormat = '%i'; break;
- case "double": $_spFormat = '%0.2f'; break;
- case "string": $_spFormat = '%s'; $workArray[$i] = str_replace("$enclosure", "$enclosure$enclosure", $workArray[$i]); break;
- // Unknown or invalid items for a csv - note: the datatype of array is already handled above, assuming the data is nested
- case "object":
- case "resource":
- default: $_spFormat = ''; break;
- }
- $returnString .= sprintf('%2$s'.$_spFormat.'%2$s', $workArray[$i], $enclosure);
- $returnString .= ($i < ($arraySize-1)) ? $delimiter : $terminator;
- }
- }
- // Done the workload, return the output information
- return $returnString;
- }
- public static function get_query_string( $key, $default = FALSE )
- {
- if( ! isset( $_GET[ $key ] ) ) return $default;
- $value = self::htmlspecialchars( $_GET[ $key ] );
- if( is_array( $value ) ) $value = $value[ 0 ];
- return $value;
- }
- public static function sanitize_text_field( $data )
- {
- if( is_array( $data ) ){
- return array_map( array( 'self', 'sanitize_text_field' ), $data );
- }
- return sanitize_text_field( $data );
- }
- public static function get_plugin_version( $plugin )
- {
- $plugins = get_plugins();
- if( ! isset( $plugins[ $plugin ] ) ) return false;
- return $plugins[ $plugin ][ 'Version' ];
- }
- public static function is_func_disabled( $function )
- {
- if( ! function_exists( $function ) ) return true;
- $disabled = explode( ',', ini_get( 'disable_functions' ) );
- return in_array( $function, $disabled );
- }
- public static function maybe_unserialize( $original )
- {
- // Repalcement for https://codex.wordpress.org/Function_Reference/maybe_unserialize
- if ( is_serialized( $original ) ){
- // Ported with php5.2 support from https://magp.ie/2014/08/13/php-unserialize-string-after-non-utf8-characters-stripped-out/
- $parsed = preg_replace_callback( '!s:(\d+):"(.*?)";!s', array( 'self', 'parse_utf8_serialized' ), $original );
- return unserialize( $parsed );
- }
- return $original;
- }
- private static function parse_utf8_serialized( $matches )
- {
- if ( isset( $matches[2] ) ){
- return 's:'.strlen($matches[2]).':"'.$matches[2].'";';
- }
- }
- } // End Class WPN_Helper