=' ) ) {
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( sanitize_text_field( wp_unslash( $_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( '3.1', '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' => __( 'v3 REST API endpoint support', 'woocommerce-subscriptions' ),
'description' => sprintf(
// translators: 1-3: opening/closing tags - link to documentation.
__( 'Webhook and REST API users can now use v3 subscription endpoints. Click here to %1$slearn more%2$s about the REST API and check out the technical API docs %3$shere%2$s.', 'woocommerce-subscriptions' ),
'',
'',
''
),
),
array(
'title' => __( 'WooCommerce checkout and cart blocks integration', 'woocommerce-subscriptions' ),
'description' => sprintf(
// translators: 1-2: opening/closing tags - link to documentation.
__( 'Subscriptions is now compatible with the WooCommerce cart and checkout blocks. You can learn more about the compatibility status of the cart & checkout blocks %1$shere%2$s.', 'woocommerce-subscriptions' ),
'', ''
),
),
);
// translators: placeholder is Subscription version string ('3.1')
$notice->set_heading( sprintf( __( 'Welcome to WooCommerce Subscriptions %s!', 'woocommerce-subscriptions' ), $version ) );
$notice->set_content_template( 'update-welcome-notice.php', WC_Subscriptions_Core_Plugin::instance()->get_subscriptions_core_directory() . '/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/whats-new-in-subscriptions-3-1/',
),
) );
$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 );
}
}
}