2020.03.18 | 网站相关 | 21 赞 | 21 条评论


毕竟自己开的项目还是要自己填填文档的坑的,于是简单做了这样一份 UniTypecho 的使用攻略,希望能帮到对这个小程序有兴趣的人 w

UniTypecho 是一个可以将你的 Typecho 博客打包为微信小程序 / QQ 小程序 / 移动 H5/Android 应用等等的跨平台应用,GitHub 项目地址在 这里,可扫描二维码进入我的博客进行预览:

如安装过程中产生问题可以加入 QQ 群 1059333269 详细咨询沟通。

那么我们开始吧ww

0. 准备工作

启用这个项目需要您已经有一个搭好了的 Typecho 博客站点,并建议开启静态化。

微信官方规定必须满足以下两个条件才能上线小程序:

  1. 域名已备案
  2. 域名开启 Https

如您符合上述条件,则需下载 微信开发者工具HbuilderX

1. 小程序后台设置

首先在 微信公众平台 注册小程序(其他平台同理);

在小程序后台中 开发 - 开发设置 中取得 APPIDAPPSecret

服务器域名 中添加如下合法域名:

注:理论上图床和图片地址不需要,只需要接口和域名即可,但我懒得改了。

2. 插件设置

下载 UniTypecho,如果可以的话还请顺手点个 star,开发不易,炖翠翠出气;

将项目目录下的 UniTypecho-Plugin 文件夹上传至 Typecho 目录 /usr/plugins 目录下,并 重命名 为 UniTypecho, 注意大小写,否则可能不能使用

进入 Typecho 后台插件管理 控制台 -> 插件,启用 UniTypecho 插件,然后进入设置,配置 API 密钥、APPID、APPSecret 等:

注 1:API 密钥,由你自己设置,用于防止恶意请求。需要与小程序代码端的设置一致,否则将无法访问,这个后面会提到。

注 2:关于页面的 cid:需要关于页面为独立页面,查看独立页面的 cid 可在编辑对应页面的 url 中看到。

校验:尝试访问域名 域名 /uniapi/getconfig?apisec=API 密钥,若访问成功,则插件端设置正常。

注:若未开启静态化并出现错误,则将 域名 替换为 域名 /index.php 进行尝试。

3. 小程序设置

打开 HbuilderX,文件 - 导入 - 从本地目录导入,选择将上一步下载项目目录下的 UniTypecho 文件夹;

复制目录中的 manifest.json.examplemanifest.json,配置其中的相关配置;

复制目录中的 static/config.js.examplestatic/config.js,并进行配置:

4. 调试与打包

调试:运行 - 运行到小程序模拟器 - 微信开发者工具,如果运行顺利,会自动打开微信小程序开发工具并打开项目;若未打开项目,项目目录为 目录 /unpackage/dev

打包:发行 - 小程序 - 微信,如果运行顺利,会自动打开微信小程序开发工具并打开项目;若未打开项目,项目目录为 目录 /unpackage/build,测试完成后即可上传发布审核。

其他平台流程类似,可参见 uniapp 发布

5. 头图的使用

在希望自定义头图的文章中添加自定义字段 thumb,指向图片的 URL。

进阶:微信订阅

  1. 微信小程序后台 功能 - 订阅消息,添加 留言回复通知
  2. 将添加成功后的模板 ID 填入插件后台中

注意事项

QQ 小程序由于存在问题,导致图标无法正常显示

解决方案:对项目进行调试、打包,并复制 /unpackage/dist/dev/mp-qq/common 替换掉 /unpackage/dist/build/mp-qq/common

本文链接:https://idealclover.top/archives/613/

本作品由 idealclover 采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可,转载请注明出处。

标签: 博客, 文章, 微信, 设置, 服务器, 静态, usr, 域名, 文件, 平台, 公众, 模板, json, 安装, 工具, 页面, 消息, 图片, 目录, 程序, unitypecho

21

已有 21 条评论


  1. Arn0
    Arn0 回复

    报个Bug,翠翠你小程序里面评论的链接全都点不开。∠( ᐛ 」∠)_

    1. idealclover
      idealclover 回复

      是故意的 feature,微信小程序不允许外链,而且评论区可能会有垃圾评论

  2. Summer
    Summer 回复

    HXD属实能折腾呐,哈哈。btw,请问下有没有类似的东西能够配合Wordpress/Hexo使用的?(动态的折腾过了,就觉得静态博客还是比较省心,最近有迁移内容的打算,顺便提前了解下相关的插件:)

    1. idealclover
      idealclover 回复

      我印象中 Wordpress 和 Hexo 都是有人写的~ 可以在 GitHub 上搜一搜?

      我其实倒觉得还是动态博客省心一点... 比如点赞评论功能哇,邮件回复功能哇,静态博客有时候折腾起来很麻烦 XD

  3. 半斤锵烤铜

    感谢(ㆆᴗㆆ) 想解析扩展的markdown语法可怎么办

    1. idealclover
      idealclover 回复

      扩展的 markdown 语法是指什么~

      可以替换 markdown 引擎的~OωO

      1. 半斤锵烤铜

        自己外挂了个js,解析好了markdown,然后发现小程序它不支持ruby标签!!!!🙄

        1. idealclover
          idealclover 回复

          对的 微信对 html 标签做了很多限制

  4. Spoience
    Spoience 回复

    向大佬学习⌇●﹏●⌇

    1. idealclover
      idealclover 回复

      不是大佬啦 //捂脸

      一起加油鸭!OωO

  5. Joseph
    Joseph 回复

    诶为啥我点👆上面那个♥,会弹一个about:blank呢...?chrome 80.0.3987.132

    1. idealclover
      idealclover 回复

      代码冲突,已经修好啦OωO

  6. frank
    frank 回复

    感谢OωO

    1. idealclover
      idealclover 回复

      没事w

  7. c0sMx
    c0sMx 回复

    太棒了太棒了

    1. idealclover
      idealclover 回复

      欸嘿~o(////▽////)q

  8. 魚丸包粗麵🌟
    魚丸包粗麵🌟 回复

    大写的赞👍🏻

    1. idealclover
      idealclover 回复

      感谢支持!!

  9. 夏目
    夏目 回复

    学习了学习了

    1. idealclover
      idealclover 回复

      感谢支持!(/ω\)

🤔关于我
翠翠 idealclover
南京大学商学院 2016 级本科生
了解更多
🏠关于博客
基于 Typecho 博客框架
使用个人创作的 clover 主题
💾博客小程序
💸支持我