WeTypecho : 一款开源可映射 typecho 的微信小程序

samuel 2019-08-25 PM 2336℃ 0条

1528416097-1.jpg
最近在网络搜寻小程序开源项目的时候无意中发现了一款将 Typecho 站点的内容映射到微信小程序中 —— WeTypecho ,在一定程度上它可以帮助站长获取更多来自微信的流量。
开源项目地址:https://github.com/MingliangLu/WeTypecho

功能特性

  • 首页预览置顶文章
  • 支持评论,回复,点赞
  • 支持内容转发,分享到朋友圈
  • 服务器资源监控
  • 图片及视频显示
  • 支持 markdown,html 解析

使用教程
虽然 WeTypecho 的整个安装相对简单,但细节部分还需要自己调整。

安装须知
由于微信官方规定必须满足两个条件才能上线小程序: ⒈域名已备案; ⒉域名开启 HTTPS 。

插件设置
1、github 下载 WeTypecho 源码
2、将根目录下的 we-typecho-plugin 上传至 /usr/plugins 目录下。
3、将 we-typecho-plugin 文件夹重命名为 WeTypecho,注意大小写,否则不能使用
4、进入 Typecho 后台插件管理 (控制台 -> 插件),启用 WeTypecho 插件,然后点设置 设置示例如下, 其中 API 密钥,自行设置,用于防止恶意请求,需要与小程序代码端的设置一致,否则可能无法访问,这个后面会提到。openid 就是设置允许微信号可以查看探针(即服务器信息),上线小程序后,用自己的微信号打开一下小程序,然后在 wetypecho 的控制台就可以看到自己的微信号和 openid。
2119717297-2.png

小程序设置
1、下载的根目录下的 Wetypecho 文件夹就是小程序的源代码,进入 Wetypecho 目录,根目录下有一个 config.js,打开编辑器, 将 domain 设置为你的已备案域名,不需要加 http 或者 https:// 。name 修改为你的网站名称,用于小程序页脚显示。 API_SECRET 必须与 WeTypecho 插件中的 API 密钥配置一样。设置完以后保存并关闭。
1191947939-3.png

2、打开根目录下的 app.json,修改为自己的网站名。
1972426396-4.png

3、打开 Template 目录下的 foot.wxml 修改页脚版权,这个我填网站原域名,因为毕竟显示值而已,对实际并没有什么影响。
2189653003-5.png

4、去微信官方小程序平台设置域名,路径:设置 -> 开发设置,服务器域名。将你的域名添加进去,如果你的图片等资源存放的地址不是你上面设置的域名,还需要将你的图片资源域名添加进去。
136349994-6.png

5、下载使用微信开发者工具打开 WeTypecho 下的 wetypecho 目录,可以预览小程序页面,也可以做相应修改。
1744437595-7.png

6、以上设置好以后就可以在微信开发者工具点击上传,上传小程序代码,然后去微信官方小程序平台发布小程序提交审核,等待审核通过。在此期间管理员微信号是可以看见自己的小程序的,其他人无权限查看。

常见问题
Q1:不显示缩略图,怎么办?

​A: 文章添加自定义字段名 thumb,添加赋值图片地址。

Q2:文章详情页,分类下的文章列表不显示怎么办?

A:如果小程序获取不了文章缩略图,就不显示分类文章列表。可尝试将所有文章都加上自定义字段 thumb,并赋值图片地址。

Q3: xxx 404 错误

A:任何 404 报错都是因为参数值不正确 / 不匹配导致的,例如后台控制面板中的填写的 mid 不正确、API 接口 id 密钥不匹配等,请自行根据报错内容,进行一一核对。

接入移动统计 SDK(可选)
适用范围: 百度移动统计的微信小程序 SDK 适用于微信小程序全部版本。

集成准备:

注册账户并登录百度移动统计官网 mtj.baidu.com;
创建应用时选择小程序 - 微信小程序平台并获取 AppKey(这里是指百度移动统计里的,不是微信小程序的);
如果已创建的应用,请从 "设置 -> 应用信息" 中查看 AppKey。
配置 SDK

下载微信小程序统计 SDK,把解压缩得到的 mtj-wx-sdk.js 和 mtj-wx-sdk.config.js 拷贝到小程序项目的 utils 文件夹中。
打开 mtj-wx-sdk.config.js,修改 AppKey 字段: AppKey: "xxxxxxxxxx";
打开小程序项目的 app.js,在文件最顶部加入: const mtjwxsdk = require("./utils/mtj-wx-sdk.js");
登录微信公众平台,进入小程序的设置 -> 开发设置 -> 服务器域名,把 https://hmma.baidu.com 加入 request 合法域名。

标签: 微信小程序, 开源

评论啦~