Test Failed
Push — master ( 36b0ed...c8da5c )
by Devin
09:29 queued 10s
created

formatting.php ➔ give_is_amount_sanitized()   A

Complexity

Conditions 5
Paths 5

Size

Total Lines 18

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 5
nc 5
nop 1
dl 0
loc 18
rs 9.3554
c 0
b 0
f 0
1
<?php
2
/**
3
 * Formatting functions for taking care of proper number formats and such
4
 *
5
 * @package     Give
6
 * @subpackage  Functions/Formatting
7
 * @copyright   Copyright (c) 2016, GiveWP
8
 * @license     https://opensource.org/licenses/gpl-license GNU Public License
9
 * @since       1.0
10
 */
11
12
// Exit if accessed directly.
13
if ( ! defined( 'ABSPATH' ) ) {
14
	exit;
15
}
16
17
/**
18
 * Get Currency Formatting Settings for each donation.
19
 *
20
 * @param int|string $id_or_currency_code Donation ID or Currency code.
21
 *
22
 * @since 1.8.15
23
 *
24
 * @return mixed
25
 */
26
function give_get_currency_formatting_settings( $id_or_currency_code = null ) {
27
	$give_options = give_get_settings();
28
	$setting      = array();
29
30
	if ( ! empty( $id_or_currency_code ) ) {
31
		$currencies = give_get_currencies( 'all' );
32
33
		// Set default formatting setting only if currency not set as global currency.
34
		if (
35
			is_string( $id_or_currency_code ) &&
36
			! empty( $give_options['currency'] ) &&
37
			$id_or_currency_code !== $give_options['currency'] &&
38
			array_key_exists( $id_or_currency_code, $currencies )
39
		) {
40
			$setting = $currencies[ $id_or_currency_code ]['setting'];
41
		} elseif ( is_numeric( $id_or_currency_code ) && 'give_payment' === get_post_type( $id_or_currency_code ) ) {
42
			$currency = give_get_meta( $id_or_currency_code, '_give_payment_currency', true );
43
44
			if (
45
				! empty( $currency) &&
0 ignored issues
show
Coding Style introduced by
Expected 1 spaces before closing bracket; 0 found
Loading history...
46
				$give_options['currency'] !== $currency
47
			) {
48
				$setting = $currencies[ $currency ]['setting'];
49
			}
50
		}
51
	}
52
53
	if ( empty( $setting ) ) {
54
		// Set thousand separator.
55
		$thousand_separator = isset( $give_options['thousands_separator'] ) ? $give_options['thousands_separator'] : ',';
56
		$thousand_separator = empty( $thousand_separator ) ? ' ' : $thousand_separator;
57
58
		// Set decimal separator.
59
		$default_decimal_separators = array(
60
			'.' => ',',
61
			',' => '.',
62
		);
63
64
		$default_decimal_separator = in_array( $thousand_separator, $default_decimal_separators ) ?
65
			$default_decimal_separators[ $thousand_separator ] :
66
			'.';
67
68
		$decimal_separator = ! empty( $give_options['decimal_separator'] ) ? $give_options['decimal_separator'] : $default_decimal_separator;
69
70
		$setting = array(
71
			'currency_position'   => give_get_option( 'currency_position', 'before' ),
72
			'thousands_separator' => $thousand_separator,
73
			'decimal_separator'   => $decimal_separator,
74
			'number_decimals'     => give_get_option( 'number_decimals', 0 ),
75
		);
76
	}
77
78
	/**
79
	 * Filter the currency formatting setting.
80
	 *
81
	 * @since 1.8.15
82
	 */
83
	return apply_filters( 'give_get_currency_formatting_settings', $setting, $id_or_currency_code );
84
}
85
86
/**
87
 * Get decimal count
88
 *
89
 * @since 1.6
90
 *
91
 * @param int|string $id_or_currency_code
92
 *
93
 * @return mixed
94
 */
95 View Code Duplication
function give_get_price_decimals( $id_or_currency_code = null ) {
0 ignored issues
show
Duplication introduced by
This function seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
96
	// Set currency on basis of donation id.
97
	if ( empty( $id_or_currency_code ) ) {
98
		$id_or_currency_code = give_get_currency();
99
	}
100
101
	$number_of_decimals = 0;
102
103
	if ( ! give_is_zero_based_currency( $id_or_currency_code ) ) {
104
		$setting            = give_get_currency_formatting_settings( $id_or_currency_code );
105
		$number_of_decimals = $setting['number_decimals'];
106
	}
107
108
	/**
109
	 * Filter the number of decimals
110
	 *
111
	 * @since 1.6
112
	 */
113
	return apply_filters( 'give_sanitize_amount_decimals', $number_of_decimals, $id_or_currency_code );
114
}
115
116
/**
117
 * Get thousand separator
118
 *
119
 * @param int|string $id_or_currency_code
120
 *
121
 * @since 1.6
122
 *
123
 * @return mixed
124
 */
125
function give_get_price_thousand_separator( $id_or_currency_code = null ) {
126
	$setting = give_get_currency_formatting_settings( $id_or_currency_code );
127
128
	/**
129
	 * Filter the thousand separator
130
	 *
131
	 * @since 1.6
132
	 */
133
	return apply_filters( 'give_get_price_thousand_separator', $setting['thousands_separator'], $id_or_currency_code );
134
}
135
136
/**
137
 * Get decimal separator
138
 *
139
 * @param string $id_or_currency_code
140
 *
141
 * @since 1.6
142
 *
143
 * @return mixed
144
 */
145
function give_get_price_decimal_separator( $id_or_currency_code = null ) {
146
	$setting = give_get_currency_formatting_settings( $id_or_currency_code );
147
148
	/**
149
	 * Filter the thousand separator
150
	 *
151
	 * @since 1.6
152
	 */
153
	return apply_filters( 'give_get_price_decimal_separator', $setting['decimal_separator'], $id_or_currency_code );
154
}
155
156
/**
157
 * Check if amount sanitized
158
 * Note: only for internal purpose
159
 *
160
 * Current this function only check if number is DB sanitize.
161
 *
162
 * @param string $amount
163
 *
164
 * @return bool
165
 * @since 2.4.5
166
 */
167
function give_is_amount_sanitized( $amount ) {
168
	$is_sanitize = false;
169
170
	if ( false === strpos( $amount, '.' ) ) {
171
		return $is_sanitize;
172
	}
173
174
	$number_parts = explode( '.', $amount );
175
176
	// Handle thousand separator as '.'
177
	// Handle sanitize database values.
178
	$is_sanitize = ( 2 === count( $number_parts ) &&
179
	                 is_numeric( $number_parts[0] ) &&
180
	                 is_numeric( $number_parts[1] ) &&
181
	                 in_array( strlen( $number_parts[1] ), array( 6, 10 ) ) );
182
183
	return $is_sanitize;
184
}
185
186
/**
187
 * Sanitize Amount before saving to database
188
 *
189
 * @since      1.8.12
190
 *
191
 * @param  int|float|string $number Expects either a float or a string with a decimal separator only (no thousands)
192
 * @param  array|bool       $args   It accepts 'number_decimals', 'trim_zeros', 'currency'.
193
 *
194
 * @return string $amount Newly sanitized amount
195
 */
196
function give_sanitize_amount_for_db( $number, $args = array() ) {
197
	$args['number_decimals'] = 6;
198
199
	if (
200
		( isset( $args['currency'] ) && 'BTC' === $args['currency'] )
201
		|| 'BTC' === give_get_currency()
202
	) {
203
		$args['number_decimals'] = 10;
204
	}
205
206
	return give_maybe_sanitize_amount( $number, $args );
207
}
208
209
/**
210
 * Sanitize Amount before saving to database
211
 *
212
 * @since      1.8.12
213
 *
214
 * @param  int|float|string $number Expects either a float or a string with a decimal separator only (no thousands)
215
 * @param  array|bool       $args   It accepts 'number_decimals', 'trim_zeros', 'currency'.
216
 *
217
 * @return string $amount Newly sanitized amount
218
 */
219
function give_maybe_sanitize_amount( $number, $args = array() ) {
220
	// Bailout.
221
	if ( empty( $number ) || ( ! is_numeric( $number ) && ! is_string( $number ) ) ) {
222
		return $number;
223
	}
224
225
	$func_args = func_get_args();
226
227
	// Backward compatibility.
228 View Code Duplication
	if ( isset( $func_args[1] ) && ( is_bool( $func_args[1] ) || is_numeric( $func_args[1] ) ) ) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
229
		$args = array(
230
			'number_decimals' => $func_args[1],
231
			'trim_zeros'      => isset( $func_args[2] ) ? $func_args[2] : false,
232
		);
233
	}
234
235
	$args = wp_parse_args(
236
		$args,
237
		array(
238
			'number_decimals' => false,
239
			'trim_zeros'      => false,
240
			'currency'        => give_get_currency(),
241
		)
242
	);
243
244
	$thousand_separator = give_get_price_thousand_separator( $args['currency'] );
245
	$decimal_separator  = give_get_price_decimal_separator( $args['currency'] );
246
	$number_decimals    = is_bool( $args['number_decimals'] ) ?
247
		give_get_price_decimals( $args['currency'] ) :
248
		$args['number_decimals'];
249
250
	// Explode number by . decimal separator.
251
	$number_parts = explode( '.', $number );
252
253
	// Remove currency symbols from number if any.
254
	$number = trim( str_replace( give_currency_symbols( true ), '', $number ) );
255
256
	if (
257
		// Non formatted number.
258
		false === strpos( $number, $thousand_separator )
259
		&& false === strpos( $number, $decimal_separator )
260
	) {
261
		return number_format( $number, $number_decimals, '.', '' );
262
	} elseif (
263
		// Decimal formatted number.
264
		// If number of decimal place set to non zero and
265
		// number only contains `.` as separator, precision set to less then or equal to number of decimal
266
		// then number will be consider as decimal formatted which means number is already sanitized.
267
		$number_decimals
268
		&& '.' === $thousand_separator
269
		&& false !== strpos( $number, $thousand_separator )
270
		&& false === strpos( $number, $decimal_separator )
271
		&& 2 === count( $number_parts )
272
		&& ( $number_decimals >= strlen( $number_parts[1] ) )
273
	) {
274
		return number_format( $number, $number_decimals, '.', '' );
275
	}
276
277
	if ( give_is_amount_sanitized( $number ) ) {
278
		// Sanitize database value.
279
		return number_format( $number, $number_decimals, '.', '' );
280
281
	} elseif (
282
		'.' === $thousand_separator &&
283
		false !== strpos( $number, $thousand_separator )
284
	) {
285
		// Fix point thousand separator value.
286
		$number = str_replace( '.', '', $number );
287
	}
288
289
	return give_sanitize_amount( $number, $args );
290
}
291
292
/**
293
 * Sanitize Amount
294
 *
295
 * Note: Do not this function to sanitize amount instead use give_maybe_sanitize_amount function.
296
 *
297
 * Returns a sanitized amount by stripping out thousands separators.
298
 *
299
 * @since      1.0
300
 *
301
 * @param  int|float|string $number Expects either a float or a string with a decimal separator only (no thousands)
302
 * @param  array|bool       $args   It accepts 'number_decimals', 'trim_zeros', 'currency'.
303
 *
304
 * @return string $amount Newly sanitized amount
305
 */
306
function give_sanitize_amount( $number, $args = array() ) {
307
308
	// Bailout.
309
	if ( empty( $number ) || ( ! is_numeric( $number ) && ! is_string( $number ) ) ) {
310
		return $number;
311
	}
312
313
	// Get function arguments.
314
	$func_args = func_get_args();
315
316
	// Backward compatibility.
317 View Code Duplication
	if ( isset( $func_args[1] ) && ( is_bool( $func_args[1] ) || is_numeric( $func_args[1] ) ) ) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
318
		$args = array(
319
			'number_decimals' => $func_args[1],
320
			'trim_zeros'      => isset( $func_args[2] ) ? $func_args[2] : false,
321
		);
322
	}
323
324
	$args = wp_parse_args(
325
		$args,
326
		array(
327
			'number_decimals' => false,
328
			'trim_zeros'      => false,
329
			'currency'        => give_get_currency(),
330
		)
331
	);
332
333
	// Remove slash from amount.
334
	// If thousand or decimal separator is set to ' then in $_POST or $_GET param we will get an escaped number.
335
	// To prevent notices and warning remove slash from amount/number.
336
	$number = wp_unslash( $number );
337
338
	$thousand_separator = give_get_price_thousand_separator( $args['currency'] );
339
340
	$locale   = localeconv();
341
	$decimals = array(
342
		give_get_price_decimal_separator( $args['currency'] ),
343
		$locale['decimal_point'],
344
		$locale['mon_decimal_point'],
345
	);
346
347
	// Remove locale from string
348
	if ( ! is_float( $number ) ) {
349
		$number = str_replace( $decimals, '.', $number );
350
	}
351
352
	// Remove thousand amount formatting if amount has.
353
	// This condition use to add backward compatibility to version before 1.6, because before version 1.6 we were saving formatted amount to db.
354
	// Do not replace thousand separator from price if it is same as decimal separator, because it will be already replace by above code.
355
	if ( ! in_array( $thousand_separator, $decimals ) && ( false !== strpos( $number, $thousand_separator ) ) ) {
356
		$number = str_replace( $thousand_separator, '', $number );
357
	} elseif ( in_array( $thousand_separator, $decimals ) ) {
358
		$number = preg_replace( '/\.(?=.*\.)/', '', $number );
359
	}
360
361
	// Remove non numeric entity before decimal separator.
362
	$number     = preg_replace( '/[^0-9\.]/', '', $number );
363
	$default_dp = give_get_price_decimals( $args['currency'] );
364
365
	// Reset negative amount to zero.
366
	if ( 0 > $number ) {
367
		$number = number_format( 0, $default_dp, '.' );
368
	}
369
370
	// If number does not have decimal then add number of decimals to it.
371
	if (
372
		false === strpos( $number, '.' )
373
		|| ( $default_dp > strlen( substr( $number, strpos( $number, '.' ) + 1 ) ) )
374
	) {
375
		$number = number_format( $number, $default_dp, '.', '' );
376
	}
377
378
	// Format number by custom number of decimals.
379
	if ( false !== $args['number_decimals'] ) {
380
		$dp     = intval( is_bool( $args['number_decimals'] ) ? $default_dp : $args['number_decimals'] );
381
		$dp     = apply_filters( 'give_sanitize_amount_decimals', $dp, $number );
382
		$number = number_format( floatval( $number ), $dp, '.', '' );
383
	}
384
385
	// Trim zeros.
386
	if ( $args['trim_zeros'] && strstr( $number, '.' ) ) {
387
		$number = rtrim( rtrim( $number, '0' ), '.' );
388
	}
389
390
	/**
391
	 * Filter the sanitize amount
392
	 *
393
	 * @since 1.0
394
	 */
395
	return apply_filters( 'give_sanitize_amount', $number );
396
}
397
398
/**
399
 * Returns a nicely formatted amount.
400
 *
401
 * @since 1.0
402
 *
403
 * @param string $amount Price amount to format
404
 * @param array  $args   Array of arguments.
405
 *
406
 * @return string $amount   Newly formatted amount or Price Not Available
407
 */
408
function give_format_amount( $amount, $args = array() ) {
409
	// Backward compatibility.
410
	if ( is_bool( $args ) ) {
411
		$args = array(
412
			'decimal' => $args,
413
		);
414
	}
415
416
	$default_args = array(
417
		'decimal'     => true,
418
		'sanitize'    => true,
419
		'donation_id' => 0,
420
		'currency'    => '',
421
	);
422
423
	$args = wp_parse_args( $args, $default_args );
424
425
	// Set Currency based on donation id, if required.
426
	if ( $args['donation_id'] && empty( $args['currency'] ) ) {
427
		$args['currency'] = give_get_meta( $args['donation_id'], '_give_payment_currency', true );
428
	}
429
430
	$formatted     = 0;
431
	$currency      = ! empty( $args['currency'] ) ? $args['currency'] : give_get_currency( $args['donation_id'] );
432
	$thousands_sep = give_get_price_thousand_separator( $currency );
433
	$decimal_sep   = give_get_price_decimal_separator( $currency );
434
	$decimals      = ! empty( $args['decimal'] ) ? give_get_price_decimals( $currency ) : 0;
435
436
	if ( ! empty( $amount ) ) {
437
		// Sanitize amount before formatting.
438
		$amount = ! empty( $args['sanitize'] ) ?
439
			give_maybe_sanitize_amount( $amount, array( 'number_decimals' => $decimals, 'currency' => $currency ) ) :
440
			number_format( $amount, $decimals, '.', '' );
441
442
		switch ( $currency ) {
443
			case 'INR':
444
				$decimal_amount = '';
445
446
				// Extract decimals from amount
447
				if ( ( $pos = strpos( $amount, '.' ) ) !== false ) {
0 ignored issues
show
introduced by
Found "!== false". Use Yoda Condition checks, you must
Loading history...
448
					if ( ! empty( $decimals ) ) {
449
						$decimal_amount = substr( round( substr( $amount, $pos ), $decimals ), 1 );
450
						$amount         = substr( $amount, 0, $pos );
451
452
						if ( ! $decimal_amount ) {
453
							$decimal_amount = substr( "{$decimal_sep}0000000000", 0, ( $decimals + 1 ) );
454
						} elseif ( ( $decimals + 1 ) > strlen( $decimal_amount ) ) {
455
							$decimal_amount = substr( "{$decimal_amount}000000000", 0, ( $decimals + 1 ) );
456
						}
457
					} else {
458
						$amount = number_format( $amount, $decimals, $decimal_sep, '' );
459
					}
460
				}
461
462
				// Extract last 3 from amount
463
				$result = substr( $amount, - 3 );
464
				$amount = substr( $amount, 0, - 3 );
465
466
				// Apply digits 2 by 2
467
				while ( strlen( $amount ) > 0 ) {
468
					$result = substr( $amount, - 2 ) . $thousands_sep . $result;
469
					$amount = substr( $amount, 0, - 2 );
470
				}
471
472
				$formatted = $result . $decimal_amount;
473
				break;
474
475
			default:
476
				$formatted = number_format( $amount, $decimals, $decimal_sep, $thousands_sep );
477
		}
478
	}
479
480
	/**
481
	 * Filter the formatted amount
482
	 *
483
	 * @since 1.0
484
	 */
485
	return apply_filters( 'give_format_amount', $formatted, $amount, $decimals, $decimal_sep, $thousands_sep, $currency, $args );
486
}
487
488
489
/**
490
 * Get human readable amount.
491
 *
492
 * Note: This function only support large number formatting from million to trillion
493
 *
494
 * @since 1.6
495
 *
496
 * @use   give_get_price_thousand_separator Get thousand separator.
497
 *
498
 * @param string $amount formatted amount number.
499
 * @param array  $args   Array of arguments.
500
 *
501
 * @return string  formatted amount number with large number names.
502
 */
503
function give_human_format_large_amount( $amount, $args = array() ) {
504
	// Sanitize amount.
505
	$sanitize_amount = give_maybe_sanitize_amount( $amount );
506
507
	// Bailout.
508
	if ( ! floatval( $sanitize_amount ) ) {
509
		return '0';
510
	};
511
512
	// Set default currency;
513
	if ( empty( $args['currency'] ) ) {
514
		$args['currency'] = give_get_currency();
515
	}
516
517
	// Get thousand separator.
518
	$thousands_sep = give_get_price_thousand_separator();
519
520
	// Explode amount to calculate name of large numbers.
521
	$amount_array = explode( $thousands_sep, $amount );
522
523
	// Calculate amount parts count.
524
	$amount_count_parts = count( $amount_array );
525
526
	// Human format amount (default).
527
	$human_format_amount = $amount;
528
529
	switch ( $args['currency'] ) {
530 View Code Duplication
		case 'INR':
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
531
			// Calculate large number formatted amount.
532
			if ( 4 < $amount_count_parts ) {
533
				$human_format_amount = sprintf( esc_html__( '%s arab', 'give' ), round( ( $sanitize_amount / 1000000000 ), 2 ) );
534
			} elseif ( 3 < $amount_count_parts ) {
535
				$human_format_amount = sprintf( esc_html__( '%s crore', 'give' ), round( ( $sanitize_amount / 10000000 ), 2 ) );
536
			} elseif ( 2 < $amount_count_parts ) {
537
				$human_format_amount = sprintf( esc_html__( '%s lakh', 'give' ), round( ( $sanitize_amount / 100000 ), 2 ) );
538
			}
539
			break;
540 View Code Duplication
		default:
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
541
			// Calculate large number formatted amount.
542
			if ( 4 < $amount_count_parts ) {
543
				$human_format_amount = sprintf( esc_html__( '%s trillion', 'give' ), round( ( $sanitize_amount / 1000000000000 ), 2 ) );
544
			} elseif ( 3 < $amount_count_parts ) {
545
				$human_format_amount = sprintf( esc_html__( '%s billion', 'give' ), round( ( $sanitize_amount / 1000000000 ), 2 ) );
546
			} elseif ( 2 < $amount_count_parts ) {
547
				$human_format_amount = sprintf( esc_html__( '%s million', 'give' ), round( ( $sanitize_amount / 1000000 ), 2 ) );
548
			}
549
	}
550
551
	return apply_filters( 'give_human_format_large_amount', $human_format_amount, $amount, $sanitize_amount );
552
}
553
554
/**
555
 * Returns a nicely formatted amount with custom decimal separator.
556
 *
557
 * @since 1.0
558
 *
559
 * @param array           $args        {
560
 *
561
 * @type int|float|string $amount      Formatted or sanitized price. (optional if donation id set)
562
 * @type int              $donation_id donation amount (optional if set amount, but provide it for better result if formatting decimal amount of donation).
563
 * @type string           $currency    donation amount (optional if set donation id). Provide either amount or donation id
564
 * @type int|bool         $dp          number of decimals
565
 * @type bool             $sanitize    Whether or not sanitize number
566
 * }
567
 *
568
 * @return string $amount Newly formatted amount or Price Not Available
569
 */
570
function give_format_decimal( $args ) {
571
	// Backward compatibility.
572
	if ( ! is_array( $args ) ) {
573
		$func_args = func_get_args();
574
		$args      = array(
575
			'amount'   => $func_args[0],
576
			'dp'       => isset( $func_args[1] ) ? $func_args[1] : false,
577
			'sanitize' => isset( $func_args[2] ) ? $func_args[2] : true,
578
		);
579
	}
580
581
	$args = wp_parse_args(
582
		$args,
583
		array(
584
			'amount'      => '',
585
			'donation_id' => 0,
586
			'currency'    => '',
587
			'dp'          => false,
588
			'sanitize'    => false,
589
		)
590
	);
591
592
	if( ! empty( $args['donation_id'] ) ) {
0 ignored issues
show
introduced by
Space after opening control structure is required
Loading history...
introduced by
No space before opening parenthesis is prohibited
Loading history...
593
594
		// Set currency if not already done.
595
		if( empty( $args['currency'] ) ) {
0 ignored issues
show
introduced by
Space after opening control structure is required
Loading history...
introduced by
No space before opening parenthesis is prohibited
Loading history...
596
			$args['currency'] = give_get_payment_currency_code( $args['donation_id'] );
597
		}
598
599
		// Set amount if not already done.
600
		if( empty( $args['amount'] ) ) {
0 ignored issues
show
introduced by
Space after opening control structure is required
Loading history...
introduced by
No space before opening parenthesis is prohibited
Loading history...
601
			$args['amount'] = give_donation_amount( $args['donation_id'] );
602
		}
603
	}
604
605
	$decimal_separator = give_get_price_decimal_separator();
606
	$formatted_amount  = $args['sanitize'] ?
607
		give_maybe_sanitize_amount( $args['amount'], array( 'number_decimals' => $args['dp'], 'currency' => $args['currency'] ) ) :
608
		number_format( $args['amount'], ( is_bool( $args['dp'] ) ? give_get_price_decimals( $args['currency'] ) : $args['dp'] ), '.', '' );
609
610
	if ( false !== strpos( $formatted_amount, '.' ) ) {
611
		$formatted_amount = str_replace( '.', $decimal_separator, $formatted_amount );
612
	}
613
614
	return apply_filters( 'give_format_decimal', $formatted_amount, $args['amount'], $decimal_separator, $args );
615
}
616
617
/**
618
 * Get date format string on basis of given context.
619
 *
620
 * @since 1.7
621
 *
622
 * @param  string $date_context Date format context name.
623
 *
624
 * @return string                  Date format string
625
 */
626
function give_date_format( $date_context = '' ) {
627
	/**
628
	 * Filter the date context
629
	 *
630
	 * You can add your own date context or use already exist context.
631
	 * For example:
632
	 *    add_filter( 'give_date_format_contexts', 'add_new_date_contexts' );
633
	 *    function add_new_date_contexts( $date_format_contexts ) {
634
	 *        // You can add single context like this $date_format_contexts['checkout'] = 'F j, Y';
635
	 *        // Instead add multiple date context at once.
636
	 *        $new_date_format_contexts = array(
637
	 *            'checkout' => 'F j, Y',
638
	 *            'report'   => 'Y-m-d',
639
	 *            'email'    => 'm/d/Y',
640
	 *        );
641
	 *
642
	 *       // Merge date contexts array only if you are adding multiple date contexts at once otherwise return  $date_format_contexts.
643
	 *       return array_merge( $new_date_format_contexts, $date_format_contexts );
644
	 *
645
	 *    }
646
	 */
647
	$date_format_contexts = apply_filters( 'give_date_format_contexts', array() );
648
649
	// Set date format to default date format.
650
	$date_format = get_option( 'date_format' );
651
652
	// Update date format if we have non empty date format context array and non empty date format string for that context.
653
	if ( $date_context && ! empty( $date_format_contexts ) && array_key_exists( $date_context, $date_format_contexts ) ) {
654
		$date_format = ! empty( $date_format_contexts[ $date_context ] )
655
			? $date_format_contexts[ $date_context ]
656
			: $date_format;
657
	}
658
659
	return apply_filters( 'give_date_format', $date_format );
660
}
661
662
/**
663
 * Get cache key.
664
 *
665
 * @since      1.7
666
 * @deprecated 1.8.7 You can access this function from Give_Cache.
667
 *
668
 * @param  string $action     Cache key prefix.
669
 * @param array  $query_args Query array.
670
 *
671
 * @return string
672
 */
673
function give_get_cache_key( $action, $query_args ) {
674
	return Give_Cache::get_key( $action, $query_args );
675
}
676
677
/**
678
 * Clean variables using sanitize_text_field. Arrays are cleaned recursively.
679
 * Non-scalar values are ignored.
680
 *
681
 * @since  1.8
682
 *
683
 * @param  string|array $var
684
 *
685
 * @return string|array
686
 */
687
function give_clean( $var ) {
688
	if ( is_array( $var ) ) {
689
		return array_map( 'give_clean', $var );
690
	} else {
691
		return is_scalar( $var ) ? sanitize_text_field( wp_unslash( $var ) ) : $var;
692
	}
693
}
694
695
/**
696
 * Transforms php.ini notation for numbers (like '2M') to an integer.
697
 *
698
 * @since 1.8
699
 *
700
 * @param $size
701
 *
702
 * @return int
703
 */
704
function give_let_to_num( $size ) {
705
	$l   = substr( $size, - 1 );
706
	$ret = substr( $size, 0, - 1 );
707
	switch ( strtoupper( $l ) ) {
708
		case 'P':
709
			$ret *= 1024;
710
		case 'T':
711
			$ret *= 1024;
712
		case 'G':
713
			$ret *= 1024;
714
		case 'M':
715
			$ret *= 1024;
716
		case 'K':
717
			$ret *= 1024;
718
	}
719
720
	return $ret;
721
}
722
723
/**
724
 * Verify nonce.
725
 *
726
 * @since 1.8
727
 *
728
 * @param string $nonce       Nonce Hash.
729
 * @param int    $action      Nonce verification action.
730
 * @param array  $wp_die_args Nonce fail arguments.
731
 *
732
 * @return bool
733
 */
734
function give_validate_nonce( $nonce, $action = - 1, $wp_die_args = array() ) {
735
736
	// Verify nonce.
737
	$verify_nonce = wp_verify_nonce( $nonce, $action );
738
739
	// On ajax request send nonce verification status.
740
	if ( wp_doing_ajax() ) {
741
		return $verify_nonce;
742
	}
743
744
	if ( ! $verify_nonce ) {
745
		$wp_die_args = wp_parse_args(
746
			$wp_die_args,
747
			array(
748
				'message' => __( 'Nonce verification has failed.', 'give' ),
749
				'title'   => __( 'Error', 'give' ),
750
				'args'    => array(
751
					'response' => 403,
752
				),
753
			)
754
		);
755
756
		wp_die(
757
			$wp_die_args['message'],
758
			$wp_die_args['title'],
759
			$wp_die_args['args']
760
		);
761
	}
762
763
	return true;
764
}
765
766
/**
767
 * Verify nonce while processing donation form.
768
 *
769
 * @since 2.0
770
 *
771
 * @param string $nonce   Nonce value.
772
 * @param int    $form_id Donation Form ID.
773
 *
774
 * @return bool
775
 */
776
function give_verify_donation_form_nonce( $nonce = '', $form_id ) {
777
778
	// Form nonce action.
779
	$nonce_action = "give_donation_form_nonce_{$form_id}";
780
781
	// Nonce validation.
782
	$verify_nonce = give_validate_nonce( $nonce, $nonce_action );
783
784
	if ( ! $verify_nonce ) {
785
		give_set_error( 'donation_form_nonce', __( 'Nonce verification has failed.', 'give' ) );
786
	}
787
788
	return $verify_nonce;
789
}
790
791
/**
792
 * Check variable and get default or valid value.
793
 *
794
 * Helper function to check if a variable is set, empty, etc.
795
 *
796
 * @since 1.8
797
 *
798
 * @param                   $variable
799
 * @param string (optional) $conditional    default value: isset
800
 * @param mixed (optional)  $default        default value: false
801
 * @param string (optional) $array_key_name default value: false
802
 *
803
 * @return mixed
804
 */
805
function give_check_variable( $variable, $conditional = '', $default = false, $array_key_name = '' ) {
806
	// Get value from array if array key non empty.
807
	if( empty( $array_key_name ) ) {
0 ignored issues
show
introduced by
Space after opening control structure is required
Loading history...
introduced by
No space before opening parenthesis is prohibited
Loading history...
808
		switch ( $conditional ) {
809
			case 'isset_empty':
810
				$variable = ( isset( $variable ) && ! empty( $variable ) ) ? $variable : $default;
811
				break;
812
813
			case 'empty':
814
				$variable = ! empty( $variable ) ? $variable : $default;
815
				break;
816
817
			case 'null':
818
				$variable = ! is_null( $variable ) ? $variable : $default;
819
				break;
820
821
			default:
822
				$variable = isset( $variable ) ? $variable : $default;
823
		}
824
	} else {
825
		$isset = array_key_exists( $array_key_name, $variable );
826
827
		switch ( $conditional ) {
828
			case 'isset_empty':
829
				$variable = ( $isset && ! empty( $variable[ $array_key_name ] ) ) ? $variable[ $array_key_name ] : $default;
830
				break;
831
832
			case 'empty':
833
				$variable = ! empty( $variable[ $array_key_name ] ) ? $variable[ $array_key_name ] : $default;
834
				break;
835
836
			case 'null':
837
				$variable = $isset && ! is_null( $variable[ $array_key_name ] ) ? $variable[ $array_key_name ] : $default;
838
				break;
839
840
			default:
841
				$variable = $isset && isset( $variable[ $array_key_name ] ) ? $variable[ $array_key_name ] : $default;
842
		}
843
	}
844
845
	return $variable;
846
847
}
848