157 lines
5.5 KiB
PHP
Executable File
157 lines
5.5 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* Class for managing and displaying an admin notice displayed after upgrading Subscriptions.
|
|
*
|
|
* @author Prospress
|
|
* @category Admin
|
|
* @package WooCommerce Subscriptions/Admin/Upgrades
|
|
* @version 2.3.0
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
exit; // Exit if accessed directly
|
|
}
|
|
|
|
class WCS_Upgrade_Notice_Manager {
|
|
|
|
/**
|
|
* The version this notice relates to.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected static $version = '2.5.0';
|
|
|
|
/**
|
|
* The number of times the notice will be displayed before being dismissed automatically.
|
|
*
|
|
* @var int
|
|
*/
|
|
protected static $display_count = 2;
|
|
|
|
/**
|
|
* The option name which stores information about the admin notice.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected static $option_name = 'wcs_display_upgrade_notice';
|
|
|
|
/**
|
|
* Attach callbacks.
|
|
*
|
|
* @since 2.3.0
|
|
*/
|
|
public static function init() {
|
|
add_action( 'woocommerce_subscriptions_upgraded', array( __CLASS__, 'maybe_record_upgrade' ), 10, 2 );
|
|
add_action( 'admin_notices', array( __CLASS__, 'maybe_show_admin_notice' ) );
|
|
}
|
|
|
|
/**
|
|
* Store an option to display an upgrade notice when the store is upgraded.
|
|
*
|
|
* @param string $current_version The new version the site has been updated to.
|
|
* @param string $previously_active_version The version of Subscriptions the store was running prior to upgrading.
|
|
* @since 2.3.0
|
|
*/
|
|
public static function maybe_record_upgrade( $current_version, $previously_active_version ) {
|
|
if ( '0' !== $previously_active_version && version_compare( $previously_active_version, self::$version, '<' ) && version_compare( $current_version, self::$version, '>=' ) ) {
|
|
update_option( self::$option_name, array(
|
|
'version' => self::$version,
|
|
'display_count' => 0,
|
|
) );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Display the upgrade notice including details about the update if it hasn't been dismissed.
|
|
*
|
|
* @since 2.3.0
|
|
*/
|
|
public static function maybe_show_admin_notice() {
|
|
|
|
if ( isset( $_GET['_wcsnonce'] ) && wp_verify_nonce( $_GET['_wcsnonce'], 'dismiss_upgrade_notice' ) && ! empty( $_GET['dismiss_upgrade_notice'] ) && self::$version === $_GET['dismiss_upgrade_notice'] ) {
|
|
delete_option( self::$option_name );
|
|
return;
|
|
}
|
|
|
|
if ( ! self::display_notice() ) {
|
|
return;
|
|
}
|
|
|
|
$version = _x( '2.5', 'plugin version number used in admin notice', 'woocommerce-subscriptions' );
|
|
$dismiss_url = wp_nonce_url( add_query_arg( 'dismiss_upgrade_notice', self::$version ), 'dismiss_upgrade_notice', '_wcsnonce' );
|
|
$notice = new WCS_Admin_Notice( 'notice notice-info', array(), $dismiss_url );
|
|
$features = array(
|
|
array(
|
|
'title' => __( 'New options to allow customers to sign up without a credit card', 'woocommerce-subscriptions' ),
|
|
'description' => __( 'Allow customers to access free trial and other $0 subscription products without needing to enter their credit card details on sign up.', 'woocommerce-subscriptions' ),
|
|
),
|
|
array(
|
|
'title' => __( 'Improved subscription payment method information', 'woocommerce-subscriptions' ),
|
|
'description' => __( 'Customers can now see more information about what payment method will be used for future payments.', 'woocommerce-subscriptions' ),
|
|
),
|
|
array(
|
|
'title' => __( 'Auto-renewal toggle', 'woocommerce-subscriptions' ),
|
|
'description' => sprintf( __( 'Enabled via a setting, this new feature will allow your customers to turn on and off automatic payments from the %sMy Account > View Subscription%s pages.', 'woocommerce-subscriptions' ), '<strong>', '</strong>' ),
|
|
),
|
|
array(
|
|
'title' => __( 'Update all subscription payment methods', 'woocommerce-subscriptions' ),
|
|
'description' => __( "Customers will now have the option to update all their subscriptions when they are changing one of their subscription's payment methods - provided the payment gateway supports it.", 'woocommerce-subscriptions' ),
|
|
),
|
|
);
|
|
|
|
// translators: placeholder is Subscription version string ('2.3')
|
|
$notice->set_heading( sprintf( __( 'Welcome to Subscriptions %s', 'woocommerce-subscriptions' ), $version ) );
|
|
$notice->set_content_template( 'update-welcome-notice.php', plugin_dir_path( WC_Subscriptions::$plugin_file ) . 'includes/upgrades/templates/', array(
|
|
'version' => $version,
|
|
'features' => $features,
|
|
) );
|
|
$notice->set_actions( array(
|
|
array(
|
|
'name' => __( 'Learn More', 'woocommerce-subscriptions' ),
|
|
'url' => 'https://docs.woocommerce.com/document/subscriptions/version-2-5/',
|
|
),
|
|
) );
|
|
|
|
$notice->display();
|
|
self::increment_display_count();
|
|
}
|
|
|
|
/**
|
|
* Determine if this admin notice should be displayed.
|
|
*
|
|
* @return bool Whether this admin notice should be displayed.
|
|
* @since 2.3.0
|
|
*/
|
|
protected static function display_notice() {
|
|
$option = get_option( self::$option_name );
|
|
$display_notice = false;
|
|
|
|
if ( isset( $option['version'] ) ) {
|
|
$display_notice = $option['version'] === self::$version;
|
|
}
|
|
|
|
return $display_notice;
|
|
}
|
|
|
|
/**
|
|
* Increment the notice display counter signalling the notice has been displayed.
|
|
*
|
|
* The option triggering this notice will be deleted if the display count has been reached.
|
|
*
|
|
* @since 2.3.0
|
|
*/
|
|
protected static function increment_display_count() {
|
|
$option = get_option( self::$option_name );
|
|
$count = isset( $option['display_count'] ) ? (int) $option['display_count'] : 0;
|
|
$count++;
|
|
|
|
// If we've reached the display count, delete the option so the notice isn't displayed again.
|
|
if ( $count >= self::$display_count ) {
|
|
delete_option( self::$option_name );
|
|
} else {
|
|
$option['display_count'] = $count;
|
|
update_option( self::$option_name, $option );
|
|
}
|
|
}
|
|
}
|