本文详解如何在wordpress tutor插件课程构建表单中，实现点击“提交审核”或“发布课程”按钮后，在保存数据的同时自动跳转至自定义url，涵盖php服务端重定向、执行时机控制及常见错误规避。
本文详解如何在wordpress tutor插件课程构建表单中，实现点击“提交审核”或“发布课程”按钮后，在保存数据的同时自动跳转至自定义url，涵盖php服务端重定向、执行时机控制及常见错误规避。
在WordPress + Tutor插件的课程构建流程中，用户点击“Submit for Review”或“Publish Course”按钮后，默认行为是刷新当前页面并显示保存结果。若需强制跳转至另一页面（例如课程列表页、成功提示页或外部链接），必须在表单提交后的服务端处理逻辑中插入重定向指令——且必须在任何HTML输出之前执行。
✅ 正确的重定向方式：header() + exit()
PHP中唯一可靠、符合HTTP规范的重定向方法是使用 header() 函数配合 exit() 或 die()：
// 示例：在表单处理逻辑末尾添加（务必放在所有echo/print/output之前）
if (isset($_POST['course_submit_btn']) && in_array($_POST['course_submit_btn'], ['submit_for_review', 'publish_course'])) {
// ✅ 执行课程保存逻辑（如wp_update_post、tutor_save_course等）
$post_id = tutor_utils()->save_course();
// ✅ 重定向前确保无任何输出（包括空格、BOM、调试echo）
if ($post_id) {
wp_redirect('https://yoursite.com/thank-you/'); // 推荐使用wp_redirect()（兼容WordPress重定向钩子）
exit; // 必须终止脚本，防止后续内容输出破坏重定向
}
}⚠️ 注意：wp_redirect() 是WordPress封装的安全版 header("Location: ...")，自动处理协议、主机名，并兼容多站点与SSL；切勿使用 header() 直接硬编码URL，否则可能因缺少 exit 导致重定向失败，或因输出已发送而触发 headers already sent 错误。
? 定位表单处理入口
上述逻辑不能写在前端模板文件（如 course-builder.php）中，而应注入到Tutor插件实际处理表单提交的PHP文件中。常见位置包括：
- tutor/classes/ course.php 中的 save_course() 方法回调；
- 主题 functions.php 中监听 tutor_course_saved 或 wp_insert_post 动作钩子；
- 推荐做法（安全且可维护）：
// 添加到主题 functions.php 或专用插件文件
add_action('tutor_course_saved', 'redirect_after_course_submission', 10, 2);
function redirect_after_course_submission($post_id, $post) {
// 仅对前台提交且为审核/发布动作生效
if (defined('DOING_AJAX') && DOING_AJAX) return;
if (!isset($_POST['course_submit_btn'])) return;
$action = sanitize_text_field($_POST['course_submit_btn']);
if (!in_array($action, ['submit_for_review', 'publish_course'])) return;
// 设置跳转URL（支持动态参数）
$redirect_url = add_query_arg(
['course_id' => $post_id, 'status' => $action],
'https://yoursite.com/course-submitted/'
);
wp_safe_redirect($redirect_url); // 更安全的重定向（校验URL合法性）
exit;
}❗ 关键注意事项
- 输出缓冲不是万能解药：虽可用 ob_start() 缓冲输出，但违背WordPress最佳实践，易引发不可预测问题，不推荐用于生产环境；
- AJAX提交场景不同：若按钮通过JS异步提交（如Tutor部分流程），则需改用JavaScript重定向（window.location.href = '...'），并在AJAX成功回调中执行；
- 权限与验证：重定向前务必校验用户权限（如 current_user_can('edit_post', $post_id)）和nonce（wp_verify_nonce()），防止越权跳转；
- SEO与用户体验：对“Save as Draft”按钮通常不应重定向，因其属于中间状态；重定向建议仅限终态操作（提交审核/发布）。
✅ 总结
实现WordPress表单提交后重定向的核心在于：在服务端保存逻辑完成后的第一时间，调用 wp_safe_redirect() + exit，并确保该逻辑挂载在正确的动作钩子上（如 tutor_course_saved）。避免在模板层操作、杜绝前置输出、优先使用WordPress原生重定向函数——这既是技术严谨性的体现，也是保障站点稳定与安全的必要实践。
