From 3ceb746b145b8caa1825ece332efc1a4774974c6 Mon Sep 17 00:00:00 2001 From: Darcy Ye Date: Mon, 4 Jul 2022 10:31:40 +0800 Subject: [PATCH] docs(connector): wechat web readme zh-CN (#1389) --- packages/connector-wechat/README.md | 76 +++++++++++++++++++++++++++-- 1 file changed, 73 insertions(+), 3 deletions(-) diff --git a/packages/connector-wechat/README.md b/packages/connector-wechat/README.md index 95e83d4ff..4cc0a1ef9 100644 --- a/packages/connector-wechat/README.md +++ b/packages/connector-wechat/README.md @@ -2,7 +2,7 @@ The official Logto connector for WeChat social sign-in in web apps. -微信 web 应用社交登录官方 Logto 连接器 [中文文档](#) +微信 web 应用社交登录官方 Logto 连接器 [中文文档](#微信网页连接器) **Table of contents** @@ -16,6 +16,16 @@ The official Logto connector for WeChat social sign-in in web apps. - [Waiting for the review result](#waiting-for-the-review-result) - [Compose the connector JSON](#compose-the-connector-json) - [Test WeChat web connector](#test-wechat-web-connector) +- [微信网页连接器](#微信网页连接器) + - [开始上手](#开始上手) + - [在微信开放平台新建一个网页应用](#在微信开放平台新建一个网页应用) + - [创建一个账号](#创建一个账号) + - [创建一个网页应用](#创建一个网页应用) + - [基础信息](#基础信息) + - [网站信息](#网站信息) + - [等待审核结果](#等待审核结果) + - [编写连接器的 JSON](#编写连接器的-json) + - [测试微信网页连接器](#测试微信网页连接器) ## Get started @@ -37,13 +47,13 @@ Open https://open.weixin.qq.com/, click the "Sign Up" button in the upper-right ### Create a web app -Sign in with the account you just created. In the "Web Application" (网站应用) tab, click the big green button "Create a web app" (创建网站应用). +Sign in with the account you just created. In the "Web Application" (网页应用) tab, click the big green button "Create a web app" (创建网页应用). ![App tabs](/packages/connector-wechat/docs/app-tabs.png) Let's fill out the required info in the application form. -![Create a mobile app](/packages/connector-wechat/docs/create-web-app.png) +![Create a web app](/packages/connector-wechat/docs/create-web-app.png) #### Basic info @@ -75,3 +85,63 @@ Once passed the review, go to the application details page and generate an AppSe That's it. Don't forget to [Enable connector in sign-in experience](https://docs.logto.io/docs/tutorials/get-started/enable-social-sign-in#enable-connector-in-sign-in-experience). Once WeChat web connector is enabled, you can sign in to your app again to see if it works. + +# 微信网页连接器 + +## 开始上手 + +如果你还不知道连接器的概念,或者还没有将本连接器添加至你的「登录体验」,请先参见 [Logto 教程](https://docs.logto.io/zh-cn/docs/tutorials/get-started/enable-social-sign-in)。 +> **⚠️ Caution** +> +> 这个连接器只适用于网页应用。如果你在寻找移动端原生应用的微信登录解决方案,请移步 [微信原生连接器](https://github.com/logto-io/logto/tree/master/packages/connector-wechat-native)。 + +## 在微信开放平台新建一个网页应用 + +> 💡 **Tip** +> +> 你可以跳过已经完成的部分。 + +### 创建一个账号 + +打开 https://open.weixin.qq.com/,点按右上角的「注册」按钮,根据引导完成注册流程。 + +### 创建一个网页应用 + +用刚创建的帐号登录。在「移动应用」标签页,点按大而绿的「创建移动应用」按钮。 + +![App tabs](/packages/connector-wechat/docs/app-tabs.png) + +让我们填写一下申请表单里的必要信息。 + +![Create a web app](/packages/connector-wechat/docs/create-web-app.png) + +#### 基础信息 + +大多数字段都很直接。在完成了表格之后,点按「下一步」以继续。 + +#### 网站信息 + +用你的 Logto 域名(例如 `logto.io`)填写「授权回调域」。 + +#### 等待审核结果 + +完成输入网站信息之后,点按「提交审核」以继续。审核速度通常很快,1-2 天即可完成。 + +我们怀疑每次提交审核者都是随机分配的,因为审核标准飘忽不定。第一次提交也许会被拒绝,但别灰心!陈述你的现状并询问审核者如何修改。 + +## 编写连接器的 JSON + +在通过审核后,进入应用详情页生成 AppSecret;并用以下格式编写连接器的 JSON: + +```json +{ + "appId": "wx123456789", + "appSecret": "some-random-string" +} +``` + +### 测试微信网页连接器 + +大功告成。别忘了 [在登录体验中启用社交登录](https://docs.logto.io/zh-cn/docs/tutorials/get-started/enable-social-sign-in/#%E5%9C%A8%E7%99%BB%E5%BD%95%E4%BD%93%E9%AA%8C%E4%B8%AD%E5%90%AF%E7%94%A8%E8%BF%9E%E6%8E%A5%E5%99%A8)。 + +在微信原生连接器启用后,你可以构建并运行你的应用看看是否生效。