notices[ $slug ] = [
'class' => $class,
'message' => $message,
'dismissible' => $dismissible,
'actions' => $actions,
];
}
/**
* Display any notices we've collected thus far.
*
* @since 1.0.0
* @version 4.0.0
*
* @return void
*/
public function admin_notices() {
if ( ! current_user_can( 'manage_woocommerce' ) ) {
return;
}
// Main Stripe payment method.
$this->stripe_check_environment();
// All other payment methods.
$this->payment_methods_check_environment();
// Check for merchants affected by ECE button location bug.
// https://github.com/woocommerce/woocommerce-gateway-stripe/issues/4861
$this->check_express_checkout_location();
// Check for subscriptions detached from the customer.
if ( WC_Stripe_Subscriptions_Helper::is_subscriptions_enabled() ) {
$this->subscription_check_detachment();
$this->subscription_check_detachment_bulk_action();
}
foreach ( (array) $this->notices as $notice_key => $notice ) {
$actions = $notice['actions'] ?? [];
$div_style = 'position:relative;';
$has_actions = count( $actions ) > 0;
if ( $has_actions ) {
// If there are actions, we need to make sure the div can contain them.
$div_style .= 'overflow: auto;';
}
echo '';
if ( $notice['dismissible'] ) {
?>
';
echo wp_kses(
$notice['message'],
[
'a' => [
'href' => [],
'target' => [],
],
'strong' => [],
'br' => [],
]
);
echo '';
if ( $has_actions ) {
foreach ( $actions as $action ) {
echo wp_kses(
$action,
[
'a' => [
'href' => [],
'style' => [],
],
]
);
}
}
echo '
', 'woocommerce-gateway-stripe' ), $upe_method->get_label(), implode( ', ', $upe_method->get_supported_currencies() ) );
}
}
$show_notice = get_option( 'wc_stripe_show_upe_payment_methods_notice' );
if ( ! empty( $currency_messages ) && 'no' !== $show_notice ) {
$this->add_admin_notice( 'upe_payment_methods', 'notice notice-error', $currency_messages, true );
}
}
/**
* Checks if the merchant may have been affected by the ECE button location bug
* in versions 10.1.0–10.2.x and displays a notice if so.
*
* @since 10.4.0
*
* @return void
*/
public function check_express_checkout_location(): void {
$show_notice = get_option( 'wc_stripe_show_ece_location_notice' );
if ( 'yes' !== $show_notice ) {
return;
}
$options = WC_Stripe_Helper::get_stripe_settings();
$enabled = isset( $options['express_checkout'] ) && 'yes' === $options['express_checkout'];
$locations = isset( $options['express_checkout_button_locations'] ) ? $options['express_checkout_button_locations'] : [];
if ( ! $enabled ) {
return;
}
$has_product = in_array( 'product', $locations, true );
$has_cart = in_array( 'cart', $locations, true );
$has_checkout = in_array( 'checkout', $locations, true );
// We only need to show the notice if we have ( product + cart ) but not checkout, so return if we have anything else.
if ( ! ( $has_product && $has_cart && ! $has_checkout ) ) {
return;
}
$settings_url = admin_url( 'admin.php?page=wc-settings&tab=checkout§ion=stripe&panel=methods&area=express_checkout' );
$message = sprintf(
/* translators: 1) HTML strong open tag 2) HTML strong closing tag 3) HTML line break tag */
__( '%1$sAction Required: Review your Stripe express checkout settings.%2$s%3$sA recent update to the Stripe plugin may have unintentionally changed where Apple Pay and Google Pay buttons appear. Currently, they are active on the product and cart pages but not on the checkout page. Please review your express checkout settings to ensure your customers have the best checkout experience.', 'woocommerce-gateway-stripe' ),
'',
'',
'
'
);
$review_action = sprintf(
'%s',
esc_url( $settings_url ),
__( 'Review Settings', 'woocommerce-gateway-stripe' )
);
$this->add_admin_notice( 'ece_location', 'notice notice-warning', $message, true, [ $review_action ] );
}
/**
* Adds a notice to the subscription details page if we are looking at an active subscription and the payment method has been detached.
*
* @return void
*/
public function subscription_check_detachment() {
if ( ! WC_Stripe_Subscriptions_Helper::is_subscription_edit_page() ) {
return;
}
global $theorder;
$subscription = null;
if ( isset( $theorder ) ) {
$subscription = $theorder;
} elseif ( ! empty( $GLOBALS['post']->ID ) ) { // If $theorder is empty (i.e. non-HPOS), fallback to using the global post object.
$subscription = wcs_get_subscription( $GLOBALS['post']->ID );
}
if ( ! isset( $subscription ) || ! $subscription instanceof WC_Subscription ) {
return;
}
if ( ! $subscription->has_status( [ 'active' ] ) ) {
// Only show the notice for active subscriptions.
return;
}
if ( WC_Stripe_Subscriptions_Helper::is_subscription_payment_method_detached( $subscription ) ) {
$customer_payment_method_link = sprintf(
'%s',
esc_url( $subscription->get_change_payment_method_url() ),
esc_html(
/* translators: this is a text for a link pointing to the customer's payment method page */
__( 'Payment method page →', 'woocommerce-gateway-stripe' )
)
);
$customer_stripe_page = sprintf(
'%s',
esc_url( WC_Stripe_Subscriptions_Helper::STRIPE_CUSTOMER_PAGE_BASE_URL . WC_Stripe_Order_Helper::get_instance()->get_stripe_customer_id( $subscription ) ),
esc_html(
/* translators: this is a text for a link pointing to the customer's page on Stripe */
__( 'Stripe customer page →', 'woocommerce-gateway-stripe' )
)
);
$detached_message = __( 'The payment method for this subscription has been detached, preventing renewals. ', 'woocommerce-gateway-stripe' );
$detached_message .= __( 'To fix this, either:
', 'woocommerce-gateway-stripe' );
$detached_message .= __( '1) Share the payment method page link with the customer to update it: ', 'woocommerce-gateway-stripe' ) . $customer_payment_method_link . '
';
$detached_message .= __( ' or
', 'woocommerce-gateway-stripe' );
$detached_message .= __( "2) Manually update the payment method in the subscription's billing details using a valid payment method from the customer's Stripe account: ", 'woocommerce-gateway-stripe' ) . $customer_stripe_page . '
';
$detached_message .= '
' . sprintf(
/* translators: 1) HTML anchor open tag 2) HTML anchor closing tag 3) The already-translated title of the tool*/
__( 'To list all your current subscriptions with payment methods detached, go to WooCommerce -> Status -> %1$sTools%2$s -> %3$s.', 'woocommerce-gateway-stripe' ),
'',
'',
__( 'List Stripe subscriptions with detached payment method', 'woocommerce-gateway-stripe' ),
);
$this->add_admin_notice( 'subscription_detached', 'notice notice-error', $detached_message );
}
}
/**
* Add a notice to the admin area if there are subscriptions with payment method detached.
*
* @return void
*/
public function subscription_check_detachment_bulk_action() {
if ( isset( $_REQUEST['detached-subscriptions'] ) && 'no' !== get_option( 'wc_stripe_show_subscription_detached_bulk_action_notice' ) ) {
$notice_content = '' . esc_html__( 'No detached subscriptions found.', 'woocommerce-gateway-stripe' ) . '
';
$notice_class = 'info';
if ( ! empty( $_REQUEST['detached-subscriptions'] ) ) {
$detached_subs_ids = explode( ',', sanitize_text_field( wp_unslash( $_REQUEST['detached-subscriptions'] ) ) );
$subscriptions = [];
foreach ( $detached_subs_ids as $detached_sub_id ) {
$detached_sub_id = absint( $detached_sub_id );
$subscription = wcs_get_subscription( $detached_sub_id );
if ( ! $subscription instanceof WC_Subscription ) {
continue;
}
$subscriptions[] = WC_Stripe_Subscriptions_Helper::get_detached_payment_data_from_subscription( $subscription );
}
$detached_messages = WC_Stripe_Subscriptions_Helper::build_subscriptions_detached_messages( $subscriptions );
if ( ! empty( $detached_messages ) ) {
$notice_content = '';
$notice_content .= wp_kses(
$detached_messages,
[
'a' => [
'href' => [],
'target' => [],
],
'strong' => [],
'br' => [],
]
);
$notice_content .= '
';
$notice_class = 'error';
}
}
$this->add_admin_notice( 'subscription_detached_bulk_action', 'notice notice-' . $notice_class, $notice_content, true );
}
}
/**
* Environment check for subscriptions.
*
* @return void
*
* @deprecated 9.6.0 This method is no longer used and will be removed in a future version.
*/
public function subscriptions_check_environment() {
_deprecated_function( __METHOD__, '9.6.0' );
$options = WC_Stripe_Helper::get_stripe_settings();
if ( 'yes' === ( $options['enabled'] ?? null ) && 'no' !== get_option( 'wc_stripe_show_subscriptions_notice' ) ) {
$subscriptions = WC_Stripe_Subscriptions_Helper::get_some_detached_subscriptions();
$detached_messages = WC_Stripe_Subscriptions_Helper::build_subscriptions_detached_messages( $subscriptions );
if ( ! empty( $detached_messages ) ) {
$this->add_admin_notice( 'subscriptions', 'notice notice-error', $detached_messages, true );
}
}
}
/**
* Hides any admin notices.
*
* @since 4.0.0
* @version 4.0.0
*
* @return void
*/
public function hide_notices() {
if ( isset( $_GET['wc-stripe-hide-notice'] ) && isset( $_GET['_wc_stripe_notice_nonce'] ) ) {
if ( ! wp_verify_nonce( wc_clean( wp_unslash( $_GET['_wc_stripe_notice_nonce'] ) ), 'wc_stripe_hide_notices_nonce' ) ) {
wp_die( esc_html__( 'Action failed. Please refresh the page and retry.', 'woocommerce-gateway-stripe' ) );
}
if ( ! current_user_can( 'manage_woocommerce' ) ) {
wp_die( esc_html__( 'Cheatin’ huh?', 'woocommerce-gateway-stripe' ) );
}
$notice = wc_clean( wp_unslash( $_GET['wc-stripe-hide-notice'] ) );
switch ( $notice ) {
case 'style':
update_option( 'wc_stripe_show_style_notice', 'no' );
break;
case 'phpver':
update_option( 'wc_stripe_show_phpver_notice', 'no' );
break;
case 'wcver':
update_option( 'wc_stripe_show_wcver_notice', 'no' );
break;
case 'curl':
update_option( 'wc_stripe_show_curl_notice', 'no' );
break;
case 'ssl':
update_option( 'wc_stripe_show_ssl_notice', 'no' );
break;
case 'keys':
update_option( 'wc_stripe_show_keys_notice', 'no' );
break;
case '3ds':
update_option( 'wc_stripe_show_3ds_notice', 'no' );
break;
case 'sofort':
update_option( 'wc_stripe_show_sofort_notice', 'no' );
update_option( 'wc_stripe_show_sofort_upe_notice', 'no' );
break;
case 'sca':
update_option( 'wc_stripe_show_sca_notice', 'no' );
break;
case 'changed_keys':
update_option( 'wc_stripe_show_changed_keys_notice', 'no' );
break;
case 'legacy_deprecation':
update_option( 'wc_stripe_show_legacy_deprecation_notice', 'no' );
break;
case 'payment_methods':
update_option( 'wc_stripe_show_payment_methods_notice', 'no' );
break;
case 'upe_payment_methods':
update_option( 'wc_stripe_show_upe_payment_methods_notice', 'no' );
break;
case 'oauth_required':
update_option( 'wc_stripe_show_oauth_required_notice', 'no' );
break;
case 'subscriptions':
update_option( 'wc_stripe_show_subscriptions_notice', 'no' );
break;
case 'subscription_detached_bulk_action':
update_option( 'wc_stripe_show_subscription_detached_bulk_action_notice', 'no' );
// Redirect back to the current page without the query param to hide the notice to avoid issues.
if ( isset( $_SERVER['REQUEST_URI'] ) ) {
wp_safe_redirect( remove_query_arg( [ 'wc-stripe-hide-notice', '_wc_stripe_notice_nonce' ], esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) );
}
break;
case 'ece_location':
update_option( 'wc_stripe_show_ece_location_notice', 'no' );
break;
}
}
}
/**
* Get setting link.
*
* @since 1.0.0
*
* @return string Setting link
*/
public function get_setting_link() {
return esc_url( admin_url( 'admin.php?page=wc-settings&tab=checkout§ion=stripe&panel=settings' ) );
}
/**
* Saves options in order to hide notices based on the gateway's version.
*
* @since 4.3.0
*
* @return void
*/
public function stripe_updated() {
$previous_version = get_option( 'wc_stripe_version' );
// Only show the style notice if the plugin was installed and older than 4.1.4.
if ( empty( $previous_version ) || version_compare( $previous_version, '4.1.4', 'ge' ) ) {
update_option( 'wc_stripe_show_style_notice', 'no' );
}
// Only show the SCA notice on pre-4.3.0 installs.
if ( empty( $previous_version ) || version_compare( $previous_version, '4.3.0', 'ge' ) ) {
update_option( 'wc_stripe_show_sca_notice', 'no' );
}
// Set the ECE location notice flag if upgrading from the affected version range (10.1.0–10.2.x).
// A bug in these versions reset express checkout button locations during upgrade.
$was_affected_version = ! empty( $previous_version )
&& version_compare( $previous_version, '10.1.0', '>=' )
&& version_compare( $previous_version, '10.4.0', '<' );
if ( $was_affected_version && 'no' !== get_option( 'wc_stripe_show_ece_location_notice' ) ) {
update_option( 'wc_stripe_show_ece_location_notice', 'yes' );
}
}
}