mirror of
https://github.com/woocommerce/woocommerce-paypal-payments.git
synced 2025-09-06 14:57:26 +08:00
179 lines
6.9 KiB
PHP
179 lines
6.9 KiB
PHP
<?php
|
|
/**
|
|
* Settings notice generator.
|
|
* Generates the settings notices.
|
|
*
|
|
* @package WooCommerce\PayPalCommerce\Axo\Helper
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace WooCommerce\PayPalCommerce\Axo\Helper;
|
|
|
|
use WooCommerce\PayPalCommerce\WcGateway\Helper\CartCheckoutDetector;
|
|
use WooCommerce\PayPalCommerce\WcGateway\Settings\Settings;
|
|
use WooCommerce\PayPalCommerce\WcGateway\Exception\NotFoundException;
|
|
|
|
/**
|
|
* Class SettingsNoticeGenerator
|
|
*/
|
|
class SettingsNoticeGenerator {
|
|
/**
|
|
* Generates the full HTML of the notification.
|
|
*
|
|
* @param string $message HTML of the inner message contents.
|
|
* @param bool $is_error Whether the provided message is an error. Affects the notice color.
|
|
*
|
|
* @return string The full HTML code of the notification, or an empty string.
|
|
*/
|
|
private function render_notice( string $message, bool $is_error = false ) : string {
|
|
if ( ! $message ) {
|
|
return '';
|
|
}
|
|
|
|
return sprintf(
|
|
'<div class="ppcp-notice %1$s"><p>%2$s</p></div>',
|
|
$is_error ? 'ppcp-notice-error' : '',
|
|
$message
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Generates the checkout notice.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function generate_checkout_notice(): string {
|
|
$checkout_page_link = esc_url( get_edit_post_link( wc_get_page_id( 'checkout' ) ) ?? '' );
|
|
$block_checkout_docs_link = __(
|
|
'https://woocommerce.com/document/cart-checkout-blocks-status/#reverting-to-the-cart-and-checkout-shortcodes',
|
|
'woocommerce-paypal-payments'
|
|
);
|
|
|
|
$notice_content = '';
|
|
|
|
if ( CartCheckoutDetector::has_elementor_checkout() ) {
|
|
$notice_content = sprintf(
|
|
/* translators: %1$s: URL to the Checkout edit page. %2$s: URL to the block checkout docs. */
|
|
__(
|
|
'<span class="highlight">Warning:</span> The <a href="%1$s">Checkout page</a> of your store currently uses the <code>Elementor Checkout widget</code>. To enable Fastlane and accelerate payments, the page must include either the <code>Classic Checkout</code> or the <code>[woocommerce_checkout]</code> shortcode. See <a href="%2$s">this page</a> for instructions on how to switch to the classic layout.',
|
|
'woocommerce-paypal-payments'
|
|
),
|
|
esc_url( $checkout_page_link ),
|
|
esc_url( $block_checkout_docs_link )
|
|
);
|
|
} elseif ( CartCheckoutDetector::has_block_checkout() ) {
|
|
$notice_content = sprintf(
|
|
/* translators: %1$s: URL to the Checkout edit page. %2$s: URL to the block checkout docs. */
|
|
__(
|
|
'<span class="highlight">Warning:</span> The <a href="%1$s">Checkout page</a> of your store currently uses the WooCommerce <code>Checkout</code> block. To enable Fastlane and accelerate payments, the page must include either the <code>Classic Checkout</code> or the <code>[woocommerce_checkout]</code> shortcode. See <a href="%2$s">this page</a> for instructions on how to switch to the classic layout.',
|
|
'woocommerce-paypal-payments'
|
|
),
|
|
esc_url( $checkout_page_link ),
|
|
esc_url( $block_checkout_docs_link )
|
|
);
|
|
} elseif ( ! CartCheckoutDetector::has_classic_checkout() ) {
|
|
$notice_content = sprintf(
|
|
/* translators: %1$s: URL to the Checkout edit page. %2$s: URL to the block checkout docs. */
|
|
__(
|
|
'<span class="highlight">Warning:</span> The <a href="%1$s">Checkout page</a> of your store does not seem to be properly configured or uses an incompatible <code>third-party Checkout</code> solution. To enable Fastlane and accelerate payments, the page must include either the <code>Classic Checkout</code> or the <code>[woocommerce_checkout]</code> shortcode. See <a href="%2$s">this page</a> for instructions on how to switch to the classic layout.',
|
|
'woocommerce-paypal-payments'
|
|
),
|
|
esc_url( $checkout_page_link ),
|
|
esc_url( $block_checkout_docs_link )
|
|
);
|
|
}
|
|
|
|
return $notice_content ? '<div class="ppcp-notice ppcp-notice-error"><p>' . $notice_content . '</p></div>' : '';
|
|
}
|
|
|
|
/**
|
|
* Generates the shipping notice.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function generate_shipping_notice(): string {
|
|
$shipping_settings_link = admin_url( 'admin.php?page=wc-settings&tab=shipping§ion=options' );
|
|
|
|
$notice_content = '';
|
|
|
|
if ( wc_shipping_enabled() && wc_ship_to_billing_address_only() ) {
|
|
$notice_content = sprintf(
|
|
/* translators: %1$s: URL to the Shipping destination settings page. */
|
|
__(
|
|
'<span class="highlight">Warning:</span> The <a href="%1$s">Shipping destination</a> of your store is currently configured to <code>Force shipping to the customer billing address</code>. To enable Fastlane and accelerate payments, the shipping destination must be configured either to <code>Default to customer shipping address</code> or <code>Default to customer billing address</code> so buyers can set separate billing and shipping details.',
|
|
'woocommerce-paypal-payments'
|
|
),
|
|
esc_url( $shipping_settings_link )
|
|
);
|
|
}
|
|
|
|
return $notice_content ? '<div class="ppcp-notice ppcp-notice-error"><p>' . $notice_content . '</p></div>' : '';
|
|
}
|
|
|
|
/**
|
|
* Generates the incompatible plugins notice.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function generate_incompatible_plugins_notice(): string {
|
|
$incompatible_plugins = array(
|
|
'Elementor' => did_action( 'elementor/loaded' ),
|
|
'CheckoutWC' => defined( 'CFW_NAME' ),
|
|
);
|
|
|
|
$active_plugins_list = array_filter( $incompatible_plugins );
|
|
|
|
if ( empty( $active_plugins_list ) ) {
|
|
return '';
|
|
}
|
|
|
|
$incompatible_plugin_items = array_map(
|
|
function ( $plugin ) {
|
|
return "<li>{$plugin}</li>";
|
|
},
|
|
array_keys( $active_plugins_list )
|
|
);
|
|
|
|
$plugins_settings_link = esc_url( admin_url( 'plugins.php' ) );
|
|
$notice_content = sprintf(
|
|
/* translators: %1$s: URL to the plugins settings page. %2$s: List of incompatible plugins. */
|
|
__(
|
|
'<span class="highlight">Note:</span> The accelerated guest buyer experience provided by Fastlane may not be fully compatible with some of the following <a href="%1$s">active plugins</a>: <ul class="ppcp-notice-list">%2$s</ul>',
|
|
'woocommerce-paypal-payments'
|
|
),
|
|
$plugins_settings_link,
|
|
implode( '', $incompatible_plugin_items )
|
|
);
|
|
|
|
return '<div class="ppcp-notice"><p>' . $notice_content . '</p></div>';
|
|
}
|
|
|
|
/**
|
|
* Generates a warning notice with instructions on conflicting plugin-internal settings.
|
|
*
|
|
* @param Settings $settings The plugin settings container, which is checked for conflicting
|
|
* values.
|
|
* @return string
|
|
*/
|
|
public function generate_settings_conflict_notice( Settings $settings ) : string {
|
|
$notice_content = '';
|
|
$is_dcc_enabled = false;
|
|
|
|
try {
|
|
$is_dcc_enabled = $settings->has( 'dcc_enabled' ) && $settings->get( 'dcc_enabled' );
|
|
// phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch
|
|
} catch ( NotFoundException $ignored ) {
|
|
// Never happens.
|
|
}
|
|
|
|
if ( ! $is_dcc_enabled ) {
|
|
$notice_content = __(
|
|
'<span class="highlight">Warning:</span> To enable Fastlane and accelerate payments, the <strong>Advanced Card Processing</strong> payment method must also be enabled.',
|
|
'woocommerce-paypal-payments'
|
|
);
|
|
}
|
|
|
|
return $this->render_notice( $notice_content, true );
|
|
}
|
|
}
|
