
本教程旨在解决 MemberPress 与 MemberPress Corporate 集成时,非订阅型交易中企业账户 ID 获取异常的问题。当 `mepr-event-transaction-completed` 钩子触发时,`corporate_account_id` 可能为 0,即使数据库中存在。文章提供了一种基于 `wp_schedule_single_event` 的延迟处理机制作为临时解决方案,确保在交易完成后能正确获取并处理企业账户信息,直至 MemberPress 官方修复此潜在缺陷。
在使用 MemberPress 和 MemberPress Corporate 插件时,开发者通常会通过 mepr-event-transaction-completed 钩子来监听交易完成事件,并执行自定义逻辑。这个钩子适用于订阅型和非订阅型交易。然而,在处理非订阅型(一次性支付)的会员注册或购买特定会员类型时,尝试通过 $transaction->corporate_account_id 获取企业账户 ID 可能会遇到一个问题:尽管数据库中明确存在对应的企业账户 ID,但在钩子触发时,该值却返回 0。
例如,以下代码片段展示了通常的尝试:
add_action('mepr-event-transaction-completed', 'my_custom_transaction_handler');
function my_custom_transaction_handler($event) {
$transaction = $event->get_data();
$membership_type_ids = array(1, 2, 4); // 示例会员类型 ID
// 检查是否为指定会员类型且交易类型为支付
if (in_array($transaction->product_id, $membership_type_ids) && $transaction->txn_type == 'payment') {
$org_id = $transaction->corporate_account_id;
// 预期在这里使用 $org_id 进行自定义操作
my_custom_function($org_id);
}
}对于订阅型交易,上述代码能够正确获取 corporate_account_id。但对于非订阅型交易,$org_id 却意外地为 0,这阻碍了依赖此 ID 的后续业务逻辑。
经过与 MemberPress 官方的沟通,确认这是一个已知的时序问题:在 mepr-event-transaction-completed 钩子触发时,对于非订阅型交易,corporate_account_id 尚未被完全设置或同步到 $transaction 对象中。这意味着在事件处理的当下,所需的企业账户 ID 无法直接获取。
为了规避这个时序问题,可以采用一种延迟处理的策略。即在 corporate_account_id 返回 0 的情况下,不立即处理,而是调度一个单次定时任务 (wp_schedule_single_event),在稍后的时间点(例如几分钟后)再执行获取和处理逻辑。这样可以确保在定时任务执行时,MemberPress 已经完成了所有数据设置,包括 corporate_account_id。
在主事件钩子中判断并调度任务: 在 mepr-event-transaction-completed 钩子中,首先检查 corporate_account_id 是否为 0。如果为 0,则调度一个 wp_schedule_single_event 任务。
定义定时任务的回调函数: 创建一个新的函数,作为 wp_schedule_single_event 的回调。在这个函数中,根据之前保存的交易编号 (trans_num) 重新获取完整的交易对象,此时 corporate_account_id 应该已经可用。
// 挂载到 MemberPress 交易完成事件
add_action('mepr-event-transaction-completed', 'handle_corporate_transaction_delayed');
function handle_corporate_transaction_delayed($event) {
$transaction = $event->get_data();
$membership_type_ids = array(1, 2, 4); // 示例:需要处理的会员类型 ID 数组
// 确保是指定会员类型且为支付交易
if (in_array($transaction->product_id, $membership_type_ids) && $transaction->txn_type == 'payment') {
// 检查 corporate_account_id 是否有效
// 注意:MemberPress 有时会将 ID 存储为字符串 "0"
if ($transaction->corporate_account_id !== "0" && $transaction->corporate_account_id !== 0) {
// 如果 corporate_account_id 已经可用,则直接执行自定义逻辑
// 这里可以放置原本依赖 corporate_account_id 的代码
// my_custom_function($transaction->corporate_account_id);
// write_log('Corporate ID available immediately for transaction: ' . $transaction->trans_num);
} else {
// 如果 corporate_account_id 返回 0,则调度一个单次事件进行延迟处理
// 记录日志以便追踪
error_log('MemberPress: Corporate ID returned as 0 for transaction ' . $transaction->trans_num . '. Scheduling cron job for delayed processing.');
// 调度一个在 2 分钟后触发的单次事件
// 'send_fix_for_zero_transaction' 是自定义的钩子名称
// 传递 $transaction 对象作为参数
wp_schedule_single_event(
strtotime("+2 minutes"),
'send_fix_for_zero_transaction',
array($transaction) // 传递原始交易对象
);
// 返回,等待定时任务执行后续逻辑
return;
}
}
}
// 定义定时任务的回调函数
add_action('send_fix_for_zero_transaction', 'single_transaction_create_corporate');
/**
* 处理由于 MemberPress Bug 导致的非订阅交易中 corporate_account_id 为 0 的情况。
* 此函数通过交易编号重新获取完整交易数据,并执行后续操作。
* @param MeprTransaction $transaction 原始的 MemberPress 交易对象。
*/
function single_transaction_create_corporate($transaction) {
// 注意:此函数仅在 MemberPress 存在 bug 导致 corporate_id 未及时设置时使用。
// 预计在 MemberPress 修复此问题后,此代码将被弃用。
$trans_num = $transaction->trans_num;
// 通过交易编号重新获取完整的交易对象
// 此时 MemberPress 应该已经完成了所有数据的设置
$full_trans = MeprTransaction::get_one_by_trans_num($trans_num);
if ($full_trans) {
$corporate_id = $full_trans->corporate_account_id;
// 再次检查 corporate_id 是否有效
if ($corporate_id !== "0" && $corporate_id !== 0) {
// 此时 $corporate_id 应该已经可以正确获取
error_log('MemberPress: Successfully retrieved corporate ID ' . $corporate_id . ' for transaction ' . $trans_num . ' via delayed cron job.');
// 在这里执行您原本依赖 corporate_account_id 的自定义逻辑
// 例如:
// my_custom_function_with_corporate_id($corporate_id, $full_trans);
} else {
error_log('MemberPress: Failed to retrieve corporate ID even after delayed processing for transaction ' . $trans_num);
}
} else {
error_log('MemberPress: Could not find transaction ' . $trans_num . ' for delayed processing.');
}
}
// 辅助函数:如果需要将日志写入文件,可以使用此函数
// function write_log($message) {
// if (WP_DEBUG === true) {
// if (is_array($message) || is_object($message)) {
// error_log(print_r($message, true));
// } else {
// error_log($message);
// }
// }
// }handle_corporate_transaction_delayed($event) 函数:
single_transaction_create_corporate($transaction) 函数:
通过利用 wp_schedule_single_event 机制,我们成功地绕过了 MemberPress 在非订阅交易中 corporate_account_id 无法及时获取的问题。这种延迟处理策略虽然是临时的,但能有效确保业务逻辑的正确执行,为开发者提供了在等待官方修复期间的可靠解决方案。务必结合错误日志和定期检查插件更新,以维护系统的稳定性和效率。
以上就是解决 MemberPress 非订阅交易中企业账户 ID 获取异常的教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号