# charitable/1.8.13/includes/donations/class-charitable-donation.php

Charitable – Donation & Fundraising Platform (Donation Forms, Recurring Donations & Fundraising Campaigns), version 1.8.13. 111 lines.

- Page: https://pluginprobe.com/plugins/charitable/1.8.13/code/includes/donations/class-charitable-donation.php
- Raw: https://pluginprobe.com/plugins/charitable/1.8.13/raw/includes/donations/class-charitable-donation.php
- Modified: 2025-07-07T14:22:36+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/charitable/1.8.13/code/includes/donations/class-charitable-donation.php#L10-L20`.

```php
<?php
/**
 * Donation model.
 *
 * @package   Charitable/Classes/Charitable_Donation
 * @author    David Bisset
 * @copyright Copyright (c) 2023, WP Charitable LLC
 * @license   http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since     1.0.0
 * @version   1.6.0
 */

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! class_exists( 'Charitable_Donation' ) ) :

	/**
	 * Donation Model.
	 *
	 * @since 1.0.0
	 */
	class Charitable_Donation extends Charitable_Abstract_Donation {

		/**
		 * The type of donation.
		 *
		 * @since 1.4.0
		 *
		 * @var   string
		 */
		public $donation_type = 'simple';

		/**
		 * Process a refund.
		 *
		 * @since  1.0.0
		 *
		 * @param  float  $refund_amount The amount to be refunded.
		 * @param  string $message       The message to add to the donation log.
		 * @return void
		 */
		public function process_refund( $refund_amount, $message = '' ) {
			$refund_log           = get_post_meta( $this->ID, 'donation_refund', true );
			$total_refund         = isset( $refund_log['total_refund'] ) ? $refund_log['total_refund'] : 0;
			$refunds_per_campaign = isset( $refund_log['campaign_refunds'] ) ? $refund_log['campaign_refunds'] : array();

			if ( charitable_is_debug( 'square' ) ) {
				// phpcs:disable
				error_log( 'process_refund - Refund amount: ' . $refund_amount );
				error_log( 'process_refund - Total refund: ' . $total_refund );
				error_log( 'process_refund - Refunds per campaign: ' . print_r( $refunds_per_campaign, true ) );
				// phpcs:enable
			}

			foreach ( $this->get_campaign_donations() as $campaign_donation ) {

				if ( 0 === $refund_amount ) {
					break;
				}

				if ( ! isset( $refunds_per_campaign[ $campaign_donation->campaign_id ] ) ) {
					$refunds_per_campaign[ $campaign_donation->campaign_id ] = array();
				}

				/**
				 * Calculate the amount to be refunded out of this particular campaign's amount.
				 *
				 * This takes into account any amounts that have already been refunded, to find the
				 * amount that remains credited towards to the campaign.
				 */
				$campaign_remaining_amount = $campaign_donation->amount - array_sum( $refunds_per_campaign[ $campaign_donation->campaign_id ] );

				if ( $campaign_remaining_amount > $refund_amount ) {
					$campaign_refund_amount = $refund_amount;
				} else {
					$campaign_refund_amount = $campaign_remaining_amount;
				}

				$refunds_per_campaign[ $campaign_donation->campaign_id ][] = $campaign_refund_amount;

				/* Reduce the remaining amount to refund. */
				$refund_amount -= $campaign_refund_amount;

				/* Increase the total refund amount. */
				$total_refund += $campaign_refund_amount;
			}

			$refund_log = array(
				'time'             => time(),
				'message'          => $message,
				'campaign_refunds' => $refunds_per_campaign,
				'total_refund'     => $total_refund,
			);

			update_post_meta( $this->ID, 'donation_refund', $refund_log );

			if ( charitable_is_debug( 'square' ) ) {
				// phpcs:disable
				error_log( 'process_refund - Refund log: ' . print_r( $refund_log, true ) );
				// phpcs:enable
			}

			$this->update_status( 'charitable-refunded' );
		}
	}

endif;

```