Google

Edit File: donations.php

<?php
/*
Seamless Donations by David Gewirtz, adopted from Allen Snook

Lab Notes: http://zatzlabs.com/lab-notes/
Plugin Page: http://zatzlabs.com/seamless-donations/
Contact: http://zatzlabs.com/contact-us/

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

function seamless_donations_create_donation_from_transaction_audit_table( $transaction_form_data ) {
	// Create a new donation record
	$transaction_form_data = apply_filters( 'seamless_donations_donation_post_gateway_form_data', $transaction_form_data );
	$donation_id = dgx_donate_create_empty_donation_record();
	dgx_donate_debug_log( 'Donation ID assigned: ' . $donation_id );

$meta_map = dgx_donate_get_meta_map();
	dgx_donate_debug_log( 'Meta map retrieved.' );

foreach ( (array) $meta_map as $transaction_form_data_key => $postmeta_key ) {
		if ( $transaction_form_data[ $transaction_form_data_key ] != '' ) {
			// using switch so new special cases are easier to add
			dgx_donate_debug_log( '== Processing postmeta key: ' . $postmeta_key );
			switch ( $postmeta_key ) {
				case '_dgx_donate_designated_fund':
					// save fund data from transaction into the donation record
					if ( $transaction_form_data[ $transaction_form_data_key ] != 0 ) {
						$fund_id = $transaction_form_data[ $transaction_form_data_key ];

// lookup the fund name from the id and save into the post meta data
						$fund_name = get_the_title( $fund_id );
						update_post_meta( $donation_id, '_dgx_donate_designated_fund', $fund_name );

// update the donation record with the fund id -- also link the funds to the donations
						update_post_meta( $donation_id, '_dgx_donate_designated_fund_id', $fund_id );

// update the donations list to point to this donation id
						seamless_donations_add_donation_id_to_fund( $fund_id, $donation_id );

// update the donation total for the fund
						seamless_donations_add_donation_amount_to_fund_total( $donation_id, $fund_id );
					}
					break;
				default:
					update_post_meta( $donation_id, $postmeta_key, $transaction_form_data[ $transaction_form_data_key ] );
			}
		}
	}
	dgx_donate_debug_log( 'Meta map mapping complete.' );

$donor_id = seamless_donations_update_donor_data( $donation_id );

dgx_donate_debug_log( 'Updating donation post meta...' );
	$email = get_post_meta( $donation_id, '_dgx_donate_donor_email', true );
	if ( $email != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_email', $email );
	}
	$employer = get_post_meta( $donation_id, '_dgx_donate_employer_name', true );
	if ( $employer != false ) {
		update_post_meta( $donor_id, '_dgx_donate_employer_name', $employer );
	}
	$occupation = get_post_meta( $donation_id, '_dgx_donate_occupation', true );
	if ( $occupation != false ) {
		update_post_meta( $donor_id, '_dgx_donate_occupation', $occupation );
	}
	$phone = get_post_meta( $donation_id, '_dgx_donate_donor_phone', true );
	if ( $phone != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_phone', $phone );
	}
	$address = get_post_meta( $donation_id, '_dgx_donate_donor_address', true );
	if ( $address != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_address', $address );
	}
	$address2 = get_post_meta( $donation_id, '_dgx_donate_donor_address2', true );
	if ( $address2 != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_address2', $address2 );
	}
	$city = get_post_meta( $donation_id, '_dgx_donate_donor_city', true );
	if ( $city != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_city', $city );
	}
	$state = get_post_meta( $donation_id, '_dgx_donate_donor_state', true );
	if ( $state != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_state', $state );
	}
	$province = get_post_meta( $donation_id, '_dgx_donate_donor_province', true );
	if ( $province != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_province', $province );
	}
	$country = get_post_meta( $donation_id, '_dgx_donate_donor_country', true );
	if ( $country != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_country', $country );
	}
	$zip = get_post_meta( $donation_id, '_dgx_donate_donor_zip', true );
	if ( $zip != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_zip', $zip );
	}
	$anon = get_post_meta( $donation_id, '_dgx_donate_anonymous', true );
	if ( $anon == 'on' ) {
		update_post_meta( $donor_id, '_dgx_donate_anonymous', 'yes' );
	}
	$transaction_form_data = apply_filters( 'seamless_donations_donation_update_post_meta', $transaction_form_data, $donation_id);
	dgx_donate_debug_log( 'Updating donation post meta complete. Returning donation id: ' . $donation_id );

return $donation_id;
}

function seamless_donations_add_donation_amount_to_fund_total( $donation_id, $fund_id ) {
	// update the donation total for the fund
	$donation_amount = get_post_meta( $donation_id, '_dgx_donate_amount', true );
	$fund_total      = get_post_meta( $fund_id, '_dgx_donate_fund_total', true );

if ( $donation_amount != '' ) {
		if ( $fund_total == '' ) {
			$fund_total = 0.0;
		} else {
			$fund_total = floatval( $fund_total );
		}
		$donation_amount = floatval( $donation_amount );
		$fund_total     += $donation_amount;
		$fund_total      = strval( $fund_total );
		update_post_meta( $fund_id, '_dgx_donate_fund_total', $fund_total );
	}
}

function seamless_donations_create_donation_from_donation( $old_donation_id ) {
	// Create a new donation record by cloning an old one (useful for repeating donations)
	dgx_donate_debug_log( "About to create donation from old donation $old_donation_id" );
	$new_donation_id = dgx_donate_create_empty_donation_record();
	dgx_donate_debug_log( "New donation id = $new_donation_id" );

$meta_map = dgx_donate_get_meta_map();

foreach ( (array) $meta_map as $transient_data_key => $postmeta_key ) {
		$old_donation_meta_value = get_post_meta( $old_donation_id, $postmeta_key, true );
		update_post_meta( $new_donation_id, $postmeta_key, $old_donation_meta_value );
	}

seamless_donations_update_donor_data( $old_donation_id, $new_donation_id );

dgx_donate_debug_log( "done with dgx_donate_create_donation_from_donation, returning new id $new_donation_id" );

return $new_donation_id;
}

function seamless_donations_create_donation_from_paypal_data() {
	// PROBABLY DEPRECATED

// Create a new donation record from paypal data (if transient no longer exists for some reason)
	// with the addition of the transaction audit table in 4.0.5, this will probably not ever be called

dgx_donate_debug_log( 'About to create donation from paypal post data' );
	$new_donation_id = dgx_donate_create_empty_donation_record();
	dgx_donate_debug_log( "New donation id = $new_donation_id" );

// @todo - loop over the meta map translating paypal keys into our keys
	// @todo ADDRESS

// not running a nonce here. Data is not at risk, and this entire mechanism is slated to go away
	$payment_gross = isset( $_POST['payment_gross'] ) ? sanitize_text_field( $_POST['payment_gross'] ) : '';
	$mc_gross      = isset( $_POST['mc_gross'] ) ? sanitize_text_field( $_POST['mc_gross'] ) : '';

$amount = empty( $payment_gross ) ? $mc_gross : $payment_gross;

update_post_meta( $new_donation_id, '_dgx_donate_donor_first_name', sanitize_text_field( $_POST['first_name'] ) );
	update_post_meta( $new_donation_id, '_dgx_donate_donor_last_name', sanitize_text_field( $_POST['last_name'] ) );
	update_post_meta( $new_donation_id, '_dgx_donate_donor_email', sanitize_email( $_POST['payer_email'] ) );
	update_post_meta( $new_donation_id, '_dgx_donate_amount', $amount );

$donor_id = seamless_donations_update_donor_data( $new_donation_id );

// update the donor detail options
	$email = get_post_meta( $new_donation_id, '_dgx_donate_donor_email', true );
	if ( $email != false ) {
		update_post_meta( $donor_id, '_dgx_donate_donor_email', $email );
	}

dgx_donate_debug_log( "Done with dgx_donate_create_donation_from_paypal_data, returning new id $new_donation_id" );

return $new_donation_id;
}

function seamless_donations_update_donor_data( $old_donation_id, $new_donation_id = '' ) {
	// this function creates the donor record. It takes the donation id as a parameter
	// it supports a second donation id for those cases when the donation is updated from a previous donation record,
	// as in the case of a repeating donation

if ( $new_donation_id == '' ) {
		$new_donation_id = $old_donation_id;
	}
	dgx_donate_debug_log( 'Preparing to update donor data...' );

// Now build in the donor data
	$first = get_post_meta( $old_donation_id, '_dgx_donate_donor_first_name', true );
	$last  = get_post_meta( $old_donation_id, '_dgx_donate_donor_last_name', true );

// now move that data into a donor post type
	$donor_name = sanitize_text_field( $first . ' ' . $last );
	$donor_slug = sanitize_title( $donor_name );

$donor = get_page_by_path( $donor_slug, OBJECT, 'donor' );

if ( $donor == null ) {
		// create the new custom donor post
		$donor_array = array(
			'post_title'   => $donor_name,
			'post_content' => '',
			'post_status'  => 'publish',
			'post_type'    => 'donor',
		);
		$donor_id    = wp_insert_post( $donor_array, true );
	} else {
		$donor_id = $donor->ID;
	}
	dgx_donate_debug_log( 'Donor data updated. Updating cross-index data...' );

// record the donor id in the donation record
	update_post_meta( $new_donation_id, '_dgx_donate_donor_id', $donor_id );

// update the donations to point to this donation id
	seamless_donations_add_donation_id_to_donor( $new_donation_id, $donor_id );

dgx_donate_debug_log( 'Updating donor total...' );
	// update the donation total for the donor
	seamless_donations_add_donation_amount_to_donor_total( $new_donation_id, $donor_id );

// update basic donor info
	update_post_meta( $donor_id, '_dgx_donate_donor_first_name', $first );
	update_post_meta( $donor_id, '_dgx_donate_donor_last_name', $last );
	dgx_donate_debug_log( 'Donor update completed, returning donor id:' . $donor_id );

return $donor_id;
}

function seamless_donations_add_donation_amount_to_donor_total( $donation_id, $donor_id ) {
	// update the donation total for the donor
	$donation_amount = get_post_meta( $donation_id, '_dgx_donate_amount', true );
	$donor_total     = get_post_meta( $donor_id, '_dgx_donate_donor_total', true );

if ( $donation_amount != '' ) {
		if ( $donor_total == '' ) {
			$donor_total = 0.0;
		} else {
			$donor_total = floatval( $donor_total );
		}
		$donation_amount = floatval( $donation_amount );
		$donor_total    += $donation_amount;
		$donor_total     = strval( $donor_total );
		update_post_meta( $donor_id, '_dgx_donate_donor_total', $donor_total );
	}
}

function seamless_donations_get_donation_detail_link( $donationID ) {
	$detailUrl  = get_admin_url();
	$detailUrl .= "post.php?post=$donationID&action=edit&post_type=donation";

return $detailUrl;
}

function seamless_donations_get_unreferenced_donation_ids( $donation_id ) {
	// this function checks to see if a donation record is valid by seeing if it's referenced by a donor

// First, check if the $donation_id has a corresponding donor id in postmeta
	$donor_id = get_post_meta( $donation_id, '_dgx_donate_donor_id', true );

// If a donor ID exists, validate it against the donor's donations
	if ( !empty( $donor_id ) ) {
		// Get the donor's donations
		$donor_donations = get_post_meta( $donor_id, '_dgx_donate_donor_donations', true );
		if ( !empty( $donor_donations ) ) {
			// Check if the donation ID is in the donor's list of donations
			$donations_array = explode( ',', $donor_donations );
			if ( in_array( $donation_id, $donations_array ) ) {
				return $donor_id; // The donation ID is valid for this donor
			}
		}
	} else {
		// If the donor ID does not exist, scan all donors to find a match
		$args = array(
			'post_type'      => 'donor', // Replace with your actual custom post type for donors
			'posts_per_page' => -1, // Retrieve all donors
			'fields'         => 'ids', // Only get the post IDs to optimize performance
		);

$donor_ids = get_posts( $args );

// Loop through each donor ID to find a matching donation ID in post meta
		foreach ( $donor_ids as $potential_donor_id ) {
			$donor_donations = get_post_meta( $potential_donor_id, '_dgx_donate_donor_donations', true );
			if ( !empty( $donor_donations ) ) {
				$donations_array = explode( ',', $donor_donations );
				if ( in_array( $donation_id, $donations_array ) ) {
					return $potential_donor_id; // Found a match
				}
			}
		}
	}

// If no match found, return 0
	return 0;
}

function seamless_donations_get_unreferenced_donation_records() {
	// Returns a comma-spearated list containing the ids of bad donation records

// Initialize an empty string to store bad donation IDs
	$bad_donations = '';

// Arguments for get_posts to fetch donation posts
	$args = array(
		'post_type'      => 'donation', // Replace with your actual custom post type for donations
		'posts_per_page' => -1, // Retrieve all donation posts
		'fields'         => 'ids', // Only get the post IDs to optimize performance
	);

// Get all donation post IDs
	$donation_ids = get_posts( $args );

// Loop through each donation ID
	foreach ( $donation_ids as $donation_id ) {
		// Validate the donation ID
		if ( seamless_donations_get_unreferenced_donation_ids( $donation_id ) == 0 ) {
			// If the donation is invalid, add it to the bad donations string
			$bad_donations .= (empty($bad_donations) ? '' : ',') . $donation_id;
		}
	}

// To get the number of bad donations found
	// count( explode( ',', $bad_donations ) );

return $bad_donations;
}

function seamless_donations_get_duplicate_donation_suspect_list() {
	// Initialize an empty array to hold groups of suspect donations
	$suspect_groups = array();

// Get all posts of the custom post type 'donation'
	$args = array(
		'post_type'      => 'donation',
		'posts_per_page' => -1, // Retrieve all posts
		'post_status'    => 'publish'
	);

$donation_posts = get_posts($args);

// Collect donation data
	$donation_data = array();
	foreach ($donation_posts as $post) {
		$donor_id = get_post_meta($post->ID, '_dgx_donate_donor_id', true);
		$session_id = get_post_meta($post->ID, '_dgx_donate_session_id', true);

// Skip if either donor_id or session_id is empty
		if (empty($donor_id) || empty($session_id)) {
			continue;
		}

$key = $donor_id . '_' . $session_id;
		$donation_data[$key][] = array(
			'post_id' => $post->ID,
			'post_date' => strtotime($post->post_date)
		);
	}

// Identify initial suspect groups
	foreach ($donation_data as $key => $donations) {
		if (count($donations) > 1) {
			$suspect_groups[$key] = $donations;
		}
	}

// Refine suspect groups based on creation time
	foreach ($suspect_groups as $key => &$group) {
		$refined_group = array();
		foreach ($group as $index => $donation) {
			foreach ($group as $compare) {
				if ($donation['post_id'] != $compare['post_id'] && abs($donation['post_date'] - $compare['post_date']) <= 3600) {
					$refined_group[] = $donation['post_id'];
					break;
				}
			}
		}
		$group = array_unique($refined_group);
	}

// Remove empty groups
	$suspect_groups = array_filter($suspect_groups, function($group) {
		return !empty($group);
	});

return $suspect_groups;
}

function seamless_donations_get_donation_record_count() {
	// Arguments for WP_Query to count donation posts
	$args = array(
		'post_type'      => 'donation', // Replace with your actual custom post type for donations
		'posts_per_page' => -1, // We set this to -1 to get all posts
		'fields'         => 'ids' // We only need the IDs to count the posts
	);

// Create a new WP_Query instance with the specified arguments
	$query = new WP_Query( $args );

// Return the total number of donation posts found
	return $query->found_posts;
}