第一部分：准备工作 (至关重要)
在开始安装之前，请确保你已经准备好以下所有内容,这可以避免后续大部分的安装问题。
（图片来源网络，侵删）
-
一个有效的 ShopEx 账号：
- 你需要有一个在 ShopEx 官网 注册的账号，并且已经购买了“云登录”服务，这个服务通常是作为 ShopEx 电商系统（如 B2B、B2C、微商城等）的一个增值模块存在的。
-
ShopEx 系统环境：
- 你已经成功安装并运行了 ShopEx 的核心电商系统（ShopEx B2B2C、B2C、移动商城等）。
- 确保你的系统是最新稳定版本，如果不是，请先通过后台进行更新,因为旧版本可能存在兼容性问题。
-
服务器/网站环境要求：
- PHP 版本： 确保你的 PHP 版本符合 ShopEx 云登录的要求（通常是 PHP 7.0 及以上版本，具体请查看官方文档）,过低或过高的版本都可能导致问题。
- 开启必要的 PHP 扩展： 确保以下 PHP 扩展已开启并正常工作：
curlopensslgd或imagick(用于图片处理)
- 目录权限： 确保 ShopEx 安装目录下的以下目录具有可写权限（通常是 755 或 777，但为了安全，建议设置为 755）：
./data/./public/(或其下的子目录，如./public/uploads/)./static/./config.php(如果存在)
-
获取云登录的“AppID”和“AppSecret”：
（图片来源网络，侵删）- 登录你的 ShopEx 商家后台。
- 找到“云登录”或类似的模块管理页面。
- 在该页面，你会看到为你生成的 AppID 和 AppSecret，这两个是连接你的网站和 ShopEx 云登录服务的唯一凭证，请务必妥善保管，不要泄露。
第二部分：安装步骤
安装过程主要在 ShopEx 后台完成。
步骤 1：登录 ShopEx 后台
使用你的管理员账号登录你的 ShopEx 商家后台。
步骤 2：进入“云登录”模块管理界面
- 在后台菜单中，找到 【系统】 -> 【应用中心】 或 【应用市场】。
- 在应用市场中，搜索“云登录”。
- 找到官方的“云登录”应用，点击 【安装】 或 【购买/启用】。
- 如果已经购买过，你可能直接在 【系统】 -> 【云登录】 菜单项下找到入口。
步骤 3：配置云登录信息
这是最核心的一步。
- 进入云登录的配置界面后,你会看到需要填写的表单。
- 填写 AppID 和 AppSecret： 将你在“准备工作”第 4 步中获取的
AppID和AppSecret准确地填入对应的输入框中。 - 选择登录方式： 勾选你希望用户可以使用哪些方式进行登录，通常包括：
- 手机号 + 验证码
- 邮箱
- 微信登录
- QQ 登录
- 微博登录
- 等等... 根据你的目标用户群体进行选择即可。
步骤 4：生成并上传配置文件
ShopEx 云登录采用了一种安全的方式来验证你的网站所有权,即通过生成一个配置文件。
（图片来源网络，侵删）
- 生成配置文件： 在后台配置界面，通常会有一个 【生成配置文件】 或类似的按钮，点击它，系统会自动生成一个名为
sso_config.php的文件。 - 下载文件： 系统会提供这个文件的下载链接,请下载它。
- 上传文件到网站根目录： 使用 FTP 工具（如 FileZilla）或你的主机控制面板的文件管理器，将刚刚下载的
sso_config.php文件上传到你的 ShopEx 网站的根目录下。- 根目录：即你访问网站时
http://www.yourdomain.com/对应的那个文件夹，通常是public_html、wwwroot或网站根目录。
- 根目录：即你访问网站时
注意： 这一步是验证网站归属的关键，文件必须上传到正确的位置,并且文件名不能修改。
步骤 5：完成安装并启用
- 返回到 ShopEx 后台的云登录配置界面。
- 系统会自动检测
sso_config.php文件是否存在，如果上传成功，你会看到“验证通过”或类似的提示。 - 点击 【保存并启用】 或 【提交】 按钮。
- 系统会提示你安装成功。
步骤 6：在前端页面显示登录入口
安装和配置只是后端工作,你还需要在前台页面上让用户看到并使用这个登录入口。
- 登录你的网站前台。
- 在你希望显示“云登录”按钮的位置（通常是网站的顶部登录栏、注册页面等）,你需要添加一小段代码。
- 这段代码可以在 ShopEx 后台的 【模板设置】 -> 【页面设置】 中找到，或者在云登录模块的说明文档里有提供，通常是这样的：
<!-- 在需要显示云登录图标的地方插入如下代码 --> <div class="slogin-container"> {slogin} </div>或者更具体地,指定显示哪些平台：
<div class="slogin-container"> {slogin type='qq,weixin,weibo'} </div> - 保存模板修改并刷新网站前台页面，你应该就能看到各种第三方登录的图标了（如微信、QQ、微博等）。
第三部分：测试与排错
安装完成后,务必进行测试。
-
正常流程测试：
- 点击前台页面的“微信登录”按钮。
- 系统会跳转到微信的授权页面。
- 使用你的微信扫码授权。
- 授权成功后，系统应能自动跳转回你的网站，并创建一个新的用户账号（或与现有账号绑定）。
- 登录成功后,检查用户信息是否正确。
-
常见问题排错：
-
问题：点击登录后，页面报错或跳转失败。
- 检查：
AppID和AppSecret是否填写正确,有无多余空格。 - 检查：
sso_config.php文件是否已上传到网站根目录,这是最常见的原因。 - 检查： 服务器是否开启了
curl和openssl扩展，可以通过phpinfo()函数来检查。
- 检查：
-
问题：第三方平台（如微信）提示“域名未登记”或“redirect_uri 域名与后台配置不一致”。
- 检查： 你需要在对应的第三方平台（如微信公众平台）的后台，将你的网站域名添加到“授权回调域名”或“JS 接口安全域名”列表中，在微信开放平台，你需要配置你的网站域名，并确保回调地址（通常是
http://www.yourdomain.com/passport/sso/callback或类似路径）已正确填写。
- 检查： 你需要在对应的第三方平台（如微信公众平台）的后台，将你的网站域名添加到“授权回调域名”或“JS 接口安全域名”列表中，在微信开放平台，你需要配置你的网站域名，并确保回调地址（通常是
-
问题：点击登录图标后，没有任何反应。
- 检查： 前台的模板代码是否正确添加,并且前台模板是否已更新缓存。
- 检查： 浏览器控制台（按 F12 打开）是否有 JavaScript 错误信息。
-
问题：无法连接到 ShopEx 服务器。
- 检查： 服务器防火墙是否阻止了对外部 API 的访问，云登录需要与 ShopEx 的服务器进行通信。
-
ShopEx 云登录的安装可以概括为以下四个核心步骤：
- 准备： 确保环境、权限和凭证（AppID/Secret）都就绪。
- 安装： 在后台应用中心安装“云登录”应用。
- 配置： 填写凭证，选择登录方式，并上传生成的
sso_config.php文件到网站根目录。 - 启用： 保存配置,并在前台模板中添加登录代码。
如果在安装过程中遇到任何困难，最可靠的方法是查阅 ShopEx 官方文档 或直接联系他们的官方技术支持，他们能提供最准确、最及时的帮助。
