连接到您的店铺
此界面仅在桌面端和移动端应用中显示。网页端用户可通过 yourdomain.com/pos 直接访问 POS，并使用 WordPress 凭据登录。
连接界面概览
打开 WCPOS 桌面端或移动端应用后，您将看到连接界面。您可以在此管理店铺连接和用户登录。
添加新店铺
- 在文本框中输入您的 WooCommerce 店铺 URL（例如
https://mystore.com） - 点击连接
- 系统将跳转到 WordPress 登录页面，请使用您的 WordPress 凭据登录
- 登录成功后，将自动返回应用
多店铺连接
您可以连接任意数量的 WooCommerce 店铺。每个店铺在连接页面上显示为一张独立的卡片，包含以下信息：
- 店铺名称和网站图标
- 店铺 URL
- 该店铺的已登录用户
如果您管理多个门店或业务，此功能非常实用。
单店铺多用户
每个店铺支持多个用户同时登录。适用于以下场景：
- 交接班 - 新收银员可以在上一位收银员退出之前登录
- 多收银台 - 不同收银员可在不同设备上操作
- 快速切换 - 轻松在用户账户之间切换
添加用户
点击 "已登录用户"旁边的按钮，即可将另一个用户添加到该店铺。
切换用户
点击用户头像（例如"Brenda"）即可以该用户身份打开 POS。
移除用户
点击用户头像上的 × 即可将该用户从店铺中注销。
移除店铺
点击店铺卡片上的红色 × 按钮，即可将其从列表中移除。此操作会注销所有用户并断开该店铺与应用的连接。
演示店铺
在屏幕底部，您可能会看到"进入演示店铺"链接。该链接可连接到一个演示 WooCommerce 店铺，让您无需影响自己的店铺数据即可试用 WCPOS 功能。
故障排除
X-Frame-Options桌面端和移动端应用使用 iframe 进行登录、支付和收据显示。任何发送 X-Frame-Options: DENY 或 SAMEORIGIN 的服务器头或插件都会导致登录失败。这是应用登录失败最常见的原因——请在进行其他操作之前，先检查登录页面的响应头（使用浏览器开发者工具，或执行 curl -I https://yourstore.com/wp-login.php）。
无法连接到我的店铺？
- 确保已在 WordPress 站点上安装并激活 WCPOS 插件
- 检查是否使用了正确的 URL（需包含
https://——WooCommerce REST API 要求使用 SSL） - 先在浏览器中打开
yourdomain.com/pos以确认插件正常运行 - 验证 WooCommerce REST API 是否可访问
- 检查用户账户是否拥有 POS 访问权限
桌面端或移动端应用登录失败
大多数应用登录失败是由安全或缓存插件阻止了登录 iframe 所导致的：
X-Frame-Options头信息（由安全插件或服务器设置）会阻止登录 iframe 的加载——请参阅上方说明。临时禁用安全插件，完成登录后重新启用即可（会话有效期约为一周）。- 安全插件 — Wordfence、Really Simple Security、WPS Hide Login、iThemes/Solid Security 和 Defender Pro 是常见的冲突来源。完整列表及解决方法请参阅插件冲突。
- Wordfence 2FA — 双重验证码字段无法在登录 iframe 中显示。目前请为 POS 用户禁用双重验证。
- 自定义登录 URL（例如 WPS Hide Login）——应用无法找到登录页面。请使用标准的
/wp-admin/URL。 - 缓存插件可能会在您禁用相关插件后仍然显示被阻止的登录表单——请清除缓存，或清除应用缓存/重新安装桌面应用。
连接界面显示"REST API 需要身份验证"或安全插件错误
某个插件（例如 Force Login 或 JWT 认证插件）要求所有 REST API 请求都必须经过身份验证，因此应用无法读取站点的公开信息。现在应用会显示服务器的实际消息（例如 "只有经过身份验证的用户才能访问 REST API"），而不是错误地报告站点类型。
**解决方法：**配置安全插件，允许未经身份验证访问 /wp-json/wcpos/ 和 /wp-json/wc/v3/，或在完成首次连接前暂时禁用该插件。
"似乎不是一个 WordPress 站点"（桌面应用）
桌面应用通过 HTTP Link 头发现 REST API。如果某个插件（常见的有 Image Prioritizer 或其他性能优化插件）填满或截断了该头信息，发现过程将会失败。**解决方法：**禁用图片优化/修改头信息的性能插件，然后重试。
应用提示需要更新／更新后崩溃
检查应用程序与服务器插件之间是否存在版本不匹配——应用商店可能已推送了应用更新，而 WCPOS 插件仍需更新（反之亦然）。请确保应用程序和 WCPOS 插件处于相同的主版本。WCPOS v1.9.0+ 应用要求 WCPOS 插件版本为 v1.8.0 或更高。
"Cannot create fast store database" 错误
这是首次登录时的竞态条件。完全关闭应用并重试——通常第二次即可成功。
停留在用户选择界面（桌面应用）
登录后可以看到用户名，但没有明显的继续操作方式。点击用户名/姓名即可进入 POS——用户名本身就是按钮。