Wenprise WooCommerce 订单短信通知：完整使用教程

本教程说明插件的全部现有功能，包括阿里云凭据、顾客通知、管理员通知、订单手动短信、模板变量、日志与更新机制。

1. 工作方式

插件监听 WooCommerce 订单状态事件：

• 订单进入某个状态时，可以向订单账单手机号发送该状态对应的顾客短信；
• 订单从“待付款”或“失败”状态转为其他状态时，可以向管理员手机号发送短信；
• 管理员可以在经典订单详情页选择预设阿里云模板，手动向顾客发送短信；
• 单个订单可以通过“SMS Closed”选项关闭自动顾客短信。

短信由阿里云 Dysmsapi 服务发送，需要提交注册，并设置 API Key，插件不会在 WordPress 数据库中保存短信正文，只保存配置并写入本地日志。

2. 通用设置

前往“WooCommerce > SMS > General”。

保存后，插件会在发送短信或查询模板时使用这些凭据。凭据错误、权限不足、签名未审核或区域限制都会导致阿里云返回错误。

3. 顾客通知

“Customer Notification”按 WooCommerce 订单状态显示独立设置。每个状态包含：

例如，阿里云模板包含 ${shop_name}、${order_id} 和 ${order_amount} 时，填写：

[shop_name]
[order_id]
[order_amount]

没有填写状态专用模板参数时，插件会尝试使用 default_template_param；如果两者都为空，则不会发送该状态短信。

4. 管理员通知

前往“Admin Notification”，配置：

当前版本在订单从“待付款”或“失败”状态转换至任一其他订单状态时触发管理员通知。手机号会移除空格、加号等非数字字符，再提交给阿里云接口。

5. 订单详情页手动发送短信

在“Customer Notification”顶部的“General SMS template code”中，每行填写一个可手动使用的阿里云模板代码。打开经典 WooCommerce 订单详情页后，“Send custom SMS”区域会从阿里云查询这些模板并显示模板名称。

操作步骤：

1. 在模板下拉列表中选择短信模板；
2. 点击“Send SMS”；
3. 插件使用订单账单手机号和订单变量调用阿里云；
4. 发送成功后，插件在订单中添加“发送短信给顾客”备注。

当前手动发送界面注册在经典 shop_order 编辑页。如果站点仅使用 WooCommerce HPOS 新订单界面且看不到该区域，请暂时通过订单状态通知发送，或在启用兼容模式后使用经典订单编辑页。

6. 单订单关闭自动短信

在经典订单详情页勾选“SMS Closed”并更新订单。插件会保存该订单标记，后续顾客状态通知将被跳过。该选项不会阻止管理员在订单详情页手动发送短信。

7. 可用模板变量

变量名称必须与阿里云模板中的变量名称一致。例如 [billing_phone] 对应 ${billing_phone}。

8. 日志与排错

插件日志位于：

wp-content/uploads/wrps-sc-smswoocommerce-logs/WenpriseSMS.log

排查顺序：

1. 确认 WordPress、WooCommerce 和 PHP 版本满足要求；
2. 确认阿里云 AccessKey、短信签名和模板均有效并已审核；
3. 确认对应通知开关已启用；
4. 确认模板代码和模板参数均不为空；
5. 确认订单账单手机号存在；
6. 检查订单备注和日志中的阿里云响应；
7. 在阿里云控制台检查短信发送记录与错误码。

日志可能包含手机号和模板参数，应限制上传目录访问权限，并按站点隐私政策定期清理。