/**
* Checks if the user can be granted the permission to remove a line item from the subscription.
*
* @param WC_Subscription $subscription An instance of a WC_Subscription object
* @since 2.0
*/
function wcs_can_items_be_removed($subscription)
{
$allow_remove = false;
if (sizeof($subscription->get_items()) > 1 && $subscription->payment_method_supports('subscription_amount_changes') && $subscription->has_status(array('active', 'on-hold', 'pending'))) {
$allow_remove = true;
}
return apply_filters('wcs_can_items_be_removed', $allow_remove, $subscription);
}
/**
* If the subscription has expired since upgrading and the end date is not the original expiration date,
* we need to unexpire it, which in the case of a previously active subscription means activate it, and
* in any other case, leave it as on-hold (a cancelled subscription wouldn't have been expired, so the
* status must be on-hold or active).
*
* @param WC_Subscription $subscription data about the subscription
* @return bool true if the trial date was repaired, otherwise false
*/
protected static function maybe_repair_status($subscription, $former_order_item_meta, $dates_to_update)
{
if ($subscription->has_status('expired') && 'expired' != $former_order_item_meta['_wcs_migrated_subscription_status'][0] && isset($dates_to_update['end'])) {
try {
// we need to bypass the update_status() method here because normally an expired subscription can't have it's status changed, we also don't want normal status change hooks to be fired
wp_update_post(array('ID' => $subscription->id, 'post_status' => 'wc-on-hold'));
// if the payment method doesn't support date changes, we still want to reactivate the subscription but we also need to process a special failed payment at the next renewal to fix up the payment method so we'll set a special flag in post meta to handle that
if (!$subscription->payment_method_supports('subscription_date_changes') && $subscription->get_total() > 0) {
update_post_meta($subscription->id, '_wcs_repaired_2_0_2_needs_failed_payment', 'true');
WCS_Upgrade_Logger::add(sprintf('For subscription %d: payment method does not support "subscription_date_changes" and total > 0, setting "_wcs_repaired_2_0_2_needs_failed_payment" post meta flag.', $subscription->id));
}
if ('active' == $former_order_item_meta['_wcs_migrated_subscription_status'][0] && $subscription->can_be_updated_to('active')) {
$subscription->update_status('active');
}
WCS_Upgrade_Logger::add(sprintf('For subscription %d: repaired status. Status was "expired", it is now "%s".', $subscription->id, $subscription->get_status()));
$repair_status = true;
} catch (Exception $e) {
WCS_Upgrade_Logger::add(sprintf('!!! For subscription %d: unable to repair status, exception "%s"', $subscription->id, $e->getMessage()));
$repair_status = false;
}
} else {
WCS_Upgrade_Logger::add(sprintf('For subscription %d: no need to repair status, current status: %s; former status: %s.', $subscription->id, $subscription->get_status(), $former_order_item_meta['_wcs_migrated_subscription_status'][0]));
$repair_status = false;
}
return $repair_status;
}
/**
* Check if a given item on a subscription can be switched.
*
* For an item to be switchable, switching must be enabled, and the item must be for a variable subscription or
* part of a grouped product (at the time the check is made, not at the time the subscription was purchased)
*
* The subscription must also be active or on-hold and use manual renewals or use a payment method which supports cancellation.
*
* @param array $item An order item on the subscription
* @param WC_Subscription $subscription An instance of WC_Subscription
* @since 2.0
*/
public static function can_item_be_switched($item, $subscription = null)
{
$product_id = wcs_get_canonical_product_id($item);
if ('line_item' == $item['type'] && wcs_is_product_switchable_type($product_id)) {
$is_product_switchable = true;
} else {
$is_product_switchable = false;
}
if ($subscription->has_status('active') && 0 !== $subscription->get_date('last_payment')) {
$is_subscription_switchable = true;
} else {
$is_subscription_switchable = false;
}
if ($subscription->payment_method_supports('subscription_amount_changes') && $subscription->payment_method_supports('subscription_date_changes')) {
$can_subscription_be_updated = true;
} else {
$can_subscription_be_updated = false;
}
if ($is_product_switchable && $is_subscription_switchable && $can_subscription_be_updated) {
$item_can_be_switch = true;
} else {
$item_can_be_switch = false;
}
return apply_filters('woocommerce_subscriptions_can_item_be_switched', $item_can_be_switch, $item, $subscription);
}
/**
* Validate the incoming request to either remove an item or add and item back to a subscription that was previously removed.
* Add an descriptive notice to the page whether or not the request was validated or not.
*
* @since 2.0
* @param WC_Subscription $subscription
* @param int $order_item_id
* @param bool $undo_request bool
* @return bool
*/
private static function validate_remove_items_request($subscription, $order_item_id, $undo_request = false)
{
$subscription_items = $subscription->get_items();
$response = false;
if (!wp_verify_nonce($_GET['_wpnonce'], $_GET['subscription_id'])) {
wc_add_notice(__('Security error. Please contact us if you need assistance.', 'woocommerce-subscriptions'), 'error');
} elseif (!current_user_can('edit_shop_subscription_line_items', $subscription->id)) {
wc_add_notice(__('You cannot modify a subscription that does not belong to you.', 'woocommerce-subscriptions'), 'error');
} elseif (!$undo_request && !isset($subscription_items[$order_item_id])) {
// only need to validate the order item id when removing
wc_add_notice(__('You cannot remove an item that does not exist. ', 'woocommerce-subscriptions'), 'error');
} elseif (!$subscription->payment_method_supports('subscription_amount_changes')) {
wc_add_notice(__('The item was not removed because this Subscription\'s payment method does not support removing an item.', 'woocommerce-subscriptions'));
} else {
$response = true;
}
return $response;
}
