WC_Helper_Updater::block_expired_updates() │ public static │ WC 4.1.0

Hooked into the upgrader_pre_download filter in order to better handle error messaging around expired plugin updates. Initially we were using an empty string, but the error message that no_package results in does not fit the cause.

Method of the class: WC_Helper_Updater{}

No Hooks.

Return

false|WP_Error. False to proceed with the update as normal, anything else to be returned instead of updating.

Usage

$result = WC_Helper_Updater::block_expired_updates( $reply, $package );

$reply(true|false) (required)

Holds the current filtered response.

$package(string) (required)

The path to the package file for the update.

Changelog

WC_Helper_Updater::block_expired_updates() WC Helper Updater::block expired updates code ^{WC 9.7.1}

public static function block_expired_updates( $reply, $package ) {
	// Don't override a reply that was set already.
	if ( false !== $reply ) {
		return $reply;
	}

	// Only for packages with expired subscriptions.
	if ( 0 !== strpos( $package, 'woocommerce-com-expired-' ) ) {
		return false;
	}

	return new WP_Error(
		'woocommerce_subscription_expired',
		sprintf(
			// translators: %s: URL of WooCommerce.com subscriptions tab.
			__( 'Please visit the <a href="%s" target="_blank">subscriptions page</a> and renew to continue receiving updates.', 'woocommerce' ),
			esc_url( admin_url( 'admin.php?page=wc-addons&section=helper' ) )
		)
	);
}