Test Failed
Push — release/1.8.17 ( baf467 )
by Ravinder
04:01
created

functions.php ➔ give_decrease_earnings()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 5
Code Lines 3

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 3
nc 1
nop 2
dl 0
loc 5
rs 9.4285
c 0
b 0
f 0
1
<?php
2
/**
3
 * Give Form Functions
4
 *
5
 * @package     WordImpress
6
 * @subpackage  Includes/Forms
7
 * @copyright   Copyright (c) 2016, WordImpress
8
 * @license     https://opensource.org/licenses/gpl-license GNU Public License
9
 * @since       1.1
10
 */
11
12
// Exit if accessed directly.
13
if ( ! defined( 'ABSPATH' ) ) {
14
	exit;
15
}
16
17
/**
18
 * Filter: Do not show the Give shortcut button on Give Forms CPT
19
 *
20
 * @return bool
21
 */
22
function give_shortcode_button_condition() {
23
24
	global $typenow;
25
26
	if ( $typenow != 'give_forms' ) {
0 ignored issues
show
introduced by
Found "!= '". Use Yoda Condition checks, you must
Loading history...
27
		return true;
28
	}
29
30
	return false;
31
}
32
33
add_filter( 'give_shortcode_button_condition', 'give_shortcode_button_condition' );
34
35
36
/**
37
 * Get the form ID from the form $args
38
 *
39
 * @param array $args
40
 *
41
 * @return int|false
42
 */
43
function get_form_id_from_args( $args ) {
44
45
	if ( isset( $args['form_id'] ) && $args['form_id'] != 0 ) {
0 ignored issues
show
introduced by
Found "!= 0". Use Yoda Condition checks, you must
Loading history...
46
47
		return intval( $args['form_id'] );
48
	}
49
50
	return false;
51
}
52
53
/**
54
 * Checks whether floating labels is enabled for the form ID in $args
55
 *
56
 * @since 1.1
57
 *
58
 * @param array $args
59
 *
60
 * @return bool
61
 */
62
function give_is_float_labels_enabled( $args ) {
63
64
	$float_labels = '';
65
66
	if ( ! empty( $args['float_labels'] ) ) {
67
		$float_labels = $args['float_labels'];
68
	}
69
70
	if ( empty( $float_labels ) ) {
71
		$float_labels = give_get_meta( $args['form_id'], '_give_form_floating_labels', true );
72
	}
73
74
	if ( empty( $float_labels ) || ( 'global' === $float_labels ) ) {
75
		$float_labels = give_get_option( 'floatlabels', 'disabled' );
76
	}
77
78
	return give_is_setting_enabled( $float_labels );
79
}
80
81
/**
82
 * Determines if a user can checkout or not
83
 *
84
 * Allows themes and plugins to set donation checkout conditions
85
 *
86
 * @since 1.0
87
 *
88
 * @return bool Can user checkout?
89
 */
90
function give_can_checkout() {
91
92
	$can_checkout = true;
93
94
	return (bool) apply_filters( 'give_can_checkout', $can_checkout );
95
}
96
97
/**
98
 * Retrieve the Success page URI
99
 *
100
 * @access      public
101
 * @since       1.0
102
 *
103
 * @return      string
104
 */
105 View Code Duplication
function give_get_success_page_uri() {
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...
106
	$give_options = give_get_settings();
107
108
	$success_page = isset( $give_options['success_page'] ) ? get_permalink( absint( $give_options['success_page'] ) ) : get_bloginfo( 'url' );
109
110
	return apply_filters( 'give_get_success_page_uri', $success_page );
111
}
112
113
/**
114
 * Determines if we're currently on the Success page.
115
 *
116
 * @since 1.0
117
 *
118
 * @return bool True if on the Success page, false otherwise.
119
 */
120
function give_is_success_page() {
121
	$give_options    = give_get_settings();
122
	$is_success_page = isset( $give_options['success_page'] ) ? is_page( $give_options['success_page'] ) : false;
123
124
	return apply_filters( 'give_is_success_page', $is_success_page );
125
}
126
127
/**
128
 * Send To Success Page
129
 *
130
 * Sends the user to the success page.
131
 *
132
 * @param string $query_string
133
 *
134
 * @access      public
135
 * @since       1.0
136
 * @return      void
137
 */
138
function give_send_to_success_page( $query_string = null ) {
139
140
	$redirect = give_get_success_page_uri();
141
142
	if ( $query_string ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $query_string of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

In PHP, under loose comparison (like ==, or !=, or switch conditions), values of different types might be equal.

For string values, the empty string '' is a special case, in particular the following results might be unexpected:

''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
Loading history...
143
		$redirect .= $query_string;
144
	}
145
146
	$gateway = isset( $_REQUEST['give-gateway'] ) ? $_REQUEST['give-gateway'] : '';
0 ignored issues
show
introduced by
Detected access of super global var $_REQUEST, probably need manual inspection.
Loading history...
introduced by
Detected usage of a non-sanitized input variable: $_REQUEST
Loading history...
147
148
	wp_redirect( apply_filters( 'give_success_page_redirect', $redirect, $gateway, $query_string ) );
149
	give_die();
150
}
151
152
153
/**
154
 * Send back to donation form.
155
 *
156
 * Used to redirect a user back to the donation form if there are errors present.
157
 *
158
 * @param array $args
159
 *
160
 * @access public
161
 * @since  1.0
162
 * @return Void
163
 */
164
function give_send_back_to_checkout( $args = array() ) {
165
166
	$url     = isset( $_POST['give-current-url'] ) ? sanitize_text_field( $_POST['give-current-url'] ) : '';
0 ignored issues
show
introduced by
Detected access of super global var $_POST, probably need manual inspection.
Loading history...
167
	$form_id = 0;
168
169
	// Set the form_id.
170
	if ( isset( $_POST['give-form-id'] ) ) {
171
		$form_id = sanitize_text_field( $_POST['give-form-id'] );
0 ignored issues
show
introduced by
Detected access of super global var $_POST, probably need manual inspection.
Loading history...
172
	}
173
174
	// Need a URL to continue. If none, redirect back to single form.
175
	if ( empty( $url ) ) {
176
		wp_safe_redirect( get_permalink( $form_id ) );
177
		give_die();
178
	}
179
180
	$defaults = array(
181
		'form-id' => (int) $form_id,
182
	);
183
184
	// Set the $level_id.
185
	if ( isset( $_POST['give-price-id'] ) ) {
186
		$defaults['level-id'] = sanitize_text_field( $_POST['give-price-id'] );
0 ignored issues
show
introduced by
Detected access of super global var $_POST, probably need manual inspection.
Loading history...
187
	}
188
189
	// Check for backward compatibility.
190
	if ( is_string( $args ) ) {
191
		$args = str_replace( '?', '', $args );
192
	}
193
194
	$args = wp_parse_args( $args, $defaults );
195
196
	// Merge URL query with $args to maintain third-party URL parameters after redirect.
197
	$url_data = wp_parse_url( $url );
198
199
	// Check if an array to prevent notices before parsing.
200
	if ( isset( $url_data['query'] ) && ! empty( $url_data['query'] ) ) {
201
		parse_str( $url_data['query'], $query );
202
203
		// Precaution: don't allow any CC info.
204
		unset( $query['card_number'] );
205
		unset( $query['card_cvc'] );
206
207
	} else {
208
		// No $url_data so pass empty array.
209
		$query = array();
210
	}
211
212
	$new_query        = array_merge( $args, $query );
213
	$new_query_string = http_build_query( $new_query );
214
215
	// Assemble URL parts.
216
	$redirect = home_url( '/' . $url_data['path'] . '?' . $new_query_string . '#give-form-' . $form_id . '-wrap' );
217
218
	// Redirect them.
219
	wp_safe_redirect( apply_filters( 'give_send_back_to_checkout', $redirect, $args ) );
220
	give_die();
221
222
}
223
224
/**
225
 * Get Success Page URL
226
 *
227
 * Gets the success page URL.
228
 *
229
 * @param string $query_string
230
 *
231
 * @access      public
232
 * @since       1.0
233
 * @return      string
234
 */
235
function give_get_success_page_url( $query_string = null ) {
236
237
	$success_page = give_get_option( 'success_page', 0 );
238
	$success_page = get_permalink( $success_page );
239
240
	if ( $query_string ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $query_string of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

In PHP, under loose comparison (like ==, or !=, or switch conditions), values of different types might be equal.

For string values, the empty string '' is a special case, in particular the following results might be unexpected:

''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
Loading history...
241
		$success_page .= $query_string;
242
	}
243
244
	return apply_filters( 'give_success_page_url', $success_page );
245
246
}
247
248
/**
249
 * Get the URL of the Failed Donation Page.
250
 *
251
 * @since 1.0
252
 *
253
 * @param bool $extras Extras to append to the URL.
254
 *
255
 * @return mixed Full URL to the Failed Donation Page, if present, home page if it doesn't exist.
256
 */
257
function give_get_failed_transaction_uri( $extras = false ) {
258
	$give_options = give_get_settings();
259
260
	// Remove question mark.
261
	if ( 0 === strpos( $extras, '?' ) ) {
262
		$extras = substr( $extras, 1 );
263
	}
264
265
	$extras_args = wp_parse_args( $extras );
266
267
	// Set nonce if payment id exist in extra params.
268
	if ( array_key_exists( 'payment-id', $extras_args ) ) {
269
		$extras_args['_wpnonce'] = wp_create_nonce( "give-failed-donation-{$extras_args['payment-id']}" );
270
		$extras                  = http_build_query( $extras_args );
271
	}
272
273
	$uri = ! empty( $give_options['failure_page'] ) ?
274
		trailingslashit( get_permalink( $give_options['failure_page'] ) ) :
275
		home_url();
276
0 ignored issues
show
Coding Style introduced by
Functions must not contain multiple empty lines in a row; found 2 empty lines
Loading history...
277
278
	if ( $extras ) {
279
		$uri .= "?{$extras}";
280
	}
281
282
	return apply_filters( 'give_get_failed_transaction_uri', $uri );
283
}
284
285
/**
286
 * Determines if we're currently on the Failed Donation Page.
287
 *
288
 * @since 1.0
289
 * @return bool True if on the Failed Donation Page, false otherwise.
290
 */
291
function give_is_failed_transaction_page() {
292
	$give_options = give_get_settings();
293
	$ret          = isset( $give_options['failure_page'] ) ? is_page( $give_options['failure_page'] ) : false;
294
295
	return apply_filters( 'give_is_failure_page', $ret );
296
}
297
298
/**
299
 * Mark payments as Failed when returning to the Failed Donation Page
300
 *
301
 * @since  1.0
302
 * @since  1.8.16 Add security check
303
 *
304
 * @return bool
305
 */
306
function give_listen_for_failed_payments() {
307
308
	$failed_page = give_get_option( 'failure_page', 0 );
309
	$payment_id  = ! empty( $_GET['payment-id'] ) ? absint( $_GET['payment-id'] ) : 0;
0 ignored issues
show
introduced by
Detected access of super global var $_GET, probably need manual inspection.
Loading history...
310
	$nonce       = ! empty( $_GET['_wpnonce'] ) ? give_clean( $_GET['_wpnonce'] ) : false;
0 ignored issues
show
introduced by
Detected access of super global var $_GET, probably need manual inspection.
Loading history...
introduced by
Detected usage of a non-sanitized input variable: $_GET
Loading history...
311
312
	// Bailout.
313
	if ( ! $failed_page || ! is_page( $failed_page ) || ! $payment_id || ! $nonce ) {
314
		return false;
315
	}
316
317
	// Security check.
318
	if ( ! wp_verify_nonce( $nonce, "give-failed-donation-{$payment_id}" ) ) {
319
		wp_die( __( 'Nonce verification failed.', 'give' ), __( 'Error', 'give' ) );
320
	}
321
322
	// Set payment status to failure
323
	give_update_payment_status( $payment_id, 'failed' );
324
}
325
326
add_action( 'template_redirect', 'give_listen_for_failed_payments' );
327
328
/**
329
 * Retrieve the Donation History page URI
330
 *
331
 * @access      public
332
 * @since       1.7
333
 *
334
 * @return      string
335
 */
336 View Code Duplication
function give_get_history_page_uri() {
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...
337
	$give_options = give_get_settings();
338
339
	$history_page = isset( $give_options['history_page'] ) ? get_permalink( absint( $give_options['history_page'] ) ) : get_bloginfo( 'url' );
340
341
	return apply_filters( 'give_get_history_page_uri', $history_page );
342
}
343
344
/**
345
 * Check if a field is required
346
 *
347
 * @param string $field
348
 * @param int    $form_id
349
 *
350
 * @access      public
351
 * @since       1.0
352
 * @return      bool
353
 */
354
function give_field_is_required( $field = '', $form_id ) {
355
356
	$required_fields = give_get_required_fields( $form_id );
357
358
	return array_key_exists( $field, $required_fields );
359
}
360
361
/**
362
 * Record Donation In Log
363
 *
364
 * Stores log information for a donation.
365
 *
366
 * @since 1.0
367
 * @global            $give_logs Give_Logging
368
 *
369
 * @param int         $give_form_id Give Form ID.
370
 * @param int         $payment_id   Payment ID.
371
 * @param bool|int    $price_id     Price ID, if any.
372
 * @param string|null $donation_date    The date of the donation.
373
 *
374
 * @return void
375
 */
376
function give_record_donation_in_log( $give_form_id = 0, $payment_id, $price_id = false, $donation_date = null ) {
377
	global $give_logs;
378
379
	$log_data = array(
380
		'post_parent'   => $give_form_id,
381
		'log_type'      => 'sale',
382
		'post_date'     => isset( $donation_date ) ? $donation_date : null,
383
		'post_date_gmt' => isset( $donation_date ) ? $donation_date : null,
384
	);
385
386
	$log_meta = array(
387
		'payment_id' => $payment_id,
388
		'price_id'   => (int) $price_id,
389
	);
390
391
	$give_logs->insert_log( $log_data, $log_meta );
392
}
393
394
395
/**
396
 * Increases the donation total count of a donation form.
397
 *
398
 * @since 1.0
399
 *
400
 * @param int $form_id  Give Form ID
401
 * @param int $quantity Quantity to increase donation count by
402
 *
403
 * @return bool|int
404
 */
405
function give_increase_donation_count( $form_id = 0, $quantity = 1 ) {
406
	$quantity = (int) $quantity;
407
	$form     = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
408
409
	return $form->increase_sales( $quantity );
410
}
411
412
/**
413
 * Decreases the sale count of a form. Primarily for when a donation is refunded.
414
 *
415
 * @since 1.0
416
 *
417
 * @param int $form_id  Give Form ID
418
 * @param int $quantity Quantity to increase donation count by
419
 *
420
 * @return bool|int
421
 */
422
function give_decrease_donation_count( $form_id = 0, $quantity = 1 ) {
423
	$quantity = (int) $quantity;
424
	$form     = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
425
426
	return $form->decrease_sales( $quantity );
427
}
428
429
/**
430
 * Increases the total earnings of a form.
431
 *
432
 * @since 1.0
433
 *
434
 * @param int $give_form_id Give Form ID
435
 * @param int $amount       Earnings
436
 *
437
 * @return bool|int
438
 */
439
function give_increase_earnings( $give_form_id = 0, $amount ) {
440
	$form = new Give_Donate_Form( $give_form_id );
0 ignored issues
show
Documentation introduced by
$give_form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
441
442
	return $form->increase_earnings( $amount );
443
}
444
445
/**
446
 * Decreases the total earnings of a form.
447
 *
448
 * Primarily for when a donation is refunded.
449
 *
450
 * @since 1.0
451
 *
452
 * @param int $form_id Give Form ID
453
 * @param int $amount  Earnings
454
 *
455
 * @return bool|int
456
 */
457
function give_decrease_form_earnings( $form_id = 0, $amount ) {
458
459
	$form = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
460
461
	return $form->decrease_earnings( $amount );
462
}
463
464
465
/**
466
 * Returns the total earnings for a form.
467
 *
468
 * @since 1.0
469
 *
470
 * @param int $form_id Give Form ID
471
 *
472
 * @return int $earnings Earnings for a certain form
473
 */
474
function give_get_form_earnings_stats( $form_id = 0 ) {
475
	$give_form = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
476
477
	/**
478
	 * Filter the form earnings
479
	 *
480
	 * @since 1.8.17
481
	 */
482
	return apply_filters( 'give_get_form_earnings_stats',  $give_form->earnings, $form_id, $give_form );
483
}
484
485
486
/**
487
 * Return the sales number for a form.
488
 *
489
 * @since 1.0
490
 *
491
 * @param int $give_form_id Give Form ID
492
 *
493
 * @return int $sales Amount of sales for a certain form
494
 */
495
function give_get_form_sales_stats( $give_form_id = 0 ) {
496
	$give_form = new Give_Donate_Form( $give_form_id );
0 ignored issues
show
Documentation introduced by
$give_form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
497
498
	return $give_form->sales;
499
}
500
501
502
/**
503
 * Retrieves the average monthly sales for a specific donation form
504
 *
505
 * @since 1.0
506
 *
507
 * @param int $form_id Form ID
508
 *
509
 * @return float $sales Average monthly sales
510
 */
511 View Code Duplication
function give_get_average_monthly_form_sales( $form_id = 0 ) {
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...
512
	$sales        = give_get_form_sales_stats( $form_id );
513
	$release_date = get_post_field( 'post_date', $form_id );
514
515
	$diff = abs( current_time( 'timestamp' ) - strtotime( $release_date ) );
516
517
	$months = floor( $diff / ( 30 * 60 * 60 * 24 ) ); // Number of months since publication
518
519
	if ( $months > 0 ) {
520
		$sales = ( $sales / $months );
521
	}
522
523
	return $sales;
524
}
525
526
527
/**
528
 * Retrieves the average monthly earnings for a specific form
529
 *
530
 * @since 1.0
531
 *
532
 * @param int $form_id Form ID
533
 *
534
 * @return float $earnings Average monthly earnings
535
 */
536 View Code Duplication
function give_get_average_monthly_form_earnings( $form_id = 0 ) {
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...
537
	$earnings     = give_get_form_earnings_stats( $form_id );
538
	$release_date = get_post_field( 'post_date', $form_id );
539
540
	$diff = abs( current_time( 'timestamp' ) - strtotime( $release_date ) );
541
542
	$months = floor( $diff / ( 30 * 60 * 60 * 24 ) ); // Number of months since publication
543
544
	if ( $months > 0 ) {
545
		$earnings = ( $earnings / $months );
546
	}
547
548
	return $earnings < 0 ? 0 : $earnings;
549
}
550
551
552
/**
553
 * Get Price Option Name (Text)
554
 *
555
 * Retrieves the name of a variable price option.
556
 *
557
 * @since       1.0
558
 *
559
 * @param int $form_id    ID of the donation form.
560
 * @param int $price_id   ID of the price option.
561
 * @param int $payment_id payment ID for use in filters ( optional ).
562
 *
563
 * @return string $price_name Name of the price option
564
 */
565
function give_get_price_option_name( $form_id = 0, $price_id = 0, $payment_id = 0 ) {
566
567
	$prices     = give_get_variable_prices( $form_id );
568
	$price_name = '';
569
570
	foreach ( $prices as $price ) {
0 ignored issues
show
Bug introduced by
The expression $prices of type false|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
571
572
		if ( intval( $price['_give_id']['level_id'] ) == intval( $price_id ) ) {
573
574
			$price_text     = isset( $price['_give_text'] ) ? $price['_give_text'] : '';
575
			$price_fallback = give_currency_filter( give_format_amount( $price['_give_amount'], array( 'sanitize' => false ) ), '', true );
576
			$price_name     = ! empty( $price_text ) ? $price_text : $price_fallback;
577
578
		}
579
	}
580
581
	return apply_filters( 'give_get_price_option_name', $price_name, $form_id, $payment_id, $price_id );
582
}
583
584
585
/**
586
 * Retrieves a price from from low to high of a variable priced form
587
 *
588
 * @since 1.0
589
 *
590
 * @param int  $form_id   ID of the form
591
 * @param bool $formatted Flag to decide which type of price range string return
592
 *
593
 * @return string $range A fully formatted price range
594
 */
595
function give_price_range( $form_id = 0, $formatted = true ) {
596
	$low        = give_get_lowest_price_option( $form_id );
597
	$high       = give_get_highest_price_option( $form_id );
598
	$order_type = ! empty( $_REQUEST['order'] ) ? $_REQUEST['order'] : 'asc';
0 ignored issues
show
introduced by
Detected access of super global var $_REQUEST, probably need manual inspection.
Loading history...
introduced by
Detected usage of a non-sanitized input variable: $_REQUEST
Loading history...
599
600
	$range = sprintf(
601
		'<span class="give_price_range_%1$s">%2$s</span><span class="give_price_range_sep">&nbsp;&ndash;&nbsp;</span><span class="give_price_range_%3$s">%4$s</span>',
602
		'asc' === $order_type ? 'low' : 'high',
603
		'asc' === $order_type ? give_currency_filter( give_format_amount( $low, array( 'sanitize' => false ) ) ) : give_currency_filter( give_format_amount( $high, array( 'sanitize' => false ) ) ),
604
		'asc' === $order_type ? 'high' : 'low',
605
		'asc' === $order_type ? give_currency_filter( give_format_amount( $high, array( 'sanitize' => false ) ) ) : give_currency_filter( give_format_amount( $low, array( 'sanitize' => false ) ) )
606
0 ignored issues
show
Coding Style introduced by
There should be no empty lines in a multi-line function call.
Loading history...
607
	);
608
609
	if( ! $formatted ) {
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...
610
		$range = wp_strip_all_tags( $range );
611
	}
612
613
	return apply_filters( 'give_price_range', $range, $form_id, $low, $high );
614
}
615
616
617
/**
618
 * Get Lowest Price ID
619
 *
620
 * Retrieves the ID for the cheapest price option of a variable donation form
621
 *
622
 * @since 1.5
623
 *
624
 * @param int $form_id ID of the donation
625
 *
626
 * @return int ID of the lowest price
627
 */
628
function give_get_lowest_price_id( $form_id = 0 ) {
629
630
	if ( empty( $form_id ) ) {
631
		$form_id = get_the_ID();
632
	}
633
634
	if ( ! give_has_variable_prices( $form_id ) ) {
635
		return give_get_form_price( $form_id );
636
	}
637
638
	$prices = give_get_variable_prices( $form_id );
639
640
	$min = $min_id = 0;
641
642
	if ( ! empty( $prices ) ) {
643
644
		foreach ( $prices as $key => $price ) {
645
646
			if ( empty( $price['_give_amount'] ) ) {
647
				continue;
648
			}
649
650
			if ( ! isset( $min ) ) {
651
				$min = $price['_give_amount'];
652
			} else {
653
				$min = min( $min, $price['_give_amount'] );
654
			}
655
656
			if ( $price['_give_amount'] == $min ) {
657
				$min_id = $price['_give_id']['level_id'];
658
			}
659
		}
660
	}
661
662
	return (int) $min_id;
663
}
664
665
/**
666
 * Retrieves cheapest price option of a variable priced form
667
 *
668
 * @since 1.0
669
 *
670
 * @param int $form_id ID of the form
671
 *
672
 * @return float Amount of the lowest price
673
 */
674 View Code Duplication
function give_get_lowest_price_option( $form_id = 0 ) {
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...
675
	if ( empty( $form_id ) ) {
676
		$form_id = get_the_ID();
677
	}
678
679
	if ( ! give_has_variable_prices( $form_id ) ) {
680
		return give_get_form_price( $form_id );
681
	}
682
683
	if ( ! ( $low = get_post_meta( $form_id, '_give_levels_minimum_amount', true ) ) ) {
684
		// Backward compatibility.
685
		$prices = wp_list_pluck( give_get_variable_prices( $form_id ), '_give_amount' );
686
		$low    = ! empty( $prices ) ? min( $prices ) : 0;
687
	}
688
689
	return give_maybe_sanitize_amount( $low );
690
}
691
692
/**
693
 * Retrieves most expensive price option of a variable priced form
694
 *
695
 * @since 1.0
696
 *
697
 * @param int $form_id ID of the form
698
 *
699
 * @return float Amount of the highest price
700
 */
701 View Code Duplication
function give_get_highest_price_option( $form_id = 0 ) {
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...
702
703
	if ( empty( $form_id ) ) {
704
		$form_id = get_the_ID();
705
	}
706
707
	if ( ! give_has_variable_prices( $form_id ) ) {
708
		return give_get_form_price( $form_id );
709
	}
710
711
	if ( ! ( $high = get_post_meta( $form_id, '_give_levels_maximum_amount', true ) ) ) {
712
		// Backward compatibility.
713
		$prices = wp_list_pluck( give_get_variable_prices( $form_id ), '_give_amount' );
714
		$high   = ! empty( $prices ) ? max( $prices ) : 0;
715
	}
716
717
	return give_maybe_sanitize_amount( $high );
718
}
719
720
/**
721
 * Returns the price of a form, but only for non-variable priced forms.
722
 *
723
 * @since 1.0
724
 *
725
 * @param int $form_id ID number of the form to retrieve a price for
726
 *
727
 * @return mixed string|int Price of the form
728
 */
729
function give_get_form_price( $form_id = 0 ) {
730
731
	if ( empty( $form_id ) ) {
732
		return false;
733
	}
734
735
	$form = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
736
737
	return $form->__get( 'price' );
738
}
739
740
/**
741
 * Returns the minimum price amount of a form, only enforced for the custom amount input.
742
 *
743
 * @since 1.3.6
744
 *
745
 * @param int $form_id ID number of the form to retrieve the minimum price for
746
 *
747
 * @return mixed string|int Minimum price of the form
748
 */
749
function give_get_form_minimum_price( $form_id = 0 ) {
750
751
	if ( empty( $form_id ) ) {
752
		return false;
753
	}
754
755
	$form = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
756
757
	return $form->__get( 'minimum_price' );
758
759
}
760
761
/**
762
 * Displays a formatted price for a donation form
763
 *
764
 * @since 1.0
765
 *
766
 * @param int      $form_id  ID of the form price to show
767
 * @param bool     $echo     Whether to echo or return the results
768
 * @param bool|int $price_id Optional price id for variable pricing
769
 *
770
 * @return int $formatted_price
771
 */
772
function give_price( $form_id = 0, $echo = true, $price_id = false ) {
773
	$price = 0;
774
775
	if ( empty( $form_id ) ) {
776
		$form_id = get_the_ID();
777
	}
778
779
	if ( give_has_variable_prices( $form_id ) ) {
780
781
		$prices = give_get_variable_prices( $form_id );
782
783
		if ( false !== $price_id ) {
784
785
			// loop through multi-prices to see which is default
786 View Code Duplication
			foreach ( $prices as $price ) {
0 ignored issues
show
Bug introduced by
The expression $prices of type false|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
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...
787
				// this is the default price
788
				if ( isset( $price['_give_default'] ) && $price['_give_default'] === 'default' ) {
0 ignored issues
show
introduced by
Found "=== '". Use Yoda Condition checks, you must
Loading history...
789
					$price = (float) $price['_give_amount'];
790
				};
791
			}
792
		} else {
793
794
			$price = give_get_lowest_price_option( $form_id );
795
		}
796
	} else {
797
798
		$price = give_get_form_price( $form_id );
799
	}
800
801
	$price           = apply_filters( 'give_form_price', give_maybe_sanitize_amount( $price ), $form_id );
802
	$formatted_price = '<span class="give_price" id="give_price_' . $form_id . '">' . $price . '</span>';
803
	$formatted_price = apply_filters( 'give_form_price_after_html', $formatted_price, $form_id, $price );
804
805
	if ( $echo ) {
806
		echo $formatted_price;
0 ignored issues
show
introduced by
Expected next thing to be a escaping function, not '$formatted_price'
Loading history...
807
	} else {
808
		return $formatted_price;
809
	}
810
}
811
812
add_filter( 'give_form_price', 'give_format_amount', 10 );
813
add_filter( 'give_form_price', 'give_currency_filter', 20 );
814
815
816
/**
817
 * Retrieves the amount of a variable price option
818
 *
819
 * @since 1.0
820
 *
821
 * @param int $form_id  ID of the form
822
 * @param int $price_id ID of the price option
823
 *
824
 * @return float $amount Amount of the price option
825
 */
826
function give_get_price_option_amount( $form_id = 0, $price_id = 0 ) {
827
	$prices = give_get_variable_prices( $form_id );
828
829
	$amount = 0.00;
830
831 View Code Duplication
	foreach ( $prices as $price ) {
0 ignored issues
show
Bug introduced by
The expression $prices of type false|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
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...
832
		if ( isset( $price['_give_id']['level_id'] ) && $price['_give_id']['level_id'] == $price_id ) {
833
			$amount = isset( $price['_give_amount'] ) ? $price['_give_amount'] : 0.00;
834
			break;
835
		};
836
	}
837
838
	return apply_filters( 'give_get_price_option_amount', give_maybe_sanitize_amount( $amount ), $form_id, $price_id );
839
}
840
841
/**
842
 * Returns the goal of a form
843
 *
844
 * @since 1.0
845
 *
846
 * @param int $form_id ID number of the form to retrieve a goal for
847
 *
848
 * @return mixed string|int Goal of the form
849
 */
850
function give_get_form_goal( $form_id = 0 ) {
851
852
	if ( empty( $form_id ) ) {
853
		return false;
854
	}
855
856
	$form = new Give_Donate_Form( $form_id );
0 ignored issues
show
Documentation introduced by
$form_id is of type integer, but the function expects a boolean.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
857
858
	return $form->goal;
859
860
}
861
862
/**
863
 * Display/Return a formatted goal for a donation form
864
 *
865
 * @since 1.0
866
 *
867
 * @param int  $form_id ID of the form price to show
868
 * @param bool $echo    Whether to echo or return the results
869
 *
870
 * @return string $formatted_goal
871
 */
872
function give_goal( $form_id = 0, $echo = true ) {
873
874
	if ( empty( $form_id ) ) {
875
		$form_id = get_the_ID();
876
	}
877
878
	$goal = give_get_form_goal( $form_id );
879
880
	$goal           = apply_filters( 'give_form_goal', give_maybe_sanitize_amount( $goal ), $form_id );
881
	$formatted_goal = '<span class="give_price" id="give_price_' . $form_id . '">' . $goal . '</span>';
882
	$formatted_goal = apply_filters( 'give_form_price_after_html', $formatted_goal, $form_id, $goal );
883
884
	if ( $echo ) {
885
		echo $formatted_goal;
0 ignored issues
show
introduced by
Expected next thing to be a escaping function, not '$formatted_goal'
Loading history...
886
	} else {
887
		return $formatted_goal;
888
	}
889
}
890
891
add_filter( 'give_form_goal', 'give_format_amount', 10 );
892
add_filter( 'give_form_goal', 'give_currency_filter', 20 );
893
894
895
/**
896
 * Checks if users can only donate when logged in
897
 *
898
 * @since  1.0
899
 *
900
 * @param  int $form_id Give form ID
901
 *
902
 * @return bool  $ret Whether or not the logged_in_only setting is set
903
 */
904
function give_logged_in_only( $form_id ) {
905
	// If _give_logged_in_only is set to enable then guest can donate from that specific form.
906
	// Otherwise it is member only donation form.
907
	$val = give_get_meta( $form_id, '_give_logged_in_only', true );
908
	$val = ! empty( $val ) ? $val : 'enabled';
909
910
	$ret = ! give_is_setting_enabled( $val );
911
912
	return (bool) apply_filters( 'give_logged_in_only', $ret, $form_id );
913
}
914
915
916
/**
917
 * Checks the option for the "Register / Login Option"
918
 *
919
 * @since 1.4.1
920
 *
921
 * @param int $form_id
922
 *
923
 * @return string
924
 */
925
function give_show_login_register_option( $form_id ) {
926
927
	$show_register_form = give_get_meta( $form_id, '_give_show_register_form', true );
928
929
	return apply_filters( 'give_show_register_form', $show_register_form, $form_id );
930
931
}
932
933
934
/**
935
 * Get pre fill form field values.
936
 *
937
 * Note: this function will extract form field values from give_purchase session data.
938
 *
939
 * @since  1.8
940
 *
941
 * @param  int $form_id Form ID.
942
 *
943
 * @return array
944
 */
945
function _give_get_prefill_form_field_values( $form_id ) {
946
	$logged_in_donor_info = array();
947
948
	if ( is_user_logged_in() ) :
949
		$donor_data    = get_userdata( get_current_user_id() );
950
		$donor_address = get_user_meta( get_current_user_id(), '_give_user_address', true );
0 ignored issues
show
introduced by
get_user_meta() usage is highly discouraged, check VIP documentation on "Working with wp_users"
Loading history...
951
952
		$logged_in_donor_info = array(
953
			// First name.
954
			'give_first'      => $donor_data->first_name,
955
956
			// Last name.
957
			'give_last'       => $donor_data->last_name,
958
959
			// Email.
960
			'give_email'      => $donor_data->user_email,
961
962
			// Street address 1.
963
			'card_address'    => ( ! empty( $donor_address['line1'] ) ? $donor_address['line1'] : '' ),
964
965
			// Street address 2.
966
			'card_address_2'  => ( ! empty( $donor_address['line2'] ) ? $donor_address['line2'] : '' ),
967
968
			// Country.
969
			'billing_country' => ( ! empty( $donor_address['country'] ) ? $donor_address['country'] : '' ),
970
971
			// State.
972
			'card_state'      => ( ! empty( $donor_address['state'] ) ? $donor_address['state'] : '' ),
973
974
			// City.
975
			'card_city'       => ( ! empty( $donor_address['city'] ) ? $donor_address['city'] : '' ),
976
977
			// Zipcode
978
			'card_zip'        => ( ! empty( $donor_address['zip'] ) ? $donor_address['zip'] : '' ),
979
		);
980
	endif;
981
982
	// Bailout: Auto fill form field values only form form which donor is donating.
983
	if (
984
		empty( $_GET['form-id'] )
0 ignored issues
show
introduced by
Detected access of super global var $_GET, probably need manual inspection.
Loading history...
985
		|| ! $form_id
986
		|| ( $form_id !== absint( $_GET['form-id'] ) )
0 ignored issues
show
introduced by
Detected access of super global var $_GET, probably need manual inspection.
Loading history...
987
	) {
988
		return $logged_in_donor_info;
989
	}
990
991
	// Get purchase data.
992
	$give_purchase_data = Give()->session->get( 'give_purchase' );
993
994
	// Get donor info from form data.
995
	$give_donor_info_in_session = empty( $give_purchase_data['post_data'] )
996
		? array()
997
		: $give_purchase_data['post_data'];
998
999
	// Output.
1000
	return wp_parse_args( $give_donor_info_in_session, $logged_in_donor_info );
1001
}
1002