laipower/wp-content/plugins/easy-digital-downloads/includes/admin/upgrades/v3/class-data-migrator.php

1534 lines
50 KiB
PHP
Raw Normal View History

<?php
/**
* 3.0 Data Migration - Data Migrator.
*
* @subpackage Admin/Upgrades/v3
* @copyright Copyright (c) 2018, Easy Digital Downloads, LLC
* @license http://opensource.org/licenses/gpl-2.0.php GNU Public License
* @since 3.0
*/
namespace EDD\Admin\Upgrades\v3;
// Exit if accessed directly
defined( 'ABSPATH' ) || exit;
/**
* Data_Migrator Class.
*
* This class holds all the logic for migrating data to custom tables as part
* of EDD 3.0.
*
* @since 3.0
*/
class Data_Migrator {
/**
* Customer addresses.
*
* @since 3.0
*
* @param object $data Data to migrate.
* @param string $type The type of address this is.
*/
public static function customer_addresses( $data = null, $type = 'billing' ) {
// Bail if no data passed.
if ( ! $data ) {
return;
}
$address = maybe_unserialize( $data->meta_value );
$user_id = absint( $data->user_id );
$customer = edd_get_customer_by( 'user_id', $user_id );
$address = wp_parse_args( $address, array(
'line1' => '',
'line2' => '',
'city' => '',
'state' => '',
'zip' => '',
'country' => '',
) );
$address_to_check = array_filter( $address );
// Do not migrate empty addresses.
if ( empty( $address_to_check ) ) {
return;
}
if ( $customer ) {
edd_maybe_add_customer_address(
array(
'customer_id' => $customer->id,
'is_primary' => true,
'name' => $customer->name,
'address' => $address['line1'],
'address2' => $address['line2'],
'city' => $address['city'],
'region' => $address['state'],
'postal_code' => $address['zip'],
'country' => $address['country'],
'date_created' => $customer->date_created,
)
);
}
}
/**
* Customer email addresses.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function customer_email_addresses( $data = null ) {
// Bail if no data passed.
if ( ! isset( $data->edd_customer_id ) || ! isset( $data->meta_value ) ) {
return;
}
$customer = edd_get_customer( absint( $data->edd_customer_id ) );
if ( ! $customer ) {
return;
}
edd_add_customer_email_address(
array(
'customer_id' => $customer->id,
'email' => $data->meta_value,
'date_created' => $customer->date_created,
)
);
}
/**
* Customer notes.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function customer_notes( $data = null ) {
// Bail if no data passed.
if ( ! $data ) {
return;
}
$customer_id = absint( $data->id );
if ( property_exists( $data, 'notes' ) && ! empty( $data->notes ) ) {
$notes = array_reverse( array_filter( explode( "\n\n", $data->notes ) ) );
$notes = array_map( function( $val ) {
return explode( ' - ', $val );
}, $notes );
if ( ! empty( $notes ) ) {
foreach ( $notes as $note ) {
try {
$date = isset( $note[0] )
? EDD()->utils->date( $note[0], edd_get_timezone_id() )->setTimezone( 'UTC' )->toDateTimeString()
: '';
} catch ( \Exception $e ) {
// An empty date will be changed to current time in BerlinDB.
$date = '';
}
$note_content = isset( $note[1] )
? $note[1]
: '';
edd_add_note( array(
'user_id' => 0,
'object_id' => $customer_id,
'object_type' => 'customer',
'content' => $note_content,
'date_created' => $date,
'date_modified' => $date,
) );
}
}
}
}
/**
* Discounts.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function discounts( $data = null ) {
// Bail if no data passed.
if ( ! $data ) {
return;
}
$data = get_post( $data->ID );
$args = array();
$meta = get_post_custom( $data->ID );
$meta_to_migrate = array();
$core_meta = array(
'code',
'name',
'status',
'uses',
'max_uses',
'amount',
'start',
'expiration',
'type',
'min_price',
'product_reqs',
'product_condition',
'excluded_products',
'is_not_global',
'is_single_use',
);
foreach ( $meta as $key => $value ) {
$value = maybe_unserialize( $value[0] );
if ( false === strpos( $key, '_edd_discount' ) ) {
// This is custom meta from another plugin that needs to be migrated to the new meta table.
$meta_to_migrate[ $key ] = $value;
continue;
}
$meta_key = str_replace( '_edd_discount_', '', $key );
if ( ! in_array( $meta_key, $core_meta, true ) ) {
$meta_to_migrate[ $meta_key ] = $value;
continue;
}
$args[ $meta_key ] = $value;
}
// If the discount name was not stored in post_meta, use value from the WP_Post object.
if ( ! isset( $args['name'] ) ) {
$args['name'] = $data->post_title;
}
$args['id'] = $data->ID;
$args['date_created'] = $data->post_date_gmt;
$args['date_modified'] = $data->post_modified_gmt;
// Use edd_store_discount() so any legacy data is handled correctly.
$discount_id = edd_store_discount( $args );
// Migrate any additional meta.
if ( ! empty( $meta_to_migrate ) ) {
foreach ( $meta_to_migrate as $key => $value ) {
edd_add_adjustment_meta( $discount_id, $key, $value );
}
}
}
/**
* Logs.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function logs( $data = null ) {
global $wpdb;
// Bail if no data passed.
if ( ! $data ) {
return;
}
$meta_to_migrate = array();
if ( 'file_download' === $data->slug ) {
$meta = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM {$wpdb->postmeta} WHERE post_id = %d", absint( $data->ID ) ) );
$post_meta = array();
foreach ( $meta as $meta_item ) {
$post_meta[ $meta_item->meta_key ] = maybe_unserialize( $meta_item->meta_value );
}
$log_data = array(
'product_id' => $data->post_parent,
/*
* Custom Deliverables was overriding the file ID to be a string instead of an integer. The preg_replace
* allows us to try to salvage the file ID from that string.
*/
'file_id' => isset( $post_meta['_edd_log_file_id'] ) ? preg_replace( '/[^0-9]/', '', $post_meta['_edd_log_file_id'] ) : 0,
'order_id' => isset( $post_meta['_edd_log_payment_id'] ) ? $post_meta['_edd_log_payment_id'] : 0,
'price_id' => isset( $post_meta['_edd_log_price_id'] ) ? $post_meta['_edd_log_price_id'] : 0,
'customer_id' => isset( $post_meta['_edd_log_customer_id'] ) ? $post_meta['_edd_log_customer_id'] : 0,
'ip' => isset( $post_meta['_edd_log_ip'] ) ? $post_meta['_edd_log_ip'] : '',
'date_created' => $data->post_date_gmt,
'date_modified' => $data->post_modified_gmt,
);
$meta_to_remove = array(
'_edd_log_file_id',
'_edd_log_payment_id',
'_edd_log_price_id',
'_edd_log_customer_id',
'_edd_log_ip',
'_edd_log_user_id',
);
// If the log doesn't have a customer ID, but does have a user ID, keep the user ID as metadata.
if ( empty( $log_data['customer_id'] ) && ! empty( $post_meta['_edd_log_user_id'] ) && ! in_array( $post_meta['_edd_log_user_id'], array( 0, -1 ) ) ) {
$meta_to_remove = array_diff( $meta_to_remove, array( '_edd_log_user_id' ) );
}
$meta_to_migrate = $post_meta;
$new_log_id = edd_add_file_download_log( $log_data );
$add_meta_function = 'edd_add_file_download_log_meta';
/**
* Triggers after a file download log has been migrated.
*
* @since 3.0
*
* @param int $new_log_id ID of the newly created log.
* @param object $data Data from the posts table. (Essentially a `WP_Post`, without being that object.)
* @param array $post_meta All meta associated with this log.
*/
do_action( 'edd_30_migrate_file_download_log', $new_log_id, $data, $post_meta );
} elseif ( 'api_request' === $data->slug ) {
$meta = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM {$wpdb->postmeta} WHERE post_id = %d", absint( $data->ID ) ) );
$post_meta = array();
foreach ( $meta as $meta_item ) {
$post_meta[ $meta_item->meta_key ] = maybe_unserialize( $meta_item->meta_value );
}
$post_meta = wp_parse_args(
$post_meta,
array(
'_edd_log_request_ip' => '',
'_edd_log_user' => 0,
'_edd_log_key' => 'public',
'_edd_log_token' => 'public',
'_edd_log_version' => '',
'_edd_log_time' => '',
)
);
if ( empty( $post_meta['_edd_log_token'] ) ) {
$post_meta['_edd_log_token'] = 'public' === $post_meta['_edd_log_key'] ? 'public' : '';
}
$log_data = array(
'ip' => $post_meta['_edd_log_request_ip'],
'user_id' => $post_meta['_edd_log_user'],
'api_key' => $post_meta['_edd_log_key'],
'token' => $post_meta['_edd_log_token'],
'version' => $post_meta['_edd_log_version'],
'time' => $post_meta['_edd_log_time'],
'request' => $data->post_excerpt,
'error' => $data->post_content,
'date_created' => $data->post_date_gmt,
'date_modified' => $data->post_modified_gmt,
);
$meta_to_remove = array(
'_edd_log_request_ip',
'_edd_log_user',
'_edd_log_key',
'_edd_log_token',
'_edd_log_version',
'_edd_log_time',
);
$meta_to_migrate = $post_meta;
$new_log_id = edd_add_api_request_log( $log_data );
$add_meta_function = 'edd_add_api_request_log_meta';
} else {
$post_meta = get_post_custom( $data->ID );
foreach ( $post_meta as $key => $value ) {
$meta_to_migrate[ $key ] = maybe_unserialize( $value[0] );
}
$log_data = array(
'object_id' => $data->post_parent,
'object_type' => 'download',
'user_id' => ! empty( $meta_to_migrate['_edd_log_user'] ) ? $meta_to_migrate['_edd_log_user'] : $data->post_author,
'type' => $data->slug,
'title' => $data->post_title,
'content' => $data->post_content,
'date_created' => $data->post_date_gmt,
'date_modified' => $data->post_modified_gmt,
);
$meta_to_remove = array(
'_edit_lock',
'_edd_log_user',
);
$new_log_id = edd_add_log( $log_data );
$add_meta_function = 'edd_add_log_meta';
}
if ( ! is_callable( $add_meta_function ) || empty( $meta_to_migrate ) ) {
return;
}
foreach ( $meta_to_migrate as $key => $value ) {
if ( ! in_array( $key, $meta_to_remove, true ) ) {
// Strip off `_edd_log_` prefix.
$key = str_replace( '_edd_log_', '', $key );
$add_meta_function( $new_log_id, $key, $value );
}
}
}
/**
* Order notes.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function order_notes( $data = null ) {
// Bail if no data passed.
if ( ! $data ) {
return;
}
$note_data = array(
'object_id' => $data->object_id,
'object_type' => 'order',
'date_created' => $data->comment_date_gmt,
'date_modified' => $data->comment_date_gmt,
'content' => $data->comment_content,
'user_id' => $data->user_id,
);
$id = edd_add_note( $note_data );
$meta = get_comment_meta( $data->comment_ID );
if ( ! empty( $meta ) ) {
foreach ( $meta as $key => $value ) {
edd_add_note_meta( $id, $key, $value );
}
}
}
public static function orders( $data = null ) {
// Bail if no data passed.
if ( ! $data ) {
return false;
}
/** Create a new order ***************************************/
global $wpdb;
// Get's all the post meta for this payment.
$meta = get_post_custom( $data->ID );
$payment_meta = maybe_unserialize( $meta['_edd_payment_meta'][0] );
$user_info = isset( $payment_meta['user_info'] ) ? maybe_unserialize( $payment_meta['user_info'] ) : array();
// It is possible that for some reason the entire unserialized array is invalid, so before trying to use it, let's just verify we got an array back.
if ( ! is_array( $payment_meta ) ) {
// Dump this data to a file to ensure we keep it for later use.
edd_debug_log( '==== Failed Migrating Legacy Payment ID: ' . $data->ID . ' ====', true );
edd_debug_log( 'Reason: Payment Meta Unserialization failed.', true );
edd_debug_log( '- Post Data', true );
foreach ( get_object_vars( $data ) as $key => $value ) {
edd_debug_log( '-- ' . $key . ': ' . $value, true );
}
edd_debug_log( '- Post Meta', true );
foreach ( $meta as $key => $value_array ) {
edd_debug_log( '-- Meta Key: ' . $key, true );
foreach ( $value_array as $value ) {
edd_debug_log( '--- ' . $value, true );
}
}
return false;
}
// Some old EDD data has the user info serialized, but starting with something other than a: so it can't be unserialized
$user_info = self::fix_possible_serialization( $user_info );
$user_info = maybe_unserialize( $user_info );
if ( ! is_array( $user_info ) ) {
$user_info = array();
}
/**
* Last chance to filter payment meta before we use it!
* Note: If modifying `cart_details`, then it's recommended that you first run
* `EDD\Admin\Upgrades\v3\Data_Migrator::fix_possible_serialization()`
* before making adjustments.
*
* @since 3.0
*
* @param array $payment_meta Payment meta.
* @param int $payment_id ID of the payment.
* @param array $meta All post meta.
*/
$payment_meta = apply_filters( 'edd_30_migration_payment_meta', $payment_meta, $data->ID, $meta );
$order_number = isset( $meta['_edd_payment_number'][0] ) ? $meta['_edd_payment_number'][0] : '';
$user_id = isset( $meta['_edd_payment_user_id'][0] ) && ! empty( $meta['_edd_payment_user_id'][0] ) ? $meta['_edd_payment_user_id'][0] : 0;
$ip = isset( $meta['_edd_payment_user_ip'][0] ) ? $meta['_edd_payment_user_ip'][0] : '';
$mode = isset( $meta['_edd_payment_mode'][0] ) ? $meta['_edd_payment_mode'][0] : 'live';
$gateway = isset( $meta['_edd_payment_gateway'][0] ) && ! empty( $meta['_edd_payment_gateway'][0] ) ? $meta['_edd_payment_gateway'][0] : 'manual';
$customer_id = isset( $meta['_edd_payment_customer_id'][0] ) ? $meta['_edd_payment_customer_id'][0] : 0;
$date_completed = isset( $meta['_edd_completed_date'][0] ) ? $meta['_edd_completed_date'][0] : null;
$purchase_key = isset( $meta['_edd_payment_purchase_key'][0]) ? $meta['_edd_payment_purchase_key'][0] : false;
$purchase_email = isset( $meta['_edd_payment_user_email'][0] ) ? $meta['_edd_payment_user_email'][0] : $payment_meta['email'];
// Get the customer object
if ( ! empty( $customer_id ) ) {
$customer = edd_get_customer( $customer_id );
} else if ( ! empty( $purchase_email ) ) {
$customer = edd_get_customer_by( 'email', $purchase_email );
if ( $customer ) {
$customer_id = $customer->id;
}
}
if ( false === $purchase_key ) {
$purchase_key = isset( $payment_meta['key'] ) ? $payment_meta['key'] : '';
}
// Do not use -1 as the user ID.
$user_id = ( -1 === $user_id )
? 0
: $user_id;
// Account for possible double serialization of the cart_details
$cart_details = isset( $payment_meta['cart_details'] ) ? maybe_unserialize( $payment_meta['cart_details'] ) : array();
// Some old EDD data has the cart details serialized, but starting with something other than a: so it can't be unserialized
$cart_details = self::fix_possible_serialization( $cart_details );
// Some old cart data does not contain subtotal or discount information. Normalize it.
$cart_details = self::normalize_cart_details( $cart_details );
// Account for possible double serialization of the cart_details
$cart_downloads = isset( $payment_meta['downloads'] ) ? maybe_unserialize( $payment_meta['downloads'] ) : array();
// Some old EDD data has the downloads serialized, but starting with something other than a: so it can't be unserialized
$cart_downloads = self::fix_possible_serialization( $cart_downloads );
// If the order status is 'publish' convert it to the new 'complete' status.
$order_status = 'publish' === $data->post_status ? 'complete' : $data->post_status;
// If there are no items, and it's abandoned, just return, since this isn't a valid order.
if ( 'abandoned' === $order_status && empty( $cart_downloads ) && empty( $cart_details ) ) {
edd_debug_log( 'Skipping order ' . $data->ID . ' due to abandoned status and no products.', true );
return false;
}
$order_subtotal = 0;
$order_tax = 0;
$order_discount = 0;
$order_total = 0;
// Track the total value of added fees in case the Order was initially migrated
// without _edd_payment_total or _edd_payment_tax and manual calculation was needed.
$order_fees_tax = 0;
$order_fees_total = 0;
$order_items_fees_tax = 0;
// Retrieve the tax amount from metadata if available.
$meta_tax = isset( $meta['_edd_payment_tax'] )
? $meta['_edd_payment_tax']
: false;
if ( false !== $meta_tax ) {
$meta_tax = maybe_unserialize( $meta_tax );
$order_tax = (float) $meta_tax[0];
}
$meta_total = false;
// Retrieve the total amount from metadata if available.
if ( isset( $meta['_edd_payment_total'] ) ) {
$meta_total = maybe_unserialize( $meta['_edd_payment_total'] );
$order_total = (float) $meta_total[0];
} elseif ( isset( $payment_meta['amount'] ) ) {
$meta_total = maybe_unserialize( $payment_meta['amount'] );
$order_total = (float) $meta_total;
}
// In some cases (very few) there is no cart details...so we have to just avoid this part.
if ( ! empty( $cart_details ) && is_array( $cart_details ) ) {
// Loop through the items in the purchase to build the totals.
foreach ( $cart_details as $cart_item ) {
$order_subtotal += $cart_item['subtotal'];
// Add the cart line item tax amount if a total is not available on the order.
if ( false === $meta_tax ) {
$order_tax += $cart_item['tax'];
}
$order_discount += $cart_item['discount'];
// Add the cart line item price amount (includes tax, order item fee, _but not order item fee tax_)
// if a total is not available on the order.
if ( false === $meta_total ) {
$order_total += $cart_item['price'];
}
}
}
// Account for a situation where the post_date_gmt is set to 0000-00-00 00:00:00
$date_created_gmt = $data->post_date_gmt;
if ( '0000-00-00 00:00:00' === $date_created_gmt ) {
$date_created_gmt = new \DateTime( $data->post_date );
$modified_time = new \DateTime( $data->post_modified );
$modified_time_gmt = new \DateTime( $data->post_modified_gmt );
if ( $modified_time != $modified_time_gmt ) {
$diff = $modified_time_gmt->diff( $modified_time );
$time_diff = 'PT';
// Add hours to the offset string.
if ( ! empty( $diff->h ) ) {
$time_diff .= $diff->h . 'H';
}
// Add minutes to the offset string.
if ( ! empty( $diff->i ) ) {
$time_diff .= $diff->i . 'M';
}
// Account for -/+ GMT offsets.
try {
if ( 1 === $diff->invert ) {
$date_created_gmt->add( new \DateInterval( $time_diff ) );
} else {
$date_created_gmt->sub( new \DateInterval( $time_diff ) );
}
} catch ( \Exception $e ) {
}
}
$date_created_gmt = $date_created_gmt->format('Y-m-d H:i:s');
}
// Maybe convert the date completed to UTC or backfill the date_completed.
$non_completed_statuses = apply_filters( 'edd_30_noncomplete_statuses', edd_get_incomplete_order_statuses() );
if ( ! in_array( $order_status, $non_completed_statuses, true ) ) {
if ( ! empty( $date_completed ) ) { // Update the data_completed to the UTC.
try {
$date_completed = EDD()->utils->date( $date_completed, edd_get_timezone_id() )->setTimezone( 'UTC' )->toDateTimeString();
} catch ( \Exception $e ) {
$date_completed = $date_created_gmt;
}
} elseif ( is_null( $date_completed ) ) { // Backfill a missing date_completed (for things like recurring payments).
$date_completed = $date_created_gmt;
}
}
if ( 'manual_purchases' === $gateway && isset( $meta['_edd_payment_total'][0] ) ) {
$gateway = 'manual';
$order_total = $meta['_edd_payment_total'][0];
}
/*
* Build up the order address data. Actual insertion happens later, but we need this now to figure out the tax rate.
*/
// First & last name.
$user_info['first_name'] = ! empty( $user_info['first_name'] )
? $user_info['first_name']
: '';
$user_info['last_name'] = ! empty( $user_info['last_name'] )
? $user_info['last_name']
: '';
// Add order address.
$user_info['address'] = ! empty( $user_info['address'] )
? $user_info['address']
: array();
$user_info['address'] = wp_parse_args( $user_info['address'], array(
'line1' => '',
'line2' => '',
'city' => '',
'zip' => '',
'country' => '',
'state' => '',
) );
$order_address_data = array(
'name' => trim( $user_info['first_name'] . ' ' . $user_info['last_name'] ),
'address' => isset( $user_info['address']['line1'] ) ? $user_info['address']['line1'] : '',
'address2' => isset( $user_info['address']['line2'] ) ? $user_info['address']['line2'] : '',
'city' => isset( $user_info['address']['city'] ) ? $user_info['address']['city'] : '',
'region' => isset( $user_info['address']['state'] ) ? $user_info['address']['state'] : '',
'country' => isset( $user_info['address']['country'] ) && array_key_exists( strtoupper( $user_info['address']['country'] ), edd_get_country_list() )
? $user_info['address']['country']
: '',
'postal_code' => isset( $user_info['address']['zip'] ) ? $user_info['address']['zip'] : '',
'date_created' => $date_created_gmt,
);
$tax_rate_id = null;
$tax_rate = isset( $meta['_edd_payment_tax_rate'][0] )
? (float) $meta['_edd_payment_tax_rate'][0]
: 0.00;
/*
* Previously tax rates were stored as a decimal (e.g. `0.2`) but they're now stored as a percentage
* (e.g. `20`). So we need to convert.
*/
if ( $tax_rate < 1 ) {
$tax_rate = $tax_rate * 100;
}
$set_tax_rate_meta = false;
if ( ! empty( $tax_rate ) ) {
// Fetch the actual tax rate object for the order region & country.
$tax_rate_object = edd_get_tax_rate_by_location( array(
'country' => $order_address_data['country'],
'region' => $order_address_data['region'],
) );
if ( ! empty( $tax_rate_object->id ) && $tax_rate_object->amount == $tax_rate ) {
$tax_rate_id = $tax_rate_object->id;
}
}
/*
* If we cannot find a matching Adjustment object, we should save this in order meta so it isn't lost.
*/
if ( ! empty( $tax_rate ) && empty( $tax_rate_id ) ) {
$set_tax_rate_meta = true;
}
// Build the order data before inserting.
$order_data = array(
'id' => $data->ID,
'parent' => $data->post_parent,
'order_number' => $order_number,
'status' => $order_status,
'type' => 'sale',
'date_created' => $date_created_gmt, // GMT is stored in the database as the offset is applied by the new query classes.
'date_modified' => $data->post_modified_gmt, // GMT is stored in the database as the offset is applied by the new query classes.
'date_completed' => $date_completed,
'user_id' => $user_id,
'customer_id' => $customer_id,
'email' => $purchase_email,
'ip' => $ip,
'gateway' => $gateway,
'mode' => $mode,
'currency' => ! empty( $payment_meta['currency'] ) ? $payment_meta['currency'] : edd_get_currency(),
'payment_key' => $purchase_key,
'tax_rate_id' => $tax_rate_id,
'subtotal' => $order_subtotal,
'tax' => $order_tax,
'discount' => $order_discount,
'total' => $order_total,
);
/**
* Filters the data used to create the order.
*
* @since 3.0
*
* @param array $order_data Order creation arguments.
* @param array $payment_meta Payment meta.
* @param array $cart_details Cart details.
* @param array $meta All payment meta.
*/
$order_data = apply_filters( 'edd_30_migration_order_creation_data', $order_data, $payment_meta, $cart_details, $meta );
update_option( '_edd_v30_doing_order_migration', true, false );
// Remove all order status transition actions.
remove_all_actions( 'edd_transition_order_status' );
remove_all_actions( 'edd_transition_order_item_status' );
$order_id = edd_add_order( $order_data );
// Save an un-matched tax rate in order meta.
if ( $set_tax_rate_meta ) {
edd_add_order_meta( $order_id, 'tax_rate', $tax_rate );
}
// Do not pass the original order ID into other arrays
unset( $order_data['id'] );
// Reset the $refund_id variable so that we don't end up accidentally creating refunds.
$refund_id = 0;
// If the order status is 'refunded', we need to generate a new order with the type of 'refund'.
if ( 'refunded' === $order_status ) {
// Since the refund is a near copy of the original order, copy over the arguments.
$refund_data = $order_data;
$refund_data['parent'] = $order_id;
$refund_data['order_number'] = $order_id . apply_filters( 'edd_order_refund_suffix', '-R-' ) . '1';
$refund_data['type'] = 'refund';
$refund_data['status'] = 'complete';
// Negate the amounts
$refund_data['subtotal'] = edd_negate_amount( $order_subtotal );
$refund_data['tax'] = edd_negate_amount( $order_tax );
$refund_data['discount'] = edd_negate_amount( $order_discount );
$refund_data['total'] = edd_negate_amount( $order_total );
// These are the best guess at the date it was refunded since we didn't store that prior.
$refund_data['date_created'] = $data->post_modified_gmt;
$refund_data['date_modified'] = $data->post_modified_gmt;
$refund_id = edd_add_order( $refund_data );
}
// Remove empty data.
$order_address_data = array_filter( $order_address_data );
if ( ! empty( $order_address_data ) ) {
// Add to edd_order_addresses table.
$order_address_data['order_id'] = $order_id;
edd_add_order_address( $order_address_data );
}
// Maybe add the address to the edd_customer_addresses.
$customer_address_data = $order_address_data;
// We don't need to pass this data to edd_maybe_add_customer_address().
unset( $customer_address_data['order_id'] );
unset( $customer_address_data['first_name'] );
unset( $customer_address_data['last_name'] );
// If possible, set the order date as the address creation date.
$customer_address_data['date_created'] = $date_created_gmt;
// Maybe add address to customer record.
edd_maybe_add_customer_address( $customer_id, $customer_address_data );
// Maybe add email address to customer record
if ( ! empty( $customer ) && $customer instanceof \EDD_Customer ) {
$type = ( $customer->email === $purchase_email ) ? 'primary' : 'secondary';
edd_add_customer_email_address(
array(
'customer_id' => $customer_id,
'date_created' => $date_created_gmt,
'email' => $purchase_email,
'type' => $type,
)
);
}
/** Migrate meta *********************************************/
// Unlimited downloads meta is not an order property, so we set it on the order meta for the new order ID.
if ( isset( $meta['_edd_payment_unlimited_downloads'] ) && ! empty( $meta['_edd_payment_unlimited_downloads'][0] ) ) {
edd_add_order_meta( $order_id, 'unlimited_downloads', $meta['_edd_payment_unlimited_downloads'][0] );
}
// Transaction IDs are no longer meta, and have their own table and data set, so we need to add the transactions.
$transaction_id = ! empty( $meta['_edd_payment_transaction_id'][0] ) ? $meta['_edd_payment_transaction_id'][0] : false;
// If we have no transaction ID & the gateway was PayPal, let's check in old payment notes.
if ( empty( $transaction_id ) && false !== strpos( $gateway, 'paypal' ) ) {
$transaction_id = self::find_transaction_id_from_notes( $order_id );
}
if ( ! empty( $transaction_id ) ) {
edd_add_order_transaction( array(
'object_id' => $order_id,
'object_type' => 'order',
'transaction_id' => $transaction_id,
'gateway' => $gateway,
'status' => 'complete',
'total' => $order_total,
'date_created' => $date_completed,
'date_modified' => $date_completed,
) );
}
/**
* By default, this is what is stored in payment meta. These array keys are part of the core payment meta in 2.x
* but are not needed as part of the order meta and will not be migrated.
* Extensions can add their keys to this filter if they use the payment meta array to store data and have
* established a migration process to keep the data intact with the new order tables.
*
* @since 3.0
* @param array The array of payment meta keys.
*/
$core_meta_keys = apply_filters( 'edd_30_payment_meta_keys_not_migrated', array(
'fees',
'key',
'email',
'date',
'downloads',
'cart_details',
'currency',
'discount',
'subtotal',
'tax',
'amount',
'user_id',
) );
// Remove core keys from `user_info`.
$remaining_user_info = false;
if ( ! empty( $user_info ) ) {
/**
* Array keys which are part of the core `user_info` in payment meta which are not needed as part of the order meta.
* Extensions can add their keys to this filter if they use the `user_info` array to store data and have
* established a migration process to keep the data intact with the new order tables.
*
* @since 3.0
* @param array The array of user info keys.
*/
$core_user_info = apply_filters( 'edd_30_core_user_info', array( 'id', 'email', 'first_name', 'last_name', 'discount', 'address', 'user_id' ) );
$remaining_user_info = array_diff_key( $user_info, array_flip( $core_user_info ) );
}
// If an extension has added data to `user_info`, migrate it.
if ( $remaining_user_info ) {
$payment_meta['user_info'] = $remaining_user_info;
} else {
$core_meta_keys[] = 'user_info';
}
// Remove all the core payment meta from the array, and...
if ( is_array( $payment_meta ) ) {
$remaining_payment_meta = array_diff_key( $payment_meta, array_flip( $core_meta_keys ) );
// ..If we have extra payment meta, it needs to be migrated across.
if ( 0 < count( $remaining_payment_meta ) ) {
edd_add_order_meta( $order_id, 'payment_meta', $remaining_payment_meta );
}
}
/** Create order items ***************************************/
// Now we iterate through all the cart items and make rows in the order items table.
if ( ! empty( $cart_details ) ) {
foreach ( $cart_details as $key => $cart_item ) {
// Reset any conditional IDs to be safe.
$refund_order_item_id = 0;
// Get product name.
$product_name = isset( $cart_item['name'] )
? $cart_item['name']
: '';
// Get price ID.
$price_id = self::get_valid_price_id_for_cart_item( $cart_item );
if ( ! empty( $product_name ) ) {
$option_name = edd_get_price_option_name( $cart_item['id'], $price_id );
if ( ! empty( $option_name ) ) {
$product_name .= ' — ' . $option_name;
}
}
$order_item_args = array(
'order_id' => $order_id,
'product_id' => $cart_item['id'],
'product_name' => $product_name,
'price_id' => $price_id,
'cart_index' => $key,
'type' => 'download',
'status' => $order_status,
'quantity' => $cart_item['quantity'],
'amount' => (float) $cart_item['item_price'],
'subtotal' => (float) $cart_item['subtotal'],
'discount' => (float) $cart_item['discount'],
'tax' => $cart_item['tax'],
'total' => (float) $cart_item['price'],
'date_created' => $date_created_gmt,
'date_modified' => $data->post_modified_gmt,
);
/**
* Filters the arguments used to create the order item.
*
* @since 1.0
*
* @param array $order_item_args Order item arguments.
* @param array $cart_item Original cart item.
* @param array $payment_meta Payment meta.
* @param array $meta All meta.
*/
$order_item_args = apply_filters( 'edd_30_migration_order_item_creation_data', $order_item_args, $cart_item, $payment_meta, $meta );
$order_item_id = edd_add_order_item( $order_item_args );
if ( ! empty( $cart_item['item_number']['options'] ) ) {
// Collect any item_number options and store them.
// Remove our price_id and quantity, as they are columns on the order item now.
unset( $cart_item['item_number']['options']['price_id'] );
unset( $cart_item['item_number']['options']['quantity'] );
foreach ( $cart_item['item_number']['options'] as $option_key => $value ) {
$option_key = '_option_' . sanitize_key( $option_key );
edd_add_order_item_meta( $order_item_id, $option_key, $value );
}
}
// If the order status is refunded, we also need to add all the refunded order items on the refund order as well.
if ( ! empty( $refund_id ) ) {
// Since the refund is a near copy of the original order, copy over the arguments.
$refund_item_args = $order_item_args;
$refund_item_args['parent'] = $order_item_id;
$refund_item_args['order_id'] = $refund_id;
$refund_item_args['status'] = 'complete';
// Subtotal is actually set to subtotal - discount.
$refund_item_args['subtotal'] = $refund_item_args['subtotal'] - $refund_item_args['discount'];
// Negate the amounts
$refund_item_args['quantity'] = edd_negate_int( $cart_item['quantity'] );
foreach( array( 'amount', 'subtotal', 'tax', 'total' ) as $field_to_negate ) {
$refund_item_args[ $field_to_negate ] = edd_negate_amount( $refund_item_args[ $field_to_negate ] );
}
// These are our best estimates since we did not store the refund date previously.
$refund_item_args['date_crated'] = $data->post_modified_gmt;
$refund_item_args['date_modified'] = $data->post_modified_gmt;
$refund_order_item_id = edd_add_order_item( $refund_item_args );
if ( ! empty( $cart_item['item_number']['options'] ) ) {
// Collect any item_number options and store them.
// Remove our price_id and quantity, as they are columns on the order item now.
unset( $cart_item['item_number']['options']['price_id'] );
unset( $cart_item['item_number']['options']['quantity'] );
foreach ( $cart_item['item_number']['options'] as $option_key => $value ) {
$option_key = '_option_' . sanitize_key( $option_key );
edd_add_order_item_meta( $refund_order_item_id, $option_key, $value );
}
}
}
// Store order item fees as adjustments.
if ( isset( $cart_item['fees'] ) && ! empty( $cart_item['fees'] ) ) {
foreach ( $cart_item['fees'] as $fee_id => $fee ) {
// Reset any conditional IDs to be safe.
$refund_adjustment_id = 0;
$tax = EDD()->fees->get_calculated_tax( $fee, $tax_rate );
$total = floatval( $fee['amount'] ) + $tax;
// Track order item fees tax to adjust order if needed.
$order_items_fees_tax += $tax;
// Add the adjustment.
$adjustment_args = array(
'object_id' => $order_item_id,
'object_type' => 'order_item',
'type_key' => $fee_id,
'type' => 'fee',
'description' => $fee['label'],
'subtotal' => floatval( $fee['amount'] ),
'tax' => $tax,
'total' => floatval( $fee['amount'] ) + $tax,
);
/**
* Filters the arguments used to create an order item adjustment.
*
* @since 3.0
*
* @param array $adjustment_args Adjustment arguments for a fee.
* @param array $fee Original fee data.
* @param array $cart_item Cart item this fee is part of.
* @param array $payment_meta Payment meta.
* @param array $meta All meta.
*/
$adjustment_args = apply_filters( 'edd_30_migration_order_item_adjustment_creation_data', $adjustment_args, $fee, $cart_item, $payment_meta, $meta );
$adjustment_id = edd_add_order_adjustment( $adjustment_args );
// If we refunded the main order, the fees also need to be added to the refund order type we created.
if ( ! empty( $refund_id ) ) {
$refund_adjustment_args = $adjustment_args;
$refund_adjustment_args['parent'] = $adjustment_id;
$refund_adjustment_args['object_id'] = $refund_order_item_id;
$refund_adjustment_args['subtotal'] = edd_negate_amount( floatval( $fee['amount'] ) );
$refund_adjustment_args['tax'] = edd_negate_amount( $tax );
$refund_adjustment_args['total'] = edd_negate_amount( floatval( $fee['amount'] ) + $tax );
$refund_adjustment_id = edd_add_order_adjustment( $refund_adjustment_args );
}
}
}
}
// Compatibility with older versions of EDD.
// Older versions stored a single dimensional array of download IDs.
} elseif ( is_array( $cart_downloads ) && count( $cart_downloads ) === count( $cart_downloads, COUNT_RECURSIVE ) ) {
foreach ( $cart_downloads as $cart_index => $download_id ) {
$download = edd_get_download( $download_id );
$order_item_args = array(
'order_id' => $order_id,
'product_id' => $download_id,
'product_name' => $download->post_name,
'price_id' => null,
'cart_index' => $cart_index,
'type' => 'download',
'quantity' => 1,
'amount' => (float) $payment_meta['amount'],
'subtotal' => (float) $payment_meta['amount'],
'discount' => 0.00,
'tax' => 0.00,
'total' => (float) $payment_meta['amount'],
'date_created' => $date_created_gmt,
'date_modified' => $data->post_modified_gmt,
);
$order_item_id = edd_add_order_item( $order_item_args );
// If the order was refunded, we also need to add these items to the refund order.
if ( ! empty( $refund_id ) ) {
// Since the refund is a near copy of the original order, copy over the arguments.
$refund_item_args = $order_item_args;
$refund_item_args['parent'] = $order_item_id;
$refund_item_args['order_id'] = $refund_id;
$refund_item_args['quantity'] = edd_negate_int( 1 );
$refund_item_args['amount'] = edd_negate_amount( (float) $payment_meta['amount'] );
$refund_item_args['subtotal'] = edd_negate_amount( (float) $payment_meta['amount'] );
$refund_item_args['total'] = edd_negate_amount( (float) $payment_meta['amount'] );
// These are the best guess at the time, since we didn't store this data previously.
$refund_item_args['date_created'] = $data->post_modified_gmt;
$refund_item_args['date_modified'] = $data->post_modified_gmt;
edd_add_order_item( $order_item_args );
}
}
}
/** Create order adjustments *********************************/
if ( isset( $payment_meta['fees'] ) && ! empty( $payment_meta['fees'] ) ) {
foreach ( $payment_meta['fees'] as $fee_id => $fee ) {
// Reset any conditional IDs to be safe.
$refund_adjustment_id = 0;
if ( ! empty( $fee['download_id'] ) ) {
continue;
}
$tax = EDD()->fees->get_calculated_tax( $fee, $tax_rate );
$total = floatval( $fee['amount'] ) + $tax;
$order_fees_tax += $tax;
$order_fees_total += $total;
// Add the adjustment.
$adjustment_args = array(
'object_id' => $order_id,
'object_type' => 'order',
'type_key' => $fee_id,
'type' => 'fee',
'description' => $fee['label'],
'subtotal' => floatval( $fee['amount'] ),
'tax' => $tax,
'total' => $total,
'date_created' => $date_created_gmt,
'date_modified' => $data->post_modified_gmt,
);
/**
* Filters the order adjustment arguments.
*
* @since 3.0
*
* @param array $adjustment_args Arguments used to create the order adjustment.
* @param array $fee Fee data.
* @param array $payment_meta Payment meta.
* @param array $meta All meta.
*/
$adjustment_args = apply_filters( 'edd_30_migration_order_adjustment_creation_data', $adjustment_args, $fee, $payment_meta, $meta );
$adjustment_id = edd_add_order_adjustment( $adjustment_args );
if ( ! empty( $refund_id ) ) {
// Since the refund is a near copy of the original order, copy over the arguments.
$refund_adjustment_args = $adjustment_args;
$refund_adjustment_args['parent'] = $adjustment_id;
$refund_adjustment_args['object_id'] = $refund_id;
// Negate the amounts.
$refund_adjustment_args['subtotal'] = edd_negate_amount( floatval( $fee['amount'] ) );
$refund_adjustment_args['tax'] = edd_negate_amount( $tax );
$refund_adjustment_args['total'] = edd_negate_amount( floatval( $fee['amount'] ) + $tax );
$refund_adjustment_id = edd_add_order_adjustment( $refund_adjustment_args );
}
}
}
// Add fee taxes (order and order item) if the order tax amount was previously manually calculated.
if ( false === $meta_tax ) {
edd_update_order( $order_id, array(
'tax' => $order_tax + $order_fees_tax + $order_items_fees_tax,
) );
}
// Add fee totals (order and order item) if the order tax amount was previously manually calculated.
// Order item fees were previously included in the total calculation. We must manually include
// order item fee tax amounts, and order fees total (subtotal + tax).
if ( false === $meta_total ) {
edd_update_order( $order_id, array(
'total' => $order_total + $order_fees_total + $order_items_fees_tax,
) );
}
// Insert discounts.
$discounts = ! empty( $user_info['discount'] )
? $user_info['discount']
: array();
if ( ! is_array( $discounts ) ) {
$discounts = explode( ',', $discounts );
}
if ( ! empty( $discounts ) && ( 'none' !== $discounts[0] ) ) {
if ( 1 === count( $discounts ) ) {
$discount_code = reset( $discounts );
/** @var \EDD_Discount $discount_object */
$discount_object = edd_get_discount_by( 'code', $discount_code );
if ( $discount_object instanceof \EDD_Discount ) {
$discount_args = array(
'object_id' => $order_id,
'object_type' => 'order',
'type_id' => $discount_object->id,
'type' => 'discount',
'description' => $discount_object->code,
'subtotal' => $order_discount,
'total' => $order_discount,
'date_created' => $date_created_gmt,
'date_modified' => $data->post_modified_gmt,
);
/**
* Filters the arguments used to create a discount adjustment.
*
* @since 3.0
*
* @param array $discount_args Order adjustment arguments.
* @param \EDD_Discount $discount_object Discount object.
* @param float $order_subtotal Order subtotal.
* @param array $user_info User info array.
* @param array $payment_meta Payment meta.
* @param array $meta All post meta.
*/
$discount_args = apply_filters( 'edd_30_migration_order_discount_creation_data', $discount_args, $discount_object, $order_subtotal, $user_info, $payment_meta, $meta );
$new_discount_id = edd_add_order_adjustment( $discount_args );
if ( $order_discount <= 0 ) {
edd_add_order_adjustment_meta(
$new_discount_id,
'migrated_order_discount_unknown',
(int) $order_id,
true
);
}
}
} else {
foreach ( $discounts as $discount_code ) {
/** @var \EDD_Discount $discount_object */
$discount_object = edd_get_discount_by( 'code', $discount_code );
if ( false === $discount_object ) {
continue;
}
$calculated_discount = $order_subtotal - $discount_object->get_discounted_amount( $order_subtotal );
$discount_args = array(
'object_id' => $order_id,
'object_type' => 'order',
'type_id' => $discount_object->id,
'type' => 'discount',
'description' => $discount_object->code,
'subtotal' => $calculated_discount,
'total' => $calculated_discount,
'date_created' => $date_created_gmt,
'date_modified' => $data->post_modified_gmt,
);
/**
* Filters the arguments used to create a discount adjustment.
*
* @since 3.0
*
* @param array $discount_args Order adjustment arguments.
* @param \EDD_Discount $discount_object Discount object.
* @param float $order_subtotal Order subtotal.
* @param array $user_info User info array.
* @param array $payment_meta Payment meta.
* @param array $meta All post meta.
*/
$discount_args = apply_filters( 'edd_30_migration_order_discount_creation_data', $discount_args, $discount_object, $order_subtotal, $user_info, $payment_meta, $meta );
$new_discount_id = edd_add_order_adjustment( $discount_args );
if ( $calculated_discount <= 0 ) {
edd_add_order_adjustment_meta(
$new_discount_id,
'migrated_order_discount_unknown',
(int) $order_id,
true
);
}
}
}
}
/** Create order meta ****************************************/
$core_meta_keys = array(
'_edd_payment_user_email',
'_edd_payment_customer_id',
'_edd_payment_user_id',
'_edd_payment_user_ip',
'_edd_payment_purchase_key',
'_edd_payment_total',
'_edd_payment_mode',
'_edd_payment_gateway',
'_edd_payment_meta',
'_edd_payment_tax',
'_edd_payment_tax_rate',
'_edd_completed_date',
'_edd_payment_unlimited_downloads',
'_edd_payment_number',
'_edd_payment_transaction_id',
);
// Determine what main payment meta keys were from core and what were custom...
$remaining_meta = array_diff_key( $meta, array_flip( $core_meta_keys ) );
// ...and whatever is not from core, needs to be added as new order meta.
foreach ( $remaining_meta as $meta_key => $meta_value ) {
$meta_value = maybe_unserialize( $meta_value[0] );
edd_add_order_meta( $order_id, $meta_key, $meta_value );
}
/**
* Now that we're done, let's run a hook here so we can allow extensions to make any necessary changes.
*
* @since 3.0
* @param int $order_id The order ID.
* @param array $payment_meta The `_edd_payment_meta` value for the original payment.
* @param array $meta All post meta associated with the payment.
*/
do_action( 'edd_30_migrate_order', $order_id, $payment_meta, $meta );
delete_option( '_edd_v30_doing_order_migration' );
return $order_id;
}
/**
* Retrieves a valid price ID for a given cart item.
* If the product does not have variable prices, then `null` is always returned.
* If the supplied price ID does not match a price ID that actually exists, then the default
* variable price is returned instead of the supplied one.
*
* @since 3.0
*
* @param array $cart_item Array of cart item details.
*
* @return int|null
*/
protected static function get_valid_price_id_for_cart_item( $cart_item ) {
// If the product doesn't have variable prices, just return `null`.
if ( ! edd_has_variable_prices( $cart_item['id'] ) ) {
return null;
}
$variable_prices = edd_get_variable_prices( $cart_item['id'] );
if ( ! is_array( $variable_prices ) || empty( $variable_prices ) ) {
return null;
}
// Return the price ID that's set to the cart item right now, if not numeric return NULL.
return isset( $cart_item['item_number']['options']['price_id'] ) && is_numeric( $cart_item['item_number']['options']['price_id'] )
? absint( $cart_item['item_number']['options']['price_id'] )
: null;
}
/**
* Attempts to locate a PayPal transaction ID from legacy payment notes.
*
* @since 3.0
*
* @param int $payment_id
*
* @return string|false Transaction ID on success, false if not found.
*/
private static function find_transaction_id_from_notes( $payment_id ) {
global $wpdb;
$payment_notes = $wpdb->get_col( $wpdb->prepare(
"SELECT comment_content FROM {$wpdb->comments} WHERE comment_post_ID = %d",
$payment_id
) );
if ( empty( $payment_notes ) || ! is_array( $payment_notes ) ) {
return false;
}
foreach ( $payment_notes as $note ) {
if ( preg_match( '/^PayPal Transaction ID: ([^\s]+)/', $note, $match ) ) {
return $match[1];
}
}
return false;
}
/**
* Tax rates.
*
* @since 3.0
*
* @param object $data Data to migrate.
*/
public static function tax_rates( $data = null ) {
// Bail if no data passed.
if ( ! $data ) {
return;
}
$scope = ! empty( $data['global'] )
? 'country'
: 'region';
// If the scope is 'country', look for other active rates that are country wide and set them as 'inactive'.
if ( 'country' === $scope ) {
$tax_rates = edd_get_adjustments(
array(
'type' => 'tax_rate',
'status' => 'active',
'scope' => 'country',
'name' => $data['country'],
)
);
if ( ! empty( $tax_rates ) ) {
foreach ( $tax_rates as $tax_rate ) {
edd_update_adjustment(
$tax_rate->id,
array( 'status' => 'inactive', )
);
}
}
}
$adjustment_data = array(
'name' => $data['country'],
'scope' => $scope,
'amount' => floatval( $data['rate'] ),
);
if ( ! empty( $data['state'] ) ) {
$adjustment_data['description'] = sanitize_text_field( $data['state'] );
}
edd_add_tax_rate( $adjustment_data );
}
/**
* Normalizes and backfills legacy payment cart data.
*
* @since 3.0.0
*
* @param array|string $cart_details Cart details. No action is performed if a string
* (array cannot be unserialized) is provided.
* @return array|string
*/
private static function normalize_cart_details( $cart_details ) {
if ( ! is_array( $cart_details ) ) {
return $cart_details;
}
foreach ( $cart_details as &$cart_item ) {
// Get price.
$cart_item['price'] = isset( $cart_item['price'] )
? (float) $cart_item['price']
: 0.00;
// Get item price.
$cart_item['item_price'] = isset( $cart_item['item_price'] )
? (float) $cart_item['item_price']
: (float) $cart_item['price'];
// Get quantity.
$cart_item['quantity'] = isset( $cart_item['quantity'] )
? $cart_item['quantity']
: 1;
// Get subtotal.
$cart_item['subtotal'] = isset( $cart_item['subtotal'] )
? (float) $cart_item['subtotal']
: (float) $cart_item['quantity'] * $cart_item['item_price'];
// Get discount.
$cart_item['discount'] = isset( $cart_item['discount'] )
? (float) $cart_item['discount']
: 0.00;
// Get tax.
$cart_item['tax'] = isset( $cart_item['tax'] )
? (float) $cart_item['tax']
: 0.00;
}
return $cart_details;
}
/**
* Given that some data quite possible has bad serialization, we need to possibly fix the bad serialization.
*
* @since 3.0.0
*
* @param $data
*
* @return mixed
*/
public static function fix_possible_serialization( $data ) {
if ( ! is_array( $data ) && is_string( $data ) ) {
$data = substr_replace( $data, 'a', 0, 1 );
}
return $data;
}
}