CMB2_Sanitize::_save_utc_value() - Code Metrics - Inspection of "Fix typo in tests" - WebDevStudios/CMB2 - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — trunk ( df6be1...704260 )

by Justin

created 2016-04-13 03:18 UTC

CMB2_Sanitize::_save_utc_value() A

↳ Parent: CMB2_Sanitize

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Metric	Value
dl	0
loc	3
ccs	0
cts	2
cp	0
rs	10
cc	1
eloc	2
nc	1
nop	2
crap	2

<?php
/**
 * CMB2 field sanitization
 *
 * @since  0.0.4
 *
 * @category  WordPress_Plugin
 * @package   CMB2
 * @author    WebDevStudios
 * @license   GPL-2.0+
 * @link      http://webdevstudios.com
 *
 * @method string _id()
 */
class CMB2_Sanitize {
namespace YourVendor;

class YourClass { }

	/**
	 * A CMB field object
	 * @var CMB2_Field object
	 */
	public $field;

	/**
	 * Field's value
	 * @var mixed
	 */
	public $value;

	/**
	 * Setup our class vars
	 * @since 1.1.0
	 * @param CMB2_Field $field A CMB2 field object
	 * @param mixed      $value Field value
	 */
	public function __construct( CMB2_Field $field, $value ) {
		$this->field = $field;
		$this->value = stripslashes_deep( $value ); // get rid of those evil magic quotes
	}

	/**
	 * Catchall method if field's 'sanitization_cb' is NOT defined, or field type does not have a corresponding validation method
	 * @since  1.0.0
	 * @param  string $name      Non-existent method name
	 * @param  array  $arguments All arguments passed to the method
	 */
	public function __call( $name, $arguments ) {
		return $this->default_sanitization();
	}

	/**
	 * Default fallback sanitization method. Applies filters.
	 * @since  1.0.2
	 */
	public function default_sanitization() {

		/**
		 * This exists for back-compatibility, but validation
		 * is not what happens here.
		 * @deprecated See documentation for "cmb2_sanitize_{$this->type()}".
		 */
		$override_value = apply_filters( "cmb2_validate_{$this->field->type()}", null, $this->value, $this->field->object_id, $this->field->args(), $this );

		if ( null !== $override_value ) {
			return $override_value;
		}

		$sanitized_value = '';
		switch ( $this->field->type() ) {
			case 'wysiwyg':
			case 'textarea_small':
			case 'oembed':
				$sanitized_value = $this->textarea();
				break;
			case 'taxonomy_select':
			case 'taxonomy_radio':
			case 'taxonomy_radio_inline':
			case 'taxonomy_multicheck':
			case 'taxonomy_multicheck_inline':
				if ( $this->field->args( 'taxonomy' ) ) {
					wp_set_object_terms( $this->field->object_id, $this->value, $this->field->args( 'taxonomy' ) );
				} else {
					cmb2_utils()->log_if_debug( __METHOD__, __LINE__, "{$this->field->type()} {$this->field->_id()} is missing the 'taxonomy' parameter." );
				}
				break;
			case 'multicheck':
			case 'multicheck_inline':
			case 'file_list':
			case 'group':
				// no filtering
				$sanitized_value = $this->value;
				break;
			default:
				// Handle repeatable fields array
				// We'll fallback to 'sanitize_text_field'
				$sanitized_value = is_array( $this->value ) ? array_map( 'sanitize_text_field', $this->value ) : sanitize_text_field( $this->value );
				break;
		}

		return $this->_is_empty_array( $sanitized_value ) ? '' : $sanitized_value;
	}

	/**
	 * Simple checkbox validation
	 * @since  1.0.1
	 * @return string|false 'on' or false
	 */
	public function checkbox() {
		return $this->value === 'on' ? 'on' : false;
	}

	/**
	 * Validate url in a meta value
	 * @since  1.0.1
	 * @return string        Empty string or escaped url
	 */
	public function text_url() {
		$protocols = $this->field->args( 'protocols' );
		// for repeatable
		if ( is_array( $this->value ) ) {
			foreach ( $this->value as $key => $val ) {
				$this->value[ $key ] = $val ? esc_url_raw( $val, $protocols ) : $this->field->get_default();
			}
		} else {
			$this->value = $this->value ? esc_url_raw( $this->value, $protocols ) : $this->field->get_default();
		}

		return $this->value;
	}

	public function colorpicker() {
		// for repeatable
		if ( is_array( $this->value ) ) {
			$check = $this->value;
			$this->value = array();
			foreach ( $check as $key => $val ) {
				if ( $val && '#' != $val ) {
					$this->value[ $key ] = esc_attr( $val );
				}
			}
		} else {
			$this->value = ! $this->value || '#' == $this->value ? '' : esc_attr( $this->value );
		}
		return $this->value;
	}

	/**
	 * Validate email in a meta value
	 * @since  1.0.1
	 * @return string       Empty string or sanitized email
	 */
	public function text_email() {
		// for repeatable
		if ( is_array( $this->value ) ) {
			foreach ( $this->value as $key => $val ) {
				$val = trim( $val );
				$this->value[ $key ] = is_email( $val ) ? $val : '';
			}
		} else {
			$this->value = trim( $this->value );
			$this->value = is_email( $this->value ) ? $this->value : '';
		}

		return $this->value;
	}

	/**
	 * Validate money in a meta value
	 * @since  1.0.1
	 * @return string       Empty string or sanitized money value
	 */
	public function text_money() {

		global $wp_locale;
function myFunction($a, $b) {
    // Do something
}

		$search = array( $wp_locale->number_format['thousands_sep'], $wp_locale->number_format['decimal_point'] );
		$replace = array( '', '.' );

		// for repeatable
		if ( is_array( $this->value ) ) {
			foreach ( $this->value as $key => $val ) {
				$this->value[ $key ] = number_format_i18n( (float) str_ireplace( $search, $replace, $val ), 2 );
			}
		} else {
			$this->value = number_format_i18n( (float) str_ireplace( $search, $replace, $this->value ), 2 );
		}

		return $this->value;
	}

	/**
	 * Converts text date to timestamp
	 * @since  1.0.2
	 * @return string Timestring
	 */
	public function text_date_timestamp() {
		return is_array( $this->value )
			? array_map( array( $this->field, 'get_timestamp_from_value' ), $this->value )
			: $this->field->get_timestamp_from_value( $this->value );
	}

	/**
	 * Datetime to timestamp
	 * @since  1.0.1
	 * @return string Timestring
	 */
	public function text_datetime_timestamp( $repeat = false ) {

		$test = is_array( $this->value ) ? array_filter( $this->value ) : '';
		if ( empty( $test ) ) {
			return '';
		}

		$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
		if ( false !== $repeat_value ) {
			return $repeat_value;
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}
		}

		if ( isset( $this->value['date'], $this->value['time'] ) ) {
			$this->value = $this->field->get_timestamp_from_value( $this->value['date'] . ' ' . $this->value['time'] );
		}

		if ( $tz_offset = $this->field->field_timezone_offset() ) {
			$this->value += (int) $tz_offset;
		}

		return $this->value;
	}

	/**
	 * Datetime to timestamp with timezone
	 * @since  1.0.1
	 * @return string       Timestring
	 */
	public function text_datetime_timestamp_timezone( $repeat = false ) {
		static $utc_values = array();

		$test = is_array( $this->value ) ? array_filter( $this->value ) : '';
		if ( empty( $test ) ) {
			return '';
		}

		$utc_key = $this->field->_id() . '_utc';

		$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
		if ( false !== $repeat_value ) {
			if ( ! empty( $utc_values[ $utc_key ] ) ) {
				$this->_save_utc_value( $utc_key, $utc_values[ $utc_key ] );
				unset( $utc_values[ $utc_key ] );
			}

			return $repeat_value;
		}

		$tzstring = null;

		if ( is_array( $this->value ) && array_key_exists( 'timezone', $this->value ) ) {
			$tzstring = $this->value['timezone'];
		}

		if ( empty( $tzstring ) ) {
			$tzstring = cmb2_utils()->timezone_string();
		}

		$offset = cmb2_utils()->timezone_offset( $tzstring );

		if ( 'UTC' === substr( $tzstring, 0, 3 ) ) {
			$tzstring = timezone_name_from_abbr( '', $offset, 0 );
			/*
			 * timezone_name_from_abbr() returns false if not found based on offset.
			 * Since there are currently some invalid timezones in wp_timezone_dropdown(),
			 * fallback to an offset of 0 (UTC+0)
			 * https://core.trac.wordpress.org/ticket/29205
			 */
			$tzstring = false !== $tzstring ? $tzstring : timezone_name_from_abbr( '', 0, 0 );
		}

		$full_format = $this->field->args['date_format'] . ' ' . $this->field->args['time_format'];
		$full_date   = $this->value['date'] . ' ' . $this->value['time'];

		try {

			$datetime = date_create_from_format( $full_format, $full_date );

			if ( ! is_object( $datetime ) ) {
				$this->value = $utc_stamp = '';
			} else {
				$timestamp   = $datetime->setTimezone( new DateTimeZone( $tzstring ) )->getTimestamp();
				$utc_stamp   = $timestamp - $offset;
				$this->value = serialize( $datetime );
			}

			if ( $this->field->group ) {
				$this->value = array(
					'supporting_field_value' => $utc_stamp,
					'supporting_field_id'    => $utc_key,
					'value'                  => $this->value,
				);
			} else {
				// Save the utc timestamp supporting field
				if ( $repeat ) {
					$utc_values[ $utc_key ][] = $utc_stamp;
				} else {
					$this->_save_utc_value( $utc_key, $utc_stamp );
				}
			}

		} catch ( Exception $e ) {
			$this->value = '';
			cmb2_utils()->log_if_debug( __METHOD__, __LINE__, $e->getMessage() );
		}

		return $this->value;
	}

	/**
	 * Sanitize textareas and wysiwyg fields
	 * @since  1.0.1
	 * @return string       Sanitized data
	 */
	public function textarea() {
		return is_array( $this->value ) ? array_map( 'wp_kses_post', $this->value ) : wp_kses_post( $this->value );
	}

	/**
	 * Sanitize code textareas
	 * @since  1.0.2
	 * @return string       Sanitized data
	 */
	public function textarea_code( $repeat = false ) {
		$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
		if ( false !== $repeat_value ) {
			return $repeat_value;
		}

		return htmlspecialchars_decode( stripslashes( $this->value ) );
	}

	/**
	 * Handles saving of attachment post ID and sanitizing file url
	 * @since  1.1.0
	 * @return string        Sanitized url
	 */
	public function file() {
		$file_id_key = $this->field->_id() . '_id';

		if ( $this->field->group ) {
			// Return an array with url/id if saving a group field
			$this->value = $this->_get_group_file_value_array( $file_id_key );
		} else {
			$this->_save_file_id_value( $file_id_key );
			$this->text_url();
		}

		return $this->value;
	}

	/**
	 * Gets the values for the `file` field type from the data being saved.
	 * @since  2.2.0
	 */
	public function _get_group_file_value_array( $id_key ) {
		$alldata = $this->field->group->data_to_save;
		$base_id = $this->field->group->_id();
		$i       = $this->field->group->index;

		// Check group $alldata data
		$id_val  = isset( $alldata[ $base_id ][ $i ][ $id_key ] )
			? absint( $alldata[ $base_id ][ $i ][ $id_key ] )
			: 0;

		return array(
			'value' => $this->text_url(),
			'supporting_field_value' => $id_val,
			'supporting_field_id'    => $id_key,
		);
	}

	/**
	 * Peforms saving of `file` attachement's ID
	 * @since  1.1.0
	 */
	public function _save_file_id_value( $file_id_key ) {
		$id_field = $this->_new_supporting_field( $file_id_key );

		// Check standard data_to_save data
		$id_val = isset( $this->field->data_to_save[ $file_id_key ] )
			? $this->field->data_to_save[ $file_id_key ]
			: null;

		// If there is no ID saved yet, try to get it from the url
		if ( $this->value && ! $id_val ) {
			$id_val = cmb2_utils()->image_id_from_url( $this->value );
		}

		return $id_field->save_field( $id_val );
	}

	/**
	 * Peforms saving of `text_datetime_timestamp_timezone` utc timestamp
	 * @since  2.2.0
	 */
	public function _save_utc_value( $utc_key, $utc_stamp ) {
		return $this->_new_supporting_field( $utc_key )->save_field( $utc_stamp );
	}

	/**
	 * Returns a new, supporting, CMB2_Field object based on a new field id.
	 * @since  2.2.0
	 */
	public function _new_supporting_field( $new_field_id ) {
		return $this->field->get_field_clone( array(
			'id' => $new_field_id,
			'sanitization_cb' => false,
		) );
	}

	/**
	 * If repeating, loop through and re-apply sanitization method
	 * @since  1.1.0
	 * @param  string $method Class method
	 * @param  bool   $repeat Whether repeating or not
	 * @return mixed          Sanitized value
	 */
	public function _check_repeat( $method, $repeat ) {
		if ( $repeat || ! $this->field->args( 'repeatable' ) ) {
			return false;
		}

		$values_array = $this->value;

		$new_value = array();
		foreach ( $values_array as $iterator => $this->value ) {
			if ( $this->value ) {
				$val = $this->$method( true );
				if ( ! empty( $val ) ) {
					$new_value[] = $val;
				}
			}
		}

		$this->value = $new_value;

		return empty( $this->value ) ? null : $this->value;
	}

	/**
	 * Determine if passed value is an empty array
	 * @since  2.0.6
	 * @param  mixed  $to_check Value to check
	 * @return boolean          Whether value is an array that's empty
	 */
	public function _is_empty_array( $to_check ) {
		if ( is_array( $to_check ) ) {
			$cleaned_up = array_filter( $to_check );
			return empty( $cleaned_up );
		}
		return false;
	}

}


Push — trunk ( df6be1...704260 )

CMB2_Sanitize::_save_utc_value() A

Complexity

Size

Duplication

Code Coverage

1. Pass all data via parameters

2. Create a class that maintains your state

1		<?php
2		/**
3		* CMB2 field sanitization
4		*
5		* @since 0.0.4
6		*
7		* @category WordPress_Plugin
8		* @package CMB2
9		* @author WebDevStudios
10		* @license GPL-2.0+
11		* @link http://webdevstudios.com
12		*
13		* @method string _id()
14		*/
15		class CMB2_Sanitize {
		0 ignored issues – show Coding Style Compatibility introduced 2015-11-24 04:05 UTC by Report Bug Copy Issue Report PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions. You can fix this by adding a namespace to your class: namespace YourVendor; class YourClass { } When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries. Loading history...
16
17		/**
18		* A CMB field object
19		* @var CMB2_Field object
20		*/
21		public $field;
22
23		/**
24		* Field's value
25		* @var mixed
26		*/
27		public $value;
28
29		/**
30		* Setup our class vars
31		* @since 1.1.0
32		* @param CMB2_Field $field A CMB2 field object
33		* @param mixed $value Field value
34		*/
35	9	public function __construct( CMB2_Field $field, $value ) {
36	9	$this->field = $field;
37	9	$this->value = stripslashes_deep( $value ); // get rid of those evil magic quotes
38	9	}
39
40		/**
41		* Catchall method if field's 'sanitization_cb' is NOT defined, or field type does not have a corresponding validation method
42		* @since 1.0.0
43		* @param string $name Non-existent method name
44		* @param array $arguments All arguments passed to the method
45		*/
46	8	public function __call( $name, $arguments ) {
47	8	return $this->default_sanitization();
48		}
49
50		/**
51		* Default fallback sanitization method. Applies filters.
52		* @since 1.0.2
53		*/
54	8	public function default_sanitization() {
55
56		/**
57		* This exists for back-compatibility, but validation
58		* is not what happens here.
59		* @deprecated See documentation for "cmb2_sanitize_{$this->type()}".
60		*/
61	8	$override_value = apply_filters( "cmb2_validate_{$this->field->type()}", null, $this->value, $this->field->object_id, $this->field->args(), $this );
62
63	8	if ( null !== $override_value ) {
64		return $override_value;
65		}
66
67	8	$sanitized_value = '';
68	8	switch ( $this->field->type() ) {
69	8	case 'wysiwyg':
70	8	case 'textarea_small':
71	8	case 'oembed':
72	2	$sanitized_value = $this->textarea();
73	2	break;
74	8	case 'taxonomy_select':
75	8	case 'taxonomy_radio':
76	8	case 'taxonomy_radio_inline':
77	8	case 'taxonomy_multicheck':
78	8	case 'taxonomy_multicheck_inline':
79		if ( $this->field->args( 'taxonomy' ) ) {
80		wp_set_object_terms( $this->field->object_id, $this->value, $this->field->args( 'taxonomy' ) );
81		} else {
82		cmb2_utils()->log_if_debug( __METHOD__, __LINE__, "{$this->field->type()} {$this->field->_id()} is missing the 'taxonomy' parameter." );
83		}
84		break;
85	8	case 'multicheck':
86	8	case 'multicheck_inline':
87	8	case 'file_list':
88	8	case 'group':
89		// no filtering
90	2	$sanitized_value = $this->value;
91	2	break;
92	7	default:
93		// Handle repeatable fields array
94		// We'll fallback to 'sanitize_text_field'
95	7	$sanitized_value = is_array( $this->value ) ? array_map( 'sanitize_text_field', $this->value ) : sanitize_text_field( $this->value );
96	7	break;
97	8	}
98
99	8	return $this->_is_empty_array( $sanitized_value ) ? '' : $sanitized_value;
100		}
101
102		/**
103		* Simple checkbox validation
104		* @since 1.0.1
105		* @return string\|false 'on' or false
106		*/
107		public function checkbox() {
108		return $this->value === 'on' ? 'on' : false;
109		}
110
111		/**
112		* Validate url in a meta value
113		* @since 1.0.1
114		* @return string Empty string or escaped url
115		*/
116	1	public function text_url() {
117	1	$protocols = $this->field->args( 'protocols' );
118		// for repeatable
119	1	if ( is_array( $this->value ) ) {
120		foreach ( $this->value as $key => $val ) {
121		$this->value[ $key ] = $val ? esc_url_raw( $val, $protocols ) : $this->field->get_default();
122		}
123		} else {
124	1	$this->value = $this->value ? esc_url_raw( $this->value, $protocols ) : $this->field->get_default();
125		}
126
127	1	return $this->value;
128		}
129
130		public function colorpicker() {
131		// for repeatable
132		if ( is_array( $this->value ) ) {
133		$check = $this->value;
134		$this->value = array();
135		foreach ( $check as $key => $val ) {
136		if ( $val && '#' != $val ) {
137		$this->value[ $key ] = esc_attr( $val );
138		}
139		}
140		} else {
141		$this->value = ! $this->value \|\| '#' == $this->value ? '' : esc_attr( $this->value );
142		}
143		return $this->value;
144		}
145
146		/**
147		* Validate email in a meta value
148		* @since 1.0.1
149		* @return string Empty string or sanitized email
150		*/
151		public function text_email() {
152		// for repeatable
153		if ( is_array( $this->value ) ) {
154		foreach ( $this->value as $key => $val ) {
155		$val = trim( $val );
156		$this->value[ $key ] = is_email( $val ) ? $val : '';
157		}
158		} else {
159		$this->value = trim( $this->value );
160		$this->value = is_email( $this->value ) ? $this->value : '';
161		}
162
163		return $this->value;
164		}
165
166		/**
167		* Validate money in a meta value
168		* @since 1.0.1
169		* @return string Empty string or sanitized money value
170		*/
171		public function text_money() {
172
173		global $wp_locale;
		0 ignored issues – show Compatibility Best Practice introduced 2015-11-24 04:05 UTC by Report Bug Copy Issue Report Use of `global` functionality is not recommended; it makes your code harder to test, and less reusable. Instead of relying on `global` state, we recommend one of these alternatives: 1. Pass all data via parameters function myFunction($a, $b) { // Do something } 2. Create a class that maintains your state class MyClass { private $a; private $b; public function __construct($a, $b) { $this->a = $a; $this->b = $b; } public function myFunction() { // Do something } } Loading history...
174
175		$search = array( $wp_locale->number_format['thousands_sep'], $wp_locale->number_format['decimal_point'] );
176		$replace = array( '', '.' );
177
178		// for repeatable
179		if ( is_array( $this->value ) ) {
180		foreach ( $this->value as $key => $val ) {
181		$this->value[ $key ] = number_format_i18n( (float) str_ireplace( $search, $replace, $val ), 2 );
182		}
183		} else {
184		$this->value = number_format_i18n( (float) str_ireplace( $search, $replace, $this->value ), 2 );
185		}
186
187		return $this->value;
188		}
189
190		/**
191		* Converts text date to timestamp
192		* @since 1.0.2
193		* @return string Timestring
194		*/
195		public function text_date_timestamp() {
196		return is_array( $this->value )
197		? array_map( array( $this->field, 'get_timestamp_from_value' ), $this->value )
198		: $this->field->get_timestamp_from_value( $this->value );
199		}
200
201		/**
202		* Datetime to timestamp
203		* @since 1.0.1
204		* @return string Timestring
205		*/
206		public function text_datetime_timestamp( $repeat = false ) {
207
208		$test = is_array( $this->value ) ? array_filter( $this->value ) : '';
209		if ( empty( $test ) ) {
210		return '';
211		}
212
213		$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
214		if ( false !== $repeat_value ) {
215		return $repeat_value;
		0 ignored issues – show Bug Best Practice introduced 2015-11-24 04:05 UTC by Report Bug Copy Issue Report The return type of `return $repeat_value;` (`array`) is incompatible with the return type documented by `CMB2_Sanitize::text_datetime_timestamp` of type `string`. If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design. Let’s take a look at an example: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
216		}
217
218		if ( isset( $this->value['date'], $this->value['time'] ) ) {
219		$this->value = $this->field->get_timestamp_from_value( $this->value['date'] . ' ' . $this->value['time'] );
220		}
221
222		if ( $tz_offset = $this->field->field_timezone_offset() ) {
223		$this->value += (int) $tz_offset;
224		}
225
226		return $this->value;
227		}
228
229		/**
230		* Datetime to timestamp with timezone
231		* @since 1.0.1
232		* @return string Timestring
233		*/
234	1	public function text_datetime_timestamp_timezone( $repeat = false ) {
235	1	static $utc_values = array();
236
237	1	$test = is_array( $this->value ) ? array_filter( $this->value ) : '';
238	1	if ( empty( $test ) ) {
239	1	return '';
240		}
241
242	1	$utc_key = $this->field->_id() . '_utc';
243
244	1	$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
245	1	if ( false !== $repeat_value ) {
246	1	if ( ! empty( $utc_values[ $utc_key ] ) ) {
247		$this->_save_utc_value( $utc_key, $utc_values[ $utc_key ] );
248		unset( $utc_values[ $utc_key ] );
249		}
250
251	1	return $repeat_value;
252		}
253
254	1	$tzstring = null;
255
256	1	if ( is_array( $this->value ) && array_key_exists( 'timezone', $this->value ) ) {
257	1	$tzstring = $this->value['timezone'];
258	1	}
259
260	1	if ( empty( $tzstring ) ) {
261		$tzstring = cmb2_utils()->timezone_string();
262		}
263
264	1	$offset = cmb2_utils()->timezone_offset( $tzstring );
265
266	1	if ( 'UTC' === substr( $tzstring, 0, 3 ) ) {
267		$tzstring = timezone_name_from_abbr( '', $offset, 0 );
268		/*
269		* timezone_name_from_abbr() returns false if not found based on offset.
270		* Since there are currently some invalid timezones in wp_timezone_dropdown(),
271		* fallback to an offset of 0 (UTC+0)
272		* https://core.trac.wordpress.org/ticket/29205
273		*/
274		$tzstring = false !== $tzstring ? $tzstring : timezone_name_from_abbr( '', 0, 0 );
275		}
276
277	1	$full_format = $this->field->args['date_format'] . ' ' . $this->field->args['time_format'];
278	1	$full_date = $this->value['date'] . ' ' . $this->value['time'];
279
280		try {
281
282	1	$datetime = date_create_from_format( $full_format, $full_date );
283
284	1	if ( ! is_object( $datetime ) ) {
285		$this->value = $utc_stamp = '';
286		} else {
287	1	$timestamp = $datetime->setTimezone( new DateTimeZone( $tzstring ) )->getTimestamp();
288	1	$utc_stamp = $timestamp - $offset;
289	1	$this->value = serialize( $datetime );
290		}
291
292	1	if ( $this->field->group ) {
293	1	$this->value = array(
294	1	'supporting_field_value' => $utc_stamp,
295	1	'supporting_field_id' => $utc_key,
296	1	'value' => $this->value,
297		);
298	1	} else {
299		// Save the utc timestamp supporting field
300		if ( $repeat ) {
301		$utc_values[ $utc_key ][] = $utc_stamp;
302		} else {
303		$this->_save_utc_value( $utc_key, $utc_stamp );
304		}
305		}
306
307	1	} catch ( Exception $e ) {
308		$this->value = '';
309		cmb2_utils()->log_if_debug( __METHOD__, __LINE__, $e->getMessage() );
310		}
311
312	1	return $this->value;
313		}
314
315		/**
316		* Sanitize textareas and wysiwyg fields
317		* @since 1.0.1
318		* @return string Sanitized data
319		*/
320	2	public function textarea() {
321	2	return is_array( $this->value ) ? array_map( 'wp_kses_post', $this->value ) : wp_kses_post( $this->value );
322		}
323
324		/**
325		* Sanitize code textareas
326		* @since 1.0.2
327		* @return string Sanitized data
328		*/
329		public function textarea_code( $repeat = false ) {
330		$repeat_value = $this->_check_repeat( __FUNCTION__, $repeat );
331		if ( false !== $repeat_value ) {
332		return $repeat_value;
333		}
334
335		return htmlspecialchars_decode( stripslashes( $this->value ) );
336		}
337
338		/**
339		* Handles saving of attachment post ID and sanitizing file url
340		* @since 1.1.0
341		* @return string Sanitized url
342		*/
343	1	public function file() {
344	1	$file_id_key = $this->field->_id() . '_id';
345
346	1	if ( $this->field->group ) {
347		// Return an array with url/id if saving a group field
348	1	$this->value = $this->_get_group_file_value_array( $file_id_key );
349	1	} else {
350		$this->_save_file_id_value( $file_id_key );
351		$this->text_url();
352		}
353
354	1	return $this->value;
355		}
356
357		/**
358		* Gets the values for the `file` field type from the data being saved.
359		* @since 2.2.0
360		*/
361	1	public function _get_group_file_value_array( $id_key ) {
362	1	$alldata = $this->field->group->data_to_save;
363	1	$base_id = $this->field->group->_id();
364	1	$i = $this->field->group->index;
365
366		// Check group $alldata data
367	1	$id_val = isset( $alldata[ $base_id ][ $i ][ $id_key ] )
368	1	? absint( $alldata[ $base_id ][ $i ][ $id_key ] )
369	1	: 0;
370
371		return array(
372	1	'value' => $this->text_url(),
373	1	'supporting_field_value' => $id_val,
374	1	'supporting_field_id' => $id_key,
375	1	);
376		}
377
378		/**
379		* Peforms saving of `file` attachement's ID
380		* @since 1.1.0
381		*/
382		public function _save_file_id_value( $file_id_key ) {
383		$id_field = $this->_new_supporting_field( $file_id_key );
384
385		// Check standard data_to_save data
386		$id_val = isset( $this->field->data_to_save[ $file_id_key ] )
387		? $this->field->data_to_save[ $file_id_key ]
388		: null;
389
390		// If there is no ID saved yet, try to get it from the url
391		if ( $this->value && ! $id_val ) {
392		$id_val = cmb2_utils()->image_id_from_url( $this->value );
393		}
394
395		return $id_field->save_field( $id_val );
396		}
397
398		/**
399		* Peforms saving of `text_datetime_timestamp_timezone` utc timestamp
400		* @since 2.2.0
401		*/
402		public function _save_utc_value( $utc_key, $utc_stamp ) {
403		return $this->_new_supporting_field( $utc_key )->save_field( $utc_stamp );
404		}
405
406		/**
407		* Returns a new, supporting, CMB2_Field object based on a new field id.
408		* @since 2.2.0
409		*/
410		public function _new_supporting_field( $new_field_id ) {
411		return $this->field->get_field_clone( array(
412		'id' => $new_field_id,
413		'sanitization_cb' => false,
414		) );
415		}
416
417		/**
418		* If repeating, loop through and re-apply sanitization method
419		* @since 1.1.0
420		* @param string $method Class method
421		* @param bool $repeat Whether repeating or not
422		* @return mixed Sanitized value
423		*/
424	1	public function _check_repeat( $method, $repeat ) {
425	1	if ( $repeat \|\| ! $this->field->args( 'repeatable' ) ) {
426	1	return false;
427		}
428
429	1	$values_array = $this->value;
430
431	1	$new_value = array();
432	1	foreach ( $values_array as $iterator => $this->value ) {
433	1	if ( $this->value ) {
434	1	$val = $this->$method( true );
435	1	if ( ! empty( $val ) ) {
436	1	$new_value[] = $val;
437	1	}
438	1	}
439	1	}
440
441	1	$this->value = $new_value;
442
443	1	return empty( $this->value ) ? null : $this->value;
444		}
445
446		/**
447		* Determine if passed value is an empty array
448		* @since 2.0.6
449		* @param mixed $to_check Value to check
450		* @return boolean Whether value is an array that's empty
451		*/
452	8	public function _is_empty_array( $to_check ) {
453	8	if ( is_array( $to_check ) ) {
454	3	$cleaned_up = array_filter( $to_check );
455	3	return empty( $cleaned_up );
456		}
457	6	return false;
458		}
459
460		}
461

WebDevStudios / CMB2

Push — trunk ( df6be1...704260 )

CMB2_Sanitize::_save_utc_value() A

Complexity

Size

Duplication

Code Coverage

1. Pass all data via parameters

2. Create a class that maintains your state

Duplication Side-by-Side

Filter issues like