Test Failed
Push — release/2.0 ( 9e8647...e4a555 )
by Ravinder
08:20 queued 04:10
created

functions.php ➔ give_get_price_option_name()   C

Complexity

Conditions 7
Paths 11

Size

Total Lines 22
Code Lines 11

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 7
eloc 11
nc 11
nop 4
dl 0
loc 22
rs 6.9811
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
 *
368
 * @param int         $give_form_id  Give Form ID.
369
 * @param int         $payment_id    Payment ID.
370
 * @param bool|int    $price_id      Price ID, if any.
371
 * @param string|null $donation_date The date of the donation.
372
 *
373
 * @return void
374
 */
375
function give_record_donation_in_log( $give_form_id = 0, $payment_id, $price_id = false, $donation_date = null ) {
376
	$log_data = array(
377
		'log_parent'   => $payment_id,
378
		'log_type'     => 'sale',
379
		'log_date'     => isset( $donation_date ) ? $donation_date : null,
380
		'log_date_gmt' => isset( $donation_date ) ? $donation_date : null,
381
	);
382
383
	$log_meta = array(
384
		'form_id'  => $give_form_id,
385
		'price_id' => (int) $price_id,
386
	);
387
388
	Give()->logs->insert_log( $log_data, $log_meta );
389
}
390
391
392
/**
393
 * Increases the donation total count of a donation form.
394
 *
395
 * @since 1.0
396
 *
397
 * @param int $form_id  Give Form ID
398
 * @param int $quantity Quantity to increase donation count by
399
 *
400
 * @return bool|int
401
 */
402
function give_increase_donation_count( $form_id = 0, $quantity = 1 ) {
403
	$quantity = (int) $quantity;
404
	$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...
405
406
	return $form->increase_sales( $quantity );
407
}
408
409
/**
410
 * Decreases the sale count of a form. Primarily for when a donation is refunded.
411
 *
412
 * @since 1.0
413
 *
414
 * @param int $form_id  Give Form ID
415
 * @param int $quantity Quantity to increase donation count by
416
 *
417
 * @return bool|int
418
 */
419
function give_decrease_donation_count( $form_id = 0, $quantity = 1 ) {
420
	$quantity = (int) $quantity;
421
	$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...
422
423
	return $form->decrease_sales( $quantity );
424
}
425
426
/**
427
 * Increases the total earnings of a form.
428
 *
429
 * @since 1.0
430
 *
431
 * @param int $give_form_id Give Form ID
432
 * @param int $amount       Earnings
433
 *
434
 * @return bool|int
435
 */
436
function give_increase_earnings( $give_form_id = 0, $amount ) {
437
	$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...
438
439
	return $form->increase_earnings( $amount );
440
}
441
442
/**
443
 * Decreases the total earnings of a form.
444
 *
445
 * Primarily for when a donation is refunded.
446
 *
447
 * @since 1.0
448
 *
449
 * @param int $form_id Give Form ID
450
 * @param int $amount  Earnings
451
 *
452
 * @return bool|int
453
 */
454
function give_decrease_form_earnings( $form_id = 0, $amount ) {
455
456
	$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...
457
458
	return $form->decrease_earnings( $amount );
459
}
460
461
462
/**
463
 * Returns the total earnings for a form.
464
 *
465
 * @since 1.0
466
 *
467
 * @param int $form_id Give Form ID
468
 *
469
 * @return int $earnings Earnings for a certain form
470
 */
471
function give_get_form_earnings_stats( $form_id = 0 ) {
472
	$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...
473
474
	/**
475
	 * Filter the form earnings
476
	 *
477
	 * @since 1.8.17
478
	 */
479
	return apply_filters( 'give_get_form_earnings_stats', $give_form->earnings, $form_id, $give_form );
480
}
481
482
483
/**
484
 * Return the sales number for a form.
485
 *
486
 * @since 1.0
487
 *
488
 * @param int $give_form_id Give Form ID
489
 *
490
 * @return int $sales Amount of sales for a certain form
491
 */
492
function give_get_form_sales_stats( $give_form_id = 0 ) {
493
	$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...
494
495
	return $give_form->sales;
496
}
497
498
499
/**
500
 * Retrieves the average monthly sales for a specific donation form
501
 *
502
 * @since 1.0
503
 *
504
 * @param int $form_id Form ID
505
 *
506
 * @return float $sales Average monthly sales
507
 */
508 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...
509
	$sales        = give_get_form_sales_stats( $form_id );
510
	$release_date = get_post_field( 'post_date', $form_id );
511
512
	$diff = abs( current_time( 'timestamp' ) - strtotime( $release_date ) );
513
514
	$months = floor( $diff / ( 30 * 60 * 60 * 24 ) ); // Number of months since publication
515
516
	if ( $months > 0 ) {
517
		$sales = ( $sales / $months );
518
	}
519
520
	return $sales;
521
}
522
523
524
/**
525
 * Retrieves the average monthly earnings for a specific form
526
 *
527
 * @since 1.0
528
 *
529
 * @param int $form_id Form ID
530
 *
531
 * @return float $earnings Average monthly earnings
532
 */
533 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...
534
	$earnings     = give_get_form_earnings_stats( $form_id );
535
	$release_date = get_post_field( 'post_date', $form_id );
536
537
	$diff = abs( current_time( 'timestamp' ) - strtotime( $release_date ) );
538
539
	$months = floor( $diff / ( 30 * 60 * 60 * 24 ) ); // Number of months since publication
540
541
	if ( $months > 0 ) {
542
		$earnings = ( $earnings / $months );
543
	}
544
545
	return $earnings < 0 ? 0 : $earnings;
546
}
547
548
549
/**
550
 * Get Price Option Name (Text)
551
 *
552
 * Retrieves the name of a variable price option.
553
 *
554
 * @since       1.0
555
 *
556
 * @param int  $form_id      ID of the donation form.
557
 * @param int  $price_id     ID of the price option.
558
 * @param int  $payment_id   payment ID for use in filters ( optional ).
559
 * @param bool $use_fallback Outputsz the level amount if no level text is provided.
560
 *
561
 * @return string $price_name Name of the price option
562
 */
563
function give_get_price_option_name( $form_id = 0, $price_id = 0, $payment_id = 0, $use_fallback = true ) {
564
565
	$prices     = give_get_variable_prices( $form_id );
566
	$price_name = '';
567
568
	if ( false === $prices ) {
569
		return $price_name;
570
	}
571
572
	foreach ( $prices as $price ) {
573
574
		if ( intval( $price['_give_id']['level_id'] ) == intval( $price_id ) ) {
575
576
			$price_text     = isset( $price['_give_text'] ) ? $price['_give_text'] : '';
577
			$price_fallback = $use_fallback ? give_currency_filter( give_format_amount( $price['_give_amount'], array( 'sanitize' => false ) ), '', true ) : '';
578
			$price_name     = ! empty( $price_text ) ? $price_text : $price_fallback;
579
580
		}
581
	}
582
583
	return apply_filters( 'give_get_price_option_name', $price_name, $form_id, $payment_id, $price_id );
584
}
585
586
587
/**
588
 * Retrieves a price from from low to high of a variable priced form
589
 *
590
 * @since 1.0
591
 *
592
 * @param int  $form_id   ID of the form
593
 * @param bool $formatted Flag to decide which type of price range string return
594
 *
595
 * @return string $range A fully formatted price range
596
 */
597
function give_price_range( $form_id = 0, $formatted = true ) {
598
	$low        = give_get_lowest_price_option( $form_id );
599
	$high       = give_get_highest_price_option( $form_id );
600
	$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...
601
602
	$range = sprintf(
603
		'<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>',
604
		'asc' === $order_type ? 'low' : 'high',
605
		'asc' === $order_type ? give_currency_filter( give_format_amount( $low, array( 'sanitize' => false ) ) ) : give_currency_filter( give_format_amount( $high, array( 'sanitize' => false ) ) ),
606
		'asc' === $order_type ? 'high' : 'low',
607
		'asc' === $order_type ? give_currency_filter( give_format_amount( $high, array( 'sanitize' => false ) ) ) : give_currency_filter( give_format_amount( $low, array( 'sanitize' => false ) ) )
608
0 ignored issues
show
Coding Style introduced by
There should be no empty lines in a multi-line function call.
Loading history...
609
	);
610
611
	if ( ! $formatted ) {
612
		$range = wp_strip_all_tags( $range );
613
	}
614
615
	return apply_filters( 'give_price_range', $range, $form_id, $low, $high );
616
}
617
618
619
/**
620
 * Get Lowest Price ID
621
 *
622
 * Retrieves the ID for the cheapest price option of a variable donation form
623
 *
624
 * @since 1.5
625
 *
626
 * @param int $form_id ID of the donation
627
 *
628
 * @return int ID of the lowest price
629
 */
630
function give_get_lowest_price_id( $form_id = 0 ) {
631
632
	if ( empty( $form_id ) ) {
633
		$form_id = get_the_ID();
634
	}
635
636
	if ( ! give_has_variable_prices( $form_id ) ) {
637
		return give_get_form_price( $form_id );
638
	}
639
640
	$prices = give_get_variable_prices( $form_id );
641
642
	$min = $min_id = 0;
643
644
	if ( ! empty( $prices ) ) {
645
646
		foreach ( $prices as $key => $price ) {
647
648
			if ( empty( $price['_give_amount'] ) ) {
649
				continue;
650
			}
651
652
			if ( ! isset( $min ) ) {
653
				$min = $price['_give_amount'];
654
			} else {
655
				$min = min( $min, $price['_give_amount'] );
656
			}
657
658
			if ( $price['_give_amount'] == $min ) {
659
				$min_id = $price['_give_id']['level_id'];
660
			}
661
		}
662
	}
663
664
	return (int) $min_id;
665
}
666
667
/**
668
 * Retrieves cheapest price option of a variable priced form
669
 *
670
 * @since 1.0
671
 *
672
 * @param int $form_id ID of the form
673
 *
674
 * @return float Amount of the lowest price
675
 */
676 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...
677
	if ( empty( $form_id ) ) {
678
		$form_id = get_the_ID();
679
	}
680
681
	if ( ! give_has_variable_prices( $form_id ) ) {
682
		return give_get_form_price( $form_id );
683
	}
684
685
	if ( ! ( $low = get_post_meta( $form_id, '_give_levels_minimum_amount', true ) ) ) {
686
		// Backward compatibility.
687
		$prices = wp_list_pluck( give_get_variable_prices( $form_id ), '_give_amount' );
688
		$low    = ! empty( $prices ) ? min( $prices ) : 0;
689
	}
690
691
	return give_maybe_sanitize_amount( $low );
692
}
693
694
/**
695
 * Retrieves most expensive price option of a variable priced form
696
 *
697
 * @since 1.0
698
 *
699
 * @param int $form_id ID of the form
700
 *
701
 * @return float Amount of the highest price
702
 */
703 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...
704
705
	if ( empty( $form_id ) ) {
706
		$form_id = get_the_ID();
707
	}
708
709
	if ( ! give_has_variable_prices( $form_id ) ) {
710
		return give_get_form_price( $form_id );
711
	}
712
713
	if ( ! ( $high = get_post_meta( $form_id, '_give_levels_maximum_amount', true ) ) ) {
714
		// Backward compatibility.
715
		$prices = wp_list_pluck( give_get_variable_prices( $form_id ), '_give_amount' );
716
		$high   = ! empty( $prices ) ? max( $prices ) : 0;
717
	}
718
719
	return give_maybe_sanitize_amount( $high );
720
}
721
722
/**
723
 * Returns the price of a form, but only for non-variable priced forms.
724
 *
725
 * @since 1.0
726
 *
727
 * @param int $form_id ID number of the form to retrieve a price for
728
 *
729
 * @return mixed string|int Price of the form
730
 */
731
function give_get_form_price( $form_id = 0 ) {
732
733
	if ( empty( $form_id ) ) {
734
		return false;
735
	}
736
737
	$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...
738
739
	return $form->__get( 'price' );
740
}
741
742
/**
743
 * Returns the minimum price amount of a form, only enforced for the custom amount input.
744
 *
745
 * @since 1.3.6
746
 *
747
 * @param int $form_id ID number of the form to retrieve the minimum price for
748
 *
749
 * @return mixed string|int Minimum price of the form
750
 */
751
function give_get_form_minimum_price( $form_id = 0 ) {
752
753
	if ( empty( $form_id ) ) {
754
		return false;
755
	}
756
757
	$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...
758
759
	return $form->get_minimum_price();
760
761
}
762
763
/**
764
 * Displays a formatted price for a donation form
765
 *
766
 * @since 1.0
767
 *
768
 * @param int      $form_id  ID of the form price to show
769
 * @param bool     $echo     Whether to echo or return the results
770
 * @param bool|int $price_id Optional price id for variable pricing
771
 *
772
 * @return int $formatted_price
773
 */
774
function give_price( $form_id = 0, $echo = true, $price_id = false ) {
775
	$price = 0;
776
777
	if ( empty( $form_id ) ) {
778
		$form_id = get_the_ID();
779
	}
780
781
	if ( give_has_variable_prices( $form_id ) ) {
782
783
		$prices = give_get_variable_prices( $form_id );
784
785
		if ( false !== $price_id ) {
786
787
			// loop through multi-prices to see which is default
788 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...
789
				// this is the default price
790
				if ( isset( $price['_give_default'] ) && $price['_give_default'] === 'default' ) {
0 ignored issues
show
introduced by
Found "=== '". Use Yoda Condition checks, you must
Loading history...
791
					$price = (float) $price['_give_amount'];
792
				};
793
			}
794
		} else {
795
796
			$price = give_get_lowest_price_option( $form_id );
797
		}
798
	} else {
799
800
		$price = give_get_form_price( $form_id );
801
	}
802
803
	$price           = apply_filters( 'give_form_price', give_maybe_sanitize_amount( $price ), $form_id );
804
	$formatted_price = '<span class="give_price" id="give_price_' . $form_id . '">' . $price . '</span>';
805
	$formatted_price = apply_filters( 'give_form_price_after_html', $formatted_price, $form_id, $price );
806
807
	if ( $echo ) {
808
		echo $formatted_price;
0 ignored issues
show
introduced by
Expected next thing to be a escaping function, not '$formatted_price'
Loading history...
809
	} else {
810
		return $formatted_price;
811
	}
812
}
813
814
add_filter( 'give_form_price', 'give_format_amount', 10 );
815
add_filter( 'give_form_price', 'give_currency_filter', 20 );
816
817
818
/**
819
 * Retrieves the amount of a variable price option
820
 *
821
 * @since 1.0
822
 *
823
 * @param int $form_id  ID of the form
824
 * @param int $price_id ID of the price option
825
 *
826
 * @return float $amount Amount of the price option
827
 */
828
function give_get_price_option_amount( $form_id = 0, $price_id = 0 ) {
829
	$prices = give_get_variable_prices( $form_id );
830
831
	$amount = 0.00;
832
833 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...
834
		if ( isset( $price['_give_id']['level_id'] ) && $price['_give_id']['level_id'] == $price_id ) {
835
			$amount = isset( $price['_give_amount'] ) ? $price['_give_amount'] : 0.00;
836
			break;
837
		};
838
	}
839
840
	return apply_filters( 'give_get_price_option_amount', give_maybe_sanitize_amount( $amount ), $form_id, $price_id );
841
}
842
843
/**
844
 * Returns the goal of a form
845
 *
846
 * @since 1.0
847
 *
848
 * @param int $form_id ID number of the form to retrieve a goal for
849
 *
850
 * @return mixed string|int Goal of the form
851
 */
852
function give_get_form_goal( $form_id = 0 ) {
853
854
	if ( empty( $form_id ) ) {
855
		return false;
856
	}
857
858
	$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...
859
860
	return $form->goal;
861
862
}
863
864
/**
865
 * Display/Return a formatted goal for a donation form
866
 *
867
 * @since 1.0
868
 *
869
 * @param int  $form_id ID of the form price to show
870
 * @param bool $echo    Whether to echo or return the results
871
 *
872
 * @return string $formatted_goal
873
 */
874
function give_goal( $form_id = 0, $echo = true ) {
875
876
	if ( empty( $form_id ) ) {
877
		$form_id = get_the_ID();
878
	}
879
880
	$goal = give_get_form_goal( $form_id );
881
882
	$goal           = apply_filters( 'give_form_goal', give_maybe_sanitize_amount( $goal ), $form_id );
883
	$formatted_goal = '<span class="give_price" id="give_price_' . $form_id . '">' . $goal . '</span>';
884
	$formatted_goal = apply_filters( 'give_form_price_after_html', $formatted_goal, $form_id, $goal );
885
886
	if ( $echo ) {
887
		echo $formatted_goal;
0 ignored issues
show
introduced by
Expected next thing to be a escaping function, not '$formatted_goal'
Loading history...
888
	} else {
889
		return $formatted_goal;
890
	}
891
}
892
893
add_filter( 'give_form_goal', 'give_format_amount', 10 );
894
add_filter( 'give_form_goal', 'give_currency_filter', 20 );
895
896
897
/**
898
 * Checks if users can only donate when logged in
899
 *
900
 * @since  1.0
901
 *
902
 * @param  int $form_id Give form ID
903
 *
904
 * @return bool  $ret Whether or not the logged_in_only setting is set
905
 */
906
function give_logged_in_only( $form_id ) {
907
	// If _give_logged_in_only is set to enable then guest can donate from that specific form.
908
	// Otherwise it is member only donation form.
909
	$val = give_get_meta( $form_id, '_give_logged_in_only', true );
910
	$val = ! empty( $val ) ? $val : 'enabled';
911
912
	$ret = ! give_is_setting_enabled( $val );
913
914
	return (bool) apply_filters( 'give_logged_in_only', $ret, $form_id );
915
}
916
917
918
/**
919
 * Checks the option for the "Register / Login Option"
920
 *
921
 * @since 1.4.1
922
 *
923
 * @param int $form_id
924
 *
925
 * @return string
926
 */
927
function give_show_login_register_option( $form_id ) {
928
929
	$show_register_form = give_get_meta( $form_id, '_give_show_register_form', true );
930
931
	return apply_filters( 'give_show_register_form', $show_register_form, $form_id );
932
933
}
934
935
936
/**
937
 * Get pre fill form field values.
938
 *
939
 * Note: this function will extract form field values from give_purchase session data.
940
 *
941
 * @since  1.8
942
 *
943
 * @param  int $form_id Form ID.
944
 *
945
 * @return array
946
 */
947
function _give_get_prefill_form_field_values( $form_id ) {
948
	$logged_in_donor_info = array();
949
950
	if ( is_user_logged_in() ) :
951
		$donor_data    = get_userdata( get_current_user_id() );
952
		$donor_address = give_get_donor_address( get_current_user_id() );
953
954
		$logged_in_donor_info = array(
955
			// First name.
956
			'give_first'      => $donor_data->first_name,
957
958
			// Last name.
959
			'give_last'       => $donor_data->last_name,
960
961
			// Email.
962
			'give_email'      => $donor_data->user_email,
963
964
			// Street address 1.
965
			'card_address'    => $donor_address['line1'],
966
967
			// Street address 2.
968
			'card_address_2'  => $donor_address['line2'],
969
970
			// Country.
971
			'billing_country' => $donor_address['country'],
972
973
			// State.
974
			'card_state'      => $donor_address['state'],
975
976
			// City.
977
			'card_city'       => $donor_address['city'],
978
979
			// Zipcode
980
			'card_zip'        => $donor_address['zip'],
981
		);
982
	endif;
983
984
	// Bailout: Auto fill form field values only form form which donor is donating.
985
	if (
986
		empty( $_GET['form-id'] )
0 ignored issues
show
introduced by
Detected access of super global var $_GET, probably need manual inspection.
Loading history...
987
		|| ! $form_id
988
		|| ( $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...
989
	) {
990
		return $logged_in_donor_info;
991
	}
992
993
	// Get purchase data.
994
	$give_purchase_data = Give()->session->get( 'give_purchase' );
995
996
	// Get donor info from form data.
997
	$give_donor_info_in_session = empty( $give_purchase_data['post_data'] )
998
		? array()
999
		: $give_purchase_data['post_data'];
1000
1001
	// Output.
1002
	return wp_parse_args( $give_donor_info_in_session, $logged_in_donor_info );
1003
}
1004