# 连接到您的店铺

仅限桌面端和移动端

此界面仅在桌面端和移动端应用中显示。网页端用户可通过 `yourdomain.com/pos` 直接访问 POS，并使用 WordPress 凭据登录。

## 连接界面概览[​](#connect-screen-overview "直接链接到 连接界面概览")

打开 WCPOS 桌面端或移动端应用后，您将看到连接界面。您可以在此管理店铺连接和用户登录。

<!-- -->

## 添加新店铺[​](#adding-a-new-store "直接链接到 添加新店铺")

1. 在文本框中输入您的 WooCommerce 店铺 URL（例如 `https://mystore.com`）
2. 点击**连接**
3. 系统将跳转到 WordPress 登录页面，请使用您的 WordPress 凭据登录
4. 登录成功后，将自动返回应用

## 多店铺连接[​](#multiple-stores "直接链接到 多店铺连接")

您可以连接任意数量的 WooCommerce 店铺。每个店铺在连接页面上显示为一张独立的卡片，包含以下信息：

* **店铺名称**和网站图标
* **店铺 URL**
* 该店铺的**已登录用户**

如果您管理多个门店或业务，此功能非常实用。

## 单店铺多用户[​](#multiple-users-per-store "直接链接到 单店铺多用户")

每个店铺支持多个用户同时登录。适用于以下场景：

* **交接班** - 新收银员可以在上一位收银员退出之前登录
* **多收银台** - 不同收银员可在不同设备上操作
* **快速切换** - 轻松在用户账户之间切换

### 添加用户[​](#adding-a-user "直接链接到 添加用户")

点击  "已登录用户"旁边的按钮，即可将另一个用户添加到该店铺。

### 切换用户[​](#switching-users "直接链接到 切换用户")

点击用户头像（例如"Brenda"）即可以该用户身份打开 POS。

### 移除用户[​](#removing-a-user "直接链接到 移除用户")

点击用户头像上的 **×** 即可将该用户从店铺中注销。

## 移除店铺[​](#removing-a-store "直接链接到 移除店铺")

点击店铺卡片上的红色 **×** 按钮，即可将其从列表中移除。此操作会注销所有用户并断开该店铺与应用的连接。

## 演示店铺[​](#demo-store "直接链接到 演示店铺")

在屏幕底部，您可能会看到"进入演示店铺"链接。该链接可连接到一个演示 WooCommerce 店铺，让您无需影响自己的店铺数据即可试用 WCPOS 功能。

## 故障排除[​](#troubleshooting "直接链接到 故障排除")

首先检查：`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 是常见的冲突来源。完整列表及解决方法请参阅[插件冲突](/zh-CN/support/troubleshooting/plugin-conflicts.md)。
* **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——用户名本身就是按钮。

连接持续失败？

* 先在浏览器中访问 `yourdomain.com/pos`，确认插件是否正常工作
* 检查站点的错误日志，排查是否存在问题
* 确认主机未屏蔽 REST API——参阅[主机相关说明](/zh-CN/support/performance/server.md)
* 确保服务器满足[最低要求](/zh-CN/support/performance/server.md)