installed plugin Easy Digital Downloads version 3.1.0.3

wp-content/plugins/easy-digital-downloads/includes/gateways/paypal/deprecated.php

@@ -0,0 +1,102 @@
+<?php
+/**
+ * Deprecated PayPal Functions
+ *
+ * @package    easy-digital-downloads
+ * @subpackage Gateways\PayPal
+ * @copyright  Copyright (c) 2021, Sandhills Development, LLC
+ * @license    GPL2+
+ * @since      3.0
+ */
+
+namespace EDD\Gateways\PayPal;
+
+/**
+ * Adds a "Refund in PayPal" checkbox when switching the payment's status to "Refunded".
+ *
+ * @deprecated 3.0 In favor of a `edd_after_submit_refund_table` hook.
+ *
+ * @param int $payment_id
+ *
+ * @since 2.11
+ * @return void
+ */
+function add_refund_javascript( $payment_id ) {
+	_edd_deprecated_function( __FUNCTION__, '3.0', null, debug_backtrace() );
+
+	$payment = edd_get_payment( $payment_id );
+
+	if ( ! $payment || 'paypal_commerce' !== $payment->gateway ) {
+		return;
+	}
+
+	$mode = ( 'live' === $payment->mode ) ? API::MODE_LIVE : API::MODE_SANDBOX;
+
+	try {
+		$api = new API( $mode );
+	} catch ( Exceptions\Authentication_Exception $e ) {
+		// If we don't have credentials.
+		return;
+	}
+
+	$label = __( 'Refund Transaction in PayPal', 'easy-digital-downloads' );
+	?>
+	<script type="text/javascript">
+		jQuery( document ).ready( function ( $ ) {
+			$( 'select[name=edd-payment-status]' ).change( function () {
+				if ( 'refunded' === $( this ).val() ) {
+					$( this ).parent().parent().append( '<input type="checkbox" id="edd-paypal-commerce-refund" name="edd-paypal-commerce-refund" value="1" style="margin-top:0">' );
+					$( this ).parent().parent().append( '<label for="edd-paypal-commerce-refund"><?php echo esc_html( $label ); ?></label>' );
+				} else {
+					$( '#edd-paypal-commerce-refund' ).remove();
+					$( 'label[for="edd-paypal-commerce-refund"]' ).remove();
+				}
+			} );
+		} );
+	</script>
+	<?php
+}
+
+/**
+ * Refunds the transaction in PayPal, if the option was selected.
+ *
+ * @deprecated 3.0 In favor of `edd_refund_order` hook.
+ *
+ * @param \EDD_Payment $payment The payment being refunded.
+ *
+ * @since 2.11
+ * @return void
+ */
+function maybe_refund_transaction( \EDD_Payment $payment ) {
+	_edd_deprecated_function( __FUNCTION__, '3.0', null, debug_backtrace() );
+
+	if ( ! current_user_can( 'edit_shop_payments', $payment->ID ) ) {
+		return;
+	}
+
+	if ( 'paypal_commerce' !== $payment->gateway || empty( $_POST['edd-paypal-commerce-refund'] ) ) {
+		return;
+	}
+
+	// Payment status should be coming from "publish" or "revoked".
+	// @todo In 3.0 use `edd_get_refundable_order_statuses()`
+	if ( ! in_array( $payment->old_status, array( 'publish', 'complete', 'revoked', 'edd_subscription' ) ) ) {
+		return;
+	}
+
+	// If the payment has already been refunded, bail.
+	if ( $payment->get_meta( '_edd_paypal_refunded', true ) ) {
+		return;
+	}
+
+	// Process the refund.
+	try {
+		refund_transaction( $payment );
+	} catch ( \Exception $e ) {
+		edd_insert_payment_note( $payment->ID, sprintf(
+		/* Translators: %s - The error message */
+			__( 'Failed to refund transaction in PayPal. Error Message: %s', 'easy-digital-downloads' ),
+			$e->getMessage()
+		) );
+	}
+}