Yoone Moneris Payments 需要 WooCommerce 插件已启用。
'; } ); // 由于 Woo 未启用，直接返回，不再继续初始化插件逻辑。 return; } // 加载常量/接口/工具与类：require_once 是 PHP 语句，确保文件仅加载一次； // __DIR__ 是当前文件所在目录，拼接 includes 路径以找到类定义文件。 require_once __DIR__ . '/includes/constants/moneris.php'; require_once __DIR__ . '/includes/interfaces/class-yoone-moneris-api-interface.php'; // 加载交易类型常量接口，统一交易类型字符串，避免在使用处多次 require require_once __DIR__ . '/includes/interfaces/class-yoone-moneris-txn-types.php'; require_once __DIR__ . '/includes/utils/logger.php'; require_once __DIR__ . '/includes/class-yoone-moneris-api.php'; require_once __DIR__ . '/includes/class-yoone-gateway-moneris.php'; // 注册到 WooCommerce 支付网关列表：add_filter 是 WordPress 的过滤器钩子 API， // 'woocommerce_payment_gateways' 钩子在 Woo 初始化网关列表时触发，回调接收现有网关类名数组 $methods； // 我们把自定义网关类名 'Yoone_Gateway_Moneris' 追加进去并返回。 add_filter( 'woocommerce_payment_gateways', function( $methods ) { $methods[] = 'Yoone_Gateway_Moneris'; return $methods; } ); } // 在 WordPress 的 'plugins_loaded' 钩子上注册初始化函数： // 'plugins_loaded' 在所有插件加载完成后触发，优先级 0 表示尽早执行； // 这样可以保证 WooCommerce 已加载，从而我们的初始化逻辑能正确检测与注册网关。 add_action( 'plugins_loaded', 'yoone_moneris_payments_init', 0 ); /** * 声明 HPOS 兼容（如启用） */ // 说明：HPOS（High-Performance Order Storage）是 WooCommerce 的高性能订单存储机制； // 若站点启用该特性，插件需要声明兼容，避免因订单数据结构变化导致不兼容问题。 function yoone_moneris_declare_hpos_compat() { if ( class_exists( '\\Automattic\\WooCommerce\\Utilities\\FeaturesUtil' ) ) { \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility( 'custom_order_tables', __FILE__, true ); } } // 在 WooCommerce 初始化前（'before_woocommerce_init' 钩子）注册兼容性声明函数： // 该钩子在 Woo 启动早期触发，确保 Woo 在初始化过程中已经知道本插件对 HPOS 的兼容性。 add_action( 'before_woocommerce_init', 'yoone_moneris_declare_hpos_compat' ); /** * 检测是否使用了 WooCommerce Blocks 结账但当前网关未提供 Blocks 集成，提示管理员。 */ function yoone_moneris_blocks_checkout_admin_notice() { if ( ! class_exists( 'WooCommerce' ) ) { return; } // 仅在后台提示 if ( ! is_admin() ) { return; } // 网关是否启用 $settings = get_option( 'woocommerce_yoone_moneris_settings', array() ); $enabled = isset( $settings['enabled'] ) ? $settings['enabled'] : 'no'; if ( 'yes' !== $enabled ) { return; } // 检查结账页是否为 Blocks 结账 $checkout_id = function_exists( 'wc_get_page_id' ) ? wc_get_page_id( 'checkout' ) : 0; if ( $checkout_id && function_exists( 'has_block' ) ) { $post = get_post( $checkout_id ); if ( $post && has_block( 'woocommerce/checkout', $post ) ) { // 当前插件未提供 Blocks 前端集成，因此 Blocks 结账不会显示本网关 add_action( 'admin_notices', function() { echo 'Yoone Moneris Payments 当前未集成 WooCommerce Blocks 结账。如果你的结账页使用了 Blocks，请改用经典结账（在结账页添加短代码 [woocommerce_checkout] 并在 WooCommerce → 设置 → 高级 中设置该页面为结账页），或联系开发者添加 Blocks 集成。