Team Booking WordPress 预约排班插件[更至v3.0.14]

在线预约排班系统 TheBooking

一款深度集成 Google Calendar 的 WordPress 预约管理插件，前身为 TeamBooking，支持团队协作排班、在线支付、Zoom / Google Meet 虚拟会议集成，适用于各类需要预约排班的服务场景。

核心亮点：三方 Google Calendar 深度同步

TheBooking 的最大特色在于与 Google Calendar 的深度整合，可直接在 Google Calendar 中规划可用时段，客户预约后自动生成包含预约详情的新事件：

• 在 Google Calendar 中创建事件即定义可用时段，客户可自助选择空位完成预约
• 预约成立后插件自动在 Google Calendar 中生成对应事件，保留完整预约信息
• 无需逐个手动创建时段，支持重复循环事件和全天事件批量生成

团队协作排班

支持多人协作排班，可指定 WordPress 用户角色作为服务提供者，各提供者在自己的 Google Calendar 中独立管理可用时段，插件自动合并汇总，无需担心时间冲突。适合多教练 / 多咨询师 / 多技师团队使用。

灵活的服务与表单配置

支持创建无限数量的独立服务，每个服务均可配置专属预约表单，可选服务类型包括：

• 固定时段预约：一对一咨询、团体课、医疗预约等需要精确时间的场景
• 工单 / 报价请求：技术支持、报价咨询等无需指定具体时段的场景

在线支付与营销工具

开箱即用，集成 PayPal 和 Stripe（含 iDEAL、ApplePay、GooglePay），无需编写代码即可收款。同时支持创建折扣券和限时促销活动，可按时间段、星期几等多种条件灵活设置，驱动转化。

虚拟会议自动集成

预约成功后自动在 Zoom 或 Google Meet 中创建虚拟会议，并将参会链接通过邮件发送给客户。后台可直接发起会议并推送通知，全程无需手动操作。

关键功能一览

• 三方 Google Calendar 同步：用 Google Calendar 管理可用时段并自动同步预约记录
• 团队协作排班：多角色协同，时段自动合并，权限灵活控制
• 自定义预约表单：拖拽式表单构建器，满足不同服务的数据收集需求
• 时区自动识别：自动检测客户本地时区，减少跨时区预约错误
• 多语言支持：完整 WPML 兼容，可面向多语言用户提供服务
• 支付收款：PayPal + Stripe 主流支付，信用卡、ApplePay、GooglePay 全覆盖
• 促销工具：折扣券、限时活动、分时段定价
• 通知邮件：支持动态数据的自定义邮件模板，预约全流程自动提醒
• 数据导出：预约记录一键导出为 CSV 或 XLSX
• 虚拟会议：Zoom / Google Meet 无缝对接，预约成功后自动创建会议

常见问题

必须连接 Google Calendar 才能使用吗？ 不需要，Google Calendar 同步为可选项，也可直接在插件后台规划可用时段。 客户预约需要注册 Google 账号吗？ 不需要，客户无需登录 Google 或任何其他平台即可完成预约。 支持创建重复循环或全天时段吗？ 支持，可在 Google Calendar 或插件后台批量创建重复循环事件，系统自动匹配可用性，大幅减少手动操作。 支持多日活动吗？ 目前暂不支持多日事件，团队正在持续迭代，未来版本将提供该功能。 可以隐藏时段的结束时间显示吗？ 可以，但时段实际时长仍然存在，只是前端不展示；客户无法自行修改时段时长。

多日历与访客权限

前端日历与短代码 TheBooking 支持创建多个前端日历，并可通过短代码或页面构建器小工具自由组合。这意味着可以为不同服务商或服务项目分别配置独立日历，也支持在同一页面混合展示多个日历。 未登录用户可见性 插件提供”仅读模式”选项，可将日历对未登录用户隐藏，仅展示基本信息而禁止操作。 用户注册引导 未注册用户在尝试预约时会收到注册邀请。默认跳转至 WordPress 标准注册页面，也可自行配置自定义注册页地址。

版本演进摘要

以下按时间倒序梳理主要版本里程碑，括号内为原文日期： v3.0（2023 年 2 月 2 日）— 重大更新 v3.0 是一次破坏性升级，带来多项核心改动：

• Google Calendar 三向同步：实现 WordPress、插件与 Google Calendar 之间双向实时同步
• PHP 版本强制要求：最低支持版本提升至 PHP 7.3
• 退款功能：支持 PayPal 与 Stripe 退款
• 表单条件字段：可根据用户填写内容动态显示 / 隐藏表单区块
• 连续时间段选择：允许用户一次选择多个相邻时间段
• Google Meet 集成：预约成功后自动生成 Google Meet 会议链接
• 前后台界面均重新设计

v2.6（2023 年 2 月前）

• Zoom 视频会议集成
• PHP 8.x 兼容性修复

v2.5.11

• 新增 WordPress 区块编辑器（Gutenberg）区块
• 重叠事件服务时间计算修正

v2.5.9

• 自动检测用户时区
• Stripe 支持 iDEAL 支付方式

v2.5.5–v2.5.7

• 修复价格显示、票数重置、优惠券应用等问题
• 新增 Stripe SCA（强客户认证）支持
• 更新 Google Batch 端点以适配最新 API

近期维护版本（v3.0.1 至 v3.0.14）主要集中在问题修复，包括 Zoom JWT 认证升级（从旧版 S2S oAuth 迁移至新系统）、Google Meet / Google Calendar 链接生成逻辑、时区处理、PayPal 证书更新等方面。

支付体系

双支付网关支持 v1.3.0 首次引入 PayPal 支付功能，标志着插件从纯预约工具升级为完整的预约 + 支付解决方案。Stripe 支付则在 v1.4.0.1 版本加入，两个网关的集成经历了多次打磨：v1.4.0.3 修复了支付网关未正确打包的问题，v1.4.0.4 处理了 Stripe 支付场景下预约确认失败的 bug，v1.4.0.7 则解决了 Stripe 网关与 PayPal 监听器之间的冲突。

审批与权限体系

三级审批机制 v1.4.1 新增审批系统，支持三种模式：无需审批（直接确认）、管理员审批（Admin approval）、协作者审批（Coworker approval）。这一功能补齐了高价值预约场景的管理闭环。 权限与角色细化 早期版本已持续完善权限边界：v1.3.6 允许管理员取消（撤销）预约，v1.4.0.1 进一步将取消权限扩展至”事件类”服务的预约。v1.4.0.5 则确保了无管理权限的协作者无法修改他人设置。

日历与前端交互

Google Calendar 深度集成 v1.3.6 实现了手动在 Google Calendar 中预订 / 取消时段槽（通过修改日程标题）；v1.3.8 突破性地支持单个协作者绑定多个 Google Calendar，并简化了协作者身份验证与日历选择流程。地图功能在 v1.3.7 首次加入，地址信息此后也会显示在时段槽列表中。 前端日历性能优化 v1.4.0.1 重点优化了日历切换月份时的加载速度，引入月份 / 年份快速选择器，整体响应更加流畅。v1.3.7 则重构了前端时段选择组件，移除了对 AJAX 调用的依赖，减少加载延迟。

后台管理体验

完整界面重构 v1.3.9 进行了全面的后台界面改版（complete admin restyle），并对 CSS 类名进行命名空间隔离以避免主题冲突。后台概览标签页持续迭代：支持多选预约记录、按预约时间或”when”值排序、搜索过滤等功能逐步加入。 TinyMCE 富文本编辑 邮件通知正文、服务描述等字段在 v1.3.5 和 v1.3.9 版本中陆续接入 TinyMCE 编辑器，管理员可直接格式化邮件内容。v1.3.9 还新增了”更新内置字段翻译”按钮。

容器模式与灵活配置

灵活部署形态 v1.3.6 引入的容器模式（Container Mode）允许以更灵活的方式配置可用性，该模式在 v1.3.9.2 中得到大量问题修复与代码重构。v1.4.0.1 支持多服务容器模式，进一步支持复杂业务场景。 设置迁移与备份

其他关键改进

• 支付网关：PayPal IPN 证书更新（解决部分 IPN 问题）、Stripe 网关完善
• 时区处理：v1.3.6 进行重大时区处理重构，DST 夏令时 bug 在 v1.3.3 修复
• 邮件通知：HTML 编辑器、文件附件支持、日期时间钩子转换修复
• 冲突修复：Bootstrap 下拉冲突、Foundation 框架与 Enfold 主题 CSS 冲突、transit.js 冲突
• 表单增强：自定义验证规则、必填选择框、文件上传白名单、已登录用户字段预填充

核心定位

TeamBooking 是一款面向 WordPress 的预约排班管理插件，支持 Google Calendar 同步、多时段购物车、WPML 多语言、Stripe / PayPal 支付、邮件提醒与自定义表单字段，适合健身房、工作室、教育培训等需要在线预约的场景。

主要功能更新脉络

v2.5.0 – 购物车与多语言

• 多时段选择（购物车）：用户可一次性预约多个可用时段，合并结算
• 完整 WPML 兼容：多语言站点无缝集成
• 邮件模板系统：支持自定义预约确认、审批、支付等邮件内容
• 前端客户列表：展示已预约用户信息
• Google Calendar 指令同步：可通过 Google Calendar 命令操控时段
• 可选模板：取消 / 审批 / 支付页面支持选择不同模板
• 服务可设为只读：限制管理员或协作者修改特定服务
• 后端列表展示历史时段：已过去的时段可在后台查看
• 持久化客户偏好：记住用户上次选择的偏好设置
• 时区选择器升级：支持搜索与时区别名

v2.4.0 – 后端管理增强

• 后端时段列表：管理员可在后台集中管理所有预约时段
• 单次使用优惠券：优惠券使用后自动失效
• 查询字符串参数：支持通过 URL 参数预设筛选条件
• 可配置筛选项：时区大陆筛选、仅在阈值以下显示余票、显示 / 隐藏地图
• 全新邮件钩子：新增 reservationid 和 servicename 变量
• do_reservation API 请求：支持程序化创建预约
• 自定义登录 URL：可指定登录页并设置预约后跳转回日历
• 自定义表单字段（meta_keys）：通过自定义字段预填充表单数据
• 优化重复事件性能：大幅提升循环时段的处理速度

v2.3.0 – 前端展示与促销

• 近期活动列表简码与小工具：可在页面 / 侧边栏展示即将到来的预约
• 促销活动限制：优惠券可设置使用次数上限与可用日期范围
• 动态已预约标题：Google Calendar 中的预约标题支持动态数据
• PayPal 结账模态窗口：优化结账流程交互
• 预约记录分页配置：每页显示条数可按用户偏好持久保存

v2.2.0 – 协作者与表单

• 协作者服务权限：可限制每位协作者只能管理特定服务
• Visual Composer 组件：支持在页面编辑器中添加 TeamBooking 元素
• 表单字段描述：每个字段可附加说明文本或 HTML
• 批量导出与筛选：预约列表支持批量选择导出与高级筛选
• 零基价增量定价：即使服务免费也可设置附加费用
• Google Maps 集成：内置基础地图样式，支持 Snazzy Maps 插件自定义风格
• 邮件流程全定制：通过钩子脚本完全自定义邮件生成与发送逻辑
• 多语言时区显示：前端时区信息翻译为当前语言
• 非十进制货币格式化：自动处理特殊货币格式
• 表单构建器预览：实时预览表单元素效果
• 预约导出含 ID：导出的样式表中包含唯一预约编号

v2.4.3 – Google Calendar 与支付

• 共享日历容器创建：非所有者也可在共享 Google Calendar 中创建容器
• 邮件提醒提前设置：提醒邮件可设置为最多提前 5 天发送
• Stripe 错误反馈：支付失败时向用户展示明确错误提示
• 协作者取消权限：服务提供者可取消已确认的预约
• 修复重复事件性能：解决多站点环境下循环事件导致的性能问题

v2.5.1 – 促销与提醒修复

• 修复促销优惠因日期格式错误无法创建的问题
• 修复提醒邮件未正常发送的问题
• 修复预约数据库超时设置未生效的问题
• 修复支付邮件页面功能异常的问题

v2.5.2 – 移动端体验

• 修复移动设备上票数选择交互不友好的问题

v2.5.3 – 购物车支付

• 修复结算过程中支付选项未显示的问题

邮件链接与界面定制

v2.1.4 — 主题继承与全球化改进

取消 / 审批 / 拒绝操作的邮件链接落地页现在会自动继承当前 WordPress 主题的模板样式，解决了部分主题下 CSS 和脚本无法加载的问题。同时修复了多语言字符串和时间显示的本地化错误，并扫除了若干 CSS 问题。

v2.1.3 — 高级定制与兼容性

新增自定义 WordPress Actions 接口，支持深度定制业务逻辑。CSS 加载顺序调整至页面顶部，提升渲染性能。新增 getslots API 函数，便于开发者查询可用时段。Bugfixes 方面，修复了无法翻译的字符串、取消预订后仍显示表单、IE 浏览器下拉菜单异常，以及 declinelink 邮件钩子显示有误等问题。

v2.1.2 — 激活修复

修复了插件激活时的报错问题。

v2.1.1 — 地图、支付与日历互操作

新增实时 Google Maps 导航和 Google Calendar 事件之间的关联依赖。概览表格全新设计，信息呈现更清晰。Stripe 信用卡动态表单得到优化，数据库体积压缩，地图缩放级别可自定义配置。邮件钩子新增 [timezone]，方便在通知邮件中显示客户时区。当促销将价格降为 0 时，支付步骤自动跳过。内建字段实现实时翻译，并支持 LocoTranslate 等 .po 编辑插件。新增”评价”步骤，完善预约流程。修复了前端日历时区问题、Google Calendar 事件提醒在取消时被还原、多选项价格未在前端和邮件模板中更新、多站点环境下可用时段不同步、REST API 报”invalid resource”错误、下拉菜单层叠冲突等问题。

v2.0.5 ~ v2.0.3 — 状态通知与多站点支持

修复了向同事 / 管理员重复发送取消邮件的问题，以及售罄标签显示不正确等细节。改进方面：取消通知邮件重新开放给管理员和同事，取消原因可配置嵌入邮件正文，startdatetime 和 enddatetime 邮件钩子拆分为独立日期和独立时间字段，前端预约列表状态标签重新设计且支持翻译。v2.0.3 还修复了概览选项卡中预订记录未正常插入的问题，并加入多站点兼容性支持。

v2.0.2 — 性能与稳定性

修复了大量预订时概览选项卡加载缓慢、多种预订场景报错、可取消重定向 URL 选项、隐藏时区选择器后部件异常、全天活动存在时的阻塞报错、部分数据库内存泄漏、前端时段排序错误等问题。脚本和样式表加入版本号标识，升级插件后不再出现浏览器缓存干扰。

v2.0.1 — 首发版本核心修复

发布初期即修复了设置无法保存、”已预订”标签在可用事件中错误显示、同一位客户预订数量统计错误、重定向 URL 功能异常、容器模式下 POST 报错、后端预订表格排序错误等问题。

v2.0 — 核心功能全面升级

这是该插件的首个主要版本，带来了功能上的全面升级： 商业与促销

• 促销活动与折扣券系统
• 随所选选项递增的价格计算

支付与集成

• REST API 开放接口
• Stripe 信用卡动态表单
• PayPal IPN 服务器要求规范化

日历与地图

• 双向 Google Calendar 同步与重叠事件管理
• 多种地图样式主题
• Google Maps API Token 规范化支持与文档化

用户侧体验

• 客户时区选择器
• 客户后端预约列表（短码）
• 客户自行取消预约
• 邮件提醒功能
• 邮件链接直接完成审批 / 拒绝 / 支付操作

后端与管理

• PDF 格式预订报表导出
• 概览表格全面提速
• Google 数据拉取更快更稳
• 前端日历全新改版（取消弹窗，减少冲突）
• 前端无障碍访问改进
• 预约的客户详情可直接在后端编辑
• “何时开放预订？”设置项落地
• 预订数据库 ID 通过重定向 URL 传递，支持转化追踪

数据与报告

• XLSX / CSV 导出缺失详情问题修复
• 修复了 ICS 导入导出问题